Quick start guide
Step-by-step instructions on how to quickly set up your NavQPlus
Following these 8 steps, you will be able to start using the NavQPlus in no time. When needed, more information is available in the detailed instructions chapter. Also checkout the TurtleBot4 / iRobot Create3 documentation, and the other parts of this GitBook.
1. Download an Ubuntu image
Download the latest Ubuntu image for NavQPlus (in .wic file format) from GitHub:
For use with iRobot Create3 (AKA Turtlebot4)
For use with NXP MR-B3RB
2. Download the UUU tool
uuu is an NXP command line tool that runs on a PC and can commnicate directly with the MPU on the NavQPlus. To flash the eMMC memory on your NavQPlus (next step), you will also need to download the uuu tool ("Universal Update Utility"). Download the latest release from GitHub:
Make sure to download the correct application for your platform. The .exe file is a Windows executable. The file named "uuu" without extension is a x86/64 Linux binary.
3. Set the boot switches to flash mode
Before plugging in the board, find the boot switches on your NavQPlus and flip them to the "flash" mode. See the table and picture below for reference.
| Mode | Switch 1 | Switch 2 |
|---|---|---|
SD | ON | ON |
eMMC | OFF | ON |
Flash | ON | OFF |
4. Flash the eMMC memory
The NavQPlus firmware is preferably installed on eMMC memory for reliability reasons, even though it may be convenient during development to use the SD card. Especially if you are flying a drone, vibrations may cause (occassional) failure of the physical connections to an SD card.
Connect the NavQPlus to your computer using the leftmost USB-C port (USB 1). The two status LEDs should light up as shown above.
Open a command line window. Run the following command to check that the NavQPlus is recognized by UUU:
Make sure to be in the correct directory where the UUU file is located and the image file. Otherwise, you must add the path to the file.
You should see that there is a device detected. To flash your board, use the command below (adapt the filename/version to match the image file that you downloaded in step 1):
Once this process has finished, make sure that the flash process was successful by comparing the program output to the image below.
5. Set the boot switches to eMMC mode
You should now (again) change the boot switches to boot from eMMC (also see step 3).
| Mode | Switch 1 | Switch 2 |
|---|---|---|
SD | ON | ON |
eMMC | OFF | ON |
Flash | ON | OFF |
6. Log in for the first time
Power on the NavQPlus by plugging in a USB-C cable to the centermost USB-C port (USB2). Make sure to provide enough power (a >5W supply is recommended). The NavQPlus will boot, and you will be able to confirm it has fully booted by observing the LEDs on board. The three LEDs by the USB1 port should all be on, as well as two LEDs next to the CAN bus connectors.
To log into NavQPlus for the first time, you can either use the included USB to UART adapter, ethernet, or USB gadget mode.
USB to UART adapter
Connect the included USB to UART adapter to the UART2 port on the NavQPlus, and open your favorite serial console application (e.g. PuTTy for Windows users, Minicom on Linux). Open a serial console and set the baud rate to 115200. If there is no output on the screen, try to press enter to get a log-in prompt.
If the boot was successful, in the terminal it will ask for the username and then the password. The default username/password is as follows:
At this point you can start playing around already with the NavQPlus. However, it is recommended to also follow the last steps.
Ethernet
To connect to the board over ethernet, connect the included ix Industrial ethernet cable to NavQPlus, and connect the RJ45 connector to your computer, switch, or router on your local network. You can log into NavQPlus over SSH. More information on this setup is explained in the Ethernet page. The default hostname for NavQPlus is imx8mpnavq or use the IP adress from your board instead. To SSH into NavQPlus, you can run the following command:
It will also ask the password after a successful connection to your board. As mentioned above the default password is user.
USB Gadget Ethernet
The IP address of the usb0 network interface on NavQPlus is statically assigned to 192.168.186.3. If you want to use USB gadget ethernet to connect to NavQPlus, you will need to assign a static IP to your existing gadget ethernet interface on your computer.
First go to your network settings and click on the plus icon on the top right.
The network configuration is as follows:
IP Address: 192.168.186.2
Network Mask: 255.255.255.0
Once you have set up your USB-C gadget ethernet interface on your computer, you can SSH by running:
7. Expand Image (if needed/desired)
Note that this step of expanding the image is currently not used with MR-B3RB image version
The flashed images MAY need expanding to utilize all the available storage. After logging into the NavQPlus, open a terminal and run:
Expand image on the eMMC memory (if you followed the instructions above):
Expand image on the SD card (if you chose to flash the image on the SD card):
8. Change the default username and password
To change the default username and password, use the commands below.
Username (replace <new_username> with your desired username):
Password (you will be prompted to enter the current and new password):
What's Next?
Now with the NavQPlus setup complete, you can start to install other software packages and run your own code. For example, ROS2 (Robot Operating System) is commonly used as a framework for controlling robotic systems, with plenty of compatible packages being available.
Last updated
