Skip to content

ZeroTrace AirLeak

Installation

Flash the ZeroTrace AirLeak firmware onto your ESP32-S3 board from the mobile app and pair over Bluetooth LE.

Installation

Getting AirLeak running is a two-part job you do once: flash the firmware onto your board, then pair with it over Bluetooth LE. After that, everything is wireless.

Before you start

You need a compatible ESP32-S3 board (see Hardware), a USB-C cable to connect it for the flash, and the ZeroTrace app installed on your phone. Have your AirLeak license key or QR code ready to activate the licensed features.

  1. Install the ZeroTrace app

    Install the ZeroTrace app on your phone and open it. This is the only tool you need, flashing and control both happen here.

  2. Connect the board

    Plug your ESP32-S3 board into your phone with a USB-C cable. On phones without a spare port, a standard USB-C adapter works. The app detects the board and offers to flash AirLeak onto it.

  3. Flash the AirLeak firmware

    Choose to install AirLeak and let the app write the firmware to the board. This takes a couple of minutes and only needs doing once, later firmware updates arrive over Bluetooth LE and do not need the cable again. When the flash finishes, the board restarts running AirLeak.

  4. Pair over Bluetooth LE

    Unplug the cable if you like, AirLeak now runs on its own. In the app, scan for nearby ZeroTrace devices and select your AirLeak. It connects over Bluetooth LE. The status light on the board (if present) confirms it is alive and advertising.

  5. Activate your license

    Enter your license key or scan its QR code in the app to unlock the licensed features. An unlicensed board still powers on and pairs, activation simply turns on the full capability set. See App integration.

  6. Start scanning

    AirLeak begins listening as soon as it is running. Open the live view and watch the devices around you appear. From here, follow-me alerts run in the background whenever AirLeak is powered.

Updating later

Once AirLeak is installed, firmware updates are delivered wirelessly from the app over Bluetooth LE, you do not reconnect the cable for updates. Keep the board powered and near your phone while an update runs.

Command Palette

Search for a command to run...