Lightbug Documentation

Appearance

Examples ​

Here are some example messages for various scenarios, to help you visualize how the protocol works.

Basic type 3 message ​

Ignoring what type of message type 3 is, this example slowly builds from an empty message to one with various headers and data.

empty ​

A message that only has a type, no headers, and no payload.

Protocol
3
3
Length
110
11 bytes
Type
10
1 (Unknown)
Header Count
00
0
Payload Count
00
0
Checksum
75190
48715

with prefix bytes ​

Adding the options prefix bytes to the start of the message.

Prefix
7666
LB
Protocol
3
3
Length
110
11 bytes
Type
10
1 (Unknown)
Header Count
00
0
Payload Count
00
0
Checksum
75190
48715

with single uint32 header ​

Prefix
7666
LB
Protocol
3
3
Length
170
17 bytes
Type
10
1 (Unknown)
Header Count
10
1
Header Types
1
1
Message ID
422000
22
Payload Count
00
0
Checksum
24335
9203

with single ascii payload ​

Prefix
7666
LB
Protocol
3
3
Length
240
24 bytes
Type
10
1 (Unknown)
Header Count
10
1
Header Types
1
1
Message ID
422000
22
Payload Count
10
1
Payload Types
26
26
Field 26
5104101108108111
(bytes) ⚙️
Checksum
22192
23773

with multiple headers and payloads ​

Prefix
7666
LB
Protocol
3
3
Length
330
33 bytes
Type
10
1 (Unknown)
Header Count
20
2
Header Types
199
1, 99
Message ID
422000
22
Timestamp
41089810898
2022-04-29 22:10:52 UTC
Payload Count
20
2
Payload Types
2627
26, 27
Field 26
5104101108108111
(bytes) ⚙️
Field 27
17
(bytes) ⚙️
Checksum
183242
62135

Real world ​

Ack ​

From the ACK message

Protocol
3
3
Length
240
24 bytes
Type
50
5 (ACK)
Header Count
20
2
Header Types
34
3, 4
Response to
455200
567
Status
10
0 (OK)
Payload Count
10
1
Payload Types
1
1
ACK Type
2130
13
Checksum
201198
50889
📡 Real example from on 2025-10-09This example is captured from an RH2 device as part of normal communications over I2C with the ESP32 co-processor, in response to a heartbeat message that was sent by the ESP.

Position ​

From the Position message

Protocol
3
3
Length
820
82 bytes
Type
150
15 (Position)
Header Count
20
2
Header Types
21
2, 1
Client ID
87310218300000
12019273
Message ID
4101200
613
Payload Count
120
12
Payload Types
123456789101112
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12
Timestamp
81604936171153100
2025-10-03 17:35:00.000 UTC
Latitude
4184374522
37.2057528 Unit: degree
Longitude
410112695183
-121.8478491 Unit: degree
Altitude
419610310
92.1 Unit: meter
Accuracy
210
0.01 Unit: meter
Course
215258
150.0 Unit: degree
Speed
200
0.0 Unit: km/h
Satellites
158
58 Unit: count
CN0
143
43 Unit: dB-Hz
Type
15
5 (rtk-fix)
Source
11
1 (rtk)
Correction Age
120
2.0 Unit: seconds
Checksum
19351
13249
📡 Real example from RV1 P1 v2287 on 2025-10-03This example is captured from an RV1 device as part of normal communications with the cloud, somewhere in California.