This page is part of archived documentation for openHAB 3.3. Go to the current stable version
# Bluetooth Roaming Adapter
This extension adds support for accessing Bluetooth devices from any other configured adapter via a virtual adapter.
# Supported Things
It defines the following bridge type:
Bridge Type ID | Description |
---|---|
roaming | A virtual Bluetooth adapter that interacts with Bluetooth devices through their nearest Bluetooth adapter. |
# Channels
Devices which use a roaming
adapter as their bridge also gain the following channels:
Channel ID | Item Type | Description |
---|---|---|
adapter-uid | String | The thingUID of the adapter that is nearest to this device |
adapter-location | String | The nearest adapter's Location value as specified in the adapter's thing properties |
# Discovery
Roaming adapters cannot be discovered, they can only be created manually.
# Bridge Configuration
The Roaming bridge has an optional parameter groupUIDs
that configures which Bluetooth adapters this roaming bridge will be monitored for the purpose of roaming devices.
groupUIDs
must be formatted as a comma separated list of Bluetooth adapter thing UID values.
If the groupUIDs
parameter is not specified or left empty then the Roaming adapter will track devices across all other Bluetooth adapters.
Additionally, the Roaming bridge has the parameter backgroundDiscovery
that can be set to true
or false
.
When set to true
, a device discovered on any other adapter will have a corresponding roaming
discovery.
The backgroundDiscovery
parameter is true by default.
# Example
This is how an Roaming adapter can be configured textually in a *.things file:
Bridge bluetooth:roaming:ctrl "BLE Roaming Adapter" [ backgroundDiscovery=true]
Bridge bluetooth:roaming:other "BLE Roaming Adapter" [ backgroundDiscovery=true, groupUIDs="bluetooth:bluez:hci0,bluetooth:bluez:hci1"]