How to Communicate with an Arduino from Docker
Ryan D. Lewis
Posted on March 14, 2021
Something I learned this weekend. Let's say you have an Arduino, and you want to communicate with it via serial from a Linux device, like a Jetson Nano. But not from that device's host operating system. No, that'd be too easy.
Instead, you want to talk with this Arduino from an application running in an unprivileged Docker container. How would you do that?
How To Bring an Arduino inside Docker
It turns out it's actually quite simple! When connected to a Linux device via a USB cable, most Arduino's show up as a device in the form /dev/ttyAMCx
where x is replaced with an integer counter, starting from 0. So the first Arduino you connect is /dev/ttyAMC0
, the second is /dev/ttyAMC1
and so on.
To access that from Docker, all you need is the docker --device
flag. Include it in the docker run command as docker run <other options> --device="/dev/ttyACM0" <more options, image name, etc>
and you're all set. You can access the Arduino in the container at /dev/ttyACMx
just like you would on the host, say with the pyserial
package in Python.
Words of Warning
Couple quick notes:
- You need to have the device connected before you launch your docker container with that flag. Otherwise, you'll get an error.
- You may run into issues if the device is disconnected and reconnected while the container is running.
- Serial over wires (for instance, with jumper cables connecting pins on the arduino to GPIO on a Jetson or Raspberry Pi) rather than via the USB port will probably have a different device file handle, but will function the same way (pass the device file handle into the container with
--devices
.
Posted on March 14, 2021
Join Our Newsletter. No Spam, Only the good stuff.
Sign up to receive the latest update from our blog.