Common Errors

Here are some of the common problems you may experience with the plugin and how to resolve them.

Cannot Pair With the Bridge

Pairing happens in the plugin settings screen and needs a physical button press on the bridge:

• Make sure the bridge is a LEAP-capable model - the Caséta Smart Bridge 2 (L-BDG2-WH), Smart Bridge Pro (L-BDGPRO2-WH), or an RA2 Select main repeater. The original non-LEAP Smart Bridge is not supported.
• The bridge and Homebridge must be on the same network, and the bridge must be reachable (not blocked by a VLAN or firewall).
• When prompted, press the small black button on the back of the bridge within the time window, then let the settings screen finish.
• If pairing was interrupted, start it again from the settings screen - a half-finished pairing can leave the secrets incomplete.

Devices Not Appearing or Not Responding

• Restart Homebridge after any configuration change.
• Check the device works in the Lutron app first - the plugin can only see devices the bridge already knows about.
• If you excluded device types under options, make sure the device you expect is not being filtered out.
• Pico remotes only appear if they are not filtered - see the filterPico option.

Getting More Help

• Search the existing issues - someone may have had the same problem.
• If not, please open a support request and include your Homebridge log (enable debug mode: Homebridge UI → Settings → Log Settings → debug level, then restart).