From c4d906f859fb56e7bcff535b6b1f2b848edaddc2 Mon Sep 17 00:00:00 2001 From: Hedda Date: Mon, 11 Sep 2023 11:53:24 +0200 Subject: [PATCH 1/7] Improve introduction in zha.markdown Improve ZHA introduction in zha.markdown --- source/_integrations/zha.markdown | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index dc6c49cffb9d..751f11840acf 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -69,15 +69,17 @@ There is also support for Zigbee grouping of lights, switches, and fans (i.e. su ## Introduction -ZHA integration is a Zigbee gateway implementation that follows the standard Zigbee 3.0 specification (and earlier revisions). In Zigbee, there are three different device types: Zigbee Coordinator (ZC), Zigbee Router (ZR), and Zigbee End Device (ZED). A Zigbee network always has one (and no more) Zigbee Coordinator, however, a Zigbee network can have multiple Zigbee Routers and multiple Zigbee End Devices. +ZHA integration is a Zigbee gateway implementation that follows the Zigbee 3.0 specification. It supports later revisions of the Zigbee PRO low-power communication protocol which uses small digital radios to create a wireless personal area network (PAN) to connect compatible devices within a local area. It supports three different device types: Zigbee Coordinator (ZC), Zigbee Router (ZR), and Zigbee End Device (ZED). A Zigbee network always needs to have one (and no more) Zigbee Coordinator, and a Zigbee device can never be connected to more than a single Zigbee network or Zigbee Coordinator, however, a Zigbee network can have multiple Zigbee Router devices and Zigbee End Devices, -A Zigbee Coordinator is the central device in a Zigbee network that manages and controls the network. It acts as a physical interface for the Zigbee wireless protocol, as well as being responsible for maintaining the Zigbee network topology and ensuring secure and efficient communication between Zigbee devices. Zigbee Router devices are mains-powered and will act as Zigbee signal repeaters within the Zigbee network mesh to extend its range and improve coverage, while Zigbee End Device devices are usually battery-operated sensors that will not act as Zigbee signal repeaters. +Before installing the ZHA integration in Home Assistant, you will need to buy and connect a Zigbee Coordinator radio adapter or hardware module. Those normally come in the form of a USB dongle that plugs directly into the computer that is running the Home Assistant installation. The ZHA integration is compatible with many "Zigbee Coordinator" adapters, including Zigbee stacks (and Zigbee stack versions) from different manufacturers via their various serial interfaces. Be sure to [note the recommendations in the respective sections below before buying a new Zigbee radio adapter or hardware module](#compatible-hardware). -In the case of ZHA, the Zigbee Coordinator is a radio adapter or hardware module, that contains a microcontroller that runs the Zigbee protocol stack which the ZHA integration uses to manage and communicate with a Zigbee network and its devices. +In the case of this ZHA integration, the Zigbee Coordinator is a physical radio adapter or hardware module, that contains a microcontroller that runs the Zigbee stack which the ZHA integration uses to manage and communicate with the Zigbee network and all its devices. The Zigbee Coordinator will act as the central device in your Zigbee network. Its main responsibility from an end-user's point-of-view is the joining of devices to the network and then controlling them. Being the network bridge interface for Zigbee, it maintains the Zigbee network topology and ensures secure and efficient communication between Zigbee devices. -Before installing the ZHA integration, you will need to buy and connect a Zigbee Coordinator radio adapter or hardware module, those usually come in the form of a USB dongle that plugs directly into the computer that is running the Home Assistant installation. The ZHA integration can work with many different "Zigbee Coordinator" adapters, however, be sure to read the respective sections below about compatible Zigbee radio adapters and hardware modules. +Once ZHA has been set up and configured with a Zigbee Coordinator radio adapter or module you will be able to directly join/pair any Zigbee Router devices and Zigbee End Devices to the Zigbee network; [regardless of the manufacturer and brand of that Zigbee-based product](#knowing-which-devices-are-supported), (with few [limitations](#limitations)). While backwards compatible with devices that use earlier versions of Zigbee Home Automation (ZHA) and Zigbee Light Link (ZLL) protocols, it is generally recommended to buy Zigbee 3.0 (ZB3) compliant devices. Zigbee 3.0 certified devices usually offer better interoperability with more Zigbee gateway solutions out-of-the-box, however [devices that use manufacturer-specific extensions to add non-standard functions and features will still need quirk code in custom device handlers to fully work with ZHA](#how-to-add-support-for-new-and-unsupported-devices). -Once ZHA has been set up and the Zigbee Coordinator radio adapter or module is configured, you will be able to directly join/pair any Zigbee device to the Zigbee network; regardless of the manufacturer and brand of that Zigbee-based product. Note, that while it is generally recommended to buy Zigbee 3.0 compliant devices as those should, in theory, offer greater interoperability, be sure of the sections about which devices are supported and exception handling. +Because a Zigbee relies on "mesh networking" technology it depends on its Zigbee Router devices for expanding the network coverage and size. These are always mains-powered devices that will act as Zigbee routers (often wrongly referred to as signal repeaters) within the Zigbee network mesh to extend its range and expand the total amount of devices that can be added. Zigbee End Device devices on the other hand will not expand the range of the network as they do not pass along any signals/messages from other devices, these are usually all battery-operated devices, but not always. You should therefore make sure that your Zigbee network has enough Zigbee Router devices, and always begin by adding those before adding Zigbee End devices when getting started. + +You will also keep in mind that a Zigbee network needs to have many Zigbee Router devices or else your network mesh coverage will be severely limited due to the short range and poor wall penetration of Zigbee radio signals. In addition, be aware that all Zigbee devices, and especially the Zigbee Coordinator, can be very sensitive to electromagnetic interference (EMI), As such it is highly recommended that you read and follow the best practice tips below about [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization). ## Compatible hardware From 18f9d4b218a0c31294c72b1abe1f6fdf9cde0b82 Mon Sep 17 00:00:00 2001 From: Hedda Date: Tue, 12 Sep 2023 12:47:33 +0200 Subject: [PATCH 2/7] Update zha.markdown fix lint MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Incorrect usage of the terminology term: “backwards compatible”, use “backward compatible” instead. --- source/_integrations/zha.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index 751f11840acf..61561d3a3bd4 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -75,7 +75,7 @@ Before installing the ZHA integration in Home Assistant, you will need to buy an In the case of this ZHA integration, the Zigbee Coordinator is a physical radio adapter or hardware module, that contains a microcontroller that runs the Zigbee stack which the ZHA integration uses to manage and communicate with the Zigbee network and all its devices. The Zigbee Coordinator will act as the central device in your Zigbee network. Its main responsibility from an end-user's point-of-view is the joining of devices to the network and then controlling them. Being the network bridge interface for Zigbee, it maintains the Zigbee network topology and ensures secure and efficient communication between Zigbee devices. -Once ZHA has been set up and configured with a Zigbee Coordinator radio adapter or module you will be able to directly join/pair any Zigbee Router devices and Zigbee End Devices to the Zigbee network; [regardless of the manufacturer and brand of that Zigbee-based product](#knowing-which-devices-are-supported), (with few [limitations](#limitations)). While backwards compatible with devices that use earlier versions of Zigbee Home Automation (ZHA) and Zigbee Light Link (ZLL) protocols, it is generally recommended to buy Zigbee 3.0 (ZB3) compliant devices. Zigbee 3.0 certified devices usually offer better interoperability with more Zigbee gateway solutions out-of-the-box, however [devices that use manufacturer-specific extensions to add non-standard functions and features will still need quirk code in custom device handlers to fully work with ZHA](#how-to-add-support-for-new-and-unsupported-devices). +Once ZHA has been set up and configured with a Zigbee Coordinator radio adapter or module you will be able to directly join/pair any Zigbee Router devices and Zigbee End Devices to the Zigbee network; [regardless of the manufacturer and brand of that Zigbee-based product](#knowing-which-devices-are-supported), (with few [limitations](#limitations)). While backward compatible with devices that use earlier versions of Zigbee Home Automation (ZHA) and Zigbee Light Link (ZLL) protocols, it is generally recommended to buy Zigbee 3.0 (ZB3) compliant devices. Zigbee 3.0 certified devices usually offer better interoperability with more Zigbee gateway solutions out-of-the-box, however [devices that use manufacturer-specific extensions to add non-standard functions and features will still need quirk code in custom device handlers to fully work with ZHA](#how-to-add-support-for-new-and-unsupported-devices). Because a Zigbee relies on "mesh networking" technology it depends on its Zigbee Router devices for expanding the network coverage and size. These are always mains-powered devices that will act as Zigbee routers (often wrongly referred to as signal repeaters) within the Zigbee network mesh to extend its range and expand the total amount of devices that can be added. Zigbee End Device devices on the other hand will not expand the range of the network as they do not pass along any signals/messages from other devices, these are usually all battery-operated devices, but not always. You should therefore make sure that your Zigbee network has enough Zigbee Router devices, and always begin by adding those before adding Zigbee End devices when getting started. From aca664684837928735700fbe42536b85adf005f1 Mon Sep 17 00:00:00 2001 From: Hedda Date: Wed, 13 Sep 2023 17:38:33 +0200 Subject: [PATCH 3/7] Update zha.markdown Rewrote to remove some jargon --- source/_integrations/zha.markdown | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index 61561d3a3bd4..1ee4904605e8 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -69,17 +69,21 @@ There is also support for Zigbee grouping of lights, switches, and fans (i.e. su ## Introduction -ZHA integration is a Zigbee gateway implementation that follows the Zigbee 3.0 specification. It supports later revisions of the Zigbee PRO low-power communication protocol which uses small digital radios to create a wireless personal area network (PAN) to connect compatible devices within a local area. It supports three different device types: Zigbee Coordinator (ZC), Zigbee Router (ZR), and Zigbee End Device (ZED). A Zigbee network always needs to have one (and no more) Zigbee Coordinator, and a Zigbee device can never be connected to more than a single Zigbee network or Zigbee Coordinator, however, a Zigbee network can have multiple Zigbee Router devices and Zigbee End Devices, +ZHA integration is a Zigbee gateway implementation that supports the Zigbee 3.0 standard as well as supporting earlier Zigbee standards for home automation and lighting devices. It follows the Zigbee PRO specification, a low-power wireless communication protocol which uses small digital radios to create a private Zigbee network that can connect compatible devices within a local area. -Before installing the ZHA integration in Home Assistant, you will need to buy and connect a Zigbee Coordinator radio adapter or hardware module. Those normally come in the form of a USB dongle that plugs directly into the computer that is running the Home Assistant installation. The ZHA integration is compatible with many "Zigbee Coordinator" adapters, including Zigbee stacks (and Zigbee stack versions) from different manufacturers via their various serial interfaces. Be sure to [note the recommendations in the respective sections below before buying a new Zigbee radio adapter or hardware module](#compatible-hardware). +A Zigbee network can have three different types of devices; "Zigbee Coordinator", "Zigbee Router", and "Zigbee End Device". A Zigbee network always needs to have one Zigbee Coordinator (it can never have more than one), and Zigbee devices can never be connected to more than a single Zigbee network (or Zigbee Coordinator), however, a Zigbee network can have multiple Zigbee Router devices and Zigbee End Devices. -In the case of this ZHA integration, the Zigbee Coordinator is a physical radio adapter or hardware module, that contains a microcontroller that runs the Zigbee stack which the ZHA integration uses to manage and communicate with the Zigbee network and all its devices. The Zigbee Coordinator will act as the central device in your Zigbee network. Its main responsibility from an end-user's point-of-view is the joining of devices to the network and then controlling them. Being the network bridge interface for Zigbee, it maintains the Zigbee network topology and ensures secure and efficient communication between Zigbee devices. +Before installing the ZHA integration in Home Assistant, you need to connect a Zigbee Coordinator adapter. Those normally come in the form of a USB dongle that plugs directly into the same computer that is running your Home Assistant installation. The ZHA integration is compatible with many different "Zigbee Coordinator" adapters from various manufacturers. Be sure to [note the recommendations in the respective sections below before buying a Zigbee Coordinator](#compatible-hardware). -Once ZHA has been set up and configured with a Zigbee Coordinator radio adapter or module you will be able to directly join/pair any Zigbee Router devices and Zigbee End Devices to the Zigbee network; [regardless of the manufacturer and brand of that Zigbee-based product](#knowing-which-devices-are-supported), (with few [limitations](#limitations)). While backward compatible with devices that use earlier versions of Zigbee Home Automation (ZHA) and Zigbee Light Link (ZLL) protocols, it is generally recommended to buy Zigbee 3.0 (ZB3) compliant devices. Zigbee 3.0 certified devices usually offer better interoperability with more Zigbee gateway solutions out-of-the-box, however [devices that use manufacturer-specific extensions to add non-standard functions and features will still need quirk code in custom device handlers to fully work with ZHA](#how-to-add-support-for-new-and-unsupported-devices). +Once ZHA has been set up with a Zigbee Coordinator it will automatically create a Zigbee network and you will be able to join/pair any Zigbee devices. With only a few [limitations](#limitations), most devices will join/pair directly regardless of brand and manufacturer. It is generally recommended to buy Zigbee 3.0 compliant devices if possible, though a new Zigbee Coordinator is also backward compatible with older devices. Zigbee 3.0 certified devices usually offer better interoperability. Still, not all functionality [will always be supported out-of-the-box](#knowing-which-devices-are-supported) and devices that use manufacturer-specific extensions to add non-standard functions and features will need [device-specific code to fully work with ZHA](#how-to-add-support-for-new-and-unsupported-devices). -Because a Zigbee relies on "mesh networking" technology it depends on its Zigbee Router devices for expanding the network coverage and size. These are always mains-powered devices that will act as Zigbee routers (often wrongly referred to as signal repeaters) within the Zigbee network mesh to extend its range and expand the total amount of devices that can be added. Zigbee End Device devices on the other hand will not expand the range of the network as they do not pass along any signals/messages from other devices, these are usually all battery-operated devices, but not always. You should therefore make sure that your Zigbee network has enough Zigbee Router devices, and always begin by adding those before adding Zigbee End devices when getting started. +The Zigbee Coordinator will act as the central device in your Zigbee network. In the case of this ZHA integration, the Zigbee Coordinator has a microcontroller and runs the Zigbee stack which is used to manage the Zigbee network and communicate with all its devices. Its main responsibility is the joining/pairing of devices to the network and then controlling them. Being the physical network bridge interface for Zigbee, it maintains the Zigbee network topology and ensures secure and efficient communication between Zigbee devices. -You will also keep in mind that a Zigbee network needs to have many Zigbee Router devices or else your network mesh coverage will be severely limited due to the short range and poor wall penetration of Zigbee radio signals. In addition, be aware that all Zigbee devices, and especially the Zigbee Coordinator, can be very sensitive to electromagnetic interference (EMI), As such it is highly recommended that you read and follow the best practice tips below about [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization). +Because a Zigbee relies on "mesh networking" technology it depends on its Zigbee Router devices to expand the network coverage and extend its size. These are always mains-powered devices that route messages to other devices that are located close to them within the Zigbee network mesh to improve the range and increase the total amount of devices you can add. You should therefore make sure that you have many Zigbee Router devices or else its network mesh coverage will be limited due to the short range and poor wall penetration of Zigbee radio signals. + +Zigbee End Device devices will not expand the range of the network as they do not route any messages from other devices. These are usually all battery-operated devices, but not always as some Zigbee End Devices can sometimes be mains-powered devices. Always begin adding Zigbee Router devices before Zigbee End Devices when creating a new Zigbee network. + +Finally, it is highly recommended that you read and follow all the general tips below about [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization). ## Compatible hardware From e9e308f0df0a4dc4eb1b27e706b27d7bfa7b7b1d Mon Sep 17 00:00:00 2001 From: Hedda Date: Thu, 28 Sep 2023 12:26:25 +0200 Subject: [PATCH 4/7] Update zha.markdown --- source/_integrations/zha.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index 1ee4904605e8..6e63342274a5 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -79,11 +79,11 @@ Once ZHA has been set up with a Zigbee Coordinator it will automatically create The Zigbee Coordinator will act as the central device in your Zigbee network. In the case of this ZHA integration, the Zigbee Coordinator has a microcontroller and runs the Zigbee stack which is used to manage the Zigbee network and communicate with all its devices. Its main responsibility is the joining/pairing of devices to the network and then controlling them. Being the physical network bridge interface for Zigbee, it maintains the Zigbee network topology and ensures secure and efficient communication between Zigbee devices. -Because a Zigbee relies on "mesh networking" technology it depends on its Zigbee Router devices to expand the network coverage and extend its size. These are always mains-powered devices that route messages to other devices that are located close to them within the Zigbee network mesh to improve the range and increase the total amount of devices you can add. You should therefore make sure that you have many Zigbee Router devices or else its network mesh coverage will be limited due to the short range and poor wall penetration of Zigbee radio signals. +Because a Zigbee relies on "mesh networking" technology it depends on its [Zigbee Router devices](#using-router-devices-to-add-more-devices) to expand the network coverage and extend its size. These are always mains-powered devices that route messages to other devices that are located close to them within the Zigbee network mesh to improve the range and increase the total amount of devices you can add. You should therefore make sure that you have many Zigbee Router devices or else its network mesh coverage will be limited due to the short range and poor wall penetration of Zigbee radio signals. -Zigbee End Device devices will not expand the range of the network as they do not route any messages from other devices. These are usually all battery-operated devices, but not always as some Zigbee End Devices can sometimes be mains-powered devices. Always begin adding Zigbee Router devices before Zigbee End Devices when creating a new Zigbee network. +Zigbee End Device devices will not expand the range of the network as they do not route any messages from other devices. These are usually all battery-operated devices, but not always as some Zigbee End Devices can sometimes be mains-powered devices. Always begin adding Zigbee Router devices before Zigbee End Devices when creating a new Zigbee network. It is highly recommended that you read and follow all the general tips below about [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization). -Finally, it is highly recommended that you read and follow all the general tips below about [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization). +Optionally you can configure Zigbee grouping of lights, switches, and fans (i.e. support for commanding multiple devices as a single group). In addition, you also have the [option to bind some Zigbee devices](#binding-and-unbinding), like a remote, directly to a device or group (i.e. define relations between two or more Zigbee devices that will work even when the Zigbee Coordinator and ZHA integration is not available). ## Compatible hardware From b2462571506b9f17be0050a3b979c69df91469e0 Mon Sep 17 00:00:00 2001 From: Hedda Date: Mon, 25 Mar 2024 09:07:00 +0100 Subject: [PATCH 5/7] Update zha.markdown Update introduction based on feedback. --- source/_integrations/zha.markdown | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index bf92a224ceef..e7dff065851e 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -73,21 +73,17 @@ In addition, it has support for "Zigbee groups" that enable native on-device gro ## Introduction -ZHA integration is a Zigbee gateway implementation that supports the Zigbee 3.0 standard as well as supporting earlier Zigbee standards for home automation and lighting devices. It follows the Zigbee PRO specification, a low-power wireless communication protocol which uses small digital radios to create a private Zigbee network that can connect compatible devices within a local area. +This ZHA integration is a hardware independent Zigbee gateway implementation that can replace most proprietary Zigbee gateways/bridges/hubs/controllers. It supports pairing/joining devices that use the Zigbee 3.0 standard and earlier Zigbee standards for home automation and lighting. It follows the Zigbee PRO specification, a low-power wireless communication protocol using small digital radios to create a private Zigbee network mesh that can connect compatible devices within a local area. A Zigbee network can have three different types of devices; "Zigbee Coordinator", "Zigbee Router", and "Zigbee End Device". A Zigbee network always needs to have one Zigbee Coordinator (it can never have more than one), and Zigbee devices can never be connected to more than a single Zigbee network (or Zigbee Coordinator), however, a Zigbee network can have multiple Zigbee Router devices and Zigbee End Devices. -Before installing the ZHA integration in Home Assistant, you need to connect a Zigbee Coordinator adapter. Those normally come in the form of a USB dongle that plugs directly into the same computer that is running your Home Assistant installation. The ZHA integration is compatible with many different "Zigbee Coordinator" adapters from various manufacturers. Be sure to [note the recommendations in the respective sections below before buying a Zigbee Coordinator](#compatible-hardware). +Before installing the ZHA integration in Home Assistant, you need to connect a Zigbee Coordinator radio adapter, that will act as the physical network bridge interface and security controller for your Zigbee network. Those normally come in the form of a USB dongle that plugs directly into the same computer that is running your Home Assistant installation. The ZHA integration is compatible with many different "Zigbee Coordinator" adapters from various manufacturers. Be sure to [note the recommendations in the respective sections below before buying a Zigbee Coordinator](#compatible-hardware). -Once ZHA has been set up with a Zigbee Coordinator it will automatically create a Zigbee network and you will be able to join/pair any Zigbee devices. With only a few [limitations](#limitations), most devices will join/pair directly regardless of brand and manufacturer. It is generally recommended to buy Zigbee 3.0 compliant devices if possible, though a new Zigbee Coordinator is also backward compatible with older devices. Zigbee 3.0 certified devices usually offer better interoperability. Still, not all functionality [will always be supported out-of-the-box](#knowing-which-devices-are-supported) and devices that use manufacturer-specific extensions to add non-standard functions and features will need [device-specific code to fully work with ZHA](#how-to-add-support-for-new-and-unsupported-devices). +Once ZHA has been set up with a Zigbee Coordinator it will automatically create a Zigbee network and you will be able to join/pair any Zigbee devices. With only a few [limitations](#limitations), most devices will join/pair directly regardless of brand and manufacturer. It is generally recommended to buy Zigbee 3.0 compliant devices if possible because those offer better interoperability, though a new Zigbee Coordinator is also backward compatible with older devices as well. Still, be aware that [all functionality might not always be supported or exposed for every device out-of-the-box](#knowing-which-devices-are-supported) as some devices that use manufacturer-specific extensions to add non-standard functions and features could sometimes need [device-specific code to fully work with ZHA](#how-to-add-support-for-new-and-unsupported-devices). -The Zigbee Coordinator will act as the central device in your Zigbee network. In the case of this ZHA integration, the Zigbee Coordinator has a microcontroller and runs the Zigbee stack which is used to manage the Zigbee network and communicate with all its devices. Its main responsibility is the joining/pairing of devices to the network and then controlling them. Being the physical network bridge interface for Zigbee, it maintains the Zigbee network topology and ensures secure and efficient communication between Zigbee devices. +Because a Zigbee relies on "mesh networking" technology it depends heavily on having [Zigbee Router devices](#using-router-devices-to-add-more-devices) to expand the network coverage and extend its size. These are always mains-powered devices that route messages to other devices that are located close to them within the Zigbee network mesh to improve the range and increase the total amount of devices you can add. You should therefore make sure that you add many Zigbee Router devices and not just Zigbee End Devices or else its network mesh connection routes will be limited due to the short range and poor wall penetration of Zigbee radio signals. It is highly recommended that you read and follow all the general tips below about [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization). -Because a Zigbee relies on "mesh networking" technology it depends on its [Zigbee Router devices](#using-router-devices-to-add-more-devices) to expand the network coverage and extend its size. These are always mains-powered devices that route messages to other devices that are located close to them within the Zigbee network mesh to improve the range and increase the total amount of devices you can add. You should therefore make sure that you have many Zigbee Router devices or else its network mesh coverage will be limited due to the short range and poor wall penetration of Zigbee radio signals. - -Zigbee End Device devices will not expand the range of the network as they do not route any messages from other devices. These are usually all battery-operated devices, but not always as some Zigbee End Devices can sometimes be mains-powered devices. Always begin adding Zigbee Router devices before Zigbee End Devices when creating a new Zigbee network. It is highly recommended that you read and follow all the general tips below about [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization). - -Optionally you can configure Zigbee grouping of lights, switches, and fans (i.e. support for commanding multiple devices as a single group). In addition, you also have the [option to bind some Zigbee devices](#binding-and-unbinding), like a remote, directly to a device or group (i.e. define relations between two or more Zigbee devices that will work even when the Zigbee Coordinator and ZHA integration is not available). +Optionally you can configure Zigbee grouping of lights, switches, and fans (i.e. support for commanding multiple devices as a single group). In addition, you also have the [option to bind some Zigbee devices](#binding-and-unbinding), like binding a button on a remote control directly to a device or group (i.e. define relations between two or more Zigbee devices that will work even when the Zigbee Coordinator and ZHA integration is not available). ## Compatible hardware From 076ddce8b6748089acc9f373d06b92cf258ed9fc Mon Sep 17 00:00:00 2001 From: Hedda Date: Mon, 25 Mar 2024 09:20:10 +0100 Subject: [PATCH 6/7] Update zha.markdown --- source/_integrations/zha.markdown | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index e7dff065851e..29eb3f8e7b2d 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -75,11 +75,9 @@ In addition, it has support for "Zigbee groups" that enable native on-device gro This ZHA integration is a hardware independent Zigbee gateway implementation that can replace most proprietary Zigbee gateways/bridges/hubs/controllers. It supports pairing/joining devices that use the Zigbee 3.0 standard and earlier Zigbee standards for home automation and lighting. It follows the Zigbee PRO specification, a low-power wireless communication protocol using small digital radios to create a private Zigbee network mesh that can connect compatible devices within a local area. -A Zigbee network can have three different types of devices; "Zigbee Coordinator", "Zigbee Router", and "Zigbee End Device". A Zigbee network always needs to have one Zigbee Coordinator (it can never have more than one), and Zigbee devices can never be connected to more than a single Zigbee network (or Zigbee Coordinator), however, a Zigbee network can have multiple Zigbee Router devices and Zigbee End Devices. +Before installing the ZHA integration in Home Assistant, you need to connect a Zigbee Coordinator radio adapter, that will act as the physical network bridge interface and single point of security controller for your Zigbee network. Those normally come in the form of a USB dongle that plugs directly into the same computer that is running your Home Assistant installation. The ZHA integration is compatible with many different "Zigbee Coordinator" adapters from various manufacturers. Be sure to [note the recommendations in the respective sections below before buying a Zigbee Coordinator](#compatible-hardware). A Zigbee network always needs to have one Zigbee Coordinator (it can never have more than one), and Zigbee devices can never be connected to more than a single Zigbee network, however, a Zigbee network can have multiple "Zigbee Router" devices and "Zigbee End Device" products. -Before installing the ZHA integration in Home Assistant, you need to connect a Zigbee Coordinator radio adapter, that will act as the physical network bridge interface and security controller for your Zigbee network. Those normally come in the form of a USB dongle that plugs directly into the same computer that is running your Home Assistant installation. The ZHA integration is compatible with many different "Zigbee Coordinator" adapters from various manufacturers. Be sure to [note the recommendations in the respective sections below before buying a Zigbee Coordinator](#compatible-hardware). - -Once ZHA has been set up with a Zigbee Coordinator it will automatically create a Zigbee network and you will be able to join/pair any Zigbee devices. With only a few [limitations](#limitations), most devices will join/pair directly regardless of brand and manufacturer. It is generally recommended to buy Zigbee 3.0 compliant devices if possible because those offer better interoperability, though a new Zigbee Coordinator is also backward compatible with older devices as well. Still, be aware that [all functionality might not always be supported or exposed for every device out-of-the-box](#knowing-which-devices-are-supported) as some devices that use manufacturer-specific extensions to add non-standard functions and features could sometimes need [device-specific code to fully work with ZHA](#how-to-add-support-for-new-and-unsupported-devices). +Once ZHA has been set up with a Zigbee Coordinator it will automatically create a Zigbee network and you will be able to join/pair any Zigbee Router devices and Zigbee End Devices. With only a few [limitations](#limitations), most devices will join/pair directly regardless of brand and manufacturer. It is generally recommended to buy Zigbee 3.0 compliant devices if possible because those offer better interoperability, though a new Zigbee Coordinator is also backward compatible with older devices as well. Still, be aware that [all functionality might not always be supported or exposed for every device out-of-the-box](#knowing-which-devices-are-supported) as some devices that use manufacturer-specific extensions to add non-standard functions and features could sometimes need [device-specific code to fully work with ZHA](#how-to-add-support-for-new-and-unsupported-devices). Because a Zigbee relies on "mesh networking" technology it depends heavily on having [Zigbee Router devices](#using-router-devices-to-add-more-devices) to expand the network coverage and extend its size. These are always mains-powered devices that route messages to other devices that are located close to them within the Zigbee network mesh to improve the range and increase the total amount of devices you can add. You should therefore make sure that you add many Zigbee Router devices and not just Zigbee End Devices or else its network mesh connection routes will be limited due to the short range and poor wall penetration of Zigbee radio signals. It is highly recommended that you read and follow all the general tips below about [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization). From d632df92759aa6cb2b63b89929f5f0b3d6f1b7d2 Mon Sep 17 00:00:00 2001 From: Hedda Date: Mon, 20 May 2024 16:00:14 +0200 Subject: [PATCH 7/7] Update zha.markdown based on feedback from TheJulianJES Update zha.markdown based on feedback from TheJulianJES --- source/_integrations/zha.markdown | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index 588ce64e60a1..eaf1151c63d4 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -73,15 +73,13 @@ In addition, it has support for "Zigbee groups" that enable native on-device gro ## Introduction -This ZHA integration is a hardware independent Zigbee gateway implementation that can replace most proprietary Zigbee gateways/bridges/hubs/controllers. It supports pairing/joining devices that use the Zigbee 3.0 standard and earlier Zigbee standards for home automation and lighting. It follows the Zigbee PRO specification, a low-power wireless communication protocol using small digital radios to create a private Zigbee network mesh that can connect compatible devices within a local area. +This ZHA integration is a hardware-independent Zigbee gateway implementation that can replace most proprietary Zigbee gateways/bridges/hubs/controllers. Zigbee is a low-bandwidth communication protocol that relies on using small low-power digital radios to connect compatible devices to local Zigbee wireless private area networks. ZHA will create a single Zigbee network to which you can then pair/join most Zigbee-based devices that are made for home automation and lighting. Before installing the ZHA integration in Home Assistant, you need to connect a Zigbee Coordinator radio adapter, that will act as the physical network bridge interface and single point of security controller for your Zigbee network. Those normally come in the form of a USB dongle that plugs directly into the same computer that is running your Home Assistant installation. The ZHA integration is compatible with many different "Zigbee Coordinator" adapters from various manufacturers. Be sure to [note the recommendations in the respective sections below before buying a Zigbee Coordinator](#compatible-hardware). A Zigbee network always needs to have one Zigbee Coordinator (it can never have more than one), and Zigbee devices can never be connected to more than a single Zigbee network, however, a Zigbee network can have multiple "Zigbee Router" devices and "Zigbee End Device" products. -Once ZHA has been set up with a Zigbee Coordinator it will automatically create a Zigbee network and you will be able to join/pair any Zigbee Router devices and Zigbee End Devices. With only a few [limitations](#limitations), most devices will join/pair directly regardless of brand and manufacturer. It is generally recommended to buy Zigbee 3.0 compliant devices if possible because those offer better interoperability, though a new Zigbee Coordinator is also backward compatible with older devices as well. Still, be aware that [all functionality might not always be supported or exposed for every device out-of-the-box](#knowing-which-devices-are-supported) as some devices that use manufacturer-specific extensions to add non-standard functions and features could sometimes need [device-specific code to fully work with ZHA](#how-to-add-support-for-new-and-unsupported-devices). +Once ZHA has been set up with a Zigbee Coordinator it will automatically create a Zigbee network and you will be able to join/pair any Zigbee Router devices and Zigbee End Devices. With only a few [limitations](#limitations), most devices will join/pair directly regardless of brand and manufacturer. Technically almost all devices that are compliant with the official Zigbee specifications should offer interoperability, though a newer Zigbee Coordinator with support for later firmware often offers better compatibility with both new and older devices. Still, be aware that [all functionality might not always be supported or exposed for every device out-of-the-box](#knowing-which-devices-are-supported) as some devices that use manufacturer-specific extensions to add non-standard functions and features could sometimes need [device-specific code to fully work with ZHA](#how-to-add-support-for-new-and-unsupported-devices). -Because a Zigbee relies on "mesh networking" technology it depends heavily on having [Zigbee Router devices](#using-router-devices-to-add-more-devices) to expand the network coverage and extend its size. These are always mains-powered devices that route messages to other devices that are located close to them within the Zigbee network mesh to improve the range and increase the total amount of devices you can add. You should therefore make sure that you add many Zigbee Router devices and not just Zigbee End Devices or else its network mesh connection routes will be limited due to the short range and poor wall penetration of Zigbee radio signals. It is highly recommended that you read and follow all the general tips below about [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization). - -Optionally you can configure Zigbee grouping of lights, switches, and fans (i.e. support for commanding multiple devices as a single group). In addition, you also have the [option to bind some Zigbee devices](#binding-and-unbinding), like binding a button on a remote control directly to a device or group (i.e. define relations between two or more Zigbee devices that will work even when the Zigbee Coordinator and ZHA integration is not available). +Note that because Zigbee relies on "mesh networking" technology it depends heavily on having [Zigbee Router devices](#using-router-devices-to-add-more-devices) to expand the network coverage and extend its size. These are always mains-powered devices that route messages to other devices that are located close to them within the Zigbee network mesh to improve the range and increase the total amount of devices you can add. You should therefore make sure that you add many Zigbee Router devices and not just Zigbee End Devices or else its network mesh connection routes will be limited due to the short range and poor wall penetration of Zigbee radio signals. It is highly recommended that you read and follow all the general tips below about [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization). ## Compatible hardware