docker コンテナからリモートシリアルポートを使ってホストに接続したシリアルデバイスにアクセスする

Posted at 2025-10-15

0. はじめに

docker: Error response from daemon: error gathering device information while adding custom device "/dev/tty.usbmodem51850109041": no such file or directory↩
コンテナからMacのUSBシリアルにアクセスするために、/dev/tty.usb* をマウントしたいのだが、macOSの仮想デバイスではそれができないようである。仕方ないので、docker cpでホストOSにコピーしてから、write_flashしている。

前回の記事でできなかったことは、どうやら仕様（制約）らしい。

そこで、リモートシリアルポートを使って、同様なことを実現する。

1. ホスト側

ポート番号とシリアルポート(/dev/tty.*)を関連付ける。
（ コンテナからの接続を待ち続ける（打ち切る場合はCtrl+C） ）

Host (macOS)

$ esp_rfc2217_server.py -p 4000 /dev/cu.wchusbserial51850109041

INFO: RFC 2217 TCP/IP to Serial redirector - type Ctrl-C / BREAK to quit
INFO: Serving serial port: /dev/cu.wchusbserial51850109041
INFO: TCP/IP port: 4000
INFO: Waiting for connection ...

2. コンテナ側

シリアルポートに、rfc2217://host.docker.internal:4000?ign_set_control を指定する。ポート番号は、ホスト側の指定に合わせる（4000以外も可）。

Container (Bookworm)

$ esptool.py --chip auto -b 460800 --port rfc2217://host.docker.internal:4000?ign_set_control chip_id

esptool.py v4.10.0
Serial port rfc2217://host.docker.internal:4000?ign_set_control
Connecting...
Device PID identification is only supported on COM and /dev/ serial ports.

Detecting chip type... ESP32-S3
Chip is ESP32-S3 (QFN56) (revision v0.1)
Features: WiFi, BLE, Embedded PSRAM 8MB (AP_3v3)
Crystal is 40MHz
MAC: 34:85:18:99:b5:ac
Uploading stub...
Running stub...
Stub running...
Changing baud rate to 460800
Changed.
Warning: ESP32-S3 has no Chip ID. Reading MAC instead.
MAC: 34:85:18:99:b5:ac
Hard resetting via RTS pin...

Host (macOS)

INFO: Waiting for connection ... use the 'rfc2217://127.0.0.1:4000?ign_set_control' as a PORT
.....INFO: Connected by 127.0.0.1:57864
INFO: Disconnected
.. ^C

# Ctrl-C するまで終わらない

3. 性能

chip_id

ホスト直

% time esptool.py --chip esp32s3 --port /dev/cu.usbmodem51850109041 chip_id

esptool.py v4.10.0
Serial port /dev/cu.usbmodem51850109041
Connecting...
Chip is ESP32-S3 (QFN56) (revision v0.1)
Features: WiFi, BLE, Embedded PSRAM 8MB (AP_3v3)
Crystal is 40MHz
MAC: 34:85:18:99:b5:ac
Stub is already running. No upload is necessary.
Warning: ESP32-S3 has no Chip ID. Reading MAC instead.
MAC: 34:85:18:99:b5:ac
Hard resetting via RTS pin...

0.09s user 0.03s system 19% cpu 0.602 total

コンテナにてリモートシリアルポート指定

$ time esptool.py --chip esp32s3 --port rfc2217://host.docker.internal:4000?ign_set_control chip_id
esptool.py v4.10.0
Serial port rfc2217://host.docker.internal:4000?ign_set_control
Connecting...
Device PID identification is only supported on COM and /dev/ serial ports.

Chip is ESP32-S3 (QFN56) (revision v0.1)
Features: WiFi, BLE, Embedded PSRAM 8MB (AP_3v3)
Crystal is 40MHz
MAC: 34:85:18:99:b5:ac
Stub is already running. No upload is necessary.
Warning: ESP32-S3 has no Chip ID. Reading MAC instead.
MAC: 34:85:18:99:b5:ac
Hard resetting via RTS pin...

real	0m18.672s
user	0m0.183s
sys 	0m0.129s

write_flash