Skip to content

Hex Code Integration for Third-Party Control Systems

Bond Bridge Pro can be integrated with third-party lighting and control systems—such as Lutron HomeWorks—by copy-pasting hex codes from a built-in Bond webpage into the third-party system's configuration software. This approach works with any system that supports sending raw hex strings over Ethernet.

System Requirements

  • Bond Bridge Pro with firmware v4.8 or higher
  • A computer with a web browser on the same network as the Bridge

Capabilities

A third-party scene or keypad button can trigger any of the following on Bond Bridge Pro:

  • Open and Close any shade or screen that appears in the Bond Home app
  • Set shade position to any percentage (when supported in the Bond Home app)
  • Control ceiling fan speed and direction (when supported in the app)
  • Toggle ceiling fan lights1
  • Adjust smart ceiling fan light brightness with discrete on/off
  • Execute any other device action supported on Bond Home
  • Group actions—any of the above applied to a Group of devices
  • Run Bond Scenes2

Limitations

  • Open-Stop-Close-Stop (what Bond calls "ToggleOpenHold") is not supported. This requires motor-level implementation that most RF protocols do not provide.
  • Hex code integration is one-directional—it allows third-party systems to control devices attached to Bond Bridge Pro. It does not allow Bond to control Lutron or other third-party motors.

Setup Guide

Step 1: Open the Hex Code Generator

  1. In the Bond Home app, go to Devices > Bridge Settings > Network.
  2. Tap the IP address to copy it. If you are using both Ethernet and Wi-Fi, you probably want the Ethernet IP address, but this depends on your network configuration.

  3. Open a web browser (Safari, Chrome, etc.) and navigate to:

    http://<bridge-ip>/hexcode

    For example: http://192.168.1.42/hexcode

Step 2: Generate a Hex Code

  1. Select Device, Group, or Scene from the Type drop-down.
  2. Select the entity you want to trigger by name.
  3. If you selected a Device or Group, also select the desired Action.
  4. For actions that require an argument (such as SetPosition), enter the Argument value. For example, enter 42 to set a shade to 42% position.
  5. The hex code appears at the bottom of the page. Use the Copy button to copy it, or the Test button to verify it works.

Hex code generator showing a SetPosition action at 42% for a shade device

Stop vs Hold

The Stop action means "stop transmitting" (end the current RF signal). To stop the motion of a shade, use the Hold action instead.

Groups and Scenes Across Multiple Bridges

For Groups and Scenes, the Bridge will only activate the devices attached to that Bridge. If you have multiple Bridges, you will need to send the hex code to each Bridge that participates in the Group or Scene.

Step 3: Configure the Third-Party System

Copy the hex code into your third-party system's configuration software. You will need:

Parameter Value
IP Address The Bond Bridge Pro's IP address
Port 80
Data Type Hex
Authentication None required

Lutron HomeWorks Example

The following walkthrough shows how to configure Lutron HomeWorks QSX with Bond Bridge Pro using Lutron Designer software.

Add the Bond Bridge as an Ethernet Device

  1. In Lutron Designer, create a new Ethernet device for the Bond Bridge Pro.
  2. Enter the Bridge's IP address and port 80.
  3. Leave username and password blank—no authentication is required.

Lutron Designer Ethernet device configuration for Bond Bridge Pro

Add Hex Codes to the Command Set

  1. In the Ethernet device's Command Set, add entries for each action you want to trigger.
  2. Paste the hex code from the Bond web interface into the Command field.
  3. Set Data Type to Hex.
  4. Set Communication Direction to To Ethernet device.

You can then trigger these commands from Lutron keypads (including wired and ClearConnect Type X keypads) or from Lutron scenes.

For shade control in Lutron Designer, select Single Action as the Button Type:

Lutron Designer Button Type dropdown with Single Action selected

Then assign hex codes to the Press and Hold button events:

Lutron Designer button event columns: Press, Double Tap, Hold

Button Event Bond Action
Press ToggleOpen
Hold Hold

This gives the most intuitive behavior: press to open or close, hold to stop mid-travel.

Warning

Assign the Hold action to Hold (press and hold)—do not use Double Tap.

Trademarks

Lutron and HomeWorks are trademarks or registered trademarks of Lutron Electronics Co., Inc., in the U.S. and/or other countries. These trademarks are used here solely to identify products compatible with Bond Bridge Pro. This use does not imply any endorsement by or affiliation with the trademark owner.

  1. Most remote-controlled ceiling fans only have a light toggle signal. We recommend linking a button to a ToggleLight action rather than discrete TurnLightOn/TurnLightOff, which often cannot achieve the desired state. Smart by Bond ceiling fans do not have this limitation. ↩

  2. If more than one action needs to be linked to a single button, using Scenes or Group actions is recommended for easiest setup. Scenes let you reconfigure button behavior without updating the third-party system configuration. ↩