The Candeo RD1-Pro with firmware v2 supports direct Zigbee binding, allowing it to control compatible Zigbee lights or Zigbee groups directly.
For most Home Assistant users, we strongly recommend using the Candeo binding Blueprints. They make the process considerably easier and automatically configure the correct RD1-Pro endpoint and Zigbee clusters.
You can also create the bindings manually. Instructions for both methods are included below.
Tip: Choose your path — jump to ZHA Blueprint, ZHA manual, Zigbee2MQTT Blueprint, or Zigbee2MQTT manual.
Zigbee binding creates a direct relationship between Zigbee devices.
With the RD1-Pro bound directly to a compatible light or Zigbee group:
This provides fast and responsive control and means normal bound control can continue even if Home Assistant or Zigbee2MQTT is temporarily unavailable.
Direct binding is different from using a Home Assistant automation. Both the RD1-Pro and the target must be connected to the same Zigbee network.
Direct binding requires:
The RD1-Pro uses its dedicated endpoint 3 for direct control.
The required Zigbee clusters are:
The target device must support the appropriate clusters. For example, a device supporting On/Off but not Level Control may switch correctly but will not support rotary dimming.
Use REM when the RD1-Pro is being used primarily as a Zigbee remote control.
The knob can directly toggle and dim its bound Zigbee light or group.
Use DPM when the RD1-Pro should control both:
The Candeo Blueprint is the easiest way to configure RD1-Pro binding with ZHA.
It automatically creates the required binding from endpoint 3 for both:
This avoids having to configure the RD1-Pro’s binding details manually.
You will need:
The RD1-Pro and target must both be on the same ZHA Zigbee network.
Import the Candeo RD1-Pro – Bind to Light or Zigbee Group in ZHA Blueprint into Home Assistant, then create a new script using the Blueprint.
Under Candeo RD1-Pro v2, select the RD1-Pro that you want to use.
The RD1-Pro must be in REM or DPM mode.
The Blueprint allows you to bind the RD1-Pro to either:
Choose Zigbee Device / Light, then select the required Zigbee light.
Choose ZHA Zigbee Group, then enter the group’s Zigbee Group ID. The group must already exist in ZHA.
Note: A ZHA Zigbee group is not the same as a normal Home Assistant software light group.
Save the script and run it.
The Blueprint creates the following bindings from RD1-Pro endpoint 3:
Existing unrelated RD1-Pro bindings are not intentionally removed.
Once completed:
To inspect the RD1-Pro binding table:
Settings → Zigbee → Devices → RD1-Pro → three-dot menu → Manage Zigbee device → Bindings
The direct-control bindings should originate from endpoint 3.
You can also use ZHA’s own binding interface instead of the Candeo Blueprint.
The Blueprint method is recommended because it automatically handles the RD1-Pro-specific binding configuration.
Make sure:
In Home Assistant go to:
Settings → Zigbee → Devices → RD1-Pro
Open the three-dot menu next to Reconfigure and select Manage Zigbee device.
Then open the Bindings tab.
Choose either:
Select the required target and choose Bind or Bind group.
After binding, inspect the RD1-Pro’s binding table.
For RD1-Pro direct lighting control, the required bindings are from endpoint 3 using:
If the required endpoint 3 bindings have not been created, use the Candeo ZHA Binding Blueprint instead.
Check that:
For Home Assistant users running Zigbee2MQTT, the Candeo Blueprint is again the easiest method.
The Blueprint automatically tells Zigbee2MQTT to create the binding from the RD1-Pro’s endpoint 3 using:
You therefore do not need to manually select the RD1-Pro endpoint or clusters.
You will need:
The RD1-Pro and target must be on the same Zigbee2MQTT network.
Open Zigbee2MQTT and select the RD1-Pro. Note its exact Friendly Name.
This is the Zigbee2MQTT Friendly Name, which may be different from the name shown for the device in Home Assistant.
Find the Zigbee light you want to control and note its exact Zigbee2MQTT Friendly Name.
If you are binding to a group, create the group first and note the group’s Friendly Name.
Import the Candeo RD1-Pro – Bind to Light or Zigbee Group in Zigbee2MQTT Blueprint into Home Assistant, then create a script from the Blueprint.
Enter:
Use the names exactly as they appear in Zigbee2MQTT.
Save and run the script.
The Blueprint requests bindings from endpoint 3 for:
If successful, the RD1-Pro should immediately control the target.
Test:
Open:
Zigbee2MQTT → RD1-Pro → Bind
Check the binding entries for the RD1-Pro.
If you do not use Home Assistant Blueprints — or do not use Home Assistant at all — the binding can be configured directly in Zigbee2MQTT.
Make sure:
In the Zigbee2MQTT frontend:
Select the required target device or Zigbee group.
The RD1-Pro direct-control binding must use:
Create the binding.
Single press and rotate the RD1-Pro to confirm that the target responds correctly.
Advanced users can create the same binding directly through the Zigbee2MQTT MQTT API.
Publish to:
zigbee2mqtt/bridge/request/device/bind
with the following information:
{
"from": "RD1-Pro Friendly Name",
"from_endpoint": 3,
"to": "Target Friendly Name",
"clusters": [
"genOnOff",
"genLevelCtrl"
]
}Replace the Friendly Names with the exact Friendly Names configured in Zigbee2MQTT.
For a Zigbee group, use the group’s Friendly Name as the target.
Zigbee2MQTT requires the group’s Friendly Name rather than its numeric Zigbee Group ID when using this binding request.
After sending the request, check the response from Zigbee2MQTT and verify the resulting entries on the RD1-Pro’s Bind page.
Once the binding is configured:
With Extra Button Commands enabled, double press, hold and release can therefore still be used separately by Home Assistant automations while single press and rotary dimming directly control the bound lighting.
Direct binding is ideal where you want straightforward, resilient:
between the RD1-Pro and Zigbee lighting.
A normal Home Assistant Blueprint or automation may be more suitable if you need to control:
A device cannot be directly Zigbee-bound across separate Zigbee networks.
For example:
If you want the RD1-Pro to stop controlling a particular light or group, the binding should be removed.
Candeo provides separate RD1-Pro – Unbind from Light or Zigbee Group Blueprints for both:
These are the easiest way to remove a specific direct binding without intentionally changing unrelated bindings.
If you need to clear the RD1-Pro’s direct-control bindings and start again, use the appropriate RD1-Pro – Clear / Reset Bindings Blueprint: ZHA or Zigbee2MQTT.
Go to:
Settings → Zigbee → Devices → RD1-Pro → Manage Zigbee device → Bindings
Select the existing target and choose Unbind or Unbind group as appropriate.
Go to:
Zigbee2MQTT → RD1-Pro → Bind
Locate the required binding and remove/unbind it.
If the binding does not work, check the following:
If you configured the binding manually and cannot get the correct endpoint or clusters to bind, we recommend removing the attempted binding and using the appropriate Candeo Binding Blueprint instead.