/* HubiThings Replica Refrigerator icemaker Driver HubiThings Replica Applications Copyright 2023 by Bloodtick HubiThings Replica Refrigerator icemaker Driver Copyright 2023 by Dave Gutheinz 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. See parent driver for added information. ==========================================================================*/ import groovy.json.JsonSlurper def driverVer() { return "1.0-1" } def appliance() { return "ReplicaSamsungRefrigeratorIcemaker" } metadata { definition (name: appliance(), namespace: "replica", author: "David Gutheinz", importUrl: "https://raw.githubusercontent.com/DaveGut/HubithingsReplica/main/Drivers/${appliance()}.groovy" ){ capability "Switch" capability "Refresh" } preferences { } } String helpLogo() { return """""" + """
Refrigerator Help
""" } // ===== Installation, setup and update ===== def installed() { runIn(1, updated) } def updated() { unschedule() def updStatus = [:] if (!getDataValue("driverVersion") || getDataValue("driverVersion") != driverVer()) { updateDataValue("driverVersion", driverVer()) updStatus << [driverVer: driverVer()] } if (logEnable) { runIn(1800, debugLogOff) } if (traceLog) { runIn(600, traceLogOff) } updStatus << [logEnable: logEnable, infoLog: infoLog, traceLog: traceLog] listAttributes(true) logInfo("updated: ${updStatus}") } // ===== Event Parse Interface s===== def checkCapabilities(components) { def disabledCapabilities = [] try { disabledCapabilities << status.main["custom.disabledCapabilities"].disabledCapabilities.value } catch (e) { } def enabledCapabilities = [] Map description = new JsonSlurper().parseText(parent.getDataValue("description")) def descComponent = description.components.find { it.id == getDataValue("componentId") } descComponent.capabilities.each { capability -> if (designCapabilities().contains(capability.id) && !disabledCapabilities.contains(capability.id)) { enabledCapabilities << capability.id } } state.deviceCapabilities = enabledCapabilities runIn(1, refreshAttributes, [data: components]) logInfo("checkCapabilities: [disabled: ${disabledCapabilities}, enabled: ${enabledCapabilities}]") } def designCapabilities() { return ["switch"] } def refreshAttributes(components) { def component = components."${getDataValue("componentId")}" logDebug("refreshAttributes: ${component}") component.each { capability -> capability.value.each { attribute -> parseEvent([capability: capability.key, attribute: attribute.key, value: attribute.value.value, unit: attribute.value.unit]) pauseExecution(50) } } listAttributes(false) } void parentEvent(Map event) { if (event.deviceEvent.componentId == getDataValue("componentId")) { try { parseEvent(event.deviceEvent) } catch (err) { logWarn("replicaEvent: [event = ${event}, error: ${err}") } } } def parseEvent(event) { logDebug("parseEvent: ${event}") // some attribute names changed for clarity. list attributes stored as states. if (state.deviceCapabilities.contains(event.capability)) { if (device.currentValue(event.attribute).toString() != event.value.toString()) { sendEvent(name: event.attribute, value: event.value, unit: event.unit) logInfo("parseEvent: [event: ${event}]") } else { logDebug("parseEvent: [ignoredEvent: ${event}]") } } else { logDebug("parseEvent: [filteredEvent: ${event}]") } } // ===== Device Commands ===== def sendCommandToParent(capability, command, arguments = []) { parent.sendRawCommand(getDataValue("componentId"), capability, command, arguments) logDebug("sendCommandToParent: [${getDataValue("componentId")}, ${capability}, ${command}, ${arguments}]") } def refresh() { parent.refresh() } def on() { setOnOff("on") } def off() { setOnOff("off") } def setOnOff(onOff) { sendCommandToParent("switch", onOff, []) logInfo("setOnOff: ${onOff}") } // ===== Libraries ===== // ~~~~~ start include (1303) davegut.Logging ~~~~~ library ( // library marker davegut.Logging, line 1 name: "Logging", // library marker davegut.Logging, line 2 namespace: "davegut", // library marker davegut.Logging, line 3 author: "Dave Gutheinz", // library marker davegut.Logging, line 4 description: "Common Logging Methods", // library marker davegut.Logging, line 5 category: "utilities", // library marker davegut.Logging, line 6 documentationLink: "" // library marker davegut.Logging, line 7 ) // library marker davegut.Logging, line 8 preferences { // library marker davegut.Logging, line 10 input ("logEnable", "bool", title: "Enable debug logging for 30 minutes", defaultValue: false) // library marker davegut.Logging, line 11 input ("infoLog", "bool", title: "Enable information logging${helpLogo()}",defaultValue: true) // library marker davegut.Logging, line 12 input ("traceLog", "bool", title: "Enable trace logging as directed by developer", defaultValue: false) // library marker davegut.Logging, line 13 } // library marker davegut.Logging, line 14 // Logging during development // library marker davegut.Logging, line 16 def listAttributes(trace = false) { // library marker davegut.Logging, line 17 def attrs = device.getSupportedAttributes() // library marker davegut.Logging, line 18 def attrList = [:] // library marker davegut.Logging, line 19 attrs.each { // library marker davegut.Logging, line 20 def val = device.currentValue("${it}") // library marker davegut.Logging, line 21 attrList << ["${it}": val] // library marker davegut.Logging, line 22 } // library marker davegut.Logging, line 23 if (trace == true) { // library marker davegut.Logging, line 24 logInfo("Attributes: ${attrList}") // library marker davegut.Logging, line 25 } else { // library marker davegut.Logging, line 26 logDebug("Attributes: ${attrList}") // library marker davegut.Logging, line 27 } // library marker davegut.Logging, line 28 } // library marker davegut.Logging, line 29 def logTrace(msg){ // library marker davegut.Logging, line 31 if (traceLog == true) { // library marker davegut.Logging, line 32 log.trace "${device.displayName}-${driverVer()}: ${msg}" // library marker davegut.Logging, line 33 } // library marker davegut.Logging, line 34 } // library marker davegut.Logging, line 35 def traceLogOff() { // library marker davegut.Logging, line 37 device.updateSetting("traceLog", [type:"bool", value: false]) // library marker davegut.Logging, line 38 logInfo("traceLogOff") // library marker davegut.Logging, line 39 } // library marker davegut.Logging, line 40 def logInfo(msg) { // library marker davegut.Logging, line 42 if (textEnable || infoLog) { // library marker davegut.Logging, line 43 log.info "${device.displayName}-${driverVer()}: ${msg}" // library marker davegut.Logging, line 44 } // library marker davegut.Logging, line 45 } // library marker davegut.Logging, line 46 def debugLogOff() { // library marker davegut.Logging, line 48 device.updateSetting("logEnable", [type:"bool", value: false]) // library marker davegut.Logging, line 49 logInfo("debugLogOff") // library marker davegut.Logging, line 50 } // library marker davegut.Logging, line 51 def logDebug(msg) { // library marker davegut.Logging, line 53 if (logEnable || debugLog) { // library marker davegut.Logging, line 54 log.debug "${device.displayName}-${driverVer()}: ${msg}" // library marker davegut.Logging, line 55 } // library marker davegut.Logging, line 56 } // library marker davegut.Logging, line 57 def logWarn(msg) { log.warn "${device.displayName}-${driverVer()}: ${msg}" } // library marker davegut.Logging, line 59 // ~~~~~ end include (1303) davegut.Logging ~~~~~