Skip to main content
This guide walks you through everything you need to go from an unboxed ANX dev module to a running firmware example in under 15 minutes. You’ll connect your hardware, install the ANX CLI, flash the latest OS firmware, and run the classic blinky application to confirm your setup is working end to end.
1

Connect Your Hardware

Plug your ANX dev module into your workstation using a USB-C cable. The module draws power from USB and enumerates as a serial device — no drivers are required on most operating systems.Once connected, confirm the device appears in your system:On Linux, if the device does not appear, add your user to the dialout group and reconnect:
On Windows, open Device Manager → Ports (COM & LPT) to find the assigned COM port. On macOS, run ls /dev/cu.* in Terminal to list available serial devices.
Use a data-capable USB-C cable. Charge-only cables will power the module but will not expose the serial interface to your workstation.
2

Install the ANX CLI

The ANX CLI is the primary tool for flashing firmware, running examples, and managing your device. Install it using the package manager or install script for your OS:
After installation completes, open a new terminal window (or reload your shell) so that the anx binary is available on your PATH.
3

Verify the Installation

Confirm the CLI installed correctly by checking its version:
You should see output similar to:
If the command is not found, ensure that ~/.anx/bin (Linux/macOS) or %LOCALAPPDATA%\ANXLabs\bin (Windows) is present in your PATH environment variable, then open a fresh terminal and try again.
4

Flash the Firmware

With the ANX dev module connected and the CLI verified, flash the latest stable ANX OS Firmware to your device:
The CLI detects your connected device automatically, downloads the latest firmware image, and writes it to the module’s flash memory. You’ll see a progress indicator followed by a confirmation message:
The module reboots automatically once flashing completes. The status LED will pulse blue to indicate the firmware is running and ready.
Do not disconnect the USB cable while flashing is in progress. Interrupting the write can corrupt the firmware and require a manual recovery using the BOOT button on the module.
5

Run the Blinky Example

Run the built-in blinky example to verify that the firmware, CLI, and module are communicating correctly:
The CLI uploads and runs the example on the module. You should see the onboard LED begin blinking at 1 Hz, and your terminal will confirm the application is running:
Press Ctrl+C to stop the example. Your module is now fully set up and ready for development.
Now that your hardware is running, read the Hardware Overview to understand the module’s processor, memory, I/O interfaces, and power capabilities before diving into more complex examples.

Next Steps

With your module flashed and your first example running, explore the rest of the ANX Labs platform:

Dev Module

Full hardware specs, pinout reference, and electrical characteristics.

OS Firmware

Firmware configuration, API reference, and over-the-air update guides.

Example Apps

Ready-to-run applications for sensors, BLE, Wi-Fi, and power management.