Skip to content

BLE Scan Results Uplink Data

The device periodically scans for BLE devices and reports the top‑N results. Each entry includes at least the RSSI; other fields are included only if the corresponding wantX flags are enabled in devcfg.blescan.

Key path: devdata.blescan

To request current scan results:

{ "devdata": { "blescan": null } }

Array of detected BLE devices from the most recent scan cycle. The array is empty if no devices were found or scanning is disabled.

Configuration variables

  • Type: array of objects
  • Sent on: After each scan cycle (periodic or on demand)

Each object may contain the following fields, depending on the devcfg.blescan configuration:

FieldIncluded whenDescription
macwantMAC is trueMAC address (12 hex digits)
rssiAlways includedSignal strength in dBm
majorwantMM is trueiBeacon major value
minorwantMM is trueiBeacon minor value
uuidwantUUID is trueProximity UUID (32 hex digits)
{
"devdata": {
"blescan": {
"lastscan": [
{ "mac": "AA:BB:CC:11:22:33", "rssi": -60, "major": 1, "minor": 2 },
{ "mac": "DD:EE:FF:44:55:66", "rssi": -75, "uuid": "E2C56DB5DFFB48D2B060D0F5A71096E0" }
]
}
}
}