Basic Tutorials

Getting Started Getting Started with an embedded board (WIP) Getting Started with simulator (WIP)

Advanced Tutorials

NuttX Getting Started Debugging a NuttX target with GDB and OpenOCD Debugging with Visual Studio Code 6LOWPAN communications between NuttX and a Raspberry Pi Getting started with ROS 2 tracing

Crazyflie Demo

This demo aims to expose a micro-ROS use case. It runs on a pair of embedded devices: a Crazyflie 2.1 drone, used as a user controller, and a Kobuki Turtlebot 2 as a mobile and controlled device.

Illustration of the Crazyflie - DDS interaction

Both of them rely on micro-ROS publication and subscription mechanisms and use an underlying Micro XRCE-DSS client.

This demo also includes conventional ROS 2 tooling as a demonstration of integration with ROS 2. We use Gazebo, RVIZ and simple ROS 2 nodes (aka external nodes) acting as data converters.

This demo was developed taking as base the Kobuki demo.

Setup

The proposed demo is composed of different kind of messages and topics.

The Crazyflie 2.1 drone relies on ST STM32F405 MCU running FreeRTOS. Using the RTOS capabilities and the integrated radio communication device, the drone can run a node that publishes:

its own relative position as a 3D vector (X, Y and Z) using a geometry_msg/Point32 message type on /drone/odometry topic.
its own attitude as a 3D vector (pitch, roll and yaw) using a geometry_msg/Point32 message type on /drone/attitude topic.

The Kobuki Turtlebot 2 robot is controlled using a UART protocol through a custom DB25 connector. The micro-ROS node runs on an Olimex STM32-E407 board attached to that UART port. This hardware features a ST STM32F407 MCU running Nuttx RTOS. In the same way, this node can communicate with the robot (UART) and with the ROS2 world (integrated Ethernet). Its used topics are:

a subscription on /cmd_vel topic (geometry_msg/Twist message type) to receive the controlling angular and linear velocity.
a publication on /robot_pose topic (geometry_msg/Vector3 message type) which includes X position, Y position and robot yaw.

The external ROS 2 nodes are rclpy tools with some different functionalities:

attitude_to_vel.py
- Converts Crazyflie /drone/attitude to Kobuki Turtlebot 2 /cmd_vel so that drone pitch is mapped to robot linear velocity and drone roll to angular valocity.
- Converts Crazyflie publications on /drone/attitude and /drone/attitude topics to tf2_msgs/TFMessage messages (required by RVIZ visualizer)
odom_to_tf.py
- Converts Kobuki Turtlebot 2 publications on /robot_pose topic to tf2_msgs/TFMessage messages (required by RVIZ visualizer).

The following image shows the described setup.

Kobuki_drone_demo

Required Hardware

This setup uses the following hardware:

Item
Kobuki Turtlebot 2	Link
Olimex STM32-E407	Link
Olimex ARM-USB-TINY-H	Link
Crazyflie 2.1	Link
Flow Desk v2	Link
Debug adapter	Link
Crazyradio PA 2.4 GHz USB dongle	Link
Additional battery + charger (optional)	Link

Installation

Install external ROS 2 nodes

Install Micro XCRE-DDS. Recommended procedure:

git clone https://github.com/eProsima/Micro-XRCE-DDS.git -b v1.1.0
cd Micro-XRCE-DDS
mkdir build && cd build
cmake ..
make
sudo make install

Create a workspace folder for this demo:

mkdir -p crazyflie_demo/src
cd crazyflie_demo

Clone this repo:

git clone --single-branch --branch crazyflie_demo https://github.com/micro-ROS/micro-ROS_kobuki_demo src

Install Gazebo. Recommended procedure:

curl -sSL http://get.gazebosim.org | sh

Install gazebo_ros_pkgs (ROS 2). Recommended procedure:

source /opt/ros/dashing/setup.bash
wget https://bitbucket.org/api/2.0/snippets/chapulina/geRKyA/f02dcd15c2c3b83b2d6aac00afe281162800da74/files/ros2.yaml
vcs import src < ros2.yaml
rosdep update && rosdep install --from-paths src --ignore-src -r -y
rm ros2.yaml

Build the project:

source /opt/ros/dashing/setup.bash
rosdep update && rosdep install --from-paths src --ignore-src -r -y
colcon build --symlink-install

Build and flash Crazyflie 2.1 firmware

Install the toolchain:

sudo add-apt-repository ppa:team-gcc-arm-embedded/ppa
sudo apt-get update
sudo apt install gcc-arm-embedded dfu-util

Download and build the Crazyflie 2.1 firmware repository:

mkdir crazyflie_firmware
git clone https://github.com/eProsima/crazyflie-firmware -b crazyflie_demo
cd crazyflie_firmware
git submodule init
git submodule update
make PLATFORM=cf2

Unplug the Crazyflie 2.1 battery

Push the reset button while connecting the USB power supply.

The top-left blue LED blinks, first slowly and after 4 seconds sightly faster, now it is in DFU programming mode. Check it with lsusb:

Bus 001 Device 051: ID 0483:df11 STMicroelectronics STM Device in DFU Mode

Flash the device:

sudo dfu-util -d 0483:df11 -a 0 -s 0x08000000 -D cf2.bin

Unplug and plug the Crazyflie 2.1 power to exit DFU mode.

Install Crazyflie Client + Bridge

Install dependencies:

sudo apt-get install libusb-1.0-0-dev
sudo apt-get install python3 python3-pip python3-pyqt5 python3-pyqt5.qtsvg

Fix permissions for the Crazyradio PA 2.4 GHz USB dongle (restart required for apply changes):

sudo groupadd plugdev
sudo usermod -a -G plugdev $USER
sudo echo SUBSYSTEM==\"usb\", ATTRS{idVendor}==\"1915\", ATTRS{idProduct}==\"7777\", \
MODE=\"0664\", GROUP=\"plugdev\" > /etc/udev/rules.d/99-crazyradio.rules
sudo echo SUBSYSTEM==\"usb\", ATTRS{idVendor}==\"0483\", ATTRS{idProduct}==\"5740\", \
MODE=\"0664\", GROUP=\"plugdev\" > /etc/udev/rules.d/99-crazyflie.rules

Clone the repo dependencies:

git clone -b Micro-XRCE-DDS_Bridge https://github.com/eProsima/crazyflie-clients-python

Build and flash Kobuki Turtlebot 2 firmware

Create a workspace for building micro-ROS:

source /opt/ros/crystal/setup.bash
sudo apt install python-rosdep curl flex ed gperf openocd automake ed bison libncurses5-dev gcc-arm-none-eabi clang clang-tidy usbutils
mkdir -p kobuki-firmware/src
cd kobuki-firmware
git clone --recursive -b crazyflie_demo https://github.com/micro-ROS/micro-ros-build.git src/micro-ros-build
colcon build --packages-select micro_ros_setup
source install/local_setup.bash

Build micro-ROS Agent:

ros2 run micro_ros_setup create_agent_ws.sh
colcon build
source install/local_setup.sh

Install tools:

git clone https://bitbucket.org/nuttx/tools.git ~/tools
pushd ~/tools/kconfig-frontends >/dev/null
./configure --enable-mconf --disable-nconf --disable-gconf --disable-qconf 
LD_RUN_PATH=/usr/local/lib && make && make install && ldconfig
popd >/dev/null

Build Olimex STM32-E407 firmware:

ros2 run micro_ros_setup create_firmware_ws.sh
cd firmware/NuttX
tools/configure.sh configs/olimex-stm32-e407/uros
cd ../..

#Put here your agent IP and port
find ./firmware/mcu_ws/ -name rmw_microxrcedds.config -exec sed -i "s/CONFIG_IP=127.0.0.1/CONFIG_IP=192.168.8.10/g" {} \;
find ./firmware/mcu_ws/ -name rmw_microxrcedds.config -exec sed -i "s/CONFIG_PORT=8888/CONFIG_PORT=9999/g" {} \;

ros2 run micro_ros_setup build_firmware.sh

Connect Olimex ARM-USB-TINY-H JTAG debugger to Olimex STM32-E407 and flash the board:

cd firmware/NuttX
scripts/flash.sh olimex-stm32-e407

Usage

After installation, the following packages should be present in your system:

.
+-- Micro-XRCE-DDS # used for installing Micro-XRCE-DDS
+-- crazyflie_demo 
+-- crazyflie-firmware # used for building and flashing Crazyflie 2.1 firmware
+-- kobuki-firmware # used for building and flashing Kobuki Turtlebot 2 firmware
+-- crazyflie-clients-python

Make sure that all ROS 2 or micro-ROS nodes created along with the following steps can reach each other using its network interfaces.

Run Kobuki Turtlebot 2 Node

TODO: Explain data and power connections between Kobuki Turtlebot 2, Olimex STM32-E407 and MiniRouter.

Run the micro-ROS Agent:

cd kobuki-firmware
source /opt/ros/crystal/setup.bash && source install/local_setup.bash
ros2 run micro_ros_agent micro_ros_agent udp 9999

micro-ROS Agent should receive an incoming client connection and /robot_pose topic should be published. Check it with ros2 topic echo /robot_pose

Run Crazyflie 2.1 Node

Connect Crazyradio PA 2.4 GHz USB dongle and turn on Crazyflie 2.1 drone.

Run the Crazyflie Client + Bridge:

cd crazyflie-clients-python
python3 bin/cfclient

This command should open the Crazyflie Client and print a serial device path in the terminal (something like /dev/pts/0).

Run (in another prompt) a Micro XRCE-DDS Agent:

MicroXRCEAgent serial --dev [serial device]

Micro XRCE-DDS Agent should receive an incoming client connection and /drone/attitude and /drone/position topics should be published. Check it with ros2 topic echo /drone/attitude and ros2 topic echo /drone/position

Run external ROS 2 nodes

Run commands:

cd crazyflie_demo
source /opt/ros/crystal/setup.bash && source install/local_setup.bash
ros2 run micro-ros_crazyflie_demo_remote attitude_to_vel

Topic /cmd_vel should be published, and the Kobuki Turtlebot 2 should start moving. Check it with ros2 topic echo /cmd_vel

Run RVIZ visualizers

Run complete visualizer:

cd crazyflie_demo
source /opt/ros/crystal/setup.bash && source install/local_setup.bash
ros2 launch micro-ros_crazyflie_demo_remote launch_drone_position.launch.py

RVIZ windows should be open, and a Crazyflie 2.1 drone model should represent the drone attitude and position along with a historic path.

Run attitude visualizer:

cd crazyflie_demo
source /opt/ros/crystal/setup.bash && source install/local_setup.bash
ros2 launch micro-ros_crazyflie_demo_remote launch_drone_attitude.launch.py

RVIZ windows should be open and a Crazyflie 2.1 drone model should represent only the drone attitude.

Improve this page