Skip to main content

Common message header

Common headerCommon headerCommon headerCommon headerCommon headerData
Byte 0Byte 1Byte 2Byte 3Byte 4Variable
TypeStatusBatteryTemperatureACK/OptInformation

Type: refer to Message types

Status:

BitStatus
Bit7-5Operating mode: 0- Standby/ 1- Motion tracking / 2- Permanent tracking / 3- Motion start/end tracking/ 4- Activity tracking / 5- OFF(2)
Bit 4Set if the user alert/SOS has been entered
Bit 3Reserved bit
Bit 2Set if the tracker is in motion state since the last payload is sent(1)
Bit 1Set for a periodic position message
Bit 0Set for a position on demand message
Notes

(1)The tracker in in motion state until the expiration of motion_duration period. The motion bit setting can be pictured as follows: (2)In shutdown payload, the operating mode is always OFF.

Battery: battery percentage (non encoded form)

  • 0x00: the battery is charging (rechargeable devices only)
  • 0x01 to 0x64: Battery percentage:
    • Trackers with a rechargeable battery: the percentage reflects the actual value.
    • Trackers with primary battery: the percentage is estimated based on the tracker usage.
  • 0xFF: Error in measurement (rechargeable devices only)

Temperature: Temperature measured in the device, expressed in degree Celsius. Encoded form using lo= - 44, hi= 85, nbits= 8, nresv= 0. It is given with a step of 0.5°C

ACK/Opt:

BitParameterExplanation
Bit 7-4ACKAcknowledge token. Refer the section Acknowledge token for more details
Bit 3-0OptOptional data (depending on message type. Currently used only for position messages)

Information: Variable part depending on the message type.