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/bleevery 60 seconds. - Update
environment/devicesfor known BLE devices.