Please help me understand zwave lock inclusion/exclusion and secure install

[muellercandd (Lee Mueller)]

I bought a kwickset lock with 914TRL. I am using the zwave 2.4 binding and an aeotec zstick. On my first attempt I succesfully included the lock, it showed up under things in Paper UI. I quickly found that I could not controle it through my sitemap. I did some looking around and found a few things. I will share my understanding and I bope someone can help me fully understans.

I found the very long artical written Chris Jackson, sorry if this is the wrong auther, which explains that locks need to be secure included and to use habmin to do so. I looked in habmin and found that my lick was not secur included. I did the intial setup with paper ui and it was identified as node 2. I excluded the device and included it based on manufacturer instruction. Habmin found it as node4 but does not give any info, state that the binding may need to finish the install. Concerned I did it wrong I excluded and included it again, used habmin and got the sam results. No info for the device, just states it is node5.

So my questions are;
Does the lock need secure included with the zwave 2.4 binding?
Is habmin the way to do this?
Why is the latest inclusion not brining in the all of the lock info?
Is there a way to change the node value? I would like to keep the sequential rather than skipping node 3, 4 and 5 if I need to exclude and include again.

I hope I have provided enough info to answer my questions. If not let me know and I will try and get what you need.

Thanks

[sihui]

@muellercandd

Does the lock need secure included with the zwave 2.4 binding?

Yes.

@muellercandd

Is habmin the way to do this?

Yes. And the stick needs to be attached to the openHAB server, don’t use the pushbutton on the stick if any.

@muellercandd

Why is the latest inclusion not brining in the all of the lock info?

Between exclusion and re-inclusion you need to factory reset the device.

@muellercandd

Is there a way to change the node value?

No.

[muellercandd (Lee Mueller)]

Thanks for the response, the zstick does have a button to push and is the only way I know how to perform the inclusion. Could you elaberate on this or point me to a wright up on how to do this?

[sihui]

@muellercandd

Could you elaberate on this

Go to PaperUI or HABmin, go to your Inbox (Things in HABmin), click on the plus sign, choose the zwave binding, inclusion starts.
For secure devices you have 15 seconds max to press the inclusion button on your device.

[muellercandd (Lee Mueller)]

I will give it a try whe I get home, thanks. Is distace an issue?

[sihui]

@muellercandd

Is distace an issue

Only with some older devices.

[muellercandd (Lee Mueller)]

I have successfully included the the lock through habmin as described, but it still shows that “Using security” with the red x

What am I missing?

[muellercandd (Lee Mueller)]

I got it, I don’t think I was excluding it properly because it continued to add the same node5 value each time I included it. Now it reads node6 and has the Using security with the green check. Now to see if I can get my code, or do is it called script here, correct.

[muellercandd (Lee Mueller)]

I have gotten some of this to work. I can lock and unlock through both HABmin and Control under PaperUI.

I created these items:

Switch Z_Wave_Front_Door_Lock “Front Door Lock” [“Switchable”] { channel=“zwave:device:Zstick:node6:lock_door” }

Number Z_Wave_Front_Door_Lock “Battery [%.0f%%]” { channel=“zwave:device:Zstick:node6:battery-level” }

And a Sitmap:
Switch item=Z_Wave_Front_Door_Lock

It gives a basic ui that looks like this;

I can not control the lock from basicUI and the locked unlocked does not seam to change. I have read some posts about map transformation. Is this something I need to do to control the lock or am I missing something else. Please elaborate with the response as I am not understanding what the next steps are.

Sorry for the way the code pasted, I am not sure how others are doing it so nicely.

[mhilbush (Mark)]

Switch Z_Wave_Front_Door_Lock “Front Door Lock” [“Switchable”] { channel=“zwave:device:Zstick:node6:lock_door” }

Number Z_Wave_Front_Door_Lock “Battery [%.0f%%]” { channel=“zwave:device:Zstick:node6:battery-level” }

Your items need to have different names.

Switch Z_Wave_Front_Door_Lock “Front Door Lock” [“Switchable”] { channel=“zwave:device:Zstick:node6:lock_door” }

Number Z_Wave_Front_Door_Lock_Battery “Battery [%.0f%%]” { channel=“zwave:device:Zstick:node6:battery-level” }

@muellercandd

Sorry for the way the code pasted, I am not sure how others are doing it so nicely.

How to use code fences

We all have to type this content over and over and over. Here is a posting we can all point to when the topic comes up. Why use code fences? Because rules, sitemap, logs, and configs are all but unreadable when code fences are not used. When to use code fences? Whenever one is posting any sort of code, config, log, and any text where line wrapping, indentation, and using an equal spaced font makes the text more legible. How to use code fences? Use 3 backticks (```)... Or use <code>... …

[jswim788 (John Schmitz)]

With Chrome there is some white space in the reply header which is where many of the “fences” are hiding. The “item fences” is visible just to left of that white space, but all of the others are not visible (rules, sitemap, javascript, code). You can hover your mouse in that area to find them and to use them. Just click on them even though they are not visible.

[muellercandd (Lee Mueller)]

Thank you for all the responses, I have door lock that I can control for BasicUI but something strange has happened. I seam to have a duplicate lock and not sure how it got there or how to fix it. Both seem to operate the lock but only one updates at a time.

Here are my items

Switch Z_Wave_Front_Door_Lock "Front Door Lock" ["Switchable"] { channel="zwave$
Number Z_Wave_Front_Door_Lock_Battery "Battery [%.0f%%]" <battery> { channel="z$

And here is my sitemap

Switch item=Z_Wave_Front_Door_Lock

Text item=Z_Wave_Front_Door_Lock_Battery label="Front Door"

And my BasicUI

Does it matter that this duplication of the lock and battery show up in HABmin? If so what caused it and how do I fix it?

[mhilbush (Mark)]

Do you have Simple Mode enabled? Check in Paper UI under System->Configuration on the Item Linking panel.

[muellercandd (Lee Mueller)]

Simple mode is enabled, yes.

[mhilbush (Mark)]

Simple mode will create items automatically. That explains where those other items are coming from. If you don’t want those items created automatically, you can disable simple mode.

[muellercandd (Lee Mueller)]

Will having both items in HABmin and only one physical item cause problems? It seams to function fine for now. Is it possible to remove the item that was automatcly populated?

[mhilbush (Mark)]

@muellercandd

Will having both items in HABmin and only one physical item cause problems? It seams to function fine for now.

No, it won’t cause a problem.

@muellercandd

Is it possible to remove the item that was automatcly populated?

I don’t know. I’ve never used this feature.

[muellercandd (Lee Mueller)]

Thank you evrryone for the help. The lock is working as I had hoped!

[muellercandd (Lee Mueller)]

So… The lock works almost as expected. It does not update openhab when manually locked or unlocked. Looking into it shows that I need to some coding with the Alarm_raw. This also means that I need to use a transform.
I have been following the wright up, but do not fully under stand:

Zwave - Yale YRD220 Lock

Here is my current rule for parsing alarm_raw. My locks (Schlage BE469) do not update the lock_door channel, so I use alarm_raw to update the items linked to lock_door, and base rules off of that item’s state. Maybe all locks behave this way? You’ll find several examples of using the JSONPATH transform to parse the data in the lambda. This can be tricky though, because JSONPATH will throw an exception if the element name you are searching for does not exist in the JSON. I haven’t had any issues…

I have used PaperUI to install JSONPATH and MAP Transformation. I am confused by what the: MAP (lock.map) is and what I need to do to create it.
I have create an Item that looks like this

Group:Switch:OR(OFF,ON)    gLock    "Locks [MAP(lock.map):%s]"    <lock>
Group    gLockRaw    "Locks (raw) [%s]"    <lock>
Switch    Z_Wave_Front_Door_Lock    "Lock (Front Entrance) [MAP(lock.map):%s]"    <lock>    (gLock)    {channel="zwave:device:Zstick:node6:lock_door"}
String 	  Z_Wave_Front_Door_Lock_Alarm_Raw    "Lock (Front Entrance): Alarm Raw [%s]"    <shield>    (gLockRaw)    {channel="zwave:device:Zstick:node6:alarm_raw"}

The wright up also talks about an import org.eclipse.smarthome.model.script.ScriptServiceUtil being at the top the rules. Does this mean the to of all the rules or the top of my lock rules? What is this import, why do I need it and how do I get it?
Also I have a list of alrarm_raw events, but I do not know where to place them.

And always, any help or advise is appreciated.

[5iver (Scott Rushworth)]

@muellercandd

I am confused by what the: MAP (lock.map) is and what I need to do to create it.

Create a file in your ${OPENHAB_CONF} (depends on how you installed OH) named lock.map and put in the contents from my post.

@muellercandd

The wright up also talks about an import org.eclipse.smarthome.model.script.ScriptServiceUtil being at the top the rules. Does this mean the to of all the rules or the top of my lock rules? What is this import, why do I need it and how do I get it?

You don’t need to get it… just import it at the top of the rule file (above all rules).

[Rules DSL] Get item from string name!

For a couple years now, I’ve been wanting/looking for a way to construct an item from its name as a string. There are other ways to do this, and the most popular requires the item to be in a group, which can have it’s challenges. I’ll keep this short and SWEET… I finally figured it out, and it is extremely simple! For OH 2.x, you’ll need this import… import org.eclipse.smarthome.model.script.ScriptServiceUtil For OH 3.x, this import instead… import org.openhab.core.model.script.ScriptService…

@muellercandd

Also I have a list of alrarm_raw events, but I do not know where to place them.

Those are just for reference. You lock may report something different, so you’ll need to change the lambda.

I typed quick… hopefully this is what you need!