Skip to Content

BP Report

BP Command (G)

Compact binary report for efficient transmission. Suitable for satellite communication (Iridium 9602 SBD).

The structure can be visualized in debug mode through DB Command.


Generate report

GBPbbc

See G Command for parameter details.

The ;@dd..dd destination from the generic G Command syntax is accepted but ignored: AddRpt() intercepts the BP report before queuing it and always sends it through the local serial port (rptBpToPort()), without going through the retry/ACK queue.


IoT Platform

For Spider IOT, Smart IOT, Zero IOT models.

Parameters are configured through CXBP Command.


Binary structure

Fixed 39-byte frame (rptBpToPort(), protocol.c:50-131), the same for all compatible devices: there are no 24/28/32-byte variants and no different format per platform.

Includes report ID, Date, Time, Latitude, Longitude, Speed, Heading, digital inputs status (IN), digital outputs (XP), analog threshold flags (AR), battery voltage, position age and device ID.

Byte(s)FieldTypeDescription
0IdRptuint8Report number (00-FF)
1Dayuint81-31
2Monthuint81-12
3Yearuint82 digits (e.g.: 24 = 2024)
4Houruint80-23
5Minuteuint80-59
6Seconduint80-59
7-10Latitudeint32, Big EndianDegrees ×100000, signed
11-14Longitudeint32, Big EndianDegrees ×100000, signed
15-16Speeduint16, Big Endiankm/h
17-18Headinguint16, Big Endiandegrees
19INuint8Digital inputs IN00-IN07 (bit 0 = IN00)
20XPuint8Digital outputs XP00-XP02 (bit 0 = XP00)
21ARuint8Analog threshold flags AR00-AR05 (bit 0 = AR00)
22-23VBatuint16, Big EndianMain battery voltage, tenths of V
24Ageuint8Seconds since last valid position
25-36Device IDchar[12]Device ID, 12 fixed characters
37-38Checksumuint16, Big EndianAccumulated sum of bytes 0-36

There are no floating-point coordinates or variable packet sizes (24/28/32 bytes): the frame is always 39 bytes, with Latitude and Longitude as signed 32-bit Big Endian integers (not IEEE754 Little Endian) and the device ID in 12 fixed bytes (not variable, not dependent on CXBP). The checksum is an accumulated sum of the preceding bytes, not an XOR.


Compatibility

C3Legacy
ULLegacy
C5Legacy
SP-IoT
SM-IoT
MT
SP
ZE-IoT
Last updated