--- /dev/null
+/**
+ * Copyright 2015 SmartThings
+ *
+ * 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.
+ *
+ * Notify Me When
+ *
+ * Author: SmartThings
+ * Date: 2013-03-20
+ *
+ * Change Log:
+ * 1. Todd Wackford
+ * 2014-10-03: Added capability.button device picker and button.pushed event subscription. For Doorbell.
+ */
+definition(
+ name: "Notify Me When",
+ namespace: "smartthings",
+ author: "SmartThings",
+ description: "Receive notifications when anything happens in your home.",
+ category: "Convenience",
+ iconUrl: "https://s3.amazonaws.com/smartapp-icons/Meta/window_contact.png",
+ iconX2Url: "https://s3.amazonaws.com/smartapp-icons/Meta/window_contact@2x.png"
+)
+
+preferences {
+ section("Choose one or more, when..."){
+ input "button", "capability.button", title: "Button Pushed", required: false, multiple: true //tw
+ input "motion", "capability.motionSensor", title: "Motion Here", required: false, multiple: true
+ input "contact", "capability.contactSensor", title: "Contact Opens", required: false, multiple: true
+ input "contactClosed", "capability.contactSensor", title: "Contact Closes", required: false, multiple: true
+ input "acceleration", "capability.accelerationSensor", title: "Acceleration Detected", required: false, multiple: true
+ input "mySwitch", "capability.switch", title: "Switch Turned On", required: false, multiple: true
+ input "mySwitchOff", "capability.switch", title: "Switch Turned Off", required: false, multiple: true
+ input "arrivalPresence", "capability.presenceSensor", title: "Arrival Of", required: false, multiple: true
+ input "departurePresence", "capability.presenceSensor", title: "Departure Of", required: false, multiple: true
+ input "smoke", "capability.smokeDetector", title: "Smoke Detected", required: false, multiple: true
+ input "water", "capability.waterSensor", title: "Water Sensor Wet", required: false, multiple: true
+ }
+ section("Send this message (optional, sends standard status message if not specified)"){
+ input "messageText", "text", title: "Message Text", required: false
+ }
+ section("Via a push notification and/or an SMS message"){
+ input("recipients", "contact", title: "Send notifications to") {
+ input "phone", "phone", title: "Enter a phone number to get SMS", required: false
+ paragraph "If outside the US please make sure to enter the proper country code"
+ input "pushAndPhone", "enum", title: "Notify me via Push Notification", required: false, options: ["Yes", "No"]
+ }
+ }
+ section("Minimum time between messages (optional, defaults to every message)") {
+ input "frequency", "decimal", title: "Minutes", required: false
+ }
+}
+
+def installed() {
+ log.debug "Installed with settings: ${settings}"
+ subscribeToEvents()
+}
+
+def updated() {
+ log.debug "Updated with settings: ${settings}"
+ unsubscribe()
+ subscribeToEvents()
+}
+
+def subscribeToEvents() {
+ subscribe(button, "button.pushed", eventHandler) //tw
+ subscribe(contact, "contact.open", eventHandler)
+ subscribe(contactClosed, "contact.closed", eventHandler)
+ subscribe(acceleration, "acceleration.active", eventHandler)
+ subscribe(motion, "motion.active", eventHandler)
+ subscribe(mySwitch, "switch.on", eventHandler)
+ subscribe(mySwitchOff, "switch.off", eventHandler)
+ subscribe(arrivalPresence, "presence.present", eventHandler)
+ subscribe(departurePresence, "presence.not present", eventHandler)
+ subscribe(smoke, "smoke.detected", eventHandler)
+ subscribe(smoke, "smoke.tested", eventHandler)
+ subscribe(smoke, "carbonMonoxide.detected", eventHandler)
+ subscribe(water, "water.wet", eventHandler)
+}
+
+def eventHandler(evt) {
+ log.debug "Notify got evt ${evt}"
+ if (frequency) {
+ def lastTime = state[evt.deviceId]
+ if (lastTime == null || now() - lastTime >= frequency * 60000) {
+ sendMessage(evt)
+ }
+ }
+ else {
+ sendMessage(evt)
+ }
+}
+
+private sendMessage(evt) {
+ String msg = messageText
+ Map options = [:]
+
+ if (!messageText) {
+ msg = defaultText(evt)
+ options = [translatable: true, triggerEvent: evt]
+ }
+ log.debug "$evt.name:$evt.value, pushAndPhone:$pushAndPhone, '$msg'"
+
+ if (location.contactBookEnabled) {
+ sendNotificationToContacts(msg, recipients, options)
+ } else {
+ if (phone) {
+ options.phone = phone
+ if (pushAndPhone != 'No') {
+ log.debug 'Sending push and SMS'
+ options.method = 'both'
+ } else {
+ log.debug 'Sending SMS'
+ options.method = 'phone'
+ }
+ } else if (pushAndPhone != 'No') {
+ log.debug 'Sending push'
+ options.method = 'push'
+ } else {
+ log.debug 'Sending nothing'
+ options.method = 'none'
+ }
+ sendNotification(msg, options)
+ }
+ if (frequency) {
+ state[evt.deviceId] = now()
+ }
+}
+
+private defaultText(evt) {
+ if (evt.name == 'presence') {
+ if (evt.value == 'present') {
+ if (includeArticle) {
+ '{{ triggerEvent.linkText }} has arrived at the {{ location.name }}'
+ }
+ else {
+ '{{ triggerEvent.linkText }} has arrived at {{ location.name }}'
+ }
+ } else {
+ if (includeArticle) {
+ '{{ triggerEvent.linkText }} has left the {{ location.name }}'
+ }
+ else {
+ '{{ triggerEvent.linkText }} has left {{ location.name }}'
+ }
+ }
+ } else {
+ '{{ triggerEvent.descriptionText }}'
+ }
+}
+
+private getIncludeArticle() {
+ def name = location.name.toLowerCase()
+ def segs = name.split(" ")
+ !(["work","home"].contains(name) || (segs.size() > 1 && (["the","my","a","an"].contains(segs[0]) || segs[0].endsWith("'s"))))
+}