sleeplog: put use of HRM data behind a setting preferHRM

Discussed around: https://github.com/orgs/espruino/discussions/7801#discussioncomment-15711051

Author: thyttan

apps/sleeplog/ChangeLog

@@ -20,3 +20,6 @@
 0.22: Fix bug with HRM threshold not updating due to movement thresholds being incorrectly compared against the HRM thresholds.
 0.23: Fix important bug with HRM data being undefined when compared - broken apps should work properly now
 0.24: Change day title to be easier to read, capitalization, and improved documentation/tuning guide in README.
+0.25: Put HRM mode behind the setting `Prefer HRM` which defaults to `false`.
+      Please turn it on if you want the recent HRM behavior. The new default
+      will be more in line with how version 0.20 worked.

apps/sleeplog/README.md

@@ -6,7 +6,7 @@ This app logs and displays the following states:
 
 It is using the built in movement calculation or HRM to decide your sleeping state. While charging it is assumed that you are not wearing the watch and if the status changes to _deep sleep_ the internal heartrate sensor is used to detect if you are wearing the watch.
 
-If HRM polling is enabled in the `Health` app, sleep tracking uses the much more accurate HRM sensor to detect sleep status instead. If not enabled in `Health`, uses movement calculations from the watch.
+If HRM polling is enabled in the `Health` app, sleep tracking can use the HRM sensor to detect sleep status instead. Set `Prefer HRM` in settings to enable. Falls back to using movement calculations if HRM is not available.
 
 #### Explanations
 * __Detection of Sleep__
@@ -93,6 +93,8 @@ To make sure the app accurately provides sleep information, it's a good idea to
       _10min_ / _20min_ / ... / __30min__ / ... / _120min_
   - __Enabled__ | completely en-/disables the background service
     __on__ / _off_
+  - __Prefer HRM__ | en-/disables use of HRM readings if they are available for determining sleep states.
+    __on__ / _off_
   - __Debugging__ submenu
     - __View log__ | display logfile data
       Select the logfile by its starting time.

apps/sleeplog/boot.js

@@ -15,7 +15,8 @@ global.sleeplog = {
     lightTh: 300, //    threshold for light sleep
     wearTemp: 19.5,
     hrmDeepTh: 60,
-    hrmLightTh: 74
+    hrmLightTh: 74,
+    preferHRM: false
   }, require("Storage").readJSON("sleeplog.json", true) || {})
 };
 
@@ -160,7 +161,7 @@ if (global.sleeplog.conf.enabled) {
       data.timestamp = data.timestamp || ((Date.now() / 6E5 | 0) - 1) * 6E5;
       // add preliminary status depending on charging and movement thresholds
       // 1 = not worn, 2 = awake, 3 = light sleep, 4 = deep sleep
-      if(data.bpm){
+      if(data.bpm && global.sleeplog.conf.preferHRM){
         data.status = Bangle.isCharging() ? 1 :
           data.bpm <= global.sleeplog.conf.hrmDeepTh ? 4 :
           data.bpm <= global.sleeplog.conf.hrmLightTh ? 3 : 2;

apps/sleeplog/metadata.json

@@ -2,7 +2,7 @@
   "id":"sleeplog",
   "name":"Sleep Log",
   "shortName": "SleepLog",
-  "version": "0.24",
+  "version": "0.25",
   "description": "Log and view your sleeping habits. This app uses built in movement calculations or HRM data, if enabled. View data from Bangle.js, or from the web app.",
   "icon": "app.png",
   "type": "app",

apps/sleeplog/settings.js

@@ -16,6 +16,7 @@
     lightTh: 300,//    threshold for light sleep
     hrmLightTh: 74,//    threshold for light sleep with HRM
     hrmDeepTh:60,//     threshold for deep sleep with HRM
+    preferHRM: false, // prefer hrm based sleep state determination
     wearTemp: 19.5, //    temperature threshold to count as worn
     // app settings
     breakToD: 12, //    [h] time of day when to start/end graphs
@@ -518,6 +519,13 @@
           require("sleeplog").setEnabled(v);
         }
       },
+      /*LANG*/"Prefer HRM": {
+        value: settings.preferHRM,
+        onchange: v => {
+          settings.preferHRM = v;
+          writeSetting();
+        }
+      },
       /*LANG*/"Debugging": {
         value: debugImg,
         onchange: () => setTimeout(showDebug, 10)