ROS2 / iRobot Create 3 Support

This application note explains how to setup, build and install an image with Ubuntu Desktop 22.04 distribution which has been adapted for usage of NAVQ Plus as a compute board for iRobot Create 3.

1. Download

Starting from the release 1.0.5, the NAVQ Plus release page contains download links for pre-built images with ROS2 / iRobot Create 3 support.

Proceed to page https://staging.voxelbotics.com/releases/ to download the latest release image.

1.1. What is in the Images

Release images contain Ubuntu Desktop 22.04 distribution along with pre-installed ROS2 packages, and pre-configured for the attachment via USB with the iRobot Create 3 adapter board. Once programmed, the image is ready to use out of the box without necessity for additional configuration.

2. How to Install Image

The <release_ver>-ros2.wic.zst image is for installation either on the SD card or on the integrated EMMC. An SD card with minimum 16GB size is required for the installation.

  1. Refer to Flashing SD Card with Linux Image from Linux Host for instructions on how to flash SD card with an image.

  2. Refer to Installing Linux to the EMMC Using USB Serial Downloader for the instructions on how to flash the integrated EMMC.

3. Hardware Setup

  1. Follow the instructions described in details inHookup Guide - Create® 3 Docs to connect NAVQ Plus to iRobot Create 3.

  2. Follow the instructions described in details in Setting up Wi-Fi to configure WLAN.

4. Update iRobot Create Firmware

The NAVQ Plus images run Humble Hawksbill release of ROS2 and require the same ROS2 release on the iRobot Create3 adapter board.

  1. Proceed to H.1.1 - Create® 3 Docs to download the H.1.1 release firmware image.

  2. Establish ssh connection with NAVQ Plus:

    ssh <NAVQPlus IP> -L 9080:192.168.186.2:80
  3. Open web browser with URL http://127.0.0.1:9080.

  4. Follow the instructions described in Update - Create® 3 Docs to update the iRobot Create 3.

5. Test ROS2 APIs

Follow the description in ROS 2 Interface - Create® 3 Docs to check ROS2 APIs exposed by iRobot Create 3.

6. Restarting iRobot Create 3 Application From NAVQ Plus

Use the following command in the NAVQ Plus console to restart iRobot Create 3 services without reboot:

curl -X POST http://192.168.186.2/api/restart-app

7. Rebooting iRobot Create 3 From NAVQ Plus

Use the following command in the NAVQ Plus console to reboot iRobot Create 3. The reboot doesn’t affect the NAVQ Plus itself.

curl -X POST http://192.168.186.2/api/reboot