From efd5a09b194bf0c3fd558ef69c08a9a10b948917 Mon Sep 17 00:00:00 2001 From: Gordon Williams Date: Thu, 11 Aug 2022 10:08:57 +0100 Subject: [PATCH] hrm docs --- apps/hrmaccevents/README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/apps/hrmaccevents/README.md b/apps/hrmaccevents/README.md index 188ca325a..ecd619152 100644 --- a/apps/hrmaccevents/README.md +++ b/apps/hrmaccevents/README.md @@ -13,6 +13,21 @@ This app can use [BTHRM](https://banglejs.com/apps/#bthrm) as a reference. * (Recording to file) Stop the recording with a long press of the button and download log.csv with the Espruino IDE. * (Recording to browser) Click "Stop" followed by "Save" and store the resulting file on your device. + +## CSV data format + +The CSV data contains the following columns: + +* Time - Current time (milliseconds since 1970) +* Acc_x,Acc_y,Acc_z - X,Y,Z acceleration in Gs +* HRM_b - BPM figure reported by internal HRM algorithm in Bangle.js +* HRM_c - BPM confidence figure (0..100%) reported by internal HRM algorithm in Bangle.js +* HRM_r - `e.raw` from the `Bangle.on("HRM-raw"` event. This is the value that gets passed to the HRM algorithm. +* HRM_f - `e.filt` from the `Bangle.on("HRM-raw"` event. This is the filtered value that comes from the Bangle's HRM algorithm and which is used for peak detection +* PPG_r - `e.vcPPG` from the `Bangle.on("HRM-raw"` event. This is the PPG value direct from the sensor +* PPG_o - `e.vcPPGoffs` from the `Bangle.on("HRM-raw"` event. This is the PPG offset used to map `e.vcPPG` to `e.raw` so there are no glitches when the exposure values in the sensor change. +* BTHRM - BPM figure from external Bluetooth HRM device (this is our reference BPM) + ## Creator [halemmerich](https://github.com/halemmerich)