[RELEASE] Device driver for Stelpro Ki Thermostat STZB402+ (ZigBee)

mike.maxwell · August 6, 2019, 12:51am

Yes, capability needs to be thermostat, heatingsetpoint, coolingSetpoint and thermostatSetpoint all need to be maintained.

You can use the temp code from this driver to report the temperatures based on the users location preference setting.
Have a look at the code starting at line 124

github.com

hubitat/HubitatPublic/blob/master/examples/drivers/environmentSensor.groovy

/*
	Environment Sensor

	2018-08-09 maxwell
		-cleaned up parsing and eventing
*/

import groovy.transform.Field

@Field Map diagAttributes = [
    	"0000":["name":"ResetCount","val":0x0000],
    	"0104":["name":"TXRetrys","val":0x0104],
    	"0105":["name":"TXFails","val":0x0105],
    	"011A":["name":"PacketDrops","val":0x011A],
    	"0115":["name":"DecryptFailures","val":0x0115],
    	"011D":["name":"RSSI","val":0x011D],
    	"011E":["name":"Parent","val":0x011E],
    	"011F":["name":"Children","val":0x011F],
    	"0120":["name":"Neighbors","val":0x0120]
    ]

This file has been truncated. show original

philippe.charette · August 6, 2019, 10:08pm

Alright, I guess it's not too hard to add those capabilities.
What's the usual approach for "Unimplemented Functions"? Since this thermostat controls line voltage heating-only systems, what should setCoolingSetpoint(temp) do? Nothing? Set the heatpoint? Set a coolingpoint state but don't send it to the device?

philippe.charette · August 6, 2019, 10:16pm

Interesting. Thanks for the head's up.

The temperature scale is configurable on the device, and the value is reported by the device. Should the driver match the user's preferences as in your example or should it match the device's configuration?

mike.maxwell · August 6, 2019, 10:16pm

well that's a whole other kettle of fish, currently GH doesn't know what to do with a heating only thermostat, what you can do is set the coolingSetpoint once to an unrealistic value such as 80F
I usually put these in the installed method:

sendEvent(name:"coolingSetpoint", value:80)

Regarding unimplemented functions, just send a log event for them, such as:

def setCoolingSetpoint(degrees) {
    log.info "setCoolingSetpoint is not available for this device"
}

dan69d69 · August 7, 2019, 2:39am

wow, finally a drivers code that work. I can now rise or lower the temp of my thermostat! a HUGE thanks Philippe. I was waiting for that day since more than a year. I have 4x STZB402+.
I don't want/need the Google integration.
I need Heat, Eco, AND OFF. And the capability to rise or lower the Heating Setpoint
The commands Auto, Cool and Emergency Heat can be removed as they are useless in that kind of equipement
I will be happy to test you future release of this driver.

philippe.charette · August 10, 2019, 6:49pm

I updated the driver! Now with working Google Home Integration and Fahrenheit scale support! Link to the GitHub in the first post.

I followed Mike's instructions and added the aforementioned capabilities, and implemented their functions.

I also added a "lastRunningMode" data value (from this thread). It's value is fixed to "heat" since GH doesn't like the custom mode "eco" or even the simple "off".

The temperature scale follows HE user's preferences. Again thanks Mike. If you change your temperature settings, click "Configure" in the device's page to update the various values.

Regarding the Google Home integration with the Fahrenheit scale, I couldn't test as much as I'd like. Even if I set the Hub to "F", the Google Home app still shows values in "C". I couldn't find a temperature scale in the GH App either. But it still works. Even with the Hub set to F, in the app I can set the setpoint (in C) and it shows up correctly (in F) in the Hub interface.

Let me know what you guys think!

dan69d69 · August 15, 2019, 1:43am

One thing that i see that can maybe be corrected can be seen in the picture attached.
In ECO mode, i loose the arrow to adjust the température.

Not a big problem. I can adjust it from the thermostat when it is in ECO mode then it keep it
Thanks again from Québec ! I use the 3 mode Heat-Eco-Off

philippe.charette · August 15, 2019, 11:53am

Hi Dan,

This is unfortunately by design. The setpoint in Eco mode is settable only on the device itself, with the hardware buttons. I can read that setpoint, but I can't set it.

I agree it's a bit strange, but in Stelpro's defense at least that behaviour is detailed in the user's guide (on page 8 if you're interested).

Merci pour les commentaires et bonne journée!

alex1 · September 13, 2019, 5:25pm

Hello, anyone tried this with HomeKit Homebridge integration? If not, what's the likelyhood that "It Just Works"? Considering buying these.

alex1 · September 17, 2019, 7:52pm

going to answer my own question here. It mostly works with HomeKit using the homebridge hubitat plugin. Reported temperature always seems 70 degrees F but setting temperature works.

Thanks for creating this driver. I bought the device just because of your work.

philippe.charette · September 18, 2019, 1:43pm

Hi Alex.

I know nothing about HomeKit Homebridge. (That's why I kept quiet).

Regarding the reported temperature, is it properly reported in Hubitat's web interface?

alex1 · September 18, 2019, 4:02pm

Hi Philippe,

OK. Thanks for the hint. I stand corrected. HomeKit reports what Hubitat reports.
The issue seems to be that the Hubitat driver in my installation isn't doing an automatic refresh
to obtain the current temperature. If I go in and hit the "Refresh" control
on the driver manually then both Hubitat and HomeKit show the same updated
temperature.

So my next question is. Did I miss something to make the driver auto refresh periodically?

I am using commit 7b92536a60198be85894bc5b94778cead9dad0f1 from Aug 10th. However, I have not updated the firmware in my hub. Its still 2.1.1.122

philippe.charette · September 18, 2019, 5:01pm

Hmmm, it looks like the hub isn't subscribed to receive values from the device. Try to click on "Configure". It could be as simple as that.

alex1 · September 18, 2019, 5:49pm

Hi Philippe,
You got it. It works beautifully now! Keeps working this well over the course of a week or so and I'll replace all my house thermostats with this unit. Thanks for your help and making this driver.

BR,
-Alex

philippompili · February 10, 2020, 2:44pm

Hello Philippe, could this device driver be ported over to the Maestro SMT402? I have 8 of these things in the house (I came from the Maestro Controller and then Vera). I found the Smartthings Device Handler, but haven't been able to get it to work yet. I have no experience with device handlers or coding in general so it's been a slow go for me trying to get this to work. I'd be willing to lend one of my SMT402s to someone in QC (preferably Mtl area) to test.

Cheers,

philippe.charette · February 12, 2020, 12:50pm

Hi!

I took a quick look at the SmartThings driver. It's very close to the Ki driver, which is good news. The command codes are the same. Looks like the Maestro have an humidity sensor, which the Ki doesn't have.

I'm pretty sure it would be a simple job to adjust the Hubitat's Ki driver to make it work with the Maestro. Hopefully I'm not missing something!

When I have a free moment I'll try and whip up a version for you.

In the meantime, If you want to try yourself, start with my driver and try and match the Maestro's SmartThings command codes. You can probably ignore the humidity sensor to start.

philippompili · February 12, 2020, 1:46pm

Ok, I'll try that tonight. If you want to borrow an SMT402 for testing, let me know. I have 1 still in the box until I get everything working.

Cheers,

philippompili · February 13, 2020, 11:16pm

Hi Philippe, tried using your driver but it didn't seem to work. I wish I could tell you what went wrong.

Sorry,

Phil

philippe.charette · February 22, 2020, 9:11pm

I've put together a driver for the Maestro. It's in this thread (to keep discussions organized )
https://community.hubitat.com/t/pre-release-device-driver-for-stelpro-maestro-thermostat-zigbee

WA4OPQ · May 12, 2020, 10:23pm

Hello Philippe and company...

I have the z-wave version of your thermostat, STZW402+.
I am very new to Hubitat and have not yet found an adequate driver. Would your driver be hard to convert over to z-wave?
Thanks!
Bill