July 15, 2016 18 Comments
For those of us interested in home automation, this might be a familiar scenario: You’ve bought that new 4-in-1 sensor you’ve wanted for a while, and rush to unwrap the package like a kid on Christmas Day. Then you insert the batteries and make your way to your SmartThings hub to include it into your network. And then the disappoint descends: it’s a sensor that’s new on the market, and it’s more complicated to integrate it than a simple on/off device. It will probably take a while before SmartThings provides official support for it. So how do you include a Z-Wave device to your hub if it's not on the list?
This is where custom device handlers come in: community members will often develop their own code to be able to use new devices with SmartThings. They usually publish them on development platforms like GitHub and then post a link to the code on the SmartThings forum. But they don’t always include instructions on how to install the custom device handler and assign it to the device. The average user may think it’s a complicated process, when in fact it’s quite simple!
Here are some instructions that should help you get a custom device handler (i.e. that awesome new device of yours!) to work in SmartThings. I’ll be taking the Zooz 4-in-1 Sensor as an example, but this process will work for any device that needs a custom handler (you’ll just need to use a different link for the right code).
1. Log in here with the same username and password you use for your SmartThings app: https://consigliere-regional.api.smartthings.com
2. Click on My Device Handlers in the top menu
3. In the top right corner, click on Create new device handler and choose From code from the top tab menu. You'll be presented with a blank area where you can copy the code from this link and paste it in (it's always best to use the raw version of the code)
4. Next, scroll to the bottom and click Create. Now click Save, then click Publish > for me.
You should now see this device type in your list of Device Handlers
Simply exclude the device if you had included it prior to installing the new device handler. Then add the device to your SmartThings hub by clicking on Add thing > + Connect New Device in your app. Press and release the Z-Wave button on the sensor twice quickly.
Remember to keep the device within 3 feet away from your hub during inclusion — the device should be automatically discovered as the Zooz 4-in-1 sensor. Then, leave the sensor by the hub for a few hours so it can fully configure.
And that should be it! I hope this was helpful in simplifying the process behind custom device handlers. Feel free to share your questions and feedback in the comment section below!
September 05, 2017
Hi Deepak,
There may be a few reasons why the device isn’t recognized correctly. Either the handler was not published in the right place or the device had been included before you published the handler or there’s another configuration issue at play. Please get in touch with our support so they can go through different troubleshooting options with you and help you solve the problem. Thanks!
September 05, 2017
Hi guys,same here as Dan. It discovers the device as generic and not as a zooz one..am i missing something in settings?
August 15, 2017
Hi Mike, did you try waking the sensor up manually by clicking on the Z-Wave button 3 times quickly after you made the change in the settings? If not, the change hasn’t been registered by the sensor yet.
August 15, 2017
I installed a second z-wave 4 in 1 and this handler was already installed and everything seems to work properly except the LED option. I have it set to 1 (for no LED) but it is still flashing red every few minutes. My other 4 in 1 (identical) does not flash. Any thoughts?
March 14, 2017
Hi Dan, we’re glad to hear you were able to make it work. Between the 2 different URL’s, it can be kind of confusing. We always recommend to start with checking if your sensors and switches are listed under My Devices first – if they’re not there, it means you need to log in using the alternative URL to install the handler in: https://graph-na02-useast1.api.smartthings.com
March 12, 2017
Nevermind, I find out now that ST’s shards aren’t all properly tied together… I had to be sure I was in the right shard.
March 11, 2017
So I follow these instructions exactly but when it finds the device it STILL just thinks it’s a generic z-wave sensor device. The Zooz name does not appear in the “found devices” list. I have tried this with three (3) versions of ZSE40 device handler code I found out there. I see them all in my device handlers list but they don’t seem to make any difference. Thoughts??
November 29, 2024
Home Assistant is slowly but surely becoming the ultimate platform for comprehensive home automation. It allows users to create a truly customized and connected environment with the most integrations we've ever seen. Home Assistant has a pretty powerful automation engine too so you can program anything from simple lighting control to complex, multi-device routines. And it's open source which means we can all contribute and the basic software is free.
The secret to making your Home Assistant set-up better than ever? Add Z-Wave to it! You can instantly increase the functionality, reliability, and device compatibility of your smart home environment. Z-Wave brings a vast range of new device options that can communicate securely and consistently. They are feature rich with tons of advanced settings to choose from so you can find a good match for any use case.
October 22, 2024
In today’s highly competitive alarm business, offering security alone is no longer enough. Customers are increasingly expecting more – they want smart security solutions that work seamlessly with their modern lifestyles. The great news for your business? If you already install alarm panels, there’s a good chance they come equipped with Z-Wave technology, a straightforward entry point to home automation.
Z-Wave is a robust wireless protocol that enables a wide array of smart home services, allowing you to move beyond the traditional boundaries of alarm systems and tap into the expanding market of home automation. By leveraging the already included Z-Wave protocol, you can offer your customers centralized control over lighting, thermostats, door locks, and much more – all from the convenience of their existing alarm panel. This not only enhances the value you deliver but also sets your business apart as an innovator in the security space.
September 26, 2024
Caring for aging parents or loved ones with limited independence is a journey filled with both emotional rewards and practical challenges. The emotional toll of balancing this responsibility with other aspects of life can be overwhelming. We want to share some helpful shortcuts from our field of expertise: smart home technology.
You'd be surprised how an inexpensive and simple system like a hub and a few connected devices can change your daily routine. With the guide below, we will help you create a supportive, secure environment tailored to your loved one’s needs, all while reducing the constant worry that comes with caregiving.
Lionel
September 24, 2017
Hello,
thanks for the instructions, I added the device handler on both
https://graph-na04-useast2.api.smartthings.com
https://graph-na02-useast1.api.smartthings.com
I have 2 ZooZ but they don’t get detected when I do Add Thing.
There is a tiny switch inside the device, I tried to press once, twice, thrice, quick/slow, hold…, the Zooz blinks green once and that’s all.
I don’t know what to do now.
Thanks for tips!
Lionel