Lightbug Documentation

Appearance

55: WiFi Scan ​

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
1SSIDSSID of the access pointascii
2MACMAC Address of the access point, as 6 bytesbytes
3RSSISignal strength of the access pointint8
4ChannelWiFi channel of the access pointuint8

Examples ​

Subscribe to WiFi scan results
Protocol
3
3
Length
260
26 bytes
Type
550
55 (WiFi Scan)
Header Count
30
3
Header Types
571
5, 7, 1
Method
13
3 (SUBSCRIBE)
Duration
41361900
5000 Unit: ms
Message ID
4211700
2003
Payload Count
00
0
Checksum
138173
44426
📡 Real example from RH2 P1 v2296 on 2025-10-14This example is captured from an RH2 device as part of normal communications over I2C with the ESP32 co-processor, where P1 subscribes to WiFi scan results from Toit on the ESP32.
WiFi scan result
Protocol
3
3
Length
480
48 bytes
Type
550
55 (WiFi Scan)
Header Count
20
2
Header Types
13
1, 3
Message ID
478100
334
Response to
4211700
2003
Payload Count
40
4
Payload Types
1234
1, 2, 3, 4
SSID
9668445656667495051
BT-ABC123
MAC
6228112858999
228,11,2,85,89,99
RSSI
1170
-86
Channel
111
11
Checksum
162180
46242
📡 Real example from RH2 ESP32 Toit on 2025-10-14This example is captured from an RH2 device as part of normal communications over I2C with the ESP32 co-processor, after WiFi scan results were subscribed to from P2, and a WiFi access point was found, sent back to P1.

Code ​

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