This page is part of archived documentation for openHAB 3.0. 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.|
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 |
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.
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
When set to
true, a device discovered on any other adapter will have a corresponding
backgroundDiscovery parameter is true by default.
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"]