Lightbug Documentation

Appearance

43: Battery Status ​

Get the battery status of a device

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
1VoltageCurrent battery voltagefloat32V
2PercentCurrent battery percentuint8%

Examples ​

Request battery status
Protocol
03
3
Length
2000
20 bytes
Type
4300
43 (Battery Status)
Header Count
0200
2
Header Types
0501
5, 1
Method
0102
2 (GET)
Message ID
0412763240189
3186638719
Payload Count
0000
0
Checksum
4207
1834
📡 Real example from RH2 ESP32 Toit on 2025-10-10This example is captured from an RH2 device as part of normal communications over I2C with the ESP32 co-processor, where Toit on the ESP32 make the request.
Receive a battery status, at 86% and 4.2v
Protocol
3
3
Length
290
29 bytes
Type
430
43 (Battery Status)
Header Count
20
2
Header Types
34
3, 4
Response to
412763240189
3186638719
Status
10
0 (OK)
Payload Count
20
2
Payload Types
21
2, 1
Percent
186
86 Unit: %
Voltage
43317613464
4.209000110626221 Unit: V
Checksum
229139
35813
📡 Real example from RH2 P1 v2287 on 2025-10-10This example is captured from an RH2 device as part of normal communications over I2C with the ESP32 co-processor, where P1 responses to a request from Toit on the ESP32.

Code ​

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