Creating a device handler

[radiocolin (Colin Weir)]

I have some off-brand motion and door sensors I’ve been using. They work great, but they get added as “Thing” and I have to change them manually in the graph to Smart Sense Motion/Open-Close.

How can I create a device handler so these are automatically added as the appropriate type?

[JDRoberts]

Here’s the long answer

"Device Handler for Dummies"? Any suggestions for a newbie? [Groovy/Classic App Edition, 2017]

Hey guys! I have never done this but am interested in learning how to write/modify a device handler. I started getting my feet wet last year with a little bit of smartapp development so now it’s time to get more up on the device handler side of things. Where are your recommendations for me as far as things to read/watch that could help me start down this road? I am currently interested in the Zigbee, Zwave side of devices. I have looked at the SmartThings Documentation that is available in the IDE thus far. Thanks for any and all suggestions.

But the short answer is you may just need to modify the identified “fingerprint” if everything else about the existing DTH works fine.

[radiocolin (Colin Weir)]

So I assume these are the relevant bits I’d need to modify from the Open/Closed sensor? How do I go about extracting this info from the device?

	fingerprint inClusters: "0000,0001,0003,0402,0500,0020,0B05", outClusters: "0019", manufacturer: "CentraLite", model: "3300-S"
	fingerprint inClusters: "0000,0001,0003,0402,0500,0020,0B05", outClusters: "0019", manufacturer: "CentraLite", model: "3300"
	fingerprint inClusters: "0000,0001,0003,0020,0402,0500,0B05", outClusters: "0019", manufacturer: "CentraLite", model: "3320-L", deviceJoinName: "Iris Contact Sensor"
	fingerprint inClusters: "0000,0001,0003,0020,0402,0500,0B05", outClusters: "0019", manufacturer: "CentraLite", model: "3323-G", deviceJoinName: "Centralite Micro Door Sensor"

[johnconstantelo]

@radiocolin

So I assume these are the relevant bits I’d need to modify from the Open/Closed sensor? How do I go about extracting this info from the device?

Yup, that’s correct. Look at the device in the IDE and find “Raw Description”. It should look like this:

Raw Description 01 0104 0402 00 07 0000 0001 0003 0020 0402 0500 0B05 01 0019

You can figure out the fingerprint from that, but I recommend looking here as well:

http://docs.smartthings.com/en/latest/device-type-developers-guide/definition-metadata.html?highlight=zigbee%20fingerprint

[JDRoberts]

Rather than changing what’s there, you will probably be able to just add a new line with the fingerprint for your specific device. So SmartThings will just look to see if a new device matches any of the fingerprints listed.

[Gutheinz (Dave Gutheinz)]

Also, you can play monkey-see, monkey-do using the device handlers at the community. A lot of examples of generic and specific DHs for many devices. Location:

SmartThingsCommunity/SmartThingsPublic

[radiocolin (Colin Weir)]

Seemed pretty easy to figure out when I lined up the raw description next to the existing device handler fingerprint info. Thanks!