Merge pull request #3474 from deirdreobyrne/master

BTHome battery level broadcast for e.g. Home Assistant

apps/bootbthomebatt/ChangeLog

@@ -0,0 +1 @@
+0.01: Initial release.

apps/bootbthomebatt/README.md

@@ -0,0 +1,11 @@
+# BLE BTHome Battery Service
+
+Broadcasts battery remaining percentage over BLE using the [BTHome protocol](https://bthome.io/) - which makes for easy integration into [Home Assistant](https://www.home-assistant.io/)
+
+## Usage
+
+This boot code runs in the background and has no user interface.
+
+## Creator
+
+[Deirdre O'Byrne](https://github.com/deirdreobyrne)

apps/bootbthomebatt/boot.js

@@ -0,0 +1,14 @@
+var btHomeBatterySequence = 0;
+
+function advertiseBTHomeBattery() {
+  var advert = [0x40, 0x00, btHomeBatterySequence, 0x01, E.getBattery()];
+
+  require("ble_advert").set(0xFCD2, advert);
+  btHomeBatterySequence = (btHomeBatterySequence + 1) & 255;
+}
+
+setInterval(function() {
+  advertiseBTHomeBattery();
+}, 300000); // update every 5 min
+
+advertiseBTHomeBattery();

apps/bootbthomebatt/metadata.json

@@ -0,0 +1,15 @@
+{
+  "id": "bootbthomebatt",
+  "name": "BLE BTHome Battery Service",
+  "shortName": "BTHome Battery Service",
+  "version": "0.01",
+  "description": "Broadcasts battery remaining over bluetooth using the BTHome protocol - makes for easy integration with Home Assistant.\n",
+  "icon": "bluetooth.png",
+  "type": "bootloader",
+  "tags": "battery,ble,bluetooth,bthome",
+  "supports": ["BANGLEJS2"],
+  "readme": "README.md",
+  "storage": [
+    {"name":"bthomebat.boot.js","url":"boot.js"}
+  ]
+}