Wiki

Technical reference for system integrators and engineers.

Wristband Pro

Industrial-grade wristband device for personnel tracking and safety features in both indoor and outdoor environments. It supports UWB TWR, UWB TDoA and L-DCB for indoor location tracking, A-GNSS for outdoor positioning, alerting and sensor telemetry over L-MESH, UWB and BLE channels.

Wristband Pro front face with status indicators and UWB / BLE / GNSS marking Wristband Pro from behind, showing the strap buckle and rear charging contacts Wristband Pro with the magnetic charging cable attached to the rear contacts

Interfaces

InterfaceNotes
UWB TWRindoor positioning
UWB TDoAindoor positioning
Unified TDMAscheduled ranging
L-MESHrelay for alerting and sensor telemetry
A-GNSSoutdoor positioning; live or buffered
BLE GATTfleet characteristic map
GATT Data Syncbuffered GNSS and sensor records
Sensor TLVproduce — IMU, baro, alarm, battery
BLE Ext Advertisingsensor carrier 0x7C = 1
MQTTpublished by the anchor that hears the tag

Two positioning rails

UWB and GNSS are not operated simultaneously. Selection is governed by site mode (0x83); in auto the device switches on accumulated evidence:

  • A run of consecutive sync beacons indicates indoor coverage; a run of satellite epochs with sufficient satellites indicates outdoor. Single events do not trigger a switch.
  • Loss of beacons alone does not commit the GNSS rail; satellite evidence is also required.
  • A provisional switch to UWB is confirmed once ranging reaches at least two anchors.
  • Where both are available, the UWB rail is selected.

GNSS mode (0x80) selects live transmission or buffer & sync; update rate is 0x7F. See GNSS.

Wearer alarm

The alarm is carried as Sensor TLV record 0x08, with a type field distinguishing a button press from fall detection or a gas threshold.

It is reported by level, not edge: the record repeats in every frame while the alarm is raised. A cleared alarm is a zero byte.

The button

A single button carries four gestures, separated by how long it is held:

GestureActionIndication
Short pressacknowledgementgreen blink
3 s holdraise or clear the alarm
10 s holdpower on or off
3 tapsone-shot indoor / outdoor switchblue ×1 indoor, ×2 outdoor
Clearing the alarm uses the same 3-second hold that raises it. This is deliberate. A short press would put "cancel the emergency" one accidental tap away on a device worn on the wrist, where the button meets sleeves, doorframes and equipment all shift.

The gestures overlap by design, which creates one behaviour worth knowing: a 10-second hold passes through the 3-second threshold on its way. Powering the device off would therefore raise an alarm every time — so the firmware undoes the alarm when the longer gesture completes. An operator watching the backend sees no alarm from a normal power-off.

How it is reported

The tag does not publish for itself. The anchor that hears it publishes on its behalf, in the {prefix}/Locators/{LocatorID}/ tree: the anchor's identity is LocatorID and the tag's BLE MAC is TagID. See MQTT.

Power and charging

Cell

Cellhigh-voltage Li-Po
Capacity530 mAh
Nominal3.8 V
Full4.35 V
Empty3.30 V
This is a high-voltage cell — full is 4.35 V, not 4.20 V. A percentage computed against a standard 4.2 V Li-Po curve reads a full wristband as roughly 88% and never reaches 100%. The chemistry curve is per-product and is not interchangeable with the rest of the line.

Battery reporting

Battery state travels as Sensor TLV record 0x09 and reaches the server in the Battery object of an MQTT /Sensors message — millivolts and percentage together, plus flags.

Both are sent because the percentage depends on a discharge curve that is chemistry-specific and load-dependent, while the millivolts do not. A consumer that needs certainty uses the voltage; one that needs a display uses the percentage.

ReportedMeaning
percentage 0100normal reading
percentage absent, voltage presentthe voltage was implausible — a scaling or sense fault, not a flat cell
charging flags absentcharge state is not known on this device
The tag reports charging state as unknown rather than defaulting to "not charging". The two are different facts, and a device on charge that reports "not charging" is worse than one that admits it cannot tell — the first is believed, the second is investigated. See Sensor TLV for the flag encoding.

Runtime

Working life between charges is set by configuration rather than by the cell alone: sensor telemetry is off by default and enabling it changes the duty cycle substantially, as does the radio configuration and the TDMA reporting rate. Determine it by measurement against the intended settings for a deployment.

Buffered records

Both GNSS and sensor records are drained over GATT Data Sync, selected with the type field. Records are released only once the response is read to its end.