Dial in your tracking.

Set the trackers down

Place every tracker you want to calibrate on a solid surface and leave them untouched. They do not need to be perfectly level, only perfectly still. Best done after 15 to 20 minutes of wear, when the trackers are warmed up.

Run it on the whole set

One relay command calibrates every connected tracker at once:

send all calibrate

For a single tracker, double-press its button instead (no console needed), use send <id> calibrate, or run calibrate over USB. Every route runs the same calibration.

Hold off for a few seconds

Each tracker takes its reading and saves it; it only takes a few seconds. Keep the surface undisturbed until then, and if a tracker gets nudged partway through, just run it again.

Start the calibration

With the tracker connected to your serial terminal, run the command for the axis you want to calibrate. The example below calibrates the Y axis using the default of 2 full revolutions:

sens auto y
Gyro sensitivity auto-calibration started on Y axis (2 rev).
  1. Hold the tracker still until the LED flashes.
  2. While flashing, spin it 2 full turns about the Y axis, then stop.

You can ask for more turns, for example sens auto y 4; more turns gives a more accurate result.

Hold still

Place the tracker down and keep it completely still. The tracker first takes a reading at rest; the LED starting to flash is your signal that this part is done and it is ready for the spin.

Spin the stated number of full turns, then stop

While the LED is flashing, rotate the tracker the exact number of full turns about the chosen axis, finishing exactly the way it started, then hold it still. Smooth and steady is better than fast; what matters is that the turns are complete and flat, with no tilting partway.

Check the result

The tracker checks the run before saving anything. If something was off (it moved at the start, the spin wobbled, or the turns were not complete) it rejects the run, saves nothing, and tells you why; just run it again. On success the new sensitivity is saved automatically. You can review it any time with info, and repeat the process for the other axes with sens auto x and sens auto z.

Start the calibration

Through the receiver, start it on one tracker (get ids from list) or the whole set at once. With no cable attached, every side of the case is free to rest on:

send 0 6-side
send all 6-side
Starting Multi-Position Calibration (Target: 18 poses)
Please rotate device to random orientations and hold still.

Over USB instead, the command is just 6-side, and you can unplug the cable right after issuing it; the calibration runs on the tracker itself.

Place, hold, repeat

Set the tracker down in any position and hold it perfectly still. The LED goes solid while it captures, gives a short blink when the position is saved, then settles into a slow blink while it waits for the next one; move it to a clearly different position and repeat. The six flat faces, then corners and tilted leans against an object, all count. The tracker does not need to be level, only motionless.

Finish (or stop early)

After the 18th position the tracker works out its correction, saves it, and gives a completion blink. If you stop giving it new positions, it times out after 30 seconds; as long as it got at least 6, it saves a partial result from what it has. Fewer than 6 and nothing is saved. If you started several trackers with send all, work round-robin so each gets a fresh position inside its own 30 second window: comfortable with two or three at once, a juggle with a full set, so batch accordingly. The full 18 gives the best result, so it is worth seeing it through.

Turn it on for the whole set

Two switches: tcal auto on tells the trackers to start learning, and tcal on turns the correction on. This is the relay at its best; two commands through the receiver and the whole set is learning:

send all tcal auto on
send all tcal on

Let it learn warm and cool

A tracker learns whenever it sits still, noting the temperature each time, and the more temperatures it has seen, the better it corrects. Cool (just switched on at room temperature) through warm (after a long session on the body) is the range that matters, and letting a tracker rest for a minute at power-on, and again right after sessions, covers it naturally over a few days of normal use; no fridges or hairdryers required.

Check the quality

Checking progress is the one part that needs a cable: plug a tracker in over USB and run tcal status. It shows how much it has learned, the temperatures covered, and a plain verdict:

tcal status
Temperature Calibration Status (MLS):
  - Points collected: 23 / 70
  - Calibrated temp range: 19.40C to 37.85C
  - Calibration quality: GOOD - Suitable for boot calibration (MLS)

Once it says GOOD, you are done; the tracker keeps improving on its own from there.