micro-ROS agent setup for Eurobot 2026 — bridges microcontroller serial connections to a ROS 2 (Humble) network running inside Docker.

This repository provides a Dockerized micro-ROS agent that exposes two serial-connected microcontrollers as ROS 2 nodes:

The container runs on the host network, so all ROS 2 topics/services are directly visible to every node on the same machine.

• Docker with BuildKit enabled
• Docker Compose v2
• Serial devices available at /dev/mission and /dev/chassis (create udev symlinks as needed)

.
├── docker/
│   ├── Dockerfile                  # ROS 2 Humble image with micro-ROS agent
│   ├── docker-compose.yaml         # Service definition
│   └── scripts/
│       ├── install_micro_ros.sh    # Builds micro_ros_setup & agent inside the image
│       └── start_agents.sh        # Launches agents in a tmux session
└── README.md

cd docker
docker compose build

docker compose up

On startup the container:

1. Sources ROS 2 Humble and the micro-ROS workspace.
2. Creates a tmux session (micro-ros) with two panes — one for each serial agent.

From another terminal, attach to the tmux session inside the running container:

docker exec -it eurobot-micro-ros tmux attach -t micro-ros

• Switch panes: Ctrl-b then arrow key ↑ / ↓
• Detach (return to host shell, container keeps running): Ctrl-b then d

docker compose down

Environment variables can be set in a .env file next to docker-compose.yaml:

Example .env:

USER_UID=1000
USER_GID=1000
ROS_DOMAIN_ID=0

The image is built for the host platform by default. Cross-compilation is supported via Docker BuildKit's --platform flag.

To get stable device names, add udev rules on the host:

# /etc/udev/rules.d/99-eurobot.rules
SUBSYSTEM=="tty", ATTRS{idVendor}=="XXXX", ATTRS{idProduct}=="YYYY", SYMLINK+="mission"
SUBSYSTEM=="tty", ATTRS{idVendor}=="AAAA", ATTRS{idProduct}=="BBBB", SYMLINK+="chassis"

Replace the vendor/product IDs with the actual values from lsusb or udevadm info.

Reload rules:

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

DIT Robotics — Eurobot 2026