Mac主机Linux容器中Arduino CLI上传故障排查及socat配置优化

背景 #

Mac无法直接将串口设备传递给Docker容器，因此使用socat将串口连接通过TCP桥接，再在容器内转回串口。

配置 #

Docker启动命令 #

通过--add-host=host.docker.internal:host-gateway实现主机到容器的TCP流量转发：

docker run -it --rm \
    -v "$HOME:$HOME" \
    -e "HOME=$HOME" \
    -w "$PWD" \
    -e "DISPLAY=host.docker.internal:0" \
    --add-host=host.docker.internal:host-gateway \
    --user root \
    openmodelica-screen bash

Socat配置 #

• Mac主机端：将Arduino所在的/dev/cu.usbmodem14201串口绑定到TCP 9000端口：

socat TCP-LISTEN:9000,reuseaddr,fork FILE:/dev/cu.usbmodem14201,raw

• Linux容器内：从TCP 9000端口创建虚拟串口，可通过ls /dev/pts查看（通常为/dev/pts/2）：

socat tcp:host.docker.internal:9000,reuseaddr pty,raw,echo=0 &

问题 #

使用picocom可与Arduino正常通信（按键输入立即发送，无需回车）：

picocom -b 9600 /dev/pts/2

但执行Arduino CLI上传命令时出错：

./arduino-cli upload -p /dev/pts/2 --fqbn arduino:avr:leonardo MyFirstSketch

错误信息：

Connecting to programmer: .
Found programmer: Id = "Invalid"; type = l
    Software Version = I.n; Hardware Version = v.a
avrdude: error: buffered memory access not supported. Maybe it isn't
a butterfly/AVR109 but a AVR910 device?
avrdude: initialization failed, rc=-1
         Double check connections and try again, or use -F to override
         this check.

avrdude: error: programmer did not respond to command: leave prog mode
avrdude: error: programmer did not respond to command: exit bootloader
Failed uploading: uploading error: exit status 1

解决技巧与方法 #

问题核心在于串口-TCP-串口转换过程中，时序、参数匹配度未满足Arduino编程的严格要求，可通过以下方式修复：

1. 补全Socat串口参数 #

Arduino编程（尤其是AVR系列）对串口参数有严格要求，需在socat命令中明确指定标准参数：

• 主机端命令修改：

socat TCP-LISTEN:9000,reuseaddr,fork FILE:/dev/cu.usbmodem14201,raw,b9600,cs8,parity-none,stopb1,icanon=0

• 容器端命令修改：

socat tcp:host.docker.internal:9000,reuseaddr pty,raw,echo=0,b9600,cs8,parity-none,stopb1,crtscts=0,icanon=0 &

参数说明：

• b9600：匹配Arduino默认波特率
• cs8/parity-none/stopb1：8位数据位、无校验、1位停止位，符合AVR编程标准
• icanon=0：关闭规范模式，确保复位信号字节无延迟转发
• crtscts=0：关闭硬件流控，避免不必要的握手干扰

2. 关闭TCP延迟优化 #

TCP的Nagle算法会延迟小数据包发送，破坏编程时序，需添加tcp-nodelay参数：

• 主机端：

socat TCP-LISTEN:9000,reuseaddr,fork,tcp-nodelay FILE:/dev/cu.usbmodem14201,raw,b9600,cs8,parity-none,stopb1,icanon=0

• 容器端：

socat tcp:host.docker.internal:9000,reuseaddr,tcp-nodelay pty,raw,echo=0,b9600,cs8,parity-none,stopb1,crtscts=0,icanon=0 &

3. 处理Leonardo的复位机制 #

Arduino Leonardo（ATmega32U4）需要触发复位进入引导加载模式才能上传：

• 上传前按住Leonardo的复位按钮，直到Arduino CLI开始打印Connecting to programmer:时松开，确保设备在引导模式下响应。

4. 确保虚拟串口权限 #

容器内虚拟串口需开放读写权限，可直接修改权限：

chmod 666 /dev/pts/2

或在创建虚拟串口时指定：

socat tcp:host.docker.internal:9000,reuseaddr,tcp-nodelay pty,raw,echo=0,b9600,cs8,parity-none,stopb1,crtscts=0,icanon=0,mode=666 &

5. 替换转发工具（备选） #

若socat时序问题无法彻底解决，可尝试用ser2net替代：

• 主机端配置ser2net绑定串口到TCP端口：

9000:raw:0:/dev/cu.usbmodem14201:9600 8DATABITS NONE 1STOPBIT

• 容器内直接连接该TCP端口进行操作。

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