Command-line tool for updating firmware on devices running the Airlock bootloader.

• Python 3.8 or later — download here
  • When installing Python on Windows, check "Add Python to PATH"

Clone this repository and install:

git clone https://github.com/binhollc/airlock-tool.git
cd airlock-tool
pip install .

Verify it works:

airlock-tool --help

Connect the board to your computer using the USB port used for firmware updates (not the debug probe port).

For example, on the FRDM-MCXN947, use the J11 (HS USB) connector.

If the application firmware supports it, the device enters bootloader mode automatically when airlock-tool flash is run. Otherwise, press the RESET button twice quickly (double-tap within half a second).

If no application is installed, the board enters bootloader mode automatically when connected.

airlock-tool list --hid

Expected output:

         HID Devices
┌──────────────┬───────────┬───────────┬──────────────┐
│ Device       │ VID:PID   │ Unique ID │ Product      │
├──────────────┼───────────┼───────────┼──────────────┤
│ FRDM-MCXN947 │ cafe:4002 │ ...       │ frdm_mcxn947 │
└──────────────┴───────────┴───────────┴──────────────┘

If you see "No HID devices found", check that:

• The USB cable is in the correct port (not the debug probe)
• You did the double-tap reset
• The bootloader is installed on the board

airlock-tool flash firmware.afx

Expected output:

Found 514 blocks in firmware.afx
Connected to FRDM-MCXN947 (cafe:4002)
  Flash: 92 pages x 8192 bytes, family 0x2abc77ec
  Board: ...
Flashing ━━━━━━━━━━━━━━━━━━━━━ 100% (514/514)
Flash complete — reset into app

The board resets automatically and the new firmware starts running.

All commands accept -p <product> to target a specific device when multiple are connected:

airlock-tool flash firmware.afx -p frdm_mcxn947

See LICENSE.