From 6239eb1e2d60e12cdb98d635e46696c41e5cb22b Mon Sep 17 00:00:00 2001 From: Carlos Espinoza Curto <148376273+Carlosespicur@users.noreply.github.com> Date: Tue, 23 Sep 2025 14:24:16 +0200 Subject: [PATCH 1/2] Change README build steps to use the official ESP-IDF image (#300) * Change README build steps to use the official ESP-IDF image Signed-off-by: Carlosespicur * Apply suggestions --------- Signed-off-by: Carlosespicur (cherry picked from commit 3fb203b8aa7bce3147ea326cbf124db02a865824) --- README.md | 28 ++++++++++++++++++++++------ 1 file changed, 22 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 49878911..5ac3dd90 100644 --- a/README.md +++ b/README.md @@ -53,18 +53,34 @@ Is possible to use a micro-ROS Agent just with this docker command: ```bash # UDPv4 micro-ROS Agent -docker run -it --rm --net=host microros/micro-ros-agent:foxy udp4 --port 8888 -v6 +docker run -it --rm --net=host microros/micro-ros-agent:kilted udp4 --port 8888 -v6 ``` ## Build with docker container -It's possible to build this example application using preconfigured docker container. Execute this line to build an example app using docker container: +It's possible to build this example application using the official Espressif [docker images](https://hub.docker.com/r/espressif/idf), following the same steps: ```bash -docker run -it --rm --user espidf --volume="/etc/timezone:/etc/timezone:ro" -v $(pwd):/micro_ros_espidf_component -v /dev:/dev --privileged --workdir /micro_ros_espidf_component microros/esp-idf-microros:latest /bin/bash -c "cd examples/int32_publisher; idf.py menuconfig build flash monitor" -``` +docker pull espressif/idf:release-v5.2 +# Run ESP-IDF container +docker run --name micro-ros-espidf-component-test -it espressif/idf:release-v5.2 bash + +git clone https://github.com/micro-ROS/micro_ros_espidf_component.git +cd micro_ros_espidf_component/ + +# Install dependencies +pip3 install catkin_pkg lark-parser colcon-common-extensions -Dockerfile for this container is provided in the ./docker directory and available in dockerhub. This approach uses ESP-IDF v5. +$IDF_PATH/export.sh +cd examples/int32_publisher +# Set target board [esp32|esp32s2|esp32s3|esp32c3] +idf.py set-target esp32 +idf.py menuconfig +# Set your micro-ROS configuration and WiFi credentials under micro-ROS Settings +idf.py build +idf.py flash +idf.py monitor +``` ## Using serial transport @@ -90,7 +106,7 @@ Is possible to use a micro-ROS Agent just with this docker command: ```bash # Serial micro-ROS Agent -docker run -it --rm -v /dev:/dev --privileged --net=host microros/micro-ros-agent:foxy serial --dev [YOUR BOARD PORT] -v6 +docker run -it --rm -v /dev:/dev --privileged --net=host microros/micro-ros-agent:kilted serial --dev [YOUR BOARD PORT] -v6 ``` ## Purpose of the Project From 7669224545e24426e321572765ef2c5bb24ff1fa Mon Sep 17 00:00:00 2001 From: Carlos Espinoza Curto <148376273+Carlosespicur@users.noreply.github.com> Date: Tue, 23 Sep 2025 14:31:56 +0200 Subject: [PATCH 2/2] Change kilted references to jazzy --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 5ac3dd90..368eada8 100644 --- a/README.md +++ b/README.md @@ -53,7 +53,7 @@ Is possible to use a micro-ROS Agent just with this docker command: ```bash # UDPv4 micro-ROS Agent -docker run -it --rm --net=host microros/micro-ros-agent:kilted udp4 --port 8888 -v6 +docker run -it --rm --net=host microros/micro-ros-agent:jazzy udp4 --port 8888 -v6 ``` ## Build with docker container @@ -106,7 +106,7 @@ Is possible to use a micro-ROS Agent just with this docker command: ```bash # Serial micro-ROS Agent -docker run -it --rm -v /dev:/dev --privileged --net=host microros/micro-ros-agent:kilted serial --dev [YOUR BOARD PORT] -v6 +docker run -it --rm -v /dev:/dev --privileged --net=host microros/micro-ros-agent:jazzy serial --dev [YOUR BOARD PORT] -v6 ``` ## Purpose of the Project