jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-18 14:56:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

Z-Wave: update procedure on adding device (#34721)

Browse Source 
* Z-Wave: update procedure on adding device

* Fix terminology

* Emphasize that step 7 is a troubleshooting step

* clarify step on turning on the device
This commit is contained in:
c0ffeeca7 2024-09-16 08:26:56 +02:00 committed by GitHub
parent 89430762aa
commit bf5c0d69b0
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 13 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
source/_integrations/zwave_js.markdown
View File

@ -134,17 +134,25 @@ While your Z-Wave mesh is permanently stored on your dongle, the additional meta
2. Select the Z-Wave integration. Then select **Configure**. 2. Select the Z-Wave integration. Then select **Configure**.
3. Select **Add device**. 3. Select **Add device**.
- The Z-Wave controller is now in inclusion mode. - The Z-Wave controller is now in inclusion mode.
4. If your device supports SmartStart (700 series controller), select **Scan QR code** and scan the QR code on your device. 4. Check, if your device supports SmartStart:
5. If your device does not support SmartStart, set the device in inclusion mode. Refer to the device manual to see how this is done. - On the packaging, check for the SmartStart label.
- 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**:
- 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**.
- Turn the device on. 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). - 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).
6. The UI should confirm that the device was added. After a short while (seconds to minutes), the entities should also be created. 6. The UI should confirm that the device was added. After a short while (seconds to minutes), the entities should also be created.
7. If the controller fails to add/find your device, cancel the inclusion process. 7. **Troubleshooting**: If the controller fails to add/find your device, cancel the inclusion process.
- In some cases, it might help to first [remove](/integrations/zwave_js/#removing-a-device-from-the-z-wave-network) a device (exclusion) before you add it, even when the device has not been added to this Z-Wave network yet. - In some cases, it might help to first [remove](/integrations/zwave_js/#removing-a-device-from-the-z-wave-network) a device (exclusion) before you add it, even when the device has not been added to this Z-Wave network yet.
- Another approach would be to factory reset the device. Refer to the device manual to see how this is done. - Another approach would be to factory reset the device. Refer to the device manual to see how this is done.
**Important:** **Important:**
1. **Do not move your Z-Wave stick to include devices.** This is no longer necessary and leads to broken routes. 1. **Do not move your Z-Wave stick to include devices.** Moving the controller is no longer necessary and leads to broken routes.
2. **Do not initiate device inclusion from the Z-Wave stick itself.** This is no longer supported. 2. **Do not initiate device inclusion from the Z-Wave stick itself.** This is no longer supported.
### Removing a device from the Z-Wave network ### Removing a device from the Z-Wave network