Help with setting up Z-Stick 10 Pro with firmware 7.23 on OH 5.1.0

Background:I run two OpenHAB servers — one on OH 2.5.12 and one on OH 5.1.0. The OH 2.5.12 server is using an Aeotec Z-Stick Gen5 as the primary Z‑Wave controller (SIS Node = 1) and has worked fine for years. I want to add an Aeotec Z-Stick 10 Pro to the OH 5.1.0 server and have both Z‑Wave controllers active simultaneously, but I’m unsure how to configure the new stick correctly.

What I’ve done so far: I followed the steps in this thread: https://community.openhab.org/t/zwave-z-stick-sdk-issue-with-oh-z-wave-binding/161582 and received the expected responses. I’m not sure what to do next or how to finish the setup. Please advise. Thank you!

Edit: If possible, for now, I would like to have the Aeotec Z-Stick Gen5 remained as the primary Z‑Wave controller on OH 2.5.12

For OH5.x there was a fix in the ZW binding at startup, so the fix was not needed anymore.

Anyway, one possibility (and what I have done between OH instances) is to use the remote OH binding to bring in the items to OH5.1. All my rules run on one OH instance and all the charts, etc. are there too. The remote OH (OH 2.5.12 in your case) just runs ZW. I have done this to optimize direct connections between controllers and nodes. (ie I have a basement location (21 nodes) and an upstairs (36 nodes) network. Don’t know if that fits your goals.

@apella12 Hi Bob, thanks for the suggestion. A bit more detail:

I have a Home Connect 620 Z-Wave Long Range smart lock ( https://community.openhab.org/t/recommendations-for-usb-z-wave-lr-and-optional-zigbee-sticks-for-openhab-5-on-raspberry-pi-5/167666) which is NOT recognized by the OLD OH 2.5.12. I tried but failed to add the lock into the OHzwave binding.

That’s why I bought the Aeotec Z‑Stick 10 Pro for my OH 5.1.0 server — I hoped it would detect the 620 lock immediately, but it hasn’t. I suspect the existing active Z‑Wave network may be causing the issue, but my Z‑Wave knowledge is minimal. I’m stuck and would appreciate any help or suggestions from you or others on the forum.

Devices need to have their MFG, type and ID in the ZW DB what message are you getting (or post the XML from the ZW folder)

@apella12 Yes the lock is in the data base https://opensmarthouse.org/zwavedatabase/1513

However, I’m not sure what you mean by

Don’t know if this helps but I also have tried this procedure many hours on OH 2.5.12 without success and gave up :cry:

Thank you.

Not sure I understand. To be clear the XML on your OH system is not the XML needed to make the device recognized.

I’d like to check the DB for your device, just to make sure we are on the same page. Do you have a message like this node x (0090:0811:xxxx::x.x)? or paste the contents of the property dropdown on the node UI page.

@apella12 Bob, I think I will need baby-step instructions from you. I apologize for the following dumb questions:

  1. Which OH system (2.5.12 or 5.1.0)?

  2. Where do I find “a message like this node x (0090:0811:xxxx::x.x)?” Is it in openhab.log? events.log?

  3. Is this called “the node UI page”? This image is from OH 2.5.12. Node 016 is the 620 lock

    Thank you!

We agree on baby steps. My concern is the device is NOT in the ZW DB. If that is true, everything done so far was a (painful?) learning experience. Devices are recognized by the numbers (in hex), not the model information and I copied the node x message directly from the docs. It is also on your screen shot under the orange bar. Numbers might be covered up by the orange bar. This post is background. I want to confirm the numbers before doing anything else.

One thing to try to get these numbers (since I do not see them in your screenshot). On OH5 with the 10 Pro, put the ZW binding in Debug mode (UI setting page on the right), then put the controller in exclude mode from it’s UI page and press the EXCLUDE sequence from the lock manual. If the log shows that was a success, then go to inbox, zwave, scan while pressing the INCLUDE sequence from the manual. There should be the needed numbers in the debug log

I have one of these. Set up was no problem. Install the zwave and the zigbee binding, the protocols use different ports so you have to set them up as so. The zigbee bridge you should use is ‘ember’ then just pair everything as normal using the ‘scan’ button.

@apella12 Hi Bob, is this the information you need?

Edit to add that there is NO “Exclude Device” in my controller’s Actions

Yes, assume that screen is from OH5 inclusion? There was a bug in 5.1.0 about the exclude, but it looks like the lock is included. The exclude was to make sure it wasn’t still paired with the 2.5. Anyway the device is not in the Db, will need to update. I can get you a file, but maybe not today

@apella12 Yes — that screenshot was from OH 5.1.0.

The lock was paired with OH 2.5 (Aeotec Z-Stick Gen5). I didn’t realize I needed to exclude it; I assumed deleting/removing Thing was sufficient.

Thanks very much for your patience and help.

Ok, this has the type:ID from your device. Everything else is unchanged from what is in the DB.

ks620_0_0.xml (6.1 KB)

It will need to be added using the procedure. You may be able to use a compressed file editor, like the last post of the reference.

I don’t think the lock got fully included in OH2.5 since the numbers were not in your screen shot, but excluding is always a good idea with failed inclusions. If you upgrade to the 5.1.1 patch release the exclude button will reappear in case you need it. (but shouldn’t). Also: If you are going to upgrade, do it before you update the jar. The OH upgrade will wipe the jar fix and you will need to do it again. The ZWDB will be updated in a stable 5.2 around June.

That gets it out of OH, but the device is still on the Z-stick and can be only paired with one zstick at a time.

@apella12 Thank you so much for the file. I followed the procedure. Everything went fine except the last step. I ran into a permission denied error

Hope this is an easy fix. So close!

Linux permissions are not my strong suit. I presume that the owner of the jar modify file is openhabian, but openhab itself runs under user openhab.

Rather than guess, the other option that should work is to remove the current ZW binding from the UI (store), and drop the modified jar in addons. You may have to run feature:install openhab-transport-serial in the console. (It is a dependency). Although more complicated, the advantage is that it should survive OH upgrades.

@apella12 Good news — after placing the modified JAR in /usr/share/openhab/addons, the Thing Type now appears as “Kwikset 620 Deadbolt variant.” and the Channels showed up.

I did need to tweak your XML: I replaced the semicolon with a colon. See below.

Also I did NOT have to “run feature:install openhab-transport-serial in the console.”

Thank you for everything!

1 Like

Good catch. It wouldn’t have worked and would be hard to find.

@apella12 Hi Bob, for some reason the Kwikset 620’s Alarm (raw) channel remains NULL. Do you have any idea why? Without the data, I don’t think I can write any rules.

The Door_Lock channel also acts weird in the Items UI:

  1. When I set the switch to OFF, the 620 unlocks, but the switch immediately flips back to ON while the 620 stays unlocked.
  2. To lock it, I set the switch to OFF (it remains OFF), then set it to ON. The 620 locks, but the switch immediately returns to OFF.

I’m not sure what’s happening. I’m considering returning this lock and getting a Schlage BE469, which I’ve had good results with.

I have no locks, so nothing to compare. What I would do is delete the thing, do not exclude, and then scan to pick up again. Everything should be preserved and maybe better.