Skip to content

Commit 6ce979a

Browse files
authored
Update ZHA intro Zigbee terminology and concepts
Update the ZHA introduction bullet points fo correct Zigbee terminology and better explaination of its concepts.
1 parent d5d1e9e commit 6ce979a

File tree

1 file changed

+21
-16
lines changed

1 file changed

+21
-16
lines changed

source/_integrations/zha.markdown

Lines changed: 21 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -75,22 +75,27 @@ The ZHA integration is a hardware-independent Zigbee gateway implementation that
7575

7676
ZHA uses an open-source Python library called [zigpy](https://github.com/zigpy/zigpy), so any coordinator that is compatible with zigpy can be used with ZHA. Review [compatible hardware](#compatible-hardware) recommendations before purchasing Zigbee devices.
7777

78-
### Zigbee terminology
79-
80-
- **Zigbee network**: A mesh-network of devices with low-power digital radios using a low-bandwidth communication protocol.
81-
- **Zigbee coordinator**: A hardware radio adapter (typically a USB dongle) that plugs directly into the same computer running your Home Assistant installation.
82-
- **Zigbee router device**: A hardware device that is always mains-powered (AC) such as outlets or fans.
83-
- **Zigbee end device**: A hardware device that is typically battery-powered (DC) such as remotes or motion sensors.
84-
- **Zigbee group**: A collection of two or more Zigbee devices of the same type, different from Home Assistant's [Groups](/integrations/group/).
85-
86-
### Zigbee concepts
87-
88-
- A Zigbee network can have **only one** Zigbee coordinator,
89-
- The Zigbee coordinator can have multiple **Zigbee router** or **Zigbee end devices** connected,
90-
- Each Zigbee router device can have multiple **Zigbee end devices** connected to it,
91-
- A Zigbee device can only be connected to a single Zigbee network,
92-
- Zigbee networks depend heavily on having multiple [Zigbee Router devices](#using-router-devices-to-add-more-devices) to expand coverage and increase device capacity.
93-
- Router devices help pass messages to other nearby devices in the Zigbee network and therefore can improve range and increase the number of devices you can add.
78+
### Zigbee terminology and underlying concepts
79+
80+
Zigbee standards is a suite of low-bandwidth wireless IoT protocol that uses low-power digital radios and standardized set of communication. Throughout this documentation, Home Assistant terminology is primarly used. For some of the underlying concepts, the wording does not correspond to the terminology used in the Zigbee standards technical documentations. The bullet points below provides equivalents for some of those terms and keywords.
81+
82+
- **Zigbee coordinator**: A hardware radio adapter (typically a USB dongle) that plugs directly into the same computer running your Home Assistant installation to form a network (i.e. creates) and command devivces on it.
83+
- **Zigbee network**: A private Zigbee network that using mesh-networking to interconnect Zigbee devices that the user adds to its PAN (Personal Area Network, i.e.made for short range and close proximity devices).
84+
- **Zigbee router device**: A hardware device that always needs to be mains-powered (AC-power) because it acts as a Zigbee repeater in the network mesh.
85+
- **Zigbee end device**: A hardware device that is typically battery-powered (DC) such as door/window sensor or motion sensors, and never act as a Zigbee router/repeater.
86+
- **Zigbee joining**: First time you add a device it is called "joining the network", it is sometimes also refered to as "pairing", (and joined devices will automatically try rejoining the betwork if it is disconnected).
87+
- **Zigbee group**: A collection of two or more Zigbee devices of the same type you can add to a Zigbee native group in ZHA, which different from Home Assistant's [Groups](/integrations/group/).
88+
- **Zigbee binding**: bindings can be used to bind (i.e. attach) two Zigbee devices logically, such as a remote and a light, and bound devices can communicate independenly even when the coordinator/network is down.
89+
- **Zigbee OTA/OTAU**: Many Zigbee devices implement Over-the-Air update / Over-the-Air-Upgrade, (though most manufacturers only provide such updates via their own third-party gateways).
90+
- **Zigbee self-healing**: refers to a Zigbee devices and its Zigbee mesh network ability to automatically recover from network disruptions.
91+
- **Zigbee clusters**: Define specific functions and attributes of Zigbee device, what in Home Assistant terminology is called entities, (so ZHA converts/translates a "cluster" into an "entity").
92+
93+
Zigbee fundamentals are not always obvious but some of its ideas includes essential principles that you as a user should try to understand to be aware why it functions as it does:
94+
95+
- A Zigbee network can have **only one** Zigbee coordinator, and a Zigbee device can only be connected to a single Zigbee network.
96+
- The Zigbee coordinator can have multiple **Zigbee router** or **Zigbee end devices** connected, and each Zigbee router device can have multiple **Zigbee end devices** connected to it.
97+
- Zigbee networks depend heavily on having multiple [Zigbee Router devices](#using-router-devices-to-add-more-devices) to expand coverage and increase device capacity. Router devices help pass messages to other nearby devices in the Zigbee network and therefore can improve range and increase the number of devices you can add.
98+
- Zigbee's "self-healing" capabilities is where devices can change route of their messages through alternate paths, rather than relying on a single path. If a device or connection fails, each device in the network will automatically reroute traffic, maintaining connectivity and functionality. While Zigbee's self-healing is generally efficient byt can take quite somet time as devices needs to fully adapt its routing and find new optimal routes, especially in larger or more complex network enviroments.
9499

95100
## Compatible hardware
96101

0 commit comments

Comments
 (0)