Elk-M1-Driver-Task.groovy

/***********************************************************************************************************************
 *
 *  A Hubitat Child Driver supporting Elk M1 Tasks.
 *
 *  License:
 *  This program is free software: you can redistribute it and/or modify it under the terms of the GNU
 *  General Public License as published by the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the
 *  implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
 *  for more details.
 *
 *  Name: Elk M1 Driver Tasks
 *
 *  I am not a programmer so alot of this work is through trial and error. I also spent a good amount of time looking
 *  at other integrations on various platforms.
 *
 *** See Release Notes at the bottom***
 ***********************************************************************************************************************/

public static String version() { return "v0.2.1" }

metadata {
	definition(name: "Elk M1 Driver Tasks", namespace: "belk", author: "Mike Magrann") {
		capability "Actuator"
		capability "Momentary"
		capability "PushableButton"
	}
	preferences {
		input name: "txtEnable", type: "bool", title: "Enable descriptionText logging", defaultValue: true
	}
}

void updated() {
	log.warn "${device.label} Updated..."
	log.warn "${device.label} description logging is: ${txtEnable}"
	sendEvent(name: "numberOfButtons", value: 1)
}

void installed() {
	log.warn "${device.label} Installed..."
	device.updateSetting("txtEnable", [type: "bool", value: true])
	clear()
}

void uninstalled() {
}

void parse(String description = null) {
	if (description != "off") {
		String descriptionText = "${device.label} was activated"
		if (txtEnable)
			log.info descriptionText
		sendEvent(name: "pushed", value: 1, descriptionText: descriptionText, isStateChange: true)
		runIn(3, clear)
	}
}

void parse(List description) {
	log.warn "${device.label} parse(List description) received ${description}"
}

hubitat.device.HubAction push() {
	String task = device.deviceNetworkId
	task = task.substring(task.length() - 3).take(3)
	parent.sendMsg(parent.TaskActivation(task.toInteger()))
}

void clear() {
	sendEvent(name: "pushed", value: 0, isStateChange: false)
}

/***********************************************************************************************************************
 *
 * Release Notes (see Known Issues Below)
 *
 * 0.2.1
 * Strongly typed commands
 *
 * 0.2.0
 * Change to a PushableButton
 *
 * 0.1.7
 * Changed logging and events to only occur when state changes
 *
 * 0.1.6
 * Added Refresh Command
 * Simplified logging and event code
 *
 * 0.1.5
 * Strongly typed variables for performance
 *
 * 0.1.4
 * Added info logging
 *
 * 0.1.3
 * Added Momentary capability
 *
 * 0.1.2
 * Changed TaskActivations to TaskActivation
 * Removed code for 'off' since this is not relevant
 *
 * 0.1.1
 * New child driver to support tasks
 *
 ***********************************************************************************************************************/
/***********************************************************************************************************************
 *
 * Feature Request & Known Issues
 *
 *
 ***********************************************************************************************************************/