- System Image Flash
- Software Configuration
- Full-wipe calibration
- Pre-flight setup
- First Flight
If you are having problems with your system, please ask questions on the forum before reflashing the system image.
It is recommended to use a USBC to USBA cable.
We have seen issues with USBC to USBC cables on some host machines.
WARNING: Backup any special calibration files not saved in
- Please backup the following manually prior to updating
❯ adb pull /etc/modalai .
❯ adb pull /data/misc .
It is recommended to install the entire platform release at once (System Image + voxl-suite) as to avoid version mismatches.
Download the latest VOXL2 platform release from here
- Unzip the download, in this example we’ll assume the download name was
voxl2_platform_M.m.b.tar.gzwhere M.m.b is the version.
❯ tar -xzvf voxl2_platform_M.m.b.tar.gz
- Get ready to run the script by going into the directory you just unzipped
❯ cd voxl2_platform_M.m.b
- Now, attach the VOXL 2 via USBC and ensure the unit is powered on
- Make sure that adb see’s your by running
adb devicesfrom the host computer
❯ adb devices
List of devices attached
If no devices show up: see ‘Force VOXL 2 into fastboot’ in VOXL2 System Image
- Check that the
fastbootcommand works by running
❯ fastboot devices
If command fails see
Missing ADB? below
- Run the following:
Install the Android Debug Bridge (ADB):
me@mylaptop:~$ sudo apt install android-tools-adb android-tools-fastboot
Once the flash has started, you will be prompted to answer a couple questions. It is recommended to preserve userdata partitions as opposed to conducting a full wipe in which you would have to recalibrate the cameras and sensors.
Would you like to preserve userdata partitions or conduct a full wipe?
3) Cancel and Exit
[INFO] Found all required files
If full wipe is conducted view
Full-wipe calibration below.
VOXL Boards that were shipped as part of a kit (M500, Seeker, VOXL CAM, etc) were configured at the factory with kit-specific MPA configuration starting around June 2021 with the introduction of MPA. In these cases, the kit part number is saved to
/data/modalai/factory_mode.txt and can be used to put your VOXL MPA services back to their kit-specific factory defaults by running:
Note this file will be wiped along with factory calibration files if you elect to wipe your /data/ partition while flashing a system image (which is not a recommended procedure).
If you conduct a full wipe, all data partitions will be erased, and you will have to calibrate all sensors and cameras and re-configure all softwares.
Sentinel flight sensors are delivered pre-calibrated from the factory. If conducting, full wipe, you will need to re-calibrate by following the px4 sensor calibration procedure.
To calibrate cameras, follow the camera calibration guide.
The following video shows how to connect using a development kit:
Then follow the pre-flight setup guide to connect to RC Radio Setup and calibrate radio.
Ensure QGC IP address is the correct one.
cat /etc/modalai/voxl-vision-px4.conf | grep qgc_ip
The IP address in the
qgc_ip field should match the one of your computer. If it doesn’t match, you can use
vi to modify the file and enter the correct IP address
Follow First Flight guide here