official/power-allowance.groovy

   1 /**
   2  *  Copyright 2015 SmartThings
   3  *
   4  *  Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
   5  *  in compliance with the License. You may obtain a copy of the License at:
   6  *
   7  *      http://www.apache.org/licenses/LICENSE-2.0
   8  *
   9  *  Unless required by applicable law or agreed to in writing, software distributed under the License is distributed
  10  *  on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License
  11  *  for the specific language governing permissions and limitations under the License.
  12  *
  13  *  Power Allowance
  14  *
  15  *  Author: SmartThings
  16  */
  17 definition(
  18     name: "Power Allowance",
  19     namespace: "smartthings",
  20     author: "SmartThings",
  21     description: "Save energy or restrict total time an appliance (like a curling iron or TV) can be in use.  When a switch turns on, automatically turn it back off after a set number of minutes you specify.",
  22     category: "Green Living",
  23     iconUrl: "https://s3.amazonaws.com/smartapp-icons/Meta/light_outlet.png",
  24     iconX2Url: "https://s3.amazonaws.com/smartapp-icons/Meta/light_outlet@2x.png"
  25 )
  26
  27 preferences {
  28         section("When a switch turns on...") {
  29                 input "theSwitch", "capability.switch"
  30         }
  31         section("Turn it off how many minutes later?") {
  32                 input "minutesLater", "number", title: "When?"
  33         }
  34 }
  35
  36 def installed() {
  37         log.debug "Installed with settings: ${settings}"
  38         subscribe(theSwitch, "switch.on", switchOnHandler, [filterEvents: false])
  39 }
  40
  41 def updated() {
  42         log.debug "Updated with settings: ${settings}"
  43
  44         unsubscribe()
  45         subscribe(theSwitch, "switch.on", switchOnHandler, [filterEvents: false])
  46 }
  47
  48 def switchOnHandler(evt) {
  49         log.debug "Switch ${theSwitch} turned: ${evt.value}"
  50         def delay = minutesLater * 60
  51         log.debug "Turning off in ${minutesLater} minutes (${delay}seconds)"
  52         runIn(delay, turnOffSwitch)
  53 }
  54
  55 def turnOffSwitch() {
  56         theSwitch.off()
  57 }