ble - Bluetooth LE plugin¶
Listens to Bluetooth Low Energy advertisements to determine which devices are in range.
requirements¶
Only tested on a Raspberry PI with an external Bluetooth LE USB dongle and the Bluez bluetooth stack.
Requires the bleServer, see ../../../helpers
.
Stores raw data (mac-address, last time seen) data for all devices in sensors/ble
, and current availability by name for specific “known” devices (programmable via plugindata/bleDevices
) into environment/devices
.
schema¶
sensors/ble
: Stores per-device entries exactly as they are read from bleServer.environment/devices
: Stores availability of known devices.status/devices/ble
: Device status updated on every action.plugindata/bleDevices/bleDevice
: Maps hardware address to name, for known devices (which will be stored inenvironment/devices
:id
: Mac address (string, 6 colon-separated hex bytes).name
: User-visible name.
actions¶
Two actions:
- Pull data from bleServer into
sensors/ble
every 60 seconds. - Update
environment/devices
for known BLE devices.