Lightbug Documentation
Search K

Appearance

58: Message Box ​

Read or subscribe to the device's cached down-synced message box on supported firmware. Build 2644 GET responses and subscription updates use field 1 for the stored message-box CRC and field 129 for its content. An empty payload is omitted. Unsupported products return Not Supported (response code 7). Field 129 uses a two-byte little-endian length prefix, even for payloads shorter than 256 bytes. Older firmware used chunk fields 10..14 with one-byte lengths; do not parse field 129 with that legacy layout. The message-frame CRC is separate from field 1. In tracking-session uploads, field 129 can instead carry pending Transmit Now upload data. In that context field 1 still describes the down-synced message box, so it must not be treated as the checksum of the upload payload.

FieldNameDescriptionType
5MethodRequest a service to be perform an action
Possible values:
  • 1: SET— Set one or more values that are provided in the message payload.
  • 2: GET— Get values for the associated message type.
  • 3: SUBSCRIBE— Subscribe to values for the associated message type. Can be used in conjunction with other header fields to define the subscription parameters, such as Interval, Duration, Timeout, Storage Level and Message Level. If no interval is provided, messages will be sent as and when new data is available. Some data, such as GPS position, may require a set interval to be provided.
  • 5: UNSUBSCRIBE— Unsubscribe from a previous subscription.
uint8
This is an extract of header fields that are relevant to this message type, you can find them all documented in the Headers section.

Payload ​

FieldNameDescriptionTypeUnit
1CRCStored checksum of the down-synced message box, separate from the outer message-frame CRC. Integer encoding may omit a high zero byte.uint16
129Full PayloadDown-synced message-box bytes in GET responses and subscription updates (up to 1024 bytes in build 2644). Uses a uint16 little-endian length prefix. Tracking-session uploads may use this field for independent Transmit Now data instead.bytes

Examples ​

Synthetic GET request (not a hardware capture)

Code ​

For convenience, the following constants can be used to reference this message type.