Ubuntu 20.04下Docker应用无法稳定识别串口设备的技术问询

问题根因 #

你当前遇到的识别不稳定问题，核心是容器启动时仅会加载创建时刻已枚举完成的/dev设备节点，热插拔或容器启动早于硬件枚举时，新的串口节点无法同步到容器内，因此保持设备连接重启主机、硬件先完成枚举再启动容器时可以正常识别。

1. 主机侧配置调整 #

• 固定串口设备路径，避免ttyUSB编号漂移
  1. 插入FTDI设备后执行lsusb获取设备的vid（厂商ID）、pid（产品ID），再执行udevadm info --name=/dev/ttyUSB0 --attribute-walk获取设备序列号
  2. 创建udev规则文件/etc/udev/rules.d/99-ftdi-serial.rules，写入如下内容（替换对应参数）：

  SUBSYSTEM=="tty", ATTRS{idVendor}=="替换为你的vid", ATTRS{idProduct}=="替换为你的pid", ATTRS{serial}=="替换为你的设备序列号", SYMLINK+="ttyFTDI0", MODE="0666"
  

  3. 执行命令加载规则：sudo udevadm control --reload-rules && sudo udevadm trigger，后续设备无论插入哪个USB端口，都会固定映射为/dev/ttyFTDI0
• 解决驱动冲突
  如果你使用的是FTDI D2XX用户态驱动，需要屏蔽内核自带的ftdi_sio驱动避免抢占设备，创建/etc/modprobe.d/blacklist-ftdi.conf，写入：

  blacklist ftdi_sio
  blacklist usbserial
  

  执行sudo update-initramfs -u后重启主机生效。

2. 容器/ Azure IoT Edge配置调整 #

• 优化容器创建参数，替换原有的全/dev挂载+全局特权模式，改为指定设备挂载，兼顾安全和可用性，调整后的参数如下：

  {
    "HostConfig": {
      "PortBindings": {
        "80/tcp": [
          {
            "HostPort": "5000"
          }
        ]
      },
      "Devices": [
        {
          "PathOnHost": "/dev/ttyFTDI0",
          "PathInContainer": "/dev/ttyFTDI0",
          "CgroupPermissions": "rwm"
        }
      ],
      "GroupAdd": ["dialout"],
      "Volumes": {
        "/run/udev": {
          "bind": "/run/udev",
          "mode": "ro"
        }
      },
      "Privileged": true
    }
  }
  

  其中：Devices字段直接挂载固定后的串口设备并授予读写权限；GroupAdd将容器用户加入串口设备默认所属的dialout用户组避免权限不足；挂载/run/udev目录可以让容器获取主机的硬件热插拔事件，实现串口设备热插拔实时同步。
• 调整模块启动策略：在应用的启动脚本中增加设备等待逻辑，循环检测/dev/ttyFTDI0是否存在，最多等待30秒，设备不存在时主动退出触发IoT Edge自动重启模块，避免容器启动早于硬件枚举导致识别失败。

3. 应用侧配置调整 #

• 不要硬编码/dev/ttyUSB0作为设备访问路径，改为固定的别名/dev/ttyFTDI0，避免端口编号漂移导致识别失败
• 增加异常重连逻辑：串口读写异常时，不要直接终止服务，每5秒重试检测设备节点、重新打开串口，适配设备临时插拔的场景
• 确认应用镜像内已安装对应版本的FTDI D2XX驱动，不要仅在主机安装驱动，容器运行环境需要补全对应的依赖库

内容的提问来源于stack exchange，提问作者itstudes