HomeSeer HSM200 Support

mjmac · September 20, 2016, 12:50pm

Hi folks.

My involvement on this project lapsed a while ago because I’d hit some roadblocks on my implementation due to lack of official documentation, but I’m happy to help with getting the best implementation published.

I grabbed the latest version of the handler and re-added my HSM 200. The UI is much better, and the color setting seems a lot more reliable now. The thing I’m a bit confused about is how the on/off switch is supposed to work. I would expect that one could set a color and then use the switch to toggle the LEDs between off and continuously on (at the set color). Maybe that isn’t possible? My intended use case for this device was to make a “smart nightlight” that I could use with a SmartApp to indicate e.g. that lights have been left on, garage doors are open, etc.

Does anyone have a sense for whether or not that is possible with a bit more hacking on the handler?

mjmac · September 21, 2016, 2:13pm

(Replying to myself…)

Ha, so I guess I should have read back through the history before posting. It looks like my use case should already be supported! And yet, when I tried wiring things up via the Smart Lighting app (e.g. turn the light red when the garage doors open), nothing happens. I suspect that I’ve got a defective unit. I’ll do some more debugging when I have a chance.

Sorry for the noise, and great work on this device type!

erocm1231 · September 23, 2016, 4:56pm

Thanks. Yeah, like you mentioned, it should already work with SmartApps that use “setColor” like Smart Lighting.

rogerg · October 2, 2016, 4:16am

Hi Eric, can you please post a link to your latest code?
I am having difficulty where the OnTime parameter is not changing from the default 10. I am trying to set it to 1 min. Has anyone been able to successfully set OnTime to 1 min?

erocm1231 · October 4, 2016, 9:48pm

The latest code should just be from DrZWave’s github:

github.com

drzwave/ExpressControls/blob/master/EZMultiPliDeviceType.gy

// Express Controls EZMultiPli Multi-sensor 
// Motion Sensor - Temperature - Light level - 8 Color Indicator LED - Z-Wave Range Extender - Wall Powered
// driver for SmartThings
// The EZMultiPli is also known as the HSM200 from HomeSeer.com
//
// 2017-04-10 - DrZwave (with help from Don Kirker) - changed fingerprint to the new format, lowered the OnTime 
//              and other parameters to be "more in line with ST user expectations", get the luminance in LUX so it reports in lux all the time.
// 2016-10-06 - erocm1231 - Added "updated" method to run when configuration options are changed. Depending on model of unit, luminance is being
//              reported as a relative percentace or as a lux value. Added the option to configure this in the handler.
// 2016-01-28 - erocm1231 - Changed the configuration method to use scaledConfiguration so that it properly formatted negative numbers.
//              Also, added configurationGet and a configurationReport method so that config values can be verified.
// 2015-12-04 - erocm1231 - added range value to preferences as suggested by @Dela-Rick.
// 2015-11-26 - erocm1231 - Fixed null condition error when adding as a new device. 
// 2015-11-24 - erocm1231 - Added refresh command. Made a few changes to how the handler maps colors to the LEDs. Fixed 
//              the device not having its on/off status updated when colors are changed.
// 2015-11-23 - erocm1231 - Changed the look to match SmartThings v2 devices. 
// 2015-11-21 - erocm1231 - Made code much more efficient. Also made it compatible when setColor is passed a hex value.
//              Mapping of special colors: Soft White - Default - Yellow, White - Concentrate - White, 
//              Daylight - Energize - Teal, Warm White - Relax - Yellow
// 2015-11-19 - erocm1231 - Fixed a couple incorrect colors, changed setColor to be more compatible with other apps

This file has been truncated. show original

My changes have been merged there. I can see from the logs that the parameter is getting changed correctly. Are you hitting the “configure” icon after making the changes in the preferences page? If so, can you post what is shown in the log when you do so?

abavery · October 6, 2016, 2:33am

Not sure if anyone else has this issue, or if it is considered a feature, but my motion sensor doesn’t reset more than every 10 minutes. Is that normal? Ideally I’d only have it retain the motion active state for about 10 seconds. It is wall powered after all. Is that just the way it is? I’m a developer so if anyone could point me in the right direction of whether or not a more sensitive setting is possible I could probably add to the DH.

rogerg · October 6, 2016, 5:13am

Thank you for replying. I think abavery is having exactly the same issue. Motion updates are only 10 mins no matter what I try to set.

When I change the parameters, this is what is shown in the logs:
Date Source Type Name Value User Displayed Text Changed
2016-10-05 10:08:59.469 PM PDT
moments ago DEVICE ENTITY_UPDATE DeviceUpdated Device ‘{{ deviceName }}’ updated false
2016-10-05 10:08:13.149 PM PDT
moments ago DEVICE ENTITY_UPDATE DeviceUpdated Device ‘{{ deviceName }}’ updated false

So update seems to be failing.

erocm1231 · October 6, 2016, 2:42pm

Are you pressing the configure button after changing the option in preferences?

abavery · October 6, 2016, 2:48pm

I am not pressing configure after changing the option. I can’t speak for rogerg though. Should I be?

erocm1231 · October 6, 2016, 3:08pm

The lowest value you can set for the motion sensor to reset is 1 minute. Change it in preferences and then hit the “CONFIGURE” button.

abavery · October 6, 2016, 3:28pm

That actually makes a lot of sense. Didn’t realize I had to hit Configure. I’ve changed it now and I’ll give it a test when I get home tonight. Thanks a bunch

rogerg · October 7, 2016, 1:04pm

@erocm1231 @abavery That worked!

Based on this experience, a UI tweak I would suggest is to rename the “Configure” button to something like “Push Settings Change” or “Push Config” to make it explicit to the user that any changes to Settings must be pushed.

Eric, overall the code that you have helped develop is awesome! Thank you so much.

erocm1231 · October 8, 2016, 7:06am

Configure is actually the common verbiage for that function in the SmartThings platform. I did just push a change though that makes the handler automatically execute configure after you change the preferences and hit done.

JDRoberts · October 8, 2016, 3:33pm

“Configure” is part of the Z wave standard. Both this device and the SmartThings hub are certified Z wave devices. So the term “configure” has a specific meaning in this context.

Here’s the official conformance statement for this device from the Z wave alliance website.

rogerg · October 8, 2016, 10:52pm

Wow ok, that’s even better. Problem solved then!

smartyhome · December 30, 2016, 2:13am

Is there a way to set color based on mode change? I’m thinking about buying this to use as an indicator for when SHM is armed.

strouja · March 12, 2017, 12:08am

Need help to see temperature in Smarthings app.
All I am missing something simple, I bought the Express Controls EZMultiPli (same thing as the HSM200) and attached it to an electrical outlet outside my house. All I want to be able to do is get the temperature reading on my Smartthings app.
I have a Smartthings version 2 hub.
Here is what I did so far

After plugging in the sensor to the outlet it was flashing green and I tried to add the sensor to my hub via the iPhone app. I was not successful in doing this.
I read this forum and logged into https://graph.api.smartthings.com
I went to My Devices and clicked on “+New Device”
I put this info in on the following fields
Name Temperature Outside HSM200
Label I left this blank
Zigbee ID I left this blank

Type I selected HomeSeer Multisensor
Device Network Id I I copied and pasted the following URL

github.com

drzwave/ExpressControls/blob/master/EZMultiPliDeviceType.gy

// Express Controls EZMultiPli Multi-sensor 
// Motion Sensor - Temperature - Light level - 8 Color Indicator LED - Z-Wave Range Extender - Wall Powered
// driver for SmartThings
// The EZMultiPli is also known as the HSM200 from HomeSeer.com
//
// 2017-04-10 - DrZwave (with help from Don Kirker) - changed fingerprint to the new format, lowered the OnTime 
//              and other parameters to be "more in line with ST user expectations", get the luminance in LUX so it reports in lux all the time.
// 2016-10-06 - erocm1231 - Added "updated" method to run when configuration options are changed. Depending on model of unit, luminance is being
//              reported as a relative percentace or as a lux value. Added the option to configure this in the handler.
// 2016-01-28 - erocm1231 - Changed the configuration method to use scaledConfiguration so that it properly formatted negative numbers.
//              Also, added configurationGet and a configurationReport method so that config values can be verified.
// 2015-12-04 - erocm1231 - added range value to preferences as suggested by @Dela-Rick.
// 2015-11-26 - erocm1231 - Fixed null condition error when adding as a new device. 
// 2015-11-24 - erocm1231 - Added refresh command. Made a few changes to how the handler maps colors to the LEDs. Fixed 
//              the device not having its on/off status updated when colors are changed.
// 2015-11-23 - erocm1231 - Changed the look to match SmartThings v2 devices. 
// 2015-11-21 - erocm1231 - Made code much more efficient. Also made it compatible when setColor is passed a hex value.
//              Mapping of special colors: Soft White - Default - Yellow, White - Concentrate - White, 
//              Daylight - Energize - Teal, Warm White - Relax - Yellow
// 2015-11-19 - erocm1231 - Fixed a couple incorrect colors, changed setColor to be more compatible with other apps

This file has been truncated. show original

Version I kept as "Published"
Location - I put in my hub name from drop down "Home Stroud"
Hub - Location - I put in my hub name from drop down "Home Stroud"
Group I left blank

After doing this the temperature sensor shows up in my smartthings iPhone app under “things” but it only shows “motion” I can’t figure out how to have this show me the outside temperature.

I tried fiddling around with the config of the “thing” in the iPhone app and saw nothing to change.
I tried changing the “Type” in the https://graph.api.smartthings.com to “Temperature Sensor”, that did not work.

I even tried using https://github.com/mjmac/smartthings/blob/master/hsm200/driver.groovy as the device network ID.

Can anyone help me configure this so I can see the temperature? Thanks in advance and sorry if this is a dumb question. James

strouja · March 12, 2017, 4:43am

After reading various things here and on Amazon.com reviews here is how I finally configured this to work with SmartThings hub (version 2 in my case)
Instructions to get EZMultiPli is also known as the HSM200 working with SmartThings Hub version 2

Plug the EZMultiPli is also known as the HSM200 into an outlet. When you do this it should flash green.
On the side of the EZMultiPli (or HSM200) you will see a very small button that is about 1/8 of inch long and a few millimeters thick. Press and hold this for about 30 seconds, it will start flashing colors (I think red) and then it will stop flashing, at this point open your SmartThings app on your iPhone or Android device and click the “Add A Thing” under My Home
You will then see a new thing called “RGBW Light” added to your SmartThings. At this point it is not configured yet.
Go the https://graph.api.smartthings.com and log in
Go to My Device Handlers at the top and click button “Create New Device Handler”
Under “Create New Device Handler” Click on the “From Code” link at the top
Go this this URL https://github.com/drzwave/ExpressControls/blob/master/EZMultiPliDeviceType.gy and copy the code into your clipboard or memory of your PC or Mac
Then Paste the code into the blank white box under the Create New Device Handler in the From Code link
Click the Create button at the bottom
From https://graph.api.smartthings.com/ go to My devices and you should see the RGBW Light Device, click Edit
Click the Type* field and scroll to the very very bottom and you should now see “EZmultiPli” select that
Optionally select Label to something more useful as in “Temperature Outside” (you can do this from the SmartThings app on your phone)
Click Update
Now in the SmartThings app on your phone you will see the temperature, you will have to enter the “thing” and leave it and it will soon show up with the temperature

erocm1231 · March 15, 2017, 6:30am

Glad you got it figured out. The method you mention in 1 & 2 is the Z-Wave inclusion process. It will generally work the same with every Z-Wave device you get. You put your SmartThings hub in inclusion mode and then press a button on the device. Some devices will work with SmartThings at that point & some need custom device handlers installed.

DRUNYON1 · March 23, 2017, 11:36pm

I followed the procedure that James created (Thanks James), and I gave the device added. It’s not working as I think it should though. The sensor has a steady flashing blue LED. Has for hours. On the phone, the configure button does not work, the light on-off says it’s turning on or off, but has no effect on the blue flashing light. The temp reads – as does the lux. On smarttiles, the temp and lux say n/a and the motion says motion. I have unplugged and replugged, removed and re-added the device. No change. I wonder if the sensor is bad? Or, if I missed a step…

Topic		Replies	Views
HomeSeer HSM200 Devices & Integrations	3	845	November 27, 2020
EZMultiPli/HSM200 Z-Wave Plug-in Multi-Sensor with Color LED now supported Devices & Integrations	3	1846	October 31, 2020
Need help for color Zwave device type Homeseer HMS200 Writing Device Types	7	3255	November 16, 2015
[RELEASE] HomeSeer Multi-Sensor HSM200 Community Created Device Types	3	2530	February 24, 2023
Can the HSM200 motion sensor (with color changing bulb) still be integrated into ST? Devices & Integrations	4	537	February 7, 2023

HomeSeer HSM200 Support

Related topics