Z-Wave
Z-Wave is a wireless technology that many smart home devices use, such as locks, light switches, and sensors. Z-Wave devices connect to Home Assistant through a Z-Wave adapter. There are two types of Z-Wave:
- Z-Wave Classic: devices form a mesh network. Devices that are always powered pass messages on for other devices, which extends the range of your network.
- Z-Wave Long Range: each device connects directly to the Z-Wave adapter, over a longer distance. Z-Wave Long Range is not a mesh network.
When you add a device that supports both, you can choose which type to use. For the steps, refer to Adding a new device to the Z-Wave network.
Home Assistant controls your Z-Wave network with the built-in Z-Wave integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more]. To set it up and add devices, refer to its documentation.
Z-Wave adapters
The Home Assistant Connect ZWA-2 is the recommended Z-Wave adapter. For all other supported adapters, refer to Z-Wave adapters.
Placing your adapter elsewhere in your home
Your Z-Wave adapter doesn’t have to be plugged into your Home Assistant server. You can place it anywhere in your home, and connect it to Home Assistant over your network.
The recommended way is to plug your Home Assistant Connect ZWA-2 into a Home Assistant Connect AUX-2, and power the Connect AUX-2 with Power over Ethernet (PoE). A single Ethernet cable then provides both power and the network connection.
You can also install the Portable Z-Wave firmware on the Connect ZWA-2 itself. The adapter then connects to Home Assistant over its built-in Wi-Fi. To install the firmware, use the Open Home Foundation toolbox.
Over the network, Z-Wave devices respond a little slower than over USB. On most home networks, you won’t notice the difference. On a busy network or with a weak Wi-Fi signal, the delay can become noticeable.
To set up an adapter that connects over your network, refer to the setup steps in the Z-Wave integration.
Z-Wave security
Z-Wave has two types of security: Security S2 and Security S0. Both encrypt the messages between Home Assistant and your devices, and detect messages that were damaged on the way.
Modern Z-Wave devices support Security S2. To add such a device, you scan the QR code on the device, or enter the PIN code that is printed next to it. This confirms that the device you add is the one in your hands, and not another device nearby that pretends to be it. After you add the device, all messages between the device and Home Assistant are encrypted. Z-Wave Long Range devices always use Security S2.
When you add a device that supports Security S2, Home Assistant uses it automatically, because it is the better choice. Security S2 does not add extra traffic to your network, and it provides additional benefits. For example, devices that use Security S2 require Home Assistant to confirm that it received and understood their reports.
Home Assistant only uses Security S0 when a device needs encryption to work, but does not support Security S2. This is the case for some older devices, such as door locks. Security S0 adds significant extra traffic to your network.
Z-Wave terminology
This section explains some Z-Wave terms and concepts you might find in Z-Wave product documentation.
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.
Classic inclusion versus SmartStart
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.
SmartStart
SmartStart enabled products can be added into a Z-Wave network by scanning the Z-Wave QR Code present on the product with an adapter supporting SmartStart inclusion. No further action is required and the SmartStart product will be added automatically within 10 minutes of being switched on in the network vicinity. Not all devices support SmartStart. Some devices require classic inclusion. For documentation on adding a device to Home Assistant, refer to adding a new device to the Z-Wave network.
Terminology mapping table
Throughout this documentation, Home Assistant terminology is used. For some of the concepts, the terminology does not correspond to the terminology used in Z-Wave documentation. The table below provides equivalents for some of those terms.
| Z-Wave functionality | Home Assistant | Definition |
|---|---|---|
| barrier operator | cover | |
| controller | adapter, when referring to the hardware device that provides the Z-Wave functionality. The term controller is still used when referring to the network role (such as primary, secondary controller) | |
| exclusion | remove | The process of removing a node from the Z-Wave network |
| inclusion | add | The process of adding a node to the Z-Wave network |
| multilevel switch | represented by different entity types, such as light or fan. | |
| replication | copy (not supported in Home Assistant) | The process of copying network information from one adapter to another. Not supported in Home Assistant. |
| window covering | cover |
Troubleshooting
How do I address interference issues?
Many users have reported issues with interference when the adapter was directly connected to the machine (proximity). If you are having issues, try to use a short USB 2.0 A (male to female) extension cord.