Skip to main content
The ANX CLI handles the entire firmware flashing workflow over USB: it downloads the selected firmware image, puts your device into a known flash state, writes the image to the module’s flash partitions, and runs an automatic checksum verification pass before declaring success. You do not need to manually manage binary images or use a separate flashing tool — the anx flash command covers every step.
Never disconnect the USB cable while a flash operation is in progress. Interrupting the write can corrupt the firmware partition and leave your device in an unbootable state. If that happens, follow the recovery mode steps below.

​
Prerequisites

Before flashing, confirm the following:
  • ANX CLI installed — run anx --version to verify. If the command is not found, follow the Quick Start guide to install the CLI.
  • Module connected via USB — use the cable that shipped with your module or any USB-C cable that supports data transfer (charge-only cables will not work).
  • Module in bootloader mode — the device must be in bootloader mode before the CLI can write firmware. See Step 1 below.

​
Flashing Firmware

1

Enter Bootloader Mode

Place your module into bootloader mode so the ANX CLI can access the flash partition:
  1. Hold the BOOT button on the module.
  2. While holding BOOT, press and immediately release the RESET button.
  3. Release the BOOT button.
The status LED turns solid blue, confirming the module is in bootloader mode and waiting for a flash command. If the LED does not turn blue, repeat the sequence — the timing between pressing RESET and releasing BOOT needs to be precise.
2

Flash the Latest Stable Firmware

With the module in bootloader mode, run the following command to download and flash the latest stable release:
The CLI downloads the image, writes it to flash, and verifies the result. You will see output similar to:
The module reboots automatically after a successful flash.
3

Verify the Flash

Confirm the correct firmware version is running:
The Firmware field in the output should reflect the version you just flashed:
If the firmware version does not match, re-run anx flash --latest and ensure the USB connection is stable throughout the process.

​
Flashing a Specific Version

To flash a particular firmware version instead of the latest, pass the --version flag:
This is useful when you need to pin a device to a known-good release or reproduce a specific firmware environment for debugging. The same bootloader mode requirement and automatic verification apply.

​
Listing Available Versions

To see all firmware versions available for download across all channels, run:
Sample output:
Pass --channel to filter by channel, for example anx firmware list --channel beta.

​
Recovery Mode

If your module becomes unresponsive after a failed flash — the LED does not light up, or the CLI cannot detect the device — use recovery mode to force-flash a minimal bootable image:
Recovery mode writes a stripped-down firmware image that restores basic USB communication and a working bootloader. Once the recovery image is running, you can follow the normal flashing steps above to install a full firmware version. If --recovery still fails to detect the device, try a different USB port, a different cable, or a different host machine to rule out a driver or hardware issue.
Once your device is deployed and connected to Wi-Fi, you can update firmware without a USB cable at all. See the OTA Updates guide to set up wireless firmware updates.