From 9f507f8d1659eb529a794cb1bd822043c0972873 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 Date: Thu, 14 Aug 2025 10:04:42 +0200 Subject: [PATCH 1/3] Z-Wave adding a device: add steps --- source/_integrations/zwave_js.markdown | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index 1dfc4d26bee4..6722a7f9a0e7 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -143,8 +143,12 @@ While your Z-Wave mesh is permanently stored on your adapter, the additional met 5. Depending on whether your device supports SmartStart, follow the steps in either option 1 or 2: - **Option 1: your device supports SmartStart**: - Select **Scan QR code** and scan the QR code on your device. - - If scanning does not work (for example due to missing HTTPS), paste the QR code content as text from a different QR reader and select **Submit**. + - **Troubleshooting**: If scanning does not work (for example due to missing HTTPS), paste the QR code content as text from a different QR reader and select **Submit**. - Turn the device on. If it was already on, you might need to power-cycle it. + - If the device supports Z-Wave Long Range, you're prompted to choose the network type. + - **Long Range**: If it is far away from other devices, or that spot has had connection issues in the past. It might also help preserve battery life. + - **Mesh**: If you already have a mesh network. Adding it can enhance coverage and reliability of this network. + - You can always remove and pair the device again to switch to the other network type. - **Option 2: your device does not support SmartStart**: - Set the device in inclusion mode. Refer to the device manual to see how this is done. - If your device is included using S2 security, you may be prompted to enter a PIN number provided with your device. Often, this PIN is provided with the documentation _and_ is also printed on the device itself. For more information on secure inclusion, refer to [this section](/integrations/zwave_js/#should-i-use-secure-inclusion). From 7070ae1ce154be649717ed3ab5b8fbfee491d9a2 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 Date: Thu, 14 Aug 2025 11:03:35 +0200 Subject: [PATCH 2/3] Tweak --- source/_integrations/zwave_js.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index 6722a7f9a0e7..ebc1f9682a56 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -142,13 +142,15 @@ While your Z-Wave mesh is permanently stored on your adapter, the additional met - Find the QR code. It can be on the packaging or on the device itself. 5. Depending on whether your device supports SmartStart, follow the steps in either option 1 or 2: - **Option 1: your device supports SmartStart**: + - Make sure the device is turned off. - Select **Scan QR code** and scan the QR code on your device. - **Troubleshooting**: If scanning does not work (for example due to missing HTTPS), paste the QR code content as text from a different QR reader and select **Submit**. - - Turn the device on. If it was already on, you might need to power-cycle it. - If the device supports Z-Wave Long Range, you're prompted to choose the network type. - **Long Range**: If it is far away from other devices, or that spot has had connection issues in the past. It might also help preserve battery life. - **Mesh**: If you already have a mesh network. Adding it can enhance coverage and reliability of this network. - You can always remove and pair the device again to switch to the other network type. + - Turn the device on and set it into inclusion mode. + - If it was already on, you might need to power-cycle it. - **Option 2: your device does not support SmartStart**: - Set the device in inclusion mode. Refer to the device manual to see how this is done. - If your device is included using S2 security, you may be prompted to enter a PIN number provided with your device. Often, this PIN is provided with the documentation _and_ is also printed on the device itself. For more information on secure inclusion, refer to [this section](/integrations/zwave_js/#should-i-use-secure-inclusion). From 387384eace5d71881ed38968247ca09de47c01d3 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 Date: Mon, 18 Aug 2025 10:29:13 +0200 Subject: [PATCH 3/3] Z-Wave: link to adapters --- source/_integrations/zwave_js.markdown | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index ebc1f9682a56..5d6ee917375a 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -44,6 +44,11 @@ ha_platforms: - update ha_integration_type: hub ha_zeroconf: true +related: + - docs: /docs/z-wave/controllers/ + title: Z-Wave adapters + - docs: /connect/zwa-2 + title: Home Assistant Connect ZWA-2 Z-Wave adapter --- The **Z-Wave** {% term integration %} allows you to control a Z-Wave network from Home Assistant via the [Z-Wave JS](https://zwave-js.github.io/node-zwave-js/#/) driver.