Skip to content

Bond Home Binding ​

This binding connects the Bond Home Bridge to openHAB using the BOND V2 Local HTTP API. You'll need to acquire your Local Token. The easiest way is to open the Bond Home app on your mobile device, tap on your bridge device, open the Advanced Settings, and copy it from the Local Token entry.

Supported Things ​

Thing TypeDescription
bondBridgeThe RF/IR/WiFi Bridge
bondFanAn RF or IR remote controlled ceiling fan with or without a light
bondFireplaceAn RF or IR remote controlled fireplace with or without a fan
bondGenericThingA generic RF or IR remote controlled device
bondLightAn RF or IR remote controlled light
bondShadesAn RF or IR remote controlled motorized shade

Discovery ​

Once the bridge has been added, individual devices will be auto-discovered and added to the inbox.

Thing Configuration ​

bondBridge ​

ParameterDescriptionRequired
bondIdThe Bond ID of the bridge from the Bond Home app.Yes
localTokenThe authentication token for the local API.Yes
bondIpAddressThe exact IP address to connect to the Bond Hub on the local networkNo

Channels ​

Not all channels will be available for every device. They are dependent on how the device is configured in the Bond Home app.

common Group ​

ChannelTypeDescription
powerSwitchDevice Power
commandStringSend a command to the device

Available commands:

CommandDescription
STOPStop any in-progress dimming operation
PRESETMove a shade to a preset
DIM_START_STOPDim the fan light (cyclically)
DIM_INCREASEStart increasing the brightness of the fan light
DIM_DECREASEStart decreasing the brightness of the fan light
UP_LIGHT_DIM_START_STOPDim the fan light (cyclically)
UP_LIGHT_DIM_INCREASEStart increasing the brightness of the up light
UP_LIGHT_DIM_DECREASEStart decreasing the brightness of the up light
DOWN_LIGHT_DIM_START_STOPDim the fan light (cyclically)
DOWN_LIGHT_DIM_INCREASEStart increasing the brightness of the down light
DOWN_LIGHT_DIM_DECREASEStart decreasing the brightness of the down light

fan Group ​

ChannelTypeDescription
powerSwitchFan power (only applicable to fireplace fans)
speedDimmerSets the fan speed. The 0-100% value will be scaled to however many speeds the fan actually has. Note that you cannot set the fan to speed 0 - you must turn OFF the power channel instead.
breezeStateSwitchEnables or disables breeze mode
breezeMeanDimmerSets the average speed in breeze mode
breezeVariabilityDimmerSets the variability of the speed in breeze mode.
directionStringSets the fan direction - "Summer" or "Winter"
timerNumberSets an automatic off timer for s seconds (turning on the fan if necessary)

light, upLight, downLight Groups ​

ChannelTypeDescription
powerSwitchTurns the light on or off
brightnessDimmerAdjusts the brightness of the light

fireplace Group ​

ChannelTypeDescription
flameDimmerAdjust the flame level

shade Group ​

ChannelTypeDescription
rollershutterRollershutterOnly UP, DOWN, STOP, 0%, and 100% are supported.

Full Example ​

bond.things File ​

dsl
bondhome:bondBridge:BD123456 "Bond Bridge" [ ipAddress="192.168.0.10", localToken="abc123", serialNumber="BD123456" ]
bondhome:bondFan:BD123456:0d11f00 "Living Room Fan" (bondhome:bondBridge:BD123456) [ deviceId="0d11f00" ]

bond.items File ​

dsl
Switch GreatFan_Switch "Great Room Fan" { channel="bondhome:bondFan:BD123456:0d11f00:common#power" }
Dimmer GreatFan_Dimmer "Great Room Fan" { channel="bondhome:bondFan:BD123456:0d11f00:fan#speed" }
String GreatFan_Rotation "Great Room Fan Rotation" { channel="bondhome:bondFan:BD123456:0d11f00:fan#direction" }
Switch GreatFanLight_Switch "Great Room Fan Light" { channel="bondhome:bondFan:BD123456:0d11f00:light#power" }
Switch RF_Outlet_Lamp "Remote Control Outlet" { channel="bondhome:bondLight:BD123456:ce1fe38:light#power" }