USBIPD-WIN项目下WSL2连接FTDI设备的故障排查与解决方案

问题背景

在Windows 11环境下通过WSL2使用USBIPD-WIN工具连接FTDI串口设备时，用户发现原本正常工作的设备突然无法识别。设备通过usbipd成功绑定并附加到WSL2后，在Linux系统中未生成预期的/dev/ttyUSB0设备节点。

技术分析

内核模块变更

经排查发现，微软在2024年1月的WSL2内核更新中进行了重大调整：

1. 将原本内置的USB串口驱动改为模块化加载方式
2. 受影响的关键模块包括：
   • ftdi_sio (FTDI设备驱动)
   • cp210x (Silicon Labs设备驱动)
   • ch341 (常见USB转串口芯片驱动)
   • usbserial (基础USB串口支持)

现象本质

当WSL2内核升级到5.15.146.1-2版本后：

1. FTDI驱动不再自动加载
2. 即使用户成功通过usbipd附加设备，系统也无法自动创建设备节点
3. 通过lsusb命令可见设备已连接，但缺少对应的/dev节点

解决方案

方案一：手动加载内核模块（推荐）

对于临时使用或不想启用systemd的用户：

sudo modprobe ftdi_sio

此命令会立即加载FTDI设备驱动模块，系统将自动创建设备节点。

方案二：启用systemd服务

对于长期使用USB设备的用户，建议启用WSL2的systemd支持：

1. 编辑/etc/wsl.conf文件
2. 添加以下内容：

[boot]
systemd=true

3. 重启WSL实例后，systemd会自动管理模块加载

方案三：设置开机自动加载（传统方式）

对于不使用systemd的环境，可编辑/etc/rc.local文件（如不存在则创建）：

#!/bin/sh
modprobe ftdi_sio
exit 0

并赋予执行权限：

chmod +x /etc/rc.local

扩展建议

多设备支持

考虑到实际开发中可能使用多种USB转串口设备，建议同时加载其他常用驱动：

sudo modprobe cp210x
sudo modprobe ch341

版本兼容性

注意不同WSL2内核版本的行为差异：

1. 5.15.146.1之前：驱动内置，无需额外操作
2. 5.15.146.1之后：需要显式加载模块

总结

微软WSL2内核的模块化改进虽然增加了灵活性，但也带来了使用门槛。通过理解内核模块加载机制，开发者可以灵活选择最适合自身工作环境的解决方案。对于嵌入式开发等频繁使用USB设备的场景，启用systemd是最为可靠的长效方案。

建议用户在WSL2环境变更后，建立基础外设的测试流程，以便及时发现类似兼容性问题。