前言
因为luckfox lume有两个千兆网口,而且还挺便宜,我比较感兴趣,所以下单购买。
到手发现烧录还挺复杂的:烧录到flash和sd卡都需要全志的刷机工具:phoenixsuit和phoenixcard。
使用phoenixsuit来烧录我还能理解,毕竟烧录到板载flash不内嵌个bootloader的话也不是标准工具可以简单涵盖的。但是phoenixcard烧录系统到sd卡就不太能理解了,为什么不直接生产一个完整系统布局的镜像?这样普通的SD卡烧录工具也能用了。
话说远了,我原本的打算是:在我的嵌入式开发环境专用的VMware虚拟机中烧录它(毕竟经过测试它能正常进行stm32/arduino编写和烧录)。但是测试发现,烧录会卡在uboot启动。等了一分钟后告诉我等待FES超时,然后烧录失败。明明这个usb有好好地映射到虚拟机中的,哪怕刷机过程中重启了也还是可以被正常映射的。
遂尝试直接在Windows 11实体机上烧录,结果发现驱动会被拦截加载,也就不能正常烧录,而且不太想在宿主机装这种神秘小驱动。
经过向AI大人求助后发现在macOS/Linux上也可以烧录不用考虑驱动问题,而且也有phoenixsuit的开源替代:OpenixSuit以及其对应的CLI版本的OpenixCLI,他们都可以跑在Linux和macOS环境。为了尽快检查开发板是否有问题,我就直接在我的macOS上烧录了,总之就是非常顺利地检查完毕了。
随后我想起来,之前有了解到通过usbipd-win的方式把Windows的USB映射到WSL2中,从而实现在Linux上访问Windows的USB外设的方式。今天正好可以用上,所以开始尝试在WSL上再次烧录这块开发板。
背景
- 开发板:Luckfox Lume(
Allwinner T153),FEL 模式枚举为1f3a:efe8 - 环境:Windows 11 + WSL2(
Fedora 44,内核6.6.x)+usbipd-win 5.3.0 - 目标:把 FEL 设备直通进 WSL,用 openixcli 烧录
开始绑定
跟着usbipd-win的教程正常走,直到执行usbipd attach --WSL --busid 2-2提示失败:
1 | |
但 usbipd list 显示设备已经是 Shared (forced),看起来“绑定成功了”。
根因
首次 force 绑定后需要重启一次 Windows
重启前设备卡在
Code 21,attach 报error state;重启后设备以USBIP Shared Device启动,attach 正常。设备每次重新枚举,force 驱动绑定都会丢失
烧录过程中设备会自己重启(
FEL->Boot0/U-Boot->FES),重新枚举后 Windows 回退到默认驱动匹配,设备变成Code 28,usbipd list退回 Shared,需要重新 force。
过程排查(AI辅助)
WSL 侧没问题
vhci_hcd、usbip_core都已加载,内核支持USBIP,问题不在 WSL。Windows 侧设备状态是 Code 21
1
2
3Get-PnpDevice -InstanceId 'USB\VID_1F3A&PID_EFE8\...' | Format-List Status,Problem
Status : Error
Problem : CM_PROB_WILL_BE_REMOVED (Code 21)Code 21 的含义是“Windows 正在卸载这个设备”。也就是说,attach 时 usbipd 对设备做了一次重新枚举,但设备没有正常回来。
usbipd 日志暴露了真正的异常
Application 事件日志里:
1
2System.IO.FileNotFoundException: Unable to find the specified file.
at Usbipd.VBoxUsb.ClaimDeviceOnce()读源码后确认:
ClaimDeviceOnce会枚举VBoxUSB的设备接口,找不到对应 BusId 的设备就抛FileNotFoundException。也就是 VBoxUSB 桩驱动没有真正就绪,attach 自然报Device in error state。一个误导项:USB 过滤器警告
usbipd 一直提示:
1
2USB filter 'TsUsbFlt' is known to be incompatible with this software; 'bind --force' will be required.
USB filter 'USBPcap' is known to be incompatible with this software; 'bind --force' will be required.很容易让人以为是这两个过滤器(远程桌面 USB 重定向 + Wireshark 抓包)导致的。但注意它的措辞:只要求 –force,并没有要求卸载。
我一度删掉了 UpperFilters,后来又把备份恢复回去测试——两个过滤器都在的情况下,attach 依然成功。所以它们不是根因,只是一个“需要 force”的提示。
读源码,找到
--force的真实含义bind --force最终调用DriverTools.ForceVBoxDriver->SetVBoxDriver,内部是:1
2
3BOOL reboot;
PInvoke.DiInstallDevice(..., &reboot);
return reboot; // true = 需要重启usbipd 会据此打印:
A reboot may be required before the changes take effect.
而 attach 的流程是:1
2
3
4
5using var restartingDevice = new RestartingDevice(device);
if (!device.HasVBoxDriver) {
mon = new VBoxUsbMon();
filterId = await mon.AddFilter(exportedDevice); // 动态伪造硬件 ID
}- 普通 bind:attach 时模拟拔插 + VBoxUSBMon 伪造硬件 ID,对设备要求高
- force bind:设备已经绑定 VBoxUSB,跳过动态接管,直接 claim
但 force 的驱动切换,需要重启(或设备节点重启)才真正生效。
脚本
我让AI生成了支持watch参数的usbipd绑定到WSL的脚本,以解决在WSL中对FEL设备烧录过程中FEL设备重启导致强制绑定状态丢失,从而无法正常映射的问题。经过测试大概5-10s即可重新映射到WSL,从而继续烧录流程。
脚本位于: dangjinghao/usbipd-attach。
总结
我说实话真不推荐这么折腾,但凡我的嵌入式开发环境是实体机,或者有一台单独的Linux实体机可能就能直接把问题解决了,这个WSL搞USB映射的弊端太多了,也就临时兴趣上来了可以折腾一下。而且要是没AI帮忙在Windows中排查我是真排查不出来问题了。毕竟环境有点特殊。