demus/openhab-addons
1
0
Fork 0
mirror of https://github.com/openhab/openhab-addons.git synced 2025-01-10 23:22:02 +01:00
Code Issues Packages Projects Releases Wiki Activity
bd56fd8e5d
openhab-addons/bundles/org.openhab.binding.bluetooth.generic
History
Pete 7abeb97396
[bluetooth.generic] Enable BLE notification for linked channels (#10122) 
* [bluetooth] Add BluetoothDevice.isNotifying()
* [bluetooth] Improve Characteristic properties support
* [bluez] Improve Characteristic properties support
* [bluetooth] Add BluetoothDevice.canNotify()
* [bluez] Also catch DBusExecutionException on read value
* [bluetooth.generic] Activate notifications for linked channels where characteristics are able to notify
* [bluez] Adjust javadoc
* [bluegiga] Add BluetoothDevice.isNotifying() support
* [bluegiga] Fix notification enabled check
* [bluetooth] move canNotify() to Characteristic
* [bluegiga] rename notificationEnabled to notifying
* [bluetooth.generic] use handlerToChannels to subscribe to notifications
* [bluetooth.generic] implement TODOs of canRead()/canWrite()
* [bluetooth.generic] optimize ChannelUID
* [bluetooth.generic] use channelUids for link check

Signed-off-by: Peter Rosenberg <prosenb.dev@gmail.com>
2021-02-16 12:26:34 -08:00
..
src [bluetooth.generic] Enable BLE notification for linked channels (#10122) 2021-02-16 12:26:34 -08:00
NOTICE [bluetooth.generic] Added support for generic bluetooth devices (#8775) 2020-11-23 10:43:44 +01:00
pom.xml Apply Spotless, update skeleton project version, resolve itest runbundles (#9459) 2020-12-22 10:37:44 +01:00
README.md [bluetooth.generic] Added support for generic bluetooth devices (#8775) 2020-11-23 10:43:44 +01:00

README.md

Generic Bluetooth Device

This binding adds support for devices that expose Bluetooth Generic Attributes (GATT)

Supported Things

Only a single thing type is added by this binding:

Thing Type ID Description
generic A generic connectable bluetooth device

Discovery

As any other Bluetooth device, generic bluetooth devices are discovered automatically by the corresponding bridge. Generic bluetooth devices will be discovered for any connectable bluetooth device that doesn't match another bluetooth binding.

Thing Configuration

Parameter Required Default Description
address yes The address of the bluetooth device (in format "XX:XX:XX:XX:XX:XX")
pollingInterval no 30 The frequency at which readable characteristics will refresh

Channels

Channels will be dynamically created based on types of characteristics the device supports. This binding contains a mostly complete database of standardized GATT services and characteristics that is used to map characteristics to one or multiple channels.

Characteristics not in the database will be mapped to a single String channel labeled Unknown. The data visible from unknown channels will be the raw binary data formated as hexadecimal. Data written (if the unknown characteristic has write support) to unknown channels must likewise be in hexadecimal.