BBS — Bluetooth Beacon Status
Returns the latest BLE advertisement service data from whitelisted beacons. Each configured whitelist entry (see BBL) that has received at least one advertisement will be included in the response.
Format
- Query:
>QBBS< - Response:
>RBBSaddr1$UUID1value1$...$2A08timestamp,addr2$...<
This command is query-only — no set variant exists.
Response Fields
The response contains a comma-separated list of beacon entries. Each entry has the format:
address$UUIDvalue[$UUIDvalue...]$2A08timestamp
| Field | Description |
|---|---|
address | 12-character lowercase hex BLE address from the whitelist. |
$ | Separator between service data fields. |
UUID | 4-character uppercase hex 16-bit UUID of the service data (e.g. 2A6E). |
value | Uppercase hex bytes of the service data payload. |
2A08 | Reserved UUID for the advertisement timestamp (Date Time characteristic). |
timestamp | 8-character uppercase hex Unix epoch (seconds) when the advertisement was received. |
Only AD type 0x16 (Service Data — 16-bit UUID) entries from the BLE advertisement payload are included.
Examples
Query with one whitelisted beacon reporting temperature (UUID 0x2A6E):
>QBBS<
>RBBScbec81c98eea$2A6E4509$2A0868421234<
Query with two beacons (temperature + humidity):
>QBBS<
>RBBScbec81c98eea$2A6E4509$2A0868421234,703bf221d4d5$2A6E3809$2A6F250D$2A0868421240<
Query with no whitelist data available (empty response):
>QBBS<
>RBBS<
Extended Tag
BBS is also available as an extended tag in event reports. When configured in an event definition, the tag appends ;BBS= followed by the same format described above.
Notes
- Only beacons with at least one received advertisement are included.
- Data is stored per whitelist slot — deleting a whitelist entry (via BBL) also clears its advertisement data.
- Each new advertisement from the same address overwrites the previous data (latest-only storage).
- The timestamp uses the device's system clock at the time the advertisement was received.
- A maximum of 8 service data entries per beacon are stored.