[RELEASE] Leviton ZW4SF Driver

erniemiller · October 23, 2020, 12:17pm

Disclaimer: I've never written a line of Groovy in my life until this evening. Spent a few hours hacking away on a Decora Dimmer driver shared a few years back by Jason Xia that looked like it was maybe ported from SmartThings. Did a bit of reading, took a stab at cleaning that up and making a proper "fan" driver for this. Unfortunately the enum that comes with FanControl capability has a few entries in it that don't match up with this 4-speed controller's options.

Anyway, hope it helps someone, or (more likely) that someone comes along and fixes my bugs.

github.com

ernie/hubitat/blob/main/drivers/leviton-zw4sf.groovy

/**
 *  Copyright 2020 Ernie Miller
 *
 *  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.
 *
 */
metadata {
  definition (name: "Leviton Decora 4-Speed Fan Controller", namespace: "ernie", author: "Ernie Miller", ocfDeviceType: "oic.d.fan") {
    capability "Actuator"
    capability "Configuration"

This file has been truncated. show original

erniemiller · October 23, 2020, 12:11pm

Following up to say that I was delighted to discover that this driver finally has cured my fan switches of being perceived as lights by Alexa. So I can stop getting stuck in a wind tunnel when I ask her to turn on the lights.

erniemiller · November 4, 2020, 2:29pm

Added this driver to HPM, for folks who prefer this way of installing.

CHUNKYBOWSER · December 16, 2020, 12:55am

Thanks for the driver! I see that you said Alexa recognizes this as a fan, but my Google Home still thinks it's a light. Is this fixable? Thanks!

erniemiller · December 16, 2020, 11:01am

No idea. I don’t own any Google Home devices. The driver should be exposing itself as a fan controller, so I assume it should work if the Google device supports it? I did a quick search and found this, don’t know if it’s related: https://www.reddit.com/r/googlehome/comments/daim9k/cant_control_ceiling_fan_speed/

BigH · March 17, 2021, 4:44am

Thanks! This fixed the mapping of the levels for me. The built-in Leviton Fan Controller driver wouldn't go to the max level even if I asked for "high". However, with both the built-in driver and with yours, Alexa says, "I'm sorry, something went wrong." after most commands. The first command actually works, but then I get this error. Then subsequent commands sometimes result in another error like the one I get when the internet is down, but it resolves in a minute or so. I'm not sure if this is due to Alexa's fan interface, the Hubitat skill, or the driver.

erniemiller · March 17, 2021, 10:55am

I’ve found that Alexa is very sensitive to how you issue commands. I think I remember reading that it had to do with devices that implemented more than one interface.

In any case, when I say “Alexa, set the living room fan to off” I get the correct result, whereas “Alexa, turn off the living room fan” spouts that something went wrong (but works). My guess is that the first functions through Alexa’s “this is a fan” code path and the other functions through its “this is a switch” (but wait, this is ALSO a fan?! Something must be wrong!) code path.