Add BLE door open detector

Author: gfwilliams

apps.json

@@ -257,13 +257,25 @@
   { "id": "bthome_button",
     "name": "BTHome button",
     "icon": "icon.png",
-    "version":"0.01",
+    "version":"0.02",
     "description": "Turn your device into a BTHome/Home Assistant compatible button",
     "tags": "bluetooth,homeassistant",
     "readme": "README.md",
     "needsFeatures":["BLE"],
     "storage": [
       {"name":".bootcde","url":"app.js"}
     ]
+  },
+  { "id": "bthome_door",
+    "name": "BTHome Door Sensor",
+    "icon": "icon.png",
+    "version":"0.01",
+    "description": "Turn your Puck.js into a BTHome/Home Assistant compatible door open detector",
+    "tags": "bluetooth,homeassistant,door",
+    "readme": "README.md",
+    "needsFeatures":["BLE","MAG"],
+    "storage": [
+      {"name":".bootcde","url":"app.js"}
+    ]
   }
 ]

apps/bthome_button/ChangeLog

@@ -1 +1,2 @@
 0.01: New App!
+0.02: Handle long/short press

apps/bthome_button/README.md

@@ -4,6 +4,8 @@ On a Bluetooth LE device, this advertises temperature and battery in a [BTHome (
 
 When you press the button, a 'button event' will be advertised which can be used to trigger tasks in https://www.home-assistant.io/.
 
+It reports `press` for a short press, or `long_press` for pressing over 0.5s
+
 ## Usage
 
 Install the app and disconnect - no configuration is needed.

apps/bthome_button/app.js

@@ -2,6 +2,7 @@ if (E.getBattery===undefined)
   E.getBattery = ()=>100;
 
 var slowTimeout; //< After 60s we revert to slow advertising
+//https://www.espruino.com/BTHome
 
 // Update the data we're advertising here
 function updateAdvertising(buttonState) {
@@ -22,7 +23,7 @@ function updateAdvertising(buttonState) {
     name : "Sensor",
     interval: buttonState?20:2000, // fast when we have a button press, slow otherwise
     // not being connectable/scannable saves power (but you'll need to reboot to connect again with the IDE!)
-    //connectable : false, scannable : false, 
+    //connectable : false, scannable : false,
   });
   /* After 60s, call updateAdvertising again to update battery/temp
   and to ensure we're advertising slowly */

apps/bthome_door/ChangeLog

@@ -0,0 +1 @@
+0.01: New App!

apps/bthome_door/README.md

@@ -0,0 +1,13 @@
+# BTHome Door Sensor
+
+On a Bluetooth LE device, this advertises temperature and battery in a [BTHome (https://bthome.io/)](https://bthome.io/) compatible format, which can then be used in https://www.home-assistant.io/
+
+If you attach a Puck.js running this code near a door, and then put a magnet on the door such that it's near the Puck when the door is closed, this will fire a `long_press` button event to Home Assistant and flash the red LED
+when the door is opened, and a `press` event (and green flash) when it is closed.
+
+This is based on https://www.espruino.com/BTHome and https://www.espruino.com/Puck.js+Door+Light
+
+
+## Usage
+
+Install the app and disconnect, then place the Puck.js running this code near a door (on the door frame), and then put a magnet on the door such that it's near the Puck when the door is closed

apps/bthome_door/app.js

@@ -0,0 +1,60 @@
+if (E.getBattery===undefined)
+  E.getBattery = ()=>100;
+
+var slowTimeout; //< After 60s we revert to slow advertising
+
+// https://www.espruino.com/BTHome
+// Update the data we're advertising here
+function updateAdvertising(buttonState) {
+  NRF.setAdvertising(require("BTHome").getAdvertisement([
+    {
+      type : "battery",
+      v : E.getBattery()
+    },
+    {
+      type : "temperature",
+      v : E.getTemperature()
+    },
+    {
+      type: "button_event",
+      v: buttonState
+    },
+  ]), {
+    name : "Door",
+    interval: (buttonState!="none")?20:2000, // fast when we have a button press, slow otherwise
+    // not being connectable/scannable saves power (but you'll need to reboot to connect again with the IDE!)
+    //connectable : false, scannable : false,
+  });
+  /* After 60s, call updateAdvertising again to update battery/temp
+  and to ensure we're advertising slowly */
+  if (slowTimeout) clearTimeout(slowTimeout);
+  slowTimeout = setTimeout(function() {
+    slowTimeout = undefined;
+    updateAdvertising("none" /* no button pressed */);
+  }, 60000);
+}
+
+// Update advertising now
+updateAdvertising("none");
+
+// Enable highest power advertising (4 on nRF52, 8 on nRF52840)
+NRF.setTxPower(4);
+
+
+// https://www.espruino.com/Puck.js+Door+Light
+var zero = Puck.mag();
+var doorOpen = false;
+function onMag(p) {
+  p.x -= zero.x;
+  p.y -= zero.y;
+  p.z -= zero.z;
+  var s = Math.sqrt(p.x*p.x + p.y*p.y + p.z*p.z);
+  var open = s<1000;
+  if (open!=doorOpen) {
+    doorOpen = open;
+    digitalPulse(open ? LED1 : LED2, 1,1000);
+    updateAdvertising(open  ? "long_press" : "press");
+  }
+}
+Puck.on('mag', onMag);
+Puck.magOn();