Flash System Image

The VOXL System Image includes the root file system and bootloader partitions. For details on the system image changes, see the VOXL System Image ChangeLog. These instructions assume the user has set up ADB.

ModalAI Top Tip: It is only necessary to update the system image to add new hardware driver support. Updating the System Image should not be necessary unless you are aware of hardware support additions that you need. You can likely skip this step and proceed to install factory and software bundles.


1. Download and Unpack Image

Download latest image from https://developer.modalai.com/asset. Then unpack the image (where M-m-b describes the version):

me@mylaptop:~$ tar -xvf modalai-M-m-b.tar.gz
me@mylaptop:~$ cd modalai-M-m-b

2. Power up and connect VOXL

Ensure the VOXL is powered from the DC power supply and connect the VOXL to the host system via micro USB cable. Then ensure the device is visible with adb devices.

me@mylaptop:~$ adb devices
List of devices attached
da2ec579	device

If the device fails to connect using ADB, please check the Troubleshooting section below

3. Start the Flashing Process

Run the python flashing script inside the folder you just unpacked to begin the process.

me@mylaptop:~/modalai-M-m-b$ sudo python flash_build_apps.py

This process will take approximately 3 minutes. When the process is complete VOXL will reboot automatically.

With System Image 1.11 and newer, the version will display when the process finishes:

Modalai M-m-b

BUIDLER: someone



The next step is to install the VOXL Software Bundles

4. Check the Version Manually (Optional)

Now that you’ve just wiped VOXL’s file system, the voxl-version utility will not yet be installed. However, we can still check the version of the system image with the version program.

me@mylaptop:~$ adb shell version
ModalAI 1.10.0

BUILDER: ekatzfey

BUILD_TIME: 2019-11-11_23:05

After you install the voxl-software-bundle in the next step you will be able to use the much more verbose voxl-version utility.

me@mylaptop:~$ adb shell voxl-version
system-image:    ModalAI 1.10.0 BUILDER: ekatzfey BUILD_TIME: 2019-11-11_23:05
kernel:          #1 SMP PREEMPT Mon Nov 11 22:28:13 UTC 2019 3.18.71-perf
factory-bundle:  0.0.2
sw-bundle:       0.0.2
architecture:    aarch64
processor:       apq8096
os:              GNU/Linux
Package: voxl-utils
Version: 0.4.3
Status: install user installed
Architecture: aarch64
Installed-Time: 14



If you think VOXL is bricked, you can usually Force VOXL into Fastboot Mode.

If problems continue, please feel free to reach out and contact us.

Next Steps

Next, we can install factory and software bundles.