Switching from Zwave 1.4 (Deprecated) to Zwave JS

petro · February 4, 2021, 2:15pm

This guide is for switching from Zwave 1.4 to Zwave JS.

Preparation

In home assistant.

Browse to Developer Tools.
Click on the template tab

Paste the following code into the template section.

{%- for node, zstates in states | selectattr('attributes.node_id', 'in', range(1000)) | groupby('attributes.node_id') %}
{{ node }}:
  {%- for s in zstates %}
  - {{ s.name }}
    {{ s.entity_id }}
  {% endfor %}
{%- endfor %}

Copy the results and paste them to a text file for safe keeping. You’ll reference this at a later time.

Migration

Locate your device and network_key. If you don’t already know them, they will be in a hidden file within your configuration folder.

device - This is the path for the USB Stick
network_key - This is the key used when adding a secure node.

1.1 Browse to /config/.storage/
1.2 Open core.config_entries with a text editor.
1.3 Search for Zwave in the file.
1.4 Inside that section will be a path to a usb device and a key. The usb device will look something like /dev/ttyACM0 or /dev/serial/by-id/usb-<bunch of numbers>. The key will have the format 0xD3, 0x05, 0x0A, etc.
Save the device and network_key to a text file for later use.
Remove Zwave 1.4 from HA.

This requires you to delete it from the integrations in the UI

or

Delete it from configuration.yamlThis of course depends on how you integrated it.
Reboot your entire system.

These steps are needed because the zwave 1.4 is tightly integrated with home assistant. Without restarting the hardware, home assistant keeps holding on to the zstick.
Install Zwave JS addon.
Add the copied device and network_key from the .storage files into the Zwave JS configuration. Remove the 0x’s and the commas and spaces from the network key, so 0x1A, 0x23, 0x5D becomes 1A235D.

image926×131 2.28 KB
Watch the logs and wait for it to fully start up.
Fix all ‘unknown’ devices by waking them up. No need for a refresh node, just wake them up.
Install Zwave JS integration and see what you have.

(optional but this is what I did)

7.1. Delete Zwave JS integration (I did this because names were unknown in HA still)
7.2. Restarted Zwave JS after waking all devices.
7.3. Install Zwave Js Integration and see what you have.
7.4. Go to Step 7.1 if things aren’t where you want them.
Rename Devices using the text file as a reference from the Preparation #4 step. This is the most time consuming step

image1605×362 25.8 KB

image1075×541 37.5 KB

image639×505 23 KB

image639×505 22.8 KB

brotherseb · February 5, 2021, 8:53am

Hello !

For those (like me) who did not set a network_key, you can get the generated one in the file /config/.storage/core.config_entries

Hope it can help…

taylen321 · February 6, 2021, 12:50am

Can anyone tell me what format the network key needs to be in for the zwave js server addon? The original ozw format of 0x or is it like zwave js to mqtt where it’s just the 32 bits?

finity · February 6, 2021, 1:18am

I’m pretty sure I saw in one of the github discussions it can be either format.

Apparently, the zwave js add-on converts the key to the correct format for you either way you enter it.

try it and see?

toddtmw · February 6, 2021, 1:40am

Where do I get the device?

taylen321 · February 6, 2021, 1:52am

Well that would make sense because they both seemed to work! But the interface right now doesn’t show any status for the connection being secure or not so I wasn’t sure

vpa · February 6, 2021, 1:16pm

Didn’t helped me. Where to find device and network key? Not found in string from template. No path /config/.storage from the 1st reply. This guide is not working.
I found from information in system, that my device path is maybe /dev/ttyACM1, it shows an error in next step. But it looks that is working.

petro · February 6, 2021, 3:57pm

It’s in your current zwave configuration. I haven’t used v1.4 in years, I was hoping people who use it would update the guide.

toddtmw · February 6, 2021, 4:03pm

How do you wake them up?

petro · February 6, 2021, 4:06pm

depends on the device. Consult the device manual and find out how to wake it up.

Most devices have a periodic wake scheduled so in time they will show up.

toddtmw · February 6, 2021, 4:07pm

Okay. @brotherseb is right on the location of the file where you can get the values you need. Keep in mind, that this starts in /config, not the config that you are used to playing in when editing yaml files.

Once you get that open, you are looking for network_key and usb_path

So:

cat /config/.storage/core.config_entries | grep network_key
cat /config/.storage/core.config_entries | grep usb_path

Should return the two values that you need to enter in the config section when you install the add-on.

miked · February 6, 2021, 4:08pm

The path is hidden but you should still be able to open it in an editor if you type the path into the editor.
For me I found the following

        "domain": "zwave",
                "title": "Z-Wave",
                "data": {
                    "network_key": "0xA5, 0xD8, 0x64, ....
                    "usb_path": "/dev/ttyAMA0"
                },

Now you need to convert 0xA5, 0xD8… to A5D8…

Hope this helps.

toddtmw · February 6, 2021, 4:12pm

Thank you. How do I tell which devices are unknown?

Sorry. I’m trying to learn and add what I learn here.

toddtmw · February 6, 2021, 4:12pm

I didn’t translate and just pasted it as-is.

petro · February 6, 2021, 4:15pm

They’ll show up as unknown in your device list.

You don’t need to. It accepts both methods.

toddtmw · February 6, 2021, 4:18pm

But, I cannot get the device list until I install the integration, correct? (again, want to make sure I am doing things in the right order…)

petro · February 6, 2021, 4:20pm

Correct, which is why I wrote steps 7.1 to 7.4, it’s a cyclical process. Either way, you should be watching the logs on first startup. If you’re having issues because the current zwave_js implementation is lacking, then I suggest you try the ZwaveJS2MQTT route as it has a nice UI. You’ll end up in the exact same position but you’ll see a list of devices prior to adding the integration.

toddtmw · February 6, 2021, 4:25pm

I don’t suppose there is an easy way to tell which device is which without going around and flipping them off an on with the app to tell which is which? (IOW, in 1.4, the exported stuff was by Node xx, but most of the things in zwavejs says in-wall smart dimmer or things like that.

Thank you.

petro · February 6, 2021, 4:26pm

If you performed the preparation steps, it would have made a list of your current network based on the node ID. Then in the integration, click on a device and it’ll list a node_id at the top

toddtmw · February 6, 2021, 4:31pm

Perfect! Thank you.

Switching from Zwave 1.4 (Deprecated) to Zwave JS

Preparation

Migration

(optional but this is what I did)