Quickstart

Bring up a calibrated two-tag distance stream using the browser console.

Requirements

Two tags, two USB-C data cables, Chrome or Edge on desktop, and a tape or laser distance meter.

1. Flash the roles

Open the firmware console.
Unplug Tag A. Hold BOOT0, reconnect USB, and select Flash Initiator.
Unplug Tag A, release BOOT0, and reconnect normally.
Repeat with Tag B and Flash Responder.

For automated DFU flashing, use flash.sh.

2. Connect

Select Connect serial for each slot and choose a different USB serial device.
Confirm Tag A reports mode I and Tag B reports mode R.
Verify live D records appear.

3. Calibrate once

Hold both tags still at an accurately measured distance with clear line of sight and the same antenna orientation.
Enter the true distance in millimeters under Pair Calibration.
Select responder slot B, collect at least 100 samples, and start calibration.

Do not recalibrate at each test distance.

Keep the same responder offset for the full distance sweep. Recalibrating would hide distance-dependent error.

4. Run a static test

Move the pair to a new known separation without changing orientation.
Enter distance and duration under Static Test.
Start the test, keep the tags still, then download the CSV.

5. Automate the workflow

python3 list_ports.py
python3 info.py /dev/tty.usbmodem1101
python3 calibrate.py /dev/tty.usbmodem1201 --true-mm 1000
python3 static_test.py /dev/tty.usbmodem1201 --true-mm 5000 --seconds 60

← Overview Host scripts →