ModalAI Technical Docs
Search

Unbricking Procedure for VOXL and VOXL Flight

Table of contents

  1. Overview
    1. Force VOXL into fastboot
    2. Reflashing System Image after Forcing the VOXL into Fastboot
  2. Prevent Flash Corruption (i.e., Bricking)

Overview

The System Image flashing process requires the device to be in fastboot mode. The typical process uses adb to put the VOXL into fastboot mode over USB. If the device is bricked and one cannot get the VOXL into fastboot using USB, then you’d follow this process before running the install.sh script as described in the Flash System Image process.

The following VOXL add-on boards support the force fastboot mode switch:

Force VOXL into fastboot

To force the VOXL to boot into fastboot mode:

  • Power off the VOXL
  • Detach VOXL USB cable (to ensure USB is not supplying any power VOXL)
  • Attach the USB Expander and Debug Add-On board
  • Ensure the FASTBOOT labeled switch is set to on
  • Ensure the EMERG BOOT labeled switch is set to off
  • Power on the VOXL
  • Reattach VOXL USB cable
  • After VOXL boots up (about 5 seconds), set the FASTBOOT back to off

You can verify you are in FASTBOOT with the following command:

sudo fastboot devices

You should see an output like:

a0259b4a    fastboot

Reflashing System Image after Forcing the VOXL into Fastboot

To reflash the System Image, run the following while in Fastboot mode:

$ sudo ./install.sh -f

Flashing the System Image using install.sh is covered in this section.

Prevent Flash Corruption (i.e., Bricking)

To prevent flash data corruption, run poweroff before pulling power:

$ poweroff -f