Overview
This application note describes a process of iRobot Create3 hardware/software setup which is specific to NavQPlus board programmed with the NavQPlus BSP release image.
The goal of the setup routine is to prepare a iRobot Create3 unit for successful inter-operation with the NavQPlus as its compute board, specifically for Lidar-based SLAM navigation.
Phase 1. NavQPlus Software Setup
Though we put the underlying steps as the first phase, this is not a necessary order. The logic behind putting these steps into the first phase is solely a convenience which depends on how you would get your iRobot Create3 and NavQPlus - separately or pre-packaged together. If they go separately, then it is indeed more convenient to do these steps first. Otherwise, Phase 2 steps have been already done, and your are remained just to update the NavQPlus BSP.
Step1. Program the VoxelBotics NavQPlus BSP Release
Unless you have a pre-programmed NavQPlus board with the most recent BSP release, you should or even must program the board with the most recent VoxelBotics BSP release.
Browse https://staging.voxelbotics.com/releases/ page for the most recent release and download the images. Then refer to either Installing Linux to the EMMC using USB Serial Downloader or Flashing SD Card with Linux Image from Linux Host to program either the internal EMMC or an external SD card with the BSP.
We recommend programming the EMMC as it allows using the external SD card for maintaining persistent data across future BSP updates.
Also, pay attention to the Verifying step for either of the installation variants as it contains the boot switch configuration step required for correct selection of the boot device on the NavQPlus.
Step 2. Setup NavQPlus Wi-Fi
Proceed with Setting up Wi-Fi application note for setting up WLAN access to the board. Check WLAN access to the board with logging in using SSH to the board’s IP address. The NavQPlus BSP contains the Ubuntu 22 distribution with “user”/”user” login credentials.
So, the SSH login command would look like:
$ ssh user@<navqplus-ip>
Phase 2. iRobot3 Create3 Hardware Setup
The steps in this phase are only required if you don’t get iRobot Create 3 packaged with pre-mounted NavQPlus.
Step 1. Set the Adapter Board to USB Mode
Set the USB/BLE toggle as shown on the following picture (the red arrow).
Step 2. Mount NavQPlus into the iRobot Create3
There is no specific mandatory way how to mount the NavQPlus in the iRobot Create cargo bay. One of the ways it can be done is pictured below.
Consider looking into https://iroboteducation.github.io/create3_docs/hw/navqplus_hookup/ for more information on the topic.
Step 3. Connect NavQPlus via USB Cable
The mandatory requirement is to connect the iRobot Create3 adapter board to the second USB-C port on the NavQPlus (one which is closer to the center).
Step 4. Mount RPLIDAR A1
Mount the RPLIDAR A1 on top of the Create3 cover as much to the center as possible.
Step 5. Connect RPLIDAR A1 to NavQPlus
RPLIDAR A1 comes with an adapter board with micro-USB connector. Use either direct USB Type-C to Micro-USB cable, or use a USB hub to connect the device to NavQPlus as depicted on the picture below. We suggest using USB 3.0 hub in order to be able to additionally connect PMD Flexx2 camera to the setup.
Phase 3. iRobot Create3 Software Setup
Put the assembled Create3 unit on the charger and wait until the boot is complete. The unit issues a sound when the booting is complete.
Step 1. Configure Wi-Fi
On your desktop PC, open a terminal application and type in the following command:
$ ssh user@<navqplus-ip> -L 8010:192.168.186.2:80
Log in to the NavQPlus console using “user”/“user” username and password.
Leave the terminal window opened, open a web browser, and type in
http://127.0.0.1:8010
in the address line.Select the Connect menu as shown on the picture below.
In the connect page select or type in the WLAN SSID and password, and the press connect button as shown below.
Upon successful connection you would see the following message.
Press the Connect menu button again. On the page you would see the IP address of the robot.
Close the terminal window and type in the Robot’s IP address in the browser address line.
If all is good, then you would end up with the same invitation page as at the address
127.0.0.1:8010
Step 2. Update Create 3 Firmware
Unless your robot is already installed with the latest firmware, you should update it.
Download the latest “Humble” firmware image (H.1.1 at the time of the writing) from this page: https://iroboteducation.github.io/create3_docs/releases/h_1_1/
On the robot’s web page click Update menu button.
On the Update page click the “Click here” link to update from the file.
Click the “Choose file” button and select the downloaded image, and then push the Upload File and Update button.
It takes about 6-7 minutes to update the Create3 firmware. The firmware update would accomplish with the same sound as at the end of booting.
Step 3. Configure Create 3 Application
On the robot web page select Application/Configuration menu button.
In the application configuration block type in ROS 2 Domain ID 1, and set
RMW_IMPLEMENTATION
tormw_cyclonedds_cpp
. Then push button save, and then click the Restart application link.The sound identical to the boot completion sound would conclude the configuration.