/** * Inovelli Switch LZW30 * Author: Eric Maycock (erocm123) * Date: 2021-04-06 * * ****************************************************************************************************** * * OPTIONAL CHILD DEVICE HANDLERS: * LED Bar: In the device settings you can enable up an RGBW child devices that can be used to change the color and intesity of the LED bar. * https://raw.githubusercontent.com/InovelliUSA/SmartThingsInovelli/master/devicetypes/inovelliusa/switch-level-child-device.src/switch-level-child-device.groovy * https://raw.githubusercontent.com/InovelliUSA/SmartThingsInovelli/master/devicetypes/inovelliusa/rgbw-child-device.src/rgbw-child-device.groovy * * ****************************************************************************************************** * * Copyright 2021 Eric Maycock / Inovelli * * 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. * * 2020-11-13: Adding option to create child devices for LED Color & Intensity when on and Intensity when off. * This will allow you to control those configuration options easily in other apps. This requires * child device handlers to be installed that are listed above. * * 2020-09-21: Changing how child devices are created for better compatibility with new app. * * 2020-07-06: Added a configuration parameter (51) that allows you to disable the 700ms delay when turing switch on/off from the wall. * Also adding white LED option to LED colors. Both of these require firmware 1.19+ * * 2020-07-01: Fix for bool settings not showing correctly in SmartThings app. * * 2020-05-05: Adding ColorControl capability to allow changing the LED bar color easily with setColor. * Adding preferences to automatically disable logs after x minutes. Previously the informational * logging would disable after 30 minutes without an option for the user. * * 2020-05-01: Correctly distinguish between digital and physical on / off. * * 2020-02-26: Switch over to using SmartThings child device handler for notifications. * * 2020-02-06: Fix for remote control child device being created when it shouldn't be. * Fix for local protection being updated via hub after being changed with config button. * * 2020-02-05: Fix for LED turning off after 3 seconds when LED intensity (when off) is set to 0. * Extra button event added for those that want to distinguish held vs pushed. * Button 8 pushed = Up button held. Button 8 held = Down button held. * Button 6 pushed = Up button released. Button 6 pushed = Down button released. * * 2019-10-15: Ability to create child devices for local & rf protection to use in various automations. * Device label is now displayed in logging. * * 2019-10-01: Adding the ability to set a custom color for the RGB indicator. Use a hue 360 color wheel. * Adding the ability to enable z-wave "rf protection" to disable control from z-wave commands. * */ import groovy.json.JsonOutput import groovy.transform.Field @Field static List ledNotificationEndpoints = [8] @Field static Map ledColorEndpoints = [103:5] @Field static Map ledIntensityEndpoints = [103:6] @Field static Map ledIntensityOffEndpoints = [104:7] metadata { definition (name: "Inovelli Switch LZW30", namespace: "InovelliUSA", author: "Eric Maycock", vid: "generic-switch") { capability "Switch" capability "Refresh" capability "Actuator" capability "Sensor" capability "Configuration" attribute "lastActivity", "String" attribute "lastEvent", "String" attribute "firmware", "String" attribute "groups", "Number" command "setAssociationGroup", ["number", "enum", "number", "number"] // group number, nodes, action (0 - remove, 1 - add), multi-channel endpoint (optional) fingerprint mfr: "031E", prod: "0004", model: "0001", deviceJoinName: "Inovelli Switch" fingerprint deviceId: "0x1001", inClusters: "0x5E,0x70,0x85,0x59,0x55,0x86,0x72,0x5A,0x73,0x98,0x9F,0x25,0x6C,0x75,0x22,0x7A" fingerprint deviceId: "0x1001", inClusters: "0x5E,0x55,0x98,0x9F,0x6C,0x22,0x70,0x85,0x59,0x86,0x25,0x72,0x5A,0x5B,0x73,0x75,0x7A" } simulator { } preferences { generate_preferences() } tiles { multiAttributeTile(name: "switch", type: "lighting", width: 6, height: 4, canChangeIcon: true) { tileAttribute("device.switch", key: "PRIMARY_CONTROL") { attributeState "off", label: '${name}', action: "switch.on", icon: "st.switches.switch.off", backgroundColor: "#ffffff", nextState: "turningOn" attributeState "on", label: '${name}', action: "switch.off", icon: "st.switches.switch.on", backgroundColor: "#00a0dc", nextState: "turningOff" attributeState "turningOff", label: '${name}', action: "switch.on", icon: "st.switches.switch.off", backgroundColor: "#ffffff", nextState: "turningOn" attributeState "turningOn", label: '${name}', action: "switch.off", icon: "st.switches.switch.on", backgroundColor: "#00a0dc", nextState: "turningOff" } tileAttribute ("device.color", key: "COLOR_CONTROL") { attributeState "color", action:"color control.setColor" } tileAttribute("device.lastEvent", key: "SECONDARY_CONTROL") { attributeState("default", label:'${currentValue}',icon: "st.unknown.zwave.remote-controller") } } valueTile("lastActivity", "device.lastActivity", inactiveLabel: false, decoration: "flat", width: 4, height: 1) { state "default", label: 'Last Activity: ${currentValue}',icon: "st.Health & Wellness.health9" } valueTile("firmware", "device.firmware", inactiveLabel: false, decoration: "flat", width: 2, height: 1) { state "default", label: 'fw: ${currentValue}', icon: "" } /* valueTile("info", "device.info", inactiveLabel: false, decoration: "flat", width: 3, height: 1) { state "default", label: 'Tap on the buttons below to test scenes (ie: Tap ▲ 1x, ▲▲ 2x, etc depending on the button)' } */ childDeviceTiles("all") valueTile("icon", "device.icon", inactiveLabel: false, decoration: "flat", width: 4, height: 1) { state "default", label: '', icon: "https://inovelli.com/wp-content/uploads/Device-Handler/Inovelli-Device-Handler-Logo.png" } standardTile("refresh", "device.switch", inactiveLabel: false, decoration: "flat", width: 2, height: 1) { state "default", label: "", action: "refresh.refresh", icon: "st.secondary.refresh" } } } def generate_preferences() { getParameterNumbers().each { i -> switch(getParameterInfo(i, "type")) { case "number": input "parameter${i}", "number", title:getParameterInfo(i, "name") + "\n" + getParameterInfo(i, "description") + "\nRange: " + getParameterInfo(i, "options") + "\nDefault: " + getParameterInfo(i, "default"), range: getParameterInfo(i, "options") //defaultValue: getParameterInfo(i, "default") break case "enum": input "parameter${i}", "enum", title:getParameterInfo(i, "name") + "\n" + getParameterInfo(i, "description"), //defaultValue: getParameterInfo(i, "default"), options: getParameterInfo(i, "options") break } if (i == 5){ input "parameter5custom", "number", title: "Custom LED RGB Value\nInput a custom value in this field to override the above setting. The value should be between 0 - 360 and can be determined by using the typical hue color wheel.", description: "Tap to set", required: false, range: "0..360" } } input "disableLocal", "enum", title: "Disable Local Control", description: "\nDisable ability to control switch from the wall", required: false, options:["1": "Yes", "0": "No"], defaultValue: "0" input "disableRemote", "enum", title: "Disable Remote Control", description: "\nDisable ability to control switch from inside SmartThings", required: false, options:["1": "Yes", "0": "No"], defaultValue: "0" input description: "Use the below options to enable child devices for the specified settings. This will allow you to adjust these settings using SmartApps such as Smart Lighting. If any of the options are enabled, make sure you have the appropriate child device handlers installed.\n(Firmware 1.02+)", title: "Child Devices", displayDuringSetup: false, type: "paragraph", element: "paragraph" input "enableDisableLocalChild", "boolean", title: "Create \"Disable Local Control\" Child Device", description: "", required: false, defaultValue: "false" input "enableDisableRemoteChild", "boolean", title: "Create \"Disable Remote Control\" Child Device", description: "", required: false, defaultValue: "false" input "enableLED1Child", "boolean", title: "Create \"Light LED\" Child Device", description: "", required: false, defaultValue: "false" input "enableLED1OffChild", "boolean", title: "Create \"Light LED When Off\" Child Device", description: "", required: false, defaultValue: "false" input name: "debugEnable", type: "boolean", title: "Enable Debug Logging", defaultValue: "true" input name: "infoEnable", type: "boolean", title: "Enable Informational Logging", defaultValue: "true" } private channelNumber(String dni) { dni.split("-ep")[-1] as Integer } private sendAlert(data) { sendEvent( descriptionText: data.message, eventType: "ALERT", name: "failedOperation", value: "failed", displayed: true, ) } def logsOff(){ log.warn "${device.label?device.label:device.name}: Disabling logging after timeout" //device.updateSetting("debugEnable",[value:"false",type:"boolean"]) //device.updateSetting("infoEnable",[value:"false",type:"boolean"]) } def setColor(value) { if (infoEnable) log.info "${device.label?device.label:device.name}: setColor($value)" if (value.hue == null || value.saturation == null) return def ledColor = Math.round(huePercentToZwaveValue(value.hue)) if (infoEnable) log.info "${device.label?device.label:device.name}: Setting LED color value to $ledColor & LED intensity to $ledLevel" def cmds = [] if (value.level != null) { def ledLevel = Math.round(value.level/10) cmds << setParameter(6, ledLevel, 1) cmds << getParameter(6) } cmds << setParameter(5, ledColor, 2) cmds << getParameter(5) return commands(cmds) } private huePercentToValue(value){ return value<=2?0:(value>=98?360:value/100*360) } private hueValueToZwaveValue(value){ return value<=2?0:(value>=356?255:value/360*255) } private huePercentToZwaveValue(value){ return value<=2?0:(value>=98?255:value/100*255) } private zwaveValueToHueValue(value){ return value<=2?0:(value>=254?360:value/255*360) } private zwaveValueToHuePercent(value){ return value<=2?0:(value>=254?100:value/255*100) } void childSetLevel(String dni, value) { def valueaux = value as Integer def level = Math.max(Math.min(valueaux, 99), 0) def cmds = [] switch (channelNumber(dni)) { case 101: cmds << new physicalgraph.device.HubAction(command(zwave.protectionV2.protectionSet(localProtectionState : level > 0 ? 1 : 0, rfProtectionState: state.rfProtectionState? state.rfProtectionState:0) )) cmds << new physicalgraph.device.HubAction(command(zwave.protectionV2.protectionGet() )) break case 102: cmds << new physicalgraph.device.HubAction(command(zwave.protectionV2.protectionSet(localProtectionState : state.localProtectionState? state.localProtectionState:0, rfProtectionState : level > 0 ? 1 : 0) )) cmds << new physicalgraph.device.HubAction(command(zwave.protectionV2.protectionGet() )) break case 103: cmds << setParameter(ledIntensityEndpoints[channelNumber(dni)], Math.round(level/10), 1) cmds << getParameter(ledIntensityEndpoints[channelNumber(dni)]) break case 104: cmds << setParameter(ledIntensityOffEndpoints[channelNumber(dni)], Math.round(level/10), 1) cmds << getParameter(ledIntensityOffEndpoints[channelNumber(dni)]) break } sendHubCommand(cmds, 1000) } private toggleTiles(number, value) { for (int i = 1; i <= 5; i++){ if ("${i}" != number){ def childDevice = childDevices.find{it.deviceNetworkId == "$device.deviceNetworkId-ep$i"} if (childDevice) { childDevice.sendEvent(name: "switch", value: "off") } } else { def childDevice = childDevices.find{it.deviceNetworkId == "$device.deviceNetworkId-ep$i"} if (childDevice) { childDevice.sendEvent(name: "switch", value: value) } } } } void childOn(String dni) { if (infoEnable) log.info "${device.label?device.label:device.name}: childOn($dni)" def cmds = [] if(channelNumber(dni).toInteger() <= 5) { toggleTiles("${channelNumber(dni)}", "on") cmds << new physicalgraph.device.HubAction(command(setParameter(8, calculateParameter("8-${channelNumber(dni)}"), 4)) ) sendHubCommand(cmds, 1000) } else { childSetLevel(dni, 99) } } void childOff(String dni) { if (infoEnable) log.info "${device.label?device.label:device.name}: childOff($dni)" def cmds = [] if(channelNumber(dni).toInteger() <= 5) { toggleTiles("${channelNumber(dni)}", "off") cmds << new physicalgraph.device.HubAction(command(setParameter(8, 0, 4)) ) sendHubCommand(cmds, 1000) } else { childSetLevel(dni, 0) } } void childRefresh(String dni) { if (infoEnable) log.info "${device.label?device.label:device.name}: childRefresh($dni)" } def childExists(ep) { def children = childDevices def childDevice = children.find{it.deviceNetworkId.endsWith(ep)} if (childDevice) return true else return false } void componentSetColor(dni, value) { if (infoEnable != "false") log.info "${device.label?device.label:device.name}: dni, componentSetColor($value)" if (value.hue == null || value.saturation == null) return def ledColor = Math.round(huePercentToZwaveValue(value.hue)) state.lastRan = now() if (infoEnable) log.info "${device.label?device.label:device.name}: Setting LED color value to $ledColor & LED intensity to $ledLevel" def cmds = [] if (value.level != null) { def ledLevel = Math.round(value.level/10) cmds << setParameter(ledIntensityEndpoints[channelNumber(dni)], ledLevel, 1) cmds << getParameter(ledIntensityEndpoints[channelNumber(dni)]) } cmds << setParameter(ledColorEndpoints[channelNumber(dni)], ledColor, 2) cmds << getParameter(ledColorEndpoints[channelNumber(dni)]) if(cmds) sendHubCommand(commands(cmds)) } void componentSetColorTemperature(dni, value) { if (infoEnable != "false") log.info "${device.label?device.label:device.name}: dni, componentSetColorTemperature($value)" if (infoEnable) log.info "${device.label?device.label:device.name}: Setting LED color value to 255" state.lastRan = now() state.colorTemperature = value def cmds = [] cmds << setParameter(ledColorEndpoints[channelNumber(dni)], 255, 2) cmds << getParameter(ledColorEndpoints[channelNumber(dni)]) if(cmds) sendHubCommand(commands(cmds)) } def installed() { if (infoEnable) log.info "${device.label?device.label:device.name}: installed()" refresh() } def configure() { if (infoEnable) log.info "${device.label?device.label:device.name}: configure()" def cmds = initialize() commands(cmds) } def updated() { if (!state.lastRan || now() >= state.lastRan + 2000) { if (infoEnable) log.info "${device.label?device.label:device.name}: updated()" state.lastRan = now() def cmds = initialize() if (cmds != []) response(commands(cmds, 1000)) else return null } else { if (infoEnable) log.info "${device.label?device.label:device.name}: updated() ran within the last 2 seconds. Skipping execution." } } private addChild(id, label, namespace, driver, isComponent){ if(!childExists(id)){ try { def newChild = addChildDevice(namespace, driver, "${device.deviceNetworkId}-${id}", null, [completedSetup: true, label: "${device.displayName} (${label})", isComponent: isComponent]) newChild.sendEvent(name:"switch", value:"off") } catch (e) { runIn(3, "sendAlert", [data: [message: "Child device creation failed. Make sure the device handler for \"${driver}\" with a namespace of ${namespace} is installed"]]) } } } private deleteChild(id){ if(childExists(id)){ def childDevice = childDevices.find{it.deviceNetworkId.endsWith(id)} try { if(childDevice) deleteChildDevice(childDevice.deviceNetworkId) } catch (e) { if (infoEnable) log.info "SmartThings may have issues trying to delete the child device when it is in use. Need to manually delete them." runIn(3, "sendAlert", [data: [message: "Failed to delete child device. Make sure the device is not in use by any SmartApp."]]) } } } def initialize() { sendEvent(name: "checkInterval", value: 3 * 60 * 60 + 2 * 60, displayed: false, data: [protocol: "zwave", hubHardwareId: device.hub.hardwareID, offlinePingable: "1"]) if (enableDisableLocalChild == "true") addChild("ep101", "Disable Local Control", "smartthings", "Child Switch", false) else deleteChild("ep101") if (enableDisableRemoteChild == "true") addChild("ep102", "Disable Remote Control", "smartthings", "Child Switch", false) else deleteChild("ep102") if (enableLED1Child == "true") addChild("ep103", "Light LED", "InovelliUSA", "RGBW Child Device", false) else deleteChild("ep103") if (enableLED1OffChild == "true") addChild("ep104", "Light LED - When Off", "InovelliUSA", "Switch Level Child Device", false) else deleteChild("ep104") if (device.label != state.oldLabel) { def children = childDevices def childDevice = children.find{it.deviceNetworkId.endsWith("ep101")} if (childDevice) childDevice.setLabel("${device.displayName} (Disable Local Control)") childDevice = children.find{it.deviceNetworkId.endsWith("ep102")} if (childDevice) childDevice.setLabel("${device.displayName} (Disable Remote Control)") } state.oldLabel = device.label def cmds = processAssociations() getParameterNumbers().each{ i -> if ((state."parameter${i}value" != ((settings."parameter${i}"!=null||calculateParameter(i)!=null)? calculateParameter(i).toInteger() : getParameterInfo(i, "default").toInteger()))){ cmds << setParameter(i, (settings."parameter${i}"!=null||calculateParameter(i)!=null)? calculateParameter(i).toInteger() : getParameterInfo(i, "default").toInteger(), getParameterInfo(i, "size").toInteger()) cmds << getParameter(i) } else { //if (infoEnable) log.info "${device.label?device.label:device.name}: Parameter already set" } } if (state."parameter9value" != 0){ cmds << zwave.configurationV1.configurationSet(scaledConfigurationValue: 0, parameterNumber: 9, size: 1) cmds << zwave.configurationV1.configurationGet(parameterNumber: 9) } cmds << zwave.versionV1.versionGet() if (state.localProtectionState?.toInteger() != settings.disableLocal?.toInteger() || state.rfProtectionState?.toInteger() != settings.disableRemote?.toInteger()) { if (infoEnable) log.info "${device.label?device.label:device.name}: Protection command class settings need to be updated" cmds << zwave.protectionV2.protectionSet(localProtectionState : disableLocal!=null? disableLocal.toInteger() : 0, rfProtectionState: disableRemote!=null? disableRemote.toInteger() : 0) cmds << zwave.protectionV2.protectionGet() } else { if (infoEnable) log.info "${device.label?device.label:device.name}: No Protection command class settings to update" } if (cmds != []) return cmds else return [] } def calculateParameter(number) { def value = 0 switch (number){ case "5": if (settings.parameter5custom =~ /^([0-9]{1}|[0-9]{2}|[0-9]{3})$/) value = hueValueToZwaveValue(settings.parameter5custom.toInteger()) else value = settings."parameter${number}" break case "8-1": case "8-2": case "8-3": case "8-4": case "8-5": value += settings."parameter${number}a"!=null ? settings."parameter${number}a".toInteger() * 1 : 0 value += settings."parameter${number}b"!=null ? settings."parameter${number}b".toInteger() * 256 : 0 value += settings."parameter${number}c"!=null ? settings."parameter${number}c".toInteger() * 65536 : 0 value += settings."parameter${number}d"!=null ? settings."parameter${number}d".toInteger() * 16777216 : 0 break default: value = settings."parameter${number}" break } return value } def setParameter(number, value, size) { if (infoEnable) log.info "${device.label?device.label:device.name}: Setting parameter $number with a size of $size bytes to $value" return zwave.configurationV1.configurationSet(configurationValue: integer2Cmd(value.toInteger(),size), parameterNumber: number, size: size) } def getParameter(number) { if (infoEnable) log.info "${device.label?device.label:device.name}: Retreiving value of parameter $number" return zwave.configurationV1.configurationGet(parameterNumber: number) } def getParameterNumbers(){ return [1,2,3,4,5,6,7,13,51] } def getParameterInfo(number, type){ def parameter = [:] parameter.parameter1default=0 parameter.parameter2default=0 parameter.parameter3default=0 parameter.parameter4default=15 parameter.parameter5default=170 parameter.parameter6default=5 parameter.parameter7default=1 parameter.parameter8default=0 parameter.parameter9default=0 parameter.parameter10default=10 parameter.parameter11default=3600 parameter.parameter12default=10 parameter.parameter13default=0 parameter.parameter51default=1 parameter.parameter1type="enum" parameter.parameter2type="enum" parameter.parameter3type="number" parameter.parameter4type="number" parameter.parameter5type="enum" parameter.parameter6type="enum" parameter.parameter7type="enum" parameter.parameter8type="enum" parameter.parameter9type="enum" parameter.parameter10type="number" parameter.parameter11type="number" parameter.parameter12type="number" parameter.parameter13type="enum" parameter.parameter51type="enum" parameter.parameter1size=1 parameter.parameter2size=1 parameter.parameter3size=2 parameter.parameter4size=1 parameter.parameter5size=2 parameter.parameter6size=1 parameter.parameter7size=1 parameter.parameter8size=4 parameter.parameter9size=1 parameter.parameter10size=1 parameter.parameter11size=2 parameter.parameter12size=1 parameter.parameter13size=1 parameter.parameter51size=1 parameter.parameter1options=["0":"Previous", "1":"On", "2":"Off"] parameter.parameter2options=["1":"Yes", "0":"No"] parameter.parameter3options="1..32767" parameter.parameter4options="0..15" parameter.parameter5options=["0":"Red","21":"Orange","42":"Yellow","85":"Green","127":"Cyan","170":"Blue","212":"Violet","234":"Pink", "255":"White (Firmware 1.19+)"] parameter.parameter6options=["0":"0%","1":"10%","2":"20%","3":"30%","4":"40%","5":"50%","6":"60%","7":"70%","8":"80%","9":"90%","10":"100%"] parameter.parameter7options=["0":"0%","1":"10%","2":"20%","3":"30%","4":"40%","5":"50%","6":"60%","7":"70%","8":"80%","9":"90%","10":"100%"] parameter.parameter8options=["1":"Yes", "2":"No"] parameter.parameter9options=["0":"Stay Off","1":"1 Second","2":"2 Seconds","3":"3 Seconds","4":"4 Seconds","5":"5 Seconds","6":"6 Seconds","7":"7 Seconds","8":"8 Seconds","9":"9 Seconds","10":"10 Seconds"] parameter.parameter10options="0..100" parameter.parameter11options="0..32767" parameter.parameter12options="0..100" parameter.parameter13options=["0":"Default", "1":"Special Load (T8)"] parameter.parameter51options=["0":"Yes", "1":"No (Default)"] parameter.parameter1name="State After Power Restored" parameter.parameter2name="Invert Switch" parameter.parameter3name="Auto Off Timer" parameter.parameter4name="Association Behavior" parameter.parameter5name="LED Strip Color" parameter.parameter6name="LED Strip Intensity" parameter.parameter7name="LED Strip Intensity (When OFF)" parameter.parameter8name="LED Strip Effect" parameter.parameter9name="LED Strip Timeout" parameter.parameter10name="Active Power Reports" parameter.parameter11name="Periodic Power & Energy Reports" parameter.parameter12name="Energy Reports" parameter.parameter13name="Load Type" parameter.parameter51name="Disable Physical On/Off Delay" parameter.parameter1description="The state the switch should return to once power is restored after power failure." parameter.parameter2description="Inverts the orientation of the switch. Useful when the switch is installed upside down. Essentially up becomes down and down becomes up." parameter.parameter3description="Automatically turns the switch off after this many seconds. When the switch is turned on a timer is started that is the duration of this setting. When the timer expires, the switch is turned off." parameter.parameter4description="When should the switch send commands to associated devices?\n\n01 - local\n02 - 3way\n03 - 3way & local\n04 - z-wave hub\n05 - z-wave hub & local\n06 - z-wave hub & 3-way\n07 - z-wave hub & local & 3way\n08 - timer\n09 - timer & local\n10 - timer & 3-way\n11 - timer & 3-way & local\n12 - timer & z-wave hub\n13 - timer & z-wave hub & local\n14 - timer & z-wave hub & 3-way\n15 - all" parameter.parameter5description="This is the color of the LED strip." parameter.parameter6description="This is the intensity of the LED strip." parameter.parameter7description="This is the intensity of the LED strip when the switch is off. This is useful for users to see the light switch location when the lights are off." parameter.parameter8description="LED Strip Effect" parameter.parameter9description="When the LED strip is disabled (LED Strip Intensity is set to 0), this setting allows the LED strip to turn on temporarily while being adjusted." parameter.parameter10description="The power level change that will result in a new power report being sent. The value is a percentage of the previous report. 0 = disabled." parameter.parameter11description="Time period between consecutive power & energy reports being sent (in seconds). The timer is reset after each report is sent." parameter.parameter12description="The energy level change that will result in a new energy report being sent. The value is a percentage of the previous report." parameter.parameter13description="The default of the switch is to auto detect the load. In some situations you may want to try the option for a special load type. (firmware 1.17+)" parameter.parameter51description="The 700ms delay that occurs after pressing the physical button to turn the switch on/off is removed. (firmware 1.19+)" return parameter."parameter${number}${type}" } def zwaveEvent(physicalgraph.zwave.commands.configurationv1.ConfigurationReport cmd) { if (debugEnable) log.debug "${device.label?device.label:device.name}: ${cmd}" if (infoEnable) log.info "${device.label?device.label:device.name}: ${device.displayName} parameter '${cmd.parameterNumber}' with a byte size of '${cmd.size}' is set to '${cmd2Integer(cmd.configurationValue)}'" state."parameter${cmd.parameterNumber}value" = cmd2Integer(cmd.configurationValue) def integerValue = cmd2Integer(cmd.configurationValue) switch (cmd.parameterNumber) { case 5: def childDevice = childDevices.find{it.deviceNetworkId.endsWith("ep${ledColorEndpoints.find { it.value == cmd.parameterNumber }?.key}")} if (childDevice) { if (integerValue == 255) { childDevice.sendEvent(name: "colorTemperature", value: state.colorTemperature?state.colorTemperature:0) childDevice.sendEvent(name: "colorMode", value: "CT", descriptionText: "${device.getDisplayName()} color mode is CT") } else { childDevice.sendEvent(name:"hue", value:"${Math.round(zwaveValueToHuePercent(integerValue))}") childDevice.sendEvent(name:"saturation", value:"100") childDevice.sendEvent(name: "colorMode", value: "RGB", descriptionText: "${device.getDisplayName()} color mode is RGB") } } break case 6: def childDevice = childDevices.find{it.deviceNetworkId.endsWith("ep${ledIntensityEndpoints.find { it.value == cmd.parameterNumber }?.key}")} if (childDevice) { childDevice.sendEvent(name:"level", value:"${integerValue*10}") childDevice.sendEvent(name:"switch", value:"${integerValue==0?"off":"on"}") } break case 7: def childDevice = childDevices.find{it.deviceNetworkId.endsWith("ep${ledIntensityOffEndpoints.find { it.value == cmd.parameterNumber }?.key}")} if (childDevice) { childDevice.sendEvent(name:"level", value:"${integerValue*10}") childDevice.sendEvent(name:"switch", value:"${integerValue==0?"off":"on"}") } break } } def cmd2Integer(array) { switch(array.size()) { case 1: array[0] break case 2: ((array[0] & 0xFF) << 8) | (array[1] & 0xFF) break case 3: ((array[0] & 0xFF) << 16) | ((array[1] & 0xFF) << 8) | (array[2] & 0xFF) break case 4: ((array[0] & 0xFF) << 24) | ((array[1] & 0xFF) << 16) | ((array[2] & 0xFF) << 8) | (array[3] & 0xFF) break } } def integer2Cmd(value, size) { try{ switch(size) { case 1: [value] break case 2: def short value1 = value & 0xFF def short value2 = (value >> 8) & 0xFF [value2, value1] break case 3: def short value1 = value & 0xFF def short value2 = (value >> 8) & 0xFF def short value3 = (value >> 16) & 0xFF [value3, value2, value1] break case 4: def short value1 = value & 0xFF def short value2 = (value >> 8) & 0xFF def short value3 = (value >> 16) & 0xFF def short value4 = (value >> 24) & 0xFF [value4, value3, value2, value1] break } } catch (e) { log.debug "${device.label?device.label:device.name}: Error: integer2Cmd $e Value: $value" } } private getCommandClassVersions() { [0x20: 1, 0x25: 1, 0x70: 1, 0x98: 1, 0x32: 3, 0x5B: 1] } def zwaveEvent(physicalgraph.zwave.commands.securityv1.SecurityMessageEncapsulation cmd) { def encapsulatedCommand = cmd.encapsulatedCommand(commandClassVersions) if (encapsulatedCommand) { state.sec = 1 zwaveEvent(encapsulatedCommand) } } def parse(description) { def result = null if (description.startsWith("Err 106")) { state.sec = 0 result = createEvent(descriptionText: description, isStateChange: true) } else if (description != "updated") { def cmd = zwave.parse(description, commandClassVersions) if (cmd) { result = zwaveEvent(cmd) //if (debugEnable) log.debug("'$cmd' parsed to $result") } else { if (debugEnable) log.debug("Couldn't zwave.parse '$description'") } } def now if(location.timeZone) now = new Date().format("yyyy MMM dd EEE h:mm:ss a", location.timeZone) else now = new Date().format("yyyy MMM dd EEE h:mm:ss a") sendEvent(name: "lastActivity", value: now, displayed:false) result } def zwaveEvent(physicalgraph.zwave.commands.basicv1.BasicReport cmd) { if (debugEnable) log.debug "${device.label?device.label:device.name}: ${cmd}" if (infoEnable) log.info "${device.label?device.label:device.name}: Basic report received with value of ${cmd.value ? "on" : "off"}" createEvent(name: "switch", value: cmd.value ? "on" : "off", type: "digital") } def zwaveEvent(physicalgraph.zwave.commands.basicv1.BasicSet cmd) { if (debugEnable) log.debug "${device.label?device.label:device.name}: ${cmd}" if (infoEnable) log.info "${device.label?device.label:device.name}: Basic set received with value of ${cmd.value ? "on" : "off"}" createEvent(name: "switch", value: cmd.value ? "on" : "off", type: "physical") } def zwaveEvent(physicalgraph.zwave.commands.switchbinaryv1.SwitchBinaryReport cmd) { if (debugEnable) log.debug "${device.label?device.label:device.name}: ${cmd}" if (infoEnable) log.info "${device.label?device.label:device.name}: Switch Binary report received with value of ${cmd.value ? "on" : "off"}" createEvent(name: "switch", value: cmd.value ? "on" : "off", type: "physical") } def zwaveEvent(physicalgraph.zwave.Command cmd) { if (debugEnable) log.debug "${device.label?device.label:device.name}: Unhandled: $cmd" null } def on() { commands([ zwave.basicV1.basicSet(value: 0xFF)//, //zwave.basicV1.basicGet() ]) } def off() { commands([ zwave.basicV1.basicSet(value: 0x00)//, //zwave.basicV1.basicGet() ]) } def ping() { if (infoEnable) log.info "${device.label?device.label:device.name}: ping()" //refresh() } def poll() { if (infoEnable) log.info "${device.label?device.label:device.name}: poll()" //refresh() } def refresh() { if (infoEnable) log.info "${device.label?device.label:device.name}: refresh()" def cmds = [] cmds << zwave.basicV1.basicGet() cmds << zwave.meterV3.meterGet(scale: 0) cmds << zwave.meterV3.meterGet(scale: 2) cmds << zwave.protectionV2.protectionGet() return commands(cmds) } private command(physicalgraph.zwave.Command cmd) { if (getZwaveInfo()?.zw?.contains("s")) { zwave.securityV1.securityMessageEncapsulation().encapsulate(cmd).format() } else { cmd.format() } } private commands(commands, delay=500) { delayBetween(commands.collect{ command(it) }, delay) } def setDefaultAssociations() { def smartThingsHubID = (zwaveHubNodeId.toString().format( '%02x', zwaveHubNodeId )).toUpperCase() state.defaultG1 = [smartThingsHubID] state.defaultG2 = [] state.defaultG3 = [] } def setAssociationGroup(group, nodes, action, endpoint = null){ if (!state."desiredAssociation${group}") { state."desiredAssociation${group}" = nodes } else { switch (action) { case 0: state."desiredAssociation${group}" = state."desiredAssociation${group}" - nodes break case 1: state."desiredAssociation${group}" = state."desiredAssociation${group}" + nodes break } } } def processAssociations(){ def cmds = [] setDefaultAssociations() def associationGroups = 5 if (state.associationGroups) { associationGroups = state.associationGroups } else { if (infoEnable) log.info "${device.label?device.label:device.name}: Getting supported association groups from device" cmds << zwave.associationV2.associationGroupingsGet() } for (int i = 1; i <= associationGroups; i++){ if(state."actualAssociation${i}" != null){ if(state."desiredAssociation${i}" != null || state."defaultG${i}") { def refreshGroup = false ((state."desiredAssociation${i}"? state."desiredAssociation${i}" : [] + state."defaultG${i}") - state."actualAssociation${i}").each { if (it != null){ if (infoEnable) log.info "${device.label?device.label:device.name}: Adding node $it to group $i" cmds << zwave.associationV2.associationSet(groupingIdentifier:i, nodeId:Integer.parseInt(it,16)) refreshGroup = true } } ((state."actualAssociation${i}" - state."defaultG${i}") - state."desiredAssociation${i}").each { if (it != null){ if (infoEnable) log.info "${device.label?device.label:device.name}: Removing node $it from group $i" cmds << zwave.associationV2.associationRemove(groupingIdentifier:i, nodeId:Integer.parseInt(it,16)) refreshGroup = true } } if (refreshGroup == true) cmds << zwave.associationV2.associationGet(groupingIdentifier:i) else if (infoEnable) log.info "${device.label?device.label:device.name}: There are no association actions to complete for group $i" } } else { if (infoEnable) log.info "${device.label?device.label:device.name}: Association info not known for group $i. Requesting info from device." cmds << zwave.associationV2.associationGet(groupingIdentifier:i) } } return cmds } def zwaveEvent(physicalgraph.zwave.commands.associationv2.AssociationReport cmd) { if (debugEnable) log.debug "${device.label?device.label:device.name}: ${cmd}" def temp = [] if (cmd.nodeId != []) { cmd.nodeId.each { temp += it.toString().format( '%02x', it.toInteger() ).toUpperCase() } } state."actualAssociation${cmd.groupingIdentifier}" = temp if (infoEnable) log.info "${device.label?device.label:device.name}: Associations for Group ${cmd.groupingIdentifier}: ${temp}" updateDataValue("associationGroup${cmd.groupingIdentifier}", "$temp") } def zwaveEvent(physicalgraph.zwave.commands.associationv2.AssociationGroupingsReport cmd) { if (debugEnable) log.debug "${device.label?device.label:device.name}: ${cmd}" sendEvent(name: "groups", value: cmd.supportedGroupings) if (infoEnable) log.info "${device.label?device.label:device.name}: Supported association groups: ${cmd.supportedGroupings}" state.associationGroups = cmd.supportedGroupings } def zwaveEvent(physicalgraph.zwave.commands.versionv1.VersionReport cmd) { if (debugEnable) log.debug "${device.label?device.label:device.name}: ${cmd}" if(cmd.applicationVersion != null && cmd.applicationSubVersion != null) { def firmware = "${cmd.applicationVersion}.${cmd.applicationSubVersion.toString().padLeft(2,'0')}" if (infoEnable) log.info "${device.label?device.label:device.name}: Firmware report received: ${firmware}" state.needfwUpdate = "false" createEvent(name: "firmware", value: "${firmware}") } else if(cmd.firmware0Version != null && cmd.firmware0SubVersion != null) { def firmware = "${cmd.firmware0Version}.${cmd.firmware0SubVersion.toString().padLeft(2,'0')}" if (infoEnable != false) log.info "${device.label?device.label:device.name}: Firmware report received: ${firmware}" state.needfwUpdate = "false" createEvent(name: "firmware", value: "${firmware}") } } def zwaveEvent(physicalgraph.zwave.commands.protectionv2.ProtectionReport cmd) { if (debugEnable) log.debug "${device.label?device.label:device.name}: ${device.label?device.label:device.name}: ${cmd}" if (infoEnable) log.info "${device.label?device.label:device.name}: Protection report received: Local protection is ${cmd.localProtectionState > 0 ? "on" : "off"} & Remote protection is ${cmd.rfProtectionState > 0 ? "on" : "off"}" if (!state.lastRan || now() <= state.lastRan + 60000) { state.localProtectionState = cmd.localProtectionState state.rfProtectionState = cmd.rfProtectionState } else { if (infoEnable) log.debug "${device.label?device.label:device.name}: Protection report received more than 60 seconds after running updated(). Possible configuration made at switch" } //device.updateSetting("disableLocal",[value:cmd.localProtectionState?cmd.localProtectionState:0,type:"enum"]) //device.updateSetting("disableRemote",[value:cmd.rfProtectionState?cmd.rfProtectionState:0,type:"enum"]) def children = childDevices def childDevice = children.find{it.deviceNetworkId.endsWith("ep101")} if (childDevice) { childDevice.sendEvent(name: "switch", value: cmd.localProtectionState > 0 ? "on" : "off") } childDevice = children.find{it.deviceNetworkId.endsWith("ep102")} if (childDevice) { childDevice.sendEvent(name: "switch", value: cmd.rfProtectionState > 0 ? "on" : "off") } }