/** * Rotuine Director * * * Changelog * * 2015-09-01 * --Added Contact Book * --Removed references to phrases and replaced with routines * --Added bool logic to inputs instead of enum for "yes" "no" options * --Fixed halting error with code installation * * Copyright 2015 Tim Slagle * * 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. * */ definition( name: "Routine Director", namespace: "tslagle13", author: "Tim Slagle", description: "Monitor a set of presence sensors and activate routines based on whether your home is empty or occupied. Each presence status change will check against the current 'sun state' to run routines based on occupancy and whether the sun is up or down.", category: "Convenience", iconUrl: "http://icons.iconarchive.com/icons/icons8/ios7/512/Very-Basic-Home-Filled-icon.png", iconX2Url: "http://icons.iconarchive.com/icons/icons8/ios7/512/Very-Basic-Home-Filled-icon.png" ) preferences { page (name: "timeIntervalInput", title: "Only during a certain time") { section { input "starting", "time", title: "Starting", required: false input "ending", "time", title: "Ending", required: false } } page(name: "selectRoutines") page(name: "Settings", title: "Settings", uninstall: true, install: true) { section("False alarm threshold (defaults to 10 min)") { input "falseAlarmThreshold", "decimal", title: "Number of minutes", required: false } section("Zip code (for sunrise/sunset)") { input "zip", "text", required: true } section("Notifications") { input "sendPushMessage", "bool", title: "Send notifications when house is empty?" input "sendPushMessageHome", "bool", title: "Send notifications when home is occupied?" } section("Send Notifications?") { input("recipients", "contact", title: "Send notifications to") { input "phone", "phone", title: "Send an SMS to this number?", required:false } } section(title: "More options", hidden: hideOptionsSection(), hideable: true) { label title: "Assign a name", required: false input "days", "enum", title: "Only on certain days of the week", multiple: true, required: false, options: ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"] input "modes", "mode", title: "Only when mode is", multiple: true, required: false } section("Change to this mode") { input "newMode", "mode", title: "Mode?" } } } def selectRoutines() { def configured = (settings.awayDay && settings.awayNight && settings.homeDay && settings.homeNight) dynamicPage(name: "selectRoutines", title: "Configure", nextPage: "Settings", uninstall: true) { section("Who?") { input "people", "capability.presenceSensor", title: "Monitor These Presences", required: true, multiple: true, submitOnChange: true } def routines = location.helloHome?.getPhrases()*.label if (routines) { routines.sort() section("Run This Routine When...") { log.trace routines input "awayDay", "enum", title: "Everyone Is Away And It's Day", required: true, options: routines, submitOnChange: true input "awayNight", "enum", title: "Everyone Is Away And It's Night", required: true, options: routines, submitOnChange: true input "homeDay", "enum", title: "At Least One Person Is Home And It's Day", required: true, options: routines, submitOnChange: true input "homeNight", "enum", title: "At Least One Person Is Home And It's Night", required: true, options: routines, submitOnChange: true } /* section("Select modes used for each condition.") { This allows the director to know which rotuine has already been ran so it does not run again if someone else comes home. input "homeModeDay", "mode", title: "Select Mode Used for 'Home Day'", required: true input "homeModeNight", "mode", title: "Select Mode Used for 'Home Night'", required: true }*/ } } } def installed() { log.debug "Updated with settings: ${settings}" initialize() } def updated() { log.debug "Updated with settings: ${settings}" unsubscribe() initialize() } def initialize() { subscribe(people, "presence", presence) checkSun() subscribe(location, "sunrise", setSunrise) subscribe(location, "sunset", setSunset) state.homestate = null } //check current sun state when installed. def checkSun() { def zip = settings.zip as String def sunInfo = getSunriseAndSunset(zipCode: zip) def current = now() if (sunInfo.sunrise.time < current && sunInfo.sunset.time > current) { state.sunMode = "sunrise" runIn(60,"setSunrise") } else { state.sunMode = "sunset" runIn(60,"setSunset") } } //change to sunrise mode on sunrise event def setSunrise(evt) { state.sunMode = "sunrise"; changeSunMode(newMode); log.debug "Current sun mode is ${state.sunMode}" } //change to sunset mode on sunset event def setSunset(evt) { state.sunMode = "sunset"; changeSunMode(newMode) log.debug "Current sun mode is ${state.sunMode}" } //change mode on sun event def changeSunMode(newMode) { if (allOk) { if (everyoneIsAway()) /*&& (state.sunMode == "sunrise")*/ { log.info("Home is Empty Setting New Away Mode") def delay = (falseAlarmThreshold != null && falseAlarmThreshold != "") ? falseAlarmThreshold * 60 : 10 * 60 setAway() } /* else if (everyoneIsAway() && (state.sunMode == "sunset")) { log.info("Home is Empty Setting New Away Mode") def delay = (falseAlarmThreshold != null && falseAlarmThreshold != "") ? falseAlarmThreshold * 60 : 10 * 60 setAway() }*/ else if (anyoneIsHome()) { log.info("Home is Occupied Setting New Home Mode") setHome() } } } //presence change run logic based on presence state of home def presence(evt) { if (allOk) { if (evt.value == "not present") { log.debug("Checking if everyone is away") if (everyoneIsAway()) { log.info("Nobody is home, running away sequence") def delay = (falseAlarmThreshold != null && falseAlarmThreshold != "") ? falseAlarmThreshold * 60 : 10 * 60 runIn(delay, "setAway") } } else { def lastTime = state[evt.deviceId] if (lastTime == null || now() - lastTime >= 1 * 60000) { log.info("Someone is home, running home sequence") setHome() } state[evt.deviceId] = now() } } } //if empty set home to one of the away modes def setAway() { if (everyoneIsAway()) { if (state.sunMode == "sunset") { def message = "Performing \"${awayNight}\" for you as requested." log.info(message) sendAway(message) location.helloHome.execute(settings.awayNight) state.homestate = "away" } else if (state.sunMode == "sunrise") { def message = "Performing \"${awayDay}\" for you as requested." log.info(message) sendAway(message) location.helloHome.execute(settings.awayDay) state.homestate = "away" } else { log.debug("Mode is the same, not evaluating") } } } //set home mode when house is occupied def setHome() { log.info("Setting Home Mode!!") if (anyoneIsHome()) { if (state.sunMode == "sunset") { if (state.homestate != "homeNight") { def message = "Performing \"${homeNight}\" for you as requested." log.info(message) sendHome(message) location.helloHome.execute(settings.homeNight) state.homestate = "homeNight" } } if (state.sunMode == "sunrise") { if (state.homestate != "homeDay") { def message = "Performing \"${homeDay}\" for you as requested." log.info(message) sendHome(message) location.helloHome.execute(settings.homeDay) state.homestate = "homeDay" } } } } private everyoneIsAway() { def result = true if(people.findAll { it?.currentPresence == "present" }) { result = false } log.debug("everyoneIsAway: ${result}") return result } private anyoneIsHome() { def result = false if(people.findAll { it?.currentPresence == "present" }) { result = true } log.debug("anyoneIsHome: ${result}") return result } def sendAway(msg) { if (sendPushMessage) { if (recipients) { sendNotificationToContacts(msg, recipients) } else { sendPush(msg) if(phone){ sendSms(phone, msg) } } } log.debug(msg) } def sendHome(msg) { if (sendPushMessageHome) { if (recipients) { sendNotificationToContacts(msg, recipients) } else { sendPush(msg) if(phone){ sendSms(phone, msg) } } } log.debug(msg) } private getAllOk() { modeOk && daysOk && timeOk } private getModeOk() { def result = !modes || modes.contains(location.mode) log.trace "modeOk = $result" result } private getDaysOk() { def result = true if (days) { def df = new java.text.SimpleDateFormat("EEEE") if (location.timeZone) { df.setTimeZone(location.timeZone) } else { df.setTimeZone(TimeZone.getTimeZone("America/New_York")) } def day = df.format(new Date()) result = days.contains(day) } log.trace "daysOk = $result" result } private getTimeOk() { def result = true if (starting && ending) { def currTime = now() def start = timeToday(starting, location?.timeZone).time def stop = timeToday(ending, location?.timeZone).time result = start < stop ? currTime >= start && currTime <= stop : currTime <= stop || currTime >= start } log.trace "timeOk = $result" result } private hhmm(time, fmt = "h:mm a") { def t = timeToday(time, location.timeZone) def f = new java.text.SimpleDateFormat(fmt) f.setTimeZone(location.timeZone?:timeZone(time)) f.format(t) } private getTimeIntervalLabel() { (starting && ending) ? hhmm(starting) + "-" + hhmm(ending, "h:mm a z"): "" } private hideOptionsSection() { (starting || ending || days || modes) ? false: true }