Merge pull request #4294 from RKBoss6/Bluewatch-Updates

[BlueWatch] Update for new iOS Bluewatch app version

Author: bobrippling

apps/bluewatch/ChangeLog

@@ -1 +1,2 @@
 0.01: New App!
+0.02: Use new device handshake method for more reliable connections (Must use the iOS BlueWatch app version 1.1)

apps/bluewatch/README.md

@@ -25,7 +25,17 @@ Then, follow the app instructions and authorize Bluetooth permissions for the ap
 After it pairs, it will automatically push weather and location data to the watch. You can turn these features off in the iOS app's settings menu.
 
 For more documentation, please see the [iOS App's README](https://github.com/RKBoss6/BlueWatch/blob/main/README.md)
-
+## Developer Info
+Upon connect, the module sends an event `"BlueWatchConnected"` which can be listened for using the following:
+```
+Bangle.on("BlueWatchConnected", function (){ ... })
+```
+
+To send a string or a JSON, you can use the following: 
+```
+require("bluewatch").sendData("string or object", true);
+```
+with an optional second parameter `forceSend`. When true, it sends even if BlueWatch is not connected at the time. By default it doesn't send info unless the device handshake is completed and BlueWatch is connected
 ## Author and Creator of the iOS App
 RKBoss6
 

apps/bluewatch/lib.js

@@ -45,9 +45,8 @@ function updateWeatherData(d) {
   require("weather").update(weatherEvent);
 }
 
-function sendData(dataString) {
-  if (global.phoneConnected) {
-    Bluetooth.write("BlueWatch_PRIMER" + "\n");
+function sendData(dataString, forceSend) {
+  if (global.phoneConnected || forceSend) {
     setTimeout(function () {
       Bluetooth.write(dataString + "\n");
     }, 500);
@@ -93,6 +92,7 @@ function sendHealthData() {
 }
 
 function onConnect() {
+  sendData("Handshake Successful",true);
   global.phoneConnected = true;
   Bangle.emit("BlueWatchConnected");
   setTimeout(sendHealthData, 1000);
@@ -185,4 +185,4 @@ exports.sendData = sendData;
 exports.sendJSON = sendData;
 exports.sendHealthData = sendHealthData;
 exports.sendRawHealthData = sendRawHealthData;
-exports.receive = messageReceived;
+exports.receive = messageReceived;

apps/bluewatch/metadata.json

@@ -2,8 +2,8 @@
   "id": "bluewatch",
   "name": "BlueWatch iOS Integration",
   "shortName": "BlueWatch",
-  "version": "0.01",
-  "description": "Uses the native iOS app BlueWatch to fetch weather, use phone GPS, find phone/watch, and more.",
+  "version": "0.02",
+  "description": "Uses the native iOS app 'BlueWatch' to fetch weather, use phone GPS, find phone/watch, and more.",
   "icon": "app.png",
   "tags": "tool,bluetooth,apple,ios,system",
   "supports": ["BANGLEJS2"],