Z-Wave: add list of used association groups (#34700)

* Z-Wave: add list of used association groups

* Rephrase

* Apply suggestions from code review

Co-authored-by: AlCalzone <dominic.griesel@nabucasa.com>

* Move term definitions to terminology section, add note user doesn't need to add device to group

* Add link to factory reset explainer

* Apply suggestions from code review

Co-authored-by: AlCalzone <dominic.griesel@nabucasa.com>

---------

Co-authored-by: AlCalzone <dominic.griesel@nabucasa.com>
This commit is contained in:
c0ffeeca7 2024-09-13 14:19:00 +02:00 committed by GitHub
parent 892fa46fff
commit 75d6db1518
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -51,7 +51,7 @@ The Z-Wave integration allows you to control a Z-Wave network via the [Z-Wave JS
## Getting started
This sections shows you how to set up a Z-Wave JS server how to add your first Z-Wave device to Home Assistant. It also introduces you to some of the basic terminology.
This sections shows you how to set up a Z-Wave JS server and how to add your first Z-Wave device to Home Assistant. It also introduces you to some of the basic terminology.
### Z-Wave terminology
@ -69,6 +69,12 @@ Throughout this documentation, Home Assistant terminology is used. For some of t
Home Assistant supports both _classic inclusion_ and _SmartStart_. _Classic inclusion_ means you set both the hub and the device to be included into the corresponding mode. The alternative is _SmartStart_, where the hub is constantly listening for inclusion requests from devices that want to join the network.
#### Association group
An _association_ in Z-Wave terminology is when two or more Z-Wave products communicate directly. This enables devices to communicate with each other without the need to communicate via a hub, or to send unsolicited reports to the central hub.
An _association group_ in Z-Wave terminology is a group of devices that another one will send commands to in certain situations. Association groups and their functionality are specific to the device that sends the commands. Refer to the device manual for details.
### Prerequisites
To run a Z-Wave network, you need the following elements:
@ -974,6 +980,16 @@ In Home Assistant, it is currently not possible to set the Z-Wave controller int
A Z-Wave controller that manages an empty network can also join a different network and act as a secondary controller there. However, with Home Assistant, this is not possible. Home Assistant does not allow the Z-Wave controller to join another network, because Home Assistant acts as the central hub.
## Z-Wave association groups used
In Home Assistant, a single [association group](#association-group) is supported:
- **Group 1**: This is an association group that includes only one device. It is used after a [factory reset](#controller), to send a **Device Reset Locally Notification**.
This association group is used when Home Assistant [resets the Z-Wave controller](#controller).
Under normal circumstances, it is not necessary to add a device to this group.
## Z-Wave Command Classes Home Assistant responds to when queried
The following table lists the Command Classes together with the implemented version and required security class. These are the Command Classes that Home Assistant will respond to when queried by other devices.
@ -997,3 +1013,4 @@ The following table lists the Command Classes together with the implemented vers
| Multi Channel Association | 5 | Highest granted |
| Power Level | 1 | Highest granted |
| Version | 3 | Highest granted |