RMW zenoh-pico implementation

Overview

The rmw_zenoh_pico is the implementation of the rmw layer with zenoh_pico. This package is generated using the Micro-ROS project stack.

This package provides the same future as the RMW Micro XRCE-DDS implementation.

This package is able to connect the rmw_zenoh layer, whose implementation is based on Zenoh and is written using the zenoh-c bindings by the ROS community.

Packages

What is rmw_zenoh_pico ?

• Implementation of the ROS 2 middleware abstraction interface written by C
• Generate micro-ROS applications using zenoh-pico
• A middleware implementation for zenoh-pico package
• Replacement XRCE-DDS on micro-ROS with zenoh-pico
• Wrapper of zenoh-pico API and zenoh-pico internal utilities(z_sting, z_mutex, etc.)
• The reference library implementation for the Zenoh protocol used from upper layers in the ROS 2 stack

Configuration

This package can be configured via CMake arguments.

Name	Description	Default	Config
RMW_ZENOH_PICO_TRANSPORT	Sets zenoh-pico transport to use (unicast, serial)	unicast	OK
RMW_ZENOH_PICO_TRANSPORT_MODE	Sets Zenoh transport connection mode	client	OK
RMW_ZENOH_PICO_CONNECT	Sets the scout address.	127.0.0.1	OK
RMW_ZENOH_PICO_CONNECT_PORT	Sets the scout port.	7447	OK
RMW_ZENOH_PICO_LISTEN	Sets the listen address.	127.0.0.1
RMW_ZENOH_PICO_LISTEN_PORT	Sets the listen port.	-1
RMW_ZENOH_PICO_SERIAL_DEVICE	Sets the agent serial port.*1	/dev/ttyAMA0	OK
RMW_ZENOH_PICO_MAX_LINENESS_LEN	This value sets the number of max liveliness resource length	256
RMW_ZENOH_PICO_C_STANDARD	Version of the C language used to build the library	99

*1 Will be supported in the future

Support rmw Functions

The rmw API for rmw_zenoh_pico is not currently as well supported as rmw_zenoh and rmw_microxrcedds_c. This list is support of rmw_zenoh_pico.

Important

The prototype implementation of rmw_zenoh_pico does not yet support graph-cache information (gid).
For rmw_zenoh_pico to support gid, several issues should be considered.
The rmw_zenoh_pico would like to support zenoh_pico and rmw_zenoh along with future updates from the ROS community.

Installing and build for rmw_zenoh_pico with the micro-ROS system

The rmw_zenoh_pico is used instead of the XRCE-DDS layer in the micro-ROS product.
The rmw_zenoh_pico has to install the micro-ROS product before building it.
For example, if you want to generate a host environment for rmw_zenoh_pico, please refer to the first_application_linux document to install the host environment.

Table: Related repositories

Repository	Branch	SID	URL
micro_ros_setup	jazzy	d60bb3ae889d3617a7a408ae78765e472eda7af9	https://github.com/micro-ROS/micro_ros_setup
zenoh-pico	1.3.1	86c67c30930b19c4df0163e86e1f1821feedc1fe	https://github.com/eclipse-zenoh/zenoh-pico.git
rmw_zenoh	jazzy/0.2.4	02e67ae014a99fa50700d4efeb7648aeb5d09397	https://github.com/ros2/rmw_zenoh.git

Create a workspace and download the micro-ROS tools

unset RMW_IMPLEMENTATION 
mkdir uros_ws && cd uros_ws
git clone -b rmw_zenoh_pico https://github.com/esol-community/micro_ros_setup src/micro_ros_setup
rosdep update && rosdep install --from-paths src --ignore-src -y
colcon build

Note

1. The rmw_zenoh_pico need part of any library which is used by get hash value in the fastdds library. Therefore, the value of RMW_IMPLEMENTATION should not be set before building rmw_zenoh_pico if you use customize rmw_middleware (ex. cyclonedds).
2. The rmw_zenoh_pico have to add patch to product of micro_ros_setup. If you need the patched product, you can clone the branch of rmw_zenoh_pico from mirror of micro_ros_setup.

Creating a new firmware workspace

The rmw_zenoh_pico has demo programs.
This section introduces a sample communication example between rmw_zenoh_pico and zenoh_pico.

Target connection summary:

Target environments:

Target	IP address
Linux target (local connect) / zenohd	localhost
Linux target (external connection) / zenohd	10.0.30.10
Raspberry-pi target	10.0.30.50

Type of rmw	ROS application name	Node name
rmw_zenoh	talker	/talker
rmw_zenoh_pico	listener	/listener_node

use token
/chatter

Build Linux target

# cd uros_ws
source install/local_setup.bash
ros2 run micro_ros_setup create_firmware_ws.sh zenoh host
source install/local_setup.bash
ros2 run micro_ros_setup build_firmware.sh
file ./install/rmw_zenoh_pico/lib/rmw_zenoh_demos_rclc/listener/listener
# ./install/rmw_zenoh_pico/lib/rmw_zenoh_demos_rclc/listener/listener: ELF 64-bit LSB pie executable, x86-64, version 1 (SYSV), dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2, BuildID[sha1]=2c0119cf4620f58fafa736594d3bba038e56e13a, for GNU/Linux 3.2.0, not stripped

Build Raspberry Pi target

# cd uros_ws
source install/local_setup.bash
ros2 run micro_ros_setup create_firmware_ws.sh zenoh raspbian bookworm_v12
ros2 run micro_ros_setup configure_firmware.sh listener -t unicast -i <zenohd ip> -p <zenohd port>
source install/local_setup.bash
ros2 run micro_ros_setup build_firmware.sh
file ./firmware/bin/listener
# ./firmware/bin/listener: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux-armhf.so.3, for GNU/Linux 3.2.0, with debug_info, not stripped

The zenoh_pico in rmw_zenoh_pico is executing in client mode, and the connection has to be set to zenoh/zenohd.
The Raspberry Pi OS configuration for rmw_zenoh_pico has to set their IP address and port when executing configure_firmware.

Name	Mean	Example
zenoh ip	address connect zenoh/zenohd	-i 10.0.30.10
zenoh port	port connect zenoh	-p 7447

The Raspberry Pi OS configuration on this patch on the rmw_zeno_pico package used Raspberry Pi 1 and Raspberry Pi Pico toolchains (ELF32bit/EABI5).
If you want to use another Raspberry Pi target, which is a 64-bit environment, you have to change part of the toolchain URL in create.sh manually.

$ cat micro_ros_setup/config/zenoh/raspbian/create.sh 
#! /bin/bash

pushd $FW_TARGETDIR/$DEV_WS_DIR >/dev/null
    if [ $OPTION == "bookworm_v12" ]; then
        TOOLCHAIN_URL="https://..."              /* Change URL of cross-compile toolchain */
                                                 /* For match target Raspberry Pi OS environment */
                    :
                    :
    else
        echo "Platform not supported."
        exit 1
    fi
       :

See: https://sourceforge.net/projects/raspberry-pi-cross-compilers/files/Raspberry%20Pi%20GCC%20Cross-Compiler%20Toolchains/

Build RTOS target

T.D.B

Running the micro-ROS app

For sample details, see Setup and Test in the rmw_zenoh repository.

Running common service on Linux

The following commands are executed on another terminal, respectively.

1. Start the Zenoh router on rmw_zenoh

   # cd <directory in install rmw_zenoh> 
   source install/setup.bash
   export ZENOH_CONFIG_OVERRIDE='transport/link/tx/lease=10000'
   ros2 run rmw_zenoh_cpp rmw_zenohd

2. Run the talker on rmw_zenoh

   # cd <directory in install rmw_zenoh> 
   sudo apt-get install ros-$ROS_DISTRO-demo-nodes-py
   sudo apt-get install ros-$ROS_DISTRO-demo-nodes-cpp
   source /opt/ros/$ROS_DISTRO/local_setup.bash
   source install/setup.bash
   export RMW_IMPLEMENTATION=rmw_zenoh_cpp
   ros2 run demo_nodes_cpp talker

Running Linux target

1. Run the listener on rmw_zenoh_pico in microros

   # cd uros_ws
   source install/local_setup.bash
   export RMW_IMPLEMENTATION=rmw_zenoh_pico
   ros2 run rmw_zenoh_demos_rclc listener

Running Raspberry Pi target (on Raspberry Pi H/W)

1. Copy the micro-ROS application to Raspberry Pi

   # cd uros_ws
   scp firmware/bin/listener <target raspberry pi>:~/.

2. Listen application

   ssh <target raspberry pi>
   ./listener

Running RTOS target

T.D.B

Name of node/topic on ROS 2

The ROS 2 CLI command starts a new ROS 2 daemon task, and the daemon caches data.
If the ROS 2 daemon is already running, it must be stopped before executing ROS 2 CLI commands.

1. Get the node name if the listener node is executed

   ros2 daemon stop
   # The daemon has been stopped
   source install/setup.bash
   export RMW_IMPLEMENTATION=rmw_zenoh_cpp
   ros2 node list
   # [INFO] [1728446929.812251213] [rmw_zenoh_cpp]: Successfully connected to a Zenoh router with id aebe653d2ff57b4ba1ef7b43c59b547.
   # [WARN] [1728446931.353213030] [rmw_zenoh_cpp]: Received liveliness token to remove node /_ros2cli_361692 from the graph before all pub/subs/clients/services for this node have been removed. Removing all entities first...
   # /listener_node

2. Get the topic name if the listener node is executed

   ros2 daemon stop
   # The daemon has been stopped
   source install/setup.bash
   export RMW_IMPLEMENTATION=rmw_zenoh_cpp
   ros2 topic list
   # [INFO] [1728446957.797293950] [rmw_zenoh_cpp]: Successfully connected to a Zenoh router with id aebe653d2ff57b4ba1ef7b43c59b547.
   # [WARN] [1728446959.338124246] [rmw_zenoh_cpp]: Received liveliness token to remove node /_ros2cli_361735 from the graph before all pub/subs/clients/services for this node have been removed. Removing all entities first...
   # /parameter_events
   # /rosout
   # /chatter

The new ROS 2 daemon started by ROS 2 CLI exits when this command exits.
At this time, the rmw_zenoh middleware outputs a few messages. This message will change depending on your build/execute environment.

Purpose of the Project

This software is not ready for production use. It has neither been developed nor tested for a specific use case.
However, the license conditions of the applicable open-source licenses allow you to adapt the software to your needs. Before using it in a safety-relevant setting, ensure the software fulfills your requirements and adjusts them according to applicable safety standards, e.g., ISO 26262.

License

This repository is open-sourced under the Apache-2.0 license. See the LICENSE file for details.

For a list of other open-source components included in this repository, see the file 3rd-party-licenses.txt.

Known Issues/Limitations

1. The rmw_zenoh_pico using malloc() system futures when there is a new memory region.
   The XRCE-DDS implementation has simple memory futures in its layer.
   This memory future is designed to run ROS 2 communication for small resource systems.
   The rmw_zenoh layer can execute on a Linux system with a memory subsystem for a large system with Zenoh.
   The zenoh-pico is designed for small resource systems.
   However, the zenoh-pico memory is compiling into its system, and it is not designed to use the same data area with an upside layer, which is rmw_zenoh_pico.
   If you use rmw_zeno_pico on a small resource system with any RTOS, you might need to add some customizations for zenoh-pico and rmw_zenoh_pico.

2. This implementation of rmw_zenoh_pico does not support graph caching.
   The graph cache is a key component in maintaining the overall structure of ROS2.
   However, we feel that it will be used less in micro ros for microcontroller targets.
   Moreover, rmw_zenoh_pico needs to dynamically allocate memory to hold the graph-cache.
   On the other hand, the graph-cache is closely related to the Qos feature of ROS2.
   Since zenoh is based on TCP/IP, the OS basically guarantees packet reliability, so there are few problems.
   However, this can be an issue when communicating directly with ROS using the zenoh plugin, etc.
   We feel it is necessary to add limited OoS functionality to the link layer used by the microcontroller.
   The ROS QoS implementation works in conjunction with ROS event processing.
   The current implementation of rmw_zenoh_pico only implements the event framework (compile only).