[RELEASE] Hank One/Four Button Scene Controller

krlaframboise · February 16, 2021, 12:48am

This is a device handler for the following devices:

Hank Z-Wave Plus One Button Scene Controller (HKZW-SCN01)
Hank Z-Wave Plus Four Button Scene Controller (HKZW-SCN04)

If you have the model with 4 buttons then you’ll need to install both DTHs below

krlaframboise/SmartThings/blob/master/devicetypes/krlaframboise/aeotec-nanomote.src/aeotec-nanomote.groovy

/**
 *  Aeotec NanoMote One/Quad v1.1.1
 *  (Models: ZWA003-A/ZWA004-A)
 *
 *  Hank Scene Controller/Hank Four-Key Scene Controller
 *  (Models: HKZW-SCN01/HKZW-SCN04)
 *
 *  Author: 
 *    Kevin LaFramboise (krlaframboise)
 *
 *  Changelog:
 *
 *    1.1.1 (09/26/2020)
 *      - Implemented single button child devices for buttons 2-4, but didn't remove those buttons from the parent device for backwards compability.
 *      - YOU MUST INSTALL MY CHILD BUTTON DTH
 *
 *    1.0.2 (03/14/2020)
 *      - Removed vid because it breaks the new mobile app.
 *
 *    1.0.1 (07/19/2019)

This file has been truncated. show original

github.com

krlaframboise/SmartThings/blob/master/devicetypes/krlaframboise/child-button.src/child-button.groovy

/**
 *  Child Button v1.0 (CHILD DEVICE)
 *
 *  Author: 
 *    Kevin LaFramboise (krlaframboise)
 *
 *  Changelog:
 *
 *    1.0 (09/26/2020)
 *      - Initial Release
 *
 *
 *  Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
 *  in compliance with the License. You may obtain a copy of the License at:
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software distributed under the License is distributed
 *  on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License
 *  for the specific language governing permissions and limitations under the License.

This file has been truncated. show original

prjct92eh2 · May 31, 2018, 2:12pm

Looks like a cool little remote

Brad_Langhorst · January 29, 2019, 4:19pm

So, I bought one of these and the driver works great. I know I can just build a piston to control what the button pushes do, but is there a recommended smart app I could use instead? I’m using the Kyse Remote Controller smartapp for my Aeon Minimotes, but it doesn’t seem to see the buttons on the Nanomote. I’m contemplating replacing all my Lutron Connected Remotes with either the Nanomote or moving those lights over to Hubitat and using Pico Remotes, so I’m hoping to run some tests with the Nanomote to see if I like it.

krlaframboise · January 31, 2019, 2:44am

You could use the built-in button controller SmartApp.

MarkTr · March 18, 2019, 12:57pm

SmartLighting also lets you link button pushes to actions (including setting one button to toggle a device on / off).

ChuckV · March 19, 2019, 4:05pm

Hi Kevin.
I’m pretty new to SmartThings. It there someplace that details step-by-step or could you walk me through it?
Thanks!

krlaframboise · March 20, 2019, 12:04am

http://thingsthataresmart.wiki/index.php?title=Using_Custom_Code#Using_a_Custom_Device_Handler

ChuckV · March 20, 2019, 12:36am

Thanks so much. Although I’ve only started and scratched the surface of SmartThings, the support of the Community is AWESOME

CV

briankr · March 23, 2019, 4:20am

I spent quite a few hours trying to get this device handler to work for a recently purchased Aeotech NanoMote Quad. I just wanted to share my experience in case it helps other users, or facilitates improvement to this device handler.

I purchased the NanoMote Quad device with the intent of using it to control lighting scenes. I attempted to use Smart Lighting to set up lighting automations, testing with both the Smarthings app, as well as the Classic app. Neither app was able to recognize the four discrete buttons on the NanoMote device as available triggers, and both apps are behaving as if there is only a single button (i.e. only one button can be assigned as a trigger in the app and pressing any button on the NanoMote device executes the single assigned action). Nothing I tried worked to change that result (including testing other Smart Apps such as CoRE).

After fumbling around IDE and both Smarthings apps for some time, I ended up trying out an Aeon WallMote hander, which seems to be working (for now) - all four buttons for both press and hold actions show up as available triggers in both Smart Lighting and CoRE. ([[RELEASE] Aeon WallMote Dual & Quad - 2 & 4 Button]). I’m not sure if this is a permanent solution though.

Appreciate any feedback if I’ve not set this device handler up properly. I would prefer to us this handler specifically written for the Nanomote if I can get it to work!

krlaframboise · March 23, 2019, 7:09am

Was the custom handler installed before joining the device? If so, did you verify that ST assigned it this handler?

Tap the refresh tile, wake the device up, wait about 30 seconds and then open the device in the IDE and check to see if numberOfButtons shows 1 or 4.

If that doesn’t fix it then open live logging, push each button about 10 seconds apart, and post the live logging results. You should also post the device’s raw description which is shown in the IDE.

I wrote the handler last May using a beta version of the device so it’s possible they changed something in the firmware. If you’re still having problems and I’m unable to figure it out with the information I requested above then I’ll try to get a hold of the latest model or at least the latest firmware for it.

briankr · March 26, 2019, 2:10am

Kevin,

Thanks for the prompt reply. I originally added the device before adding the handler. I then added the handler in IDE and edited the device to select the correct handler.

That said, after switching to the WallMote handler and then now switching back to your NanoMote handler to troubleshoot further per your feedback, numberOfButtons has updated to 4 and I am now able to assign actions to each button individually. I have tested assigning a few different actions to press and hold events for the different buttons and it seems to be working well!

Thanks again for your reply and I really appreciate your contribution with this device handler.

Brian

George_Pinkosky · April 4, 2019, 1:21am

Kevin,
My Quad is not working. I have installed the device handler and the app.
The device type is “Aeotec NanoMote”

[4d0844bb-0ce4-423a-a464-bd9956678afc]8:16:23 PM: debug Button 4 pushed

[4d0844bb-0ce4-423a-a464-bd9956678afc] 8:16:13 PM: debug Button 3 pushed

[4d0844bb-0ce4-423a-a464-bd9956678afc 8:16:04 PM: debug Button 2 pushed

[4d0844bb-0ce4-423a-a464-bd9956678afc] 8:15:58 PM: debug Button 1 pushed

Above is what I got from live logging.

[lastCheckIn]: 04/03/2019 08:16:23 PM
[lastAction]: PUSHED 4|

Thanks for any help

krlaframboise · April 4, 2019, 2:34am

The log shows that it’s detecting button pushes so what isn’t working?

George_Pinkosky · April 4, 2019, 1:48pm

It is showing only a single rectangular panel saying Button with a circle in the middle and Standby under the circle.
When I go to custom automation, it only shows pressed and held.

My guess is:
It appear the SmartThings App is showing the SmartThings Button graphics.

krlaframboise · April 4, 2019, 2:25pm

The issue is usually one of these things:

If you added the handler after joining the device you need to manually change the type to the custom handler and wake up the device up so that it set the numberOfButtons attribute to 4.

The new mobile app doesn’t support custom handlers so I have very little control over how that app displays things and you’ll most likely need to use the Classic app to see the button status. In theory, it should work as expected in the new mobile application’s apps, but I haven’t tested that.

George_Pinkosky · April 4, 2019, 4:10pm

I added the device after adding the custom handler and it the IDE display it correct.
So the issue is the new SmartThings app, I do not use the Classic app.

Thank you.

prjct92eh2 · April 4, 2019, 4:18pm

The custom device creator in the new app doesn’t current work with multi-button devices. They’re supposed to be making some changes to the new app the handle multi component devices some time soon i think.

OldPro · April 14, 2019, 11:27pm

@ krlaframboise Kevin, thanks for your great work on the Aeotec NanoMote scene controller DTH. I bought one and got it running right away (call it NanoMote #1). I’m using press of Button 1 to set a “Watch TV” routine and hold of Button 1 to restore lighting after done watching TV.

I bought two more NanoMotes for our master bedroom nightstands to toggle the nightstand lights on and off. I just installed NanoMote #2 and I expected to see a list of two NanoMotes on the main “Button Controller” page and was pulling my hair out because I couldn’t see the new one. I FINALLY spotted the tiny arrow to the right of the “Button” label and the instruction “First, select your button device.” I think the UI would be better and more intuitive if you had a list of the button devices on your home screen.

Here’s my problem. I set up NanoMote #2 using the same DTH as I used for NanoMote #1. I set up Button 4 to toggle my nightstand light on and off. Then I noticed that the buttons I had configured for NanoMote #1 were now defined for NanoMote #2.

I need to have completely different button control configuration on NanoMote #2. Likewise, NanoMote #3 will be a slightly different button configuration from #2. On NanoMote #2, button 4 will toggle my nightstand light on/off. On NanoMote #3, button 4 will toggle my wife’s nightstand light on/off.

How can I do this? Do I need to install the Button Controller DTH three times?

Thanks again! You made the hardware product useful with the SmartThings hub. You have to wonder why Aeotec itself didn’t do this.

krlaframboise · April 15, 2019, 11:41am

OldPro:

@ krlaframboise Kevin, thanks for your great work on the Aeotec NanoMote scene controller DTH. I bought one and got it running right away (call it NanoMote #1). I’m using press of Button 1 to set a “Watch TV” routine and hold of Button 1 to restore lighting after done watching TV.

I bought two more NanoMotes for our master bedroom nightstands to toggle the nightstand lights on and off. I just installed NanoMote #2 and I expected to see a list of two NanoMotes on the main “Button Controller” page and was pulling my hair out because I couldn’t see the new one. I FINALLY spotted the tiny arrow to the right of the “Button” label and the instruction “First, select your button device.” I think the UI would be better and more intuitive if you had a list of the button devices on your home screen.

Here’s my problem. I set up NanoMote #2 using the same DTH as I used for NanoMote #1. I set up Button 4 to toggle my nightstand light on and off. Then I noticed that the buttons I had configured for NanoMote #1 were now defined for NanoMote #2.

I need to have completely different button control configuration on NanoMote #2. Likewise, NanoMote #3 will be a slightly different button configuration from #2. On NanoMote #2, button 4 will toggle my nightstand light on/off. On NanoMote #3, button 4 will toggle my wife’s nightstand light on/off.

How can I do this? Do I need to install the Button Controller DTH three times?

Thanks again! You made the hardware product useful with the SmartThings hub. You have to wonder why Aeotec itself didn’t do this.

If you’ve joined 3 Nano Motes then you should see 3 devices listed in your device list.

Use the Button Controller SmartApp to set actions for the buttons of each device. I’m not sure if that app is available in the new mobile app so you might have to use the Classic mobile app.

OldPro · April 15, 2019, 2:36pm

Thanks. I am using the classic app. I have never upgraded to the new app. When I went to set up my second NanoMote device yesterday, it showed the same button configuration as my first, already-configured NanoMote device.

[RELEASE] Hank One/Four Button Scene Controller

Customers

Developers

Download the SmartThings App