MSA-1748: Integrates Xandem Home to SmartThings. Coded out of personal need as there are currently no Xandem SmartApps available. App detects motion, if motion detected vat or above user defined threshold, turn on light.

2026-03-08 21:02:56 +00:00 · 2017-01-28 09:55:03 -08:00
parent 54da556c17
commit 387e59a9bb
1 changed files with 101 additions and 0 deletions
--- a/smartapps/xandem/xandem-home-integration.src/xandem-home-integration.groovy
+++ b/smartapps/xandem/xandem-home-integration.src/xandem-home-integration.groovy
@@ -0,0 +1,101 @@
+/**
+ *  Xandem Home Integration
+ *
+ *  Copyright 2017 Derek Twaddle
+ *
+ *  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.
+ *
+ * README
+ *
+ * Hello, after purchsing Xandem Home for a rental property I noticed there were no SmartApps yet developed.  This is my
+ * first attempt at integrating Xandem with SmartThings out of personal need and decided to share with the community.
+ *
+ * Depending on your ISP and setup, there are some preliminary steps that need to be performed before installing this app.  Xandem is initially
+ * accessible only via local network so you will need to make some minor rule changes to your firewall / router.
+ *
+ * If you have a static IP assignment from your ISP, you may forgo the following step.  If your ISP assigns an IP Address to you Dynamically
+ * which is what most do at Resedential installations, you will need a Dynamic DNS service.  Dynamic DNS will map your randomly assigned IP
+ * address to a static name like (Ex: myhome.dyndns.com). No matter what your IP changes to, it will always be resolved using the same name you chose.
+ *
+ * Once the above is completed, you will need to configure your router to pass or port forward to your internal Xandem Hub.  You will
+ * want to statically assign a local IP to the mac address of the Xandem Hub.  This way you will always assign the same local IP to the Xandem Hub which can be mapped
+ * and used in port forwarding rules.  After the IP has been assigned (Ex: 192.168.1.25) add a rule on your rounter to pass incoming Port 80 request
+ * to your Xandem Hub IP address on the same port.  This effectively lets your router listen for and pass data from SmarthThings to your Xandem Hub.
+ * 
+ * Once the above networking steps are completed, create a Xandem API key on your local Xandem Hub.  Instructions can
+ * found here: http://documentation.xandem.com/api/#api-keys-and-authorization-header
+ *
+ * This SmartApp is a personal project you are free to use.
+*/
+
+definition(
+    name: "Xandem Home Integration",
+    namespace: "Xandem",
+    author: "Derek Twaddle",
+    description: "Integrates Xandem Home to SmartThings. Detects motion, if above a user set threshold, turn on light.",
+    category: "Safety & Security",
+    iconUrl: "https://s3.amazonaws.com/smartapp-icons/Convenience/Cat-Convenience.png",
+    iconX2Url: "https://s3.amazonaws.com/smartapp-icons/Convenience/Cat-Convenience@2x.png",
+    iconX3Url: "https://s3.amazonaws.com/smartapp-icons/Convenience/Cat-Convenience@2x.png"
+    )
+
+preferences {
+    section("Network Configuration") {
+        input "ddns", "text", title: " External Hostname or Static IP", required: true
+        paragraph "Example: mynetwork.dyndns.org or 64.102.0.1"
+        input "apikey", "text", title: "API Key", required: true
+        paragraph "Enter the Xandem API Key generated on your local Hub"
+    }
+    section("Turn on when motion detected and at or above level:") {
+    	input "thelevel", "text", title: "1 - 10", required: true
+        paragraph "Motion Level: 1 Minimal Motion - 10 High Motion"
+    }
+    section("Turn on this light") {
+        input "theswitch", "capability.switch", required: true
+    }
+}
+
+def installed() {
+	log.debug "Installed with settings: ${settings}"
+	initialize()
+}
+
+def updated() {
+	log.debug "Updated with settings: ${settings}"
+	unsubscribe()
+	initialize()
+}
+
+def initialize() {
+    runEvery5Minutes(updateStatus)
+}
+
+def updateStatus() {
+    def params = [
+        uri: "http://${ddns}/v1/data",
+        headers: [Authorization: "${apikey}"],
+        body: [data_fields: ["motion_score", "is_motion"]]
+	]
+
+	try {
+    	httpPostJson(params) { resp ->
+        	resp.headers.each {
+       	 }
+        
+        // If motion detected and motion level is at or above chosen level, Light On
+        if (resp.data.is_motion != 0 && resp.data.motion_score >= thelevel){
+            theswitch.on()
+            log.debug "Motion detected, light on"
+        } 
+   	 }
+	} catch (e) {
+    	log.debug "something went wrong: $e"
+	}
+}