BBL — Bluetooth Beacon White List
Manages a persistent whitelist of up to 10 BLE beacon addresses (indices 00–09). When at least one entry is configured, the module switches to continuous scanning mode: it automatically starts scanning at boot, allows duplicate advertisements, and reports only the whitelisted beacons. When the whitelist is empty the device returns to manual scan mode (see BBF).
Format
- Set (configure):
>SBBLxx1Faabbccddeeff< - Set (delete):
>SBBLxxU< - Query single:
>QBBLxx< - Query all:
>QBBL<
Responses
| Request | Response (configured) | Response (not configured) |
|---|---|---|
>QBBLxx< | >RBBLxx1Faabbccddeeff< | >RBBLxxU< |
>QBBL< | >RBBLFaddr0,Faddr1,,Faddr3,,,,,,< | >RBBL,,,,,,,,,< |
The query-all response always contains exactly 10 comma-separated fields (one per index). Empty fields indicate unconfigured slots.
Parameters
| Parameter | Values | Description |
|---|---|---|
xx | 00–09 | Whitelist slot index. |
1 | literal 1 | Configure flag (set command only). |
F | 0 or 1 | Address type: 0 = public, 1 = random. |
aabbccddeeff | 12 lowercase hex chars | BLE device address (no colons). |
U | literal U | Delete flag — removes the entry at index xx. |
Response Fields
| Field | Description |
|---|---|
xx | Slot index (zero-padded). |
1 | Indicates the slot is configured. |
F | Address type: 0 = public, 1 = random. |
aabbccddeeff | 12-character lowercase hexadecimal BLE address. |
U | Indicates the slot is not configured. |
Examples
Add a public-address beacon at index 02:
>SBBL0210703bf221d4d5<
>RBBL0210703bf221d4d5<
Query the entry at index 02:
>QBBL02<
>RBBL0210703bf221d4d5<
Delete the entry at index 02:
>SBBL02U<
>RBBL02U<
After deleting, query index 02:
>QBBL02<
>RBBL02U<
Query all 10 slots (indices 00 and 03 configured):
>QBBL<
>RBBL0112233da8040,,06f24996da077,,,,,,<
Notes
- Entries are persisted across reboots in the device database.
- A maximum of 10 slots are available (indices
00–09). - Deleting an entry removes it from the whitelist immediately; a scan reconfiguration cycle is triggered if the whitelist becomes empty.
- While continuous scanning is active (whitelist non-empty), issuing
>SBBFxx<starts a new scan by filtering duplicates. - Beacon addresses must be 12 lowercase hexadecimal characters with no separators (e.g.
703bf221d4d5).