Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document "Zigbee Groups" in ZHA integration #29316

Open
wants to merge 23 commits into
base: current
Choose a base branch
from
Open
Changes from 2 commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
45ab4ad
Document "Zigbee Groups" in ZHA integration
Hedda Oct 12, 2023
fcd60ee
Change heading levels to fix lint error
Hedda Oct 12, 2023
f726bac
Update source/_integrations/zha.markdown
Hedda Nov 7, 2023
cbece76
Update source/_integrations/zha.markdown
Hedda Nov 7, 2023
c123ce4
Merge branch 'current' into patch-97
Hedda Nov 24, 2023
284f49f
Merge branch 'current' into patch-97
Hedda Dec 5, 2023
9b8880e
Merge branch 'current' into patch-97
Hedda Mar 11, 2024
08a324b
Merge branch 'current' into patch-97
Hedda Mar 25, 2024
21a3848
Update zha.markdown
Hedda Mar 25, 2024
877b24d
Merge branch 'current' into patch-97
Hedda Apr 30, 2024
5f46766
Update source/_integrations/zha.markdown
Hedda May 20, 2024
57143ff
Update source/_integrations/zha.markdown
Hedda May 20, 2024
895cf35
Update source/_integrations/zha.markdown
Hedda May 20, 2024
3a540cc
Update source/_integrations/zha.markdown
Hedda May 20, 2024
cae3db3
Update source/_integrations/zha.markdown
Hedda May 20, 2024
bb535e0
Update source/_integrations/zha.markdown
Hedda May 20, 2024
aa6824b
Update source/_integrations/zha.markdown
Hedda May 20, 2024
d283be3
Update source/_integrations/zha.markdown
Hedda May 20, 2024
3699c69
Update source/_integrations/zha.markdown
Hedda May 20, 2024
cb8c156
Update source/_integrations/zha.markdown
Hedda May 20, 2024
e6f652d
Update source/_integrations/zha.markdown
Hedda May 20, 2024
8733ac4
Merge branch 'current' into patch-97
Hedda May 20, 2024
51d0d0c
Merge branch 'current' into patch-97
Hedda May 31, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
18 changes: 16 additions & 2 deletions source/_integrations/zha.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -414,9 +414,23 @@ In this theoretical example, a CC2652-based Zigbee coordinator has three CC2530

In practice, you will likely need to add a lot more Zigbee router devices than in this example in order to extend the coverage of the network to reach that many devices.

## Binding and unbinding
## Zigbee Groups, Bindings and Unbindings
Hedda marked this conversation as resolved.
Show resolved Hide resolved

ZHA support for binding and unbinding. Binding is an action in Zigbee which defines relations between two Zigbee devices, specific endpoints, and cluster id. It provides a mechanism for attaching an endpoint on one Zigbee node to one or more endpoints on another Zigbee node or Zigbee group (a group of Zigbee devices).
ZHA integration support for native Zigbee Groups, as well as Zigbee Bindings and Unbindings. These features can be used separately or combined.

### Zigbee Group
Hedda marked this conversation as resolved.
Show resolved Hide resolved

A "Zigbee Group" enables native on-device grouping of multiple Zigbee lights, switches, and fans that enable controlling all compatible entities for those devices in those groups with only one command/entity.
Hedda marked this conversation as resolved.
Show resolved Hide resolved

Importantly note that using a native "Zigbee Group" inside the ZHA integration instead of Home Assistant's [Group](/integrations/group/) integration should make for much faster response times and better synchronization, especially when grouping lights.
Hedda marked this conversation as resolved.
Show resolved Hide resolved

To create a Zigbee Group click on "CONFIGURE" in the Zigbee Home Automation integration, at the top of the screen you will find "Groups", and there you can select "+ CREATE GROUP". Give the group a name and choose which devices that are compatible with each other should be in that group.
Hedda marked this conversation as resolved.
Show resolved Hide resolved

The group should consist of products of the same device type, (e.g. all lights, switches, or fans), and at least two entities must be added to a Zigbee group inside the ZHA integration before a group entity is created.
Hedda marked this conversation as resolved.
Show resolved Hide resolved

### Zigbee Binding and Unbinding
Hedda marked this conversation as resolved.
Show resolved Hide resolved

Binding is a native action in Zigbee which defines on-device relations between two Zigbee devices, specific endpoints, and cluster id. It provides a mechanism for attaching an endpoint on one Zigbee node to one or more endpoints on another Zigbee node or Zigbee group (a group of Zigbee devices).
Hedda marked this conversation as resolved.
Show resolved Hide resolved

Binding is a "target destination" in form of a device address or group ID, endpoint, and cluster. For example, binding a Zigbee device like a remote to a Zigbee lightbulb, switch or group of lightbulbs allows direct control of the "target" device (light, switch, shade) from the "remote" Zigbee device, bypassing ZHA. This means that the remote can control the lightbulb/group of lightbulbs even when the Zigbee coordinator is not available.
Binding is only supported between the same cluster, for example, "output cluster id 6" (on/off cluster) of a remote, can be only bound to an "input cluster id 6" on the target device -- light, switch.
Expand Down