# Z-Wave JS Ul

## Prerequisite:

1. The iSG system version must be 20124 or higher.
2. You can refer to this guide for upgrading the iSG version: [iSG firmware Updates](https://kb.linknlink.com/isg/settings/firmware-updates/isg-software).
3. You need to have a Z-Wave USB dongle.
4. Use the [Serial Port Viewer](https://kb.linknlink.com/isg/using-isg/add-ons/serial-port-viewer) Add-on to view the serial port information of the Z-wave USB dongle in the system and copy its Path information.

## Instructions for Use:

**1）**Turn on the iSG, and in the left navigation bar of the iSG, find "Add-Ons" → "ZWave-JS-Ul". Then click on "Install".

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FGUcL1S2RrYGGq2HG9bkL%2F%E4%BC%81%E4%B8%9A%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20241014173514.png?alt=media&#x26;token=becbbbd5-ec31-4fe2-8d7f-c8e9b8f3dfb0" alt=""><figcaption></figcaption></figure>

**2）**&#x41;fter the installation is successful, the service is default to being disabled. If you need to enable it, click on "Enable".

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FjQD7HtmuiJ4jDEYnL4dJ%2F%E4%BC%81%E4%B8%9A%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20241014174330.png?alt=media&#x26;token=8ff32409-ec62-48e5-b1f7-1d256a1fba8f" alt=""><figcaption></figcaption></figure>

Turn on Auto Start Service. The plug-in service will be automatically started every time iSG restarts.

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FkhspI0Ws0E931aaRWJLz%2F%E4%BC%81%E4%B8%9A%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20241014174400.png?alt=media&#x26;token=6ae0d736-5e67-4074-9765-657069e29f38" alt=""><figcaption></figcaption></figure>

3）Access iSG ZWave-JS UI webpage in PC web browser by using URL shows on Add-on.&#x20;

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FBmk1l78TOhyqD9ePb5gF%2Fimage.png?alt=media&#x26;token=5948d895-193c-4218-88fe-50bd8f338a77" alt=""><figcaption></figcaption></figure>

Go to Settings - Z-wave, input the Serial Port Path copied from Serial Port Viewer add-on, and click flash button to generate all keys, then click SAVE

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2F8heEsEs3JGUtk6g15bPv%2Fimage.png?alt=media&#x26;token=e9502970-1413-447c-bb1e-76b8d52db840" alt=""><figcaption></figcaption></figure>

4\) Go to Control Panel, you should be able to see the Z-wave dongle you have added. Click the dongle infomation section to see the detail&#x20;

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FH5t4TnxpoJpfAG48AAj4%2Fimage.png?alt=media&#x26;token=c25221a6-6a46-442f-a01e-c2e940265635" alt=""><figcaption></figcaption></figure>

5\) Add Z-wave device in webpage, click right bottom manue and click manage nodes

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FHw62Cv3iSLc32oUBHKjs%2Fimage.png?alt=media&#x26;token=7f19b659-6ff7-4dd4-9b01-158a7897b62d" alt=""><figcaption></figcaption></figure>

6\) Add to Home Assistant, Go to Settings - Home Assistant, enable WS Server and keep the Serier Port 3000.

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FkKzeiMiNMQdz5kwSh0qv%2Fimage.png?alt=media&#x26;token=7f4be816-5a06-4fc6-afab-3cefed272124" alt=""><figcaption></figcaption></figure>

7\) Login to iSG built in Home Assistant, Go to Settings - Device & Services - ADD Integration, search Z-wave, Click Z-wave.

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FWzMQ3ANS2sPM0Oh373IW%2Fimage.png?alt=media&#x26;token=a92f4738-a333-4008-86ad-1914e9ee808b" alt=""><figcaption></figcaption></figure>

Input URL, ws\://127.0.0.1:3000, then submit

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FekQNo7ia1lKoyazvsO6r%2Fimage.png?alt=media&#x26;token=80c49f6d-e076-44aa-966b-2460e0a7c69e" alt=""><figcaption></figcaption></figure>

8\) You can now see the Z-wave intergration in the list

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FZvNOvQVdmrVT0PQXWSb3%2Fimage.png?alt=media&#x26;token=208cdc99-94b5-482f-bc41-50be18def4bb" alt=""><figcaption></figcaption></figure>

9\) Click Configure to add Z-wave devices

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FYytRLQQhfzEAoKckcV5e%2Fimage.png?alt=media&#x26;token=3f3a25f8-0761-487f-b256-df18fc611bd9" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FbezKJyP7hILxcNmC4OtI%2Fimage.png?alt=media&#x26;token=20a8fc53-8896-4732-8128-9702029e0ba8" alt=""><figcaption></figcaption></figure>

10\) Add Z-wace JS to Home Assistant Side bar, Click Settings - Dashboards - Add Dashboard, Input Title and choose the icon, then Creat dashboard.

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FddRhH9HEcWce4uJmWirT%2Fimage.png?alt=media&#x26;token=17b36fe8-6524-47bb-99a7-f802b0217c4e" alt=""><figcaption></figcaption></figure>

Go to Side Bar, Choose Z-wave JS, click add card, choose Webpage

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FVgUDQ8qSYI1MypSokDKo%2Fimage.png?alt=media&#x26;token=dfa9f4c9-0fb1-4c21-b01b-84e3e8da52ea" alt=""><figcaption></figcaption></figure>

Input URL, <http://Your> iSG IP:8091, sand Save

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FOiI6NqWli6ttNNwMJPVd%2Fimage.png?alt=media&#x26;token=76afc4f9-714e-4344-b77f-786cf5db9769" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FYBxZdW8s3xKEqrgTPxjC%2Fimage.png?alt=media&#x26;token=258981e9-1432-4580-b904-93dcf89b1266" alt=""><figcaption></figcaption></figure>