Azure IoT Hub树莓派Modbus模块配置：无法读取USB连接Pico数据

1. 确认宿主机设备权限与所属组 #

先在树莓派终端执行命令，查看ttyACM0的权限信息：

ls -l /dev/ttyACM0

正常输出类似：

crw-rw---- 1 root dialout 166, 0 Aug 20 10:00 /dev/ttyACM0

这类USB串口设备通常归属于dialout组（默认GID为20），容器内进程需要加入该组才能获取访问权限。

2. 调整容器创建配置 #

修改你的容器创建选项，添加GroupAdd字段将容器进程加入宿主机的dialout组，同时保留原有设备映射规则：

{
    "HostConfig": {
        "Devices": [
            {
                "PathOnHost": "/dev/ttyACM0",
                "PathInContainer": "/dev/ttyACM0",
                "CgroupPermissions": "rwm"
            }
        ],
        "DeviceCgroupRules": [
            "c 166:* rmw"
        ],
        "GroupAdd": [
            "20"
        ]
    }
}

若你修改过系统组ID，用getent group dialout命令获取实际GID替换20

3. 验证容器内设备权限 #

容器启动后，进入容器内部执行：

ls -l /dev/ttyACM0

确认权限为crw-rw----且所属组包含容器进程的组。若仍无权限，可临时以root用户启动容器排查（生产环境不推荐）：

{
    "HostConfig": {
        "Devices": [
            {
                "PathOnHost": "/dev/ttyACM0",
                "PathInContainer": "/dev/ttyACM0",
                "CgroupPermissions": "rwm"
            }
        ],
        "DeviceCgroupRules": [
            "c 166:* rmw"
        ]
    },
    "User": "0:0"
}

若此配置能正常访问，说明核心问题是容器内用户权限不足，回到步骤2调整组配置即可。

4. 确保设备挂载时权限稳定 #

创建udev规则保证Pico挂载时权限正确，避免容器启动后设备权限变化：

1. 在树莓派上创建文件/etc/udev/rules.d/99-pico.rules，内容如下（替换Vendor/Product ID为你的Pico实际ID，用lsusb命令查看）：

SUBSYSTEM=="tty", ATTRS{idVendor}=="2e8a", ATTRS{idProduct}=="0005", MODE="0666", GROUP="dialout"

2. 重新加载udev规则：

sudo udevadm control --reload-rules && sudo udevadm trigger

5. 核对Modbus服务配置 #

确认容器内Modbus模块的串口配置（路径、波特率、奇偶校验等）与Pico上MicroPython的设置完全匹配，避免因参数不匹配导致连接失败。

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