Skip to content
CC2 Device Documentation

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,
  },
}

lastscan

Section titled “lastscan”

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:

Field Included when Description
mac wantMAC is true MAC address (12 hex digits)
rssi Always included Signal strength in dBm
major wantMM is true iBeacon major value
minor wantMM is true iBeacon minor value
uuid wantUUID is true Proximity 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",
        },
      ],
    },
  },
}
Section titled “Related”