Skip to content

Farmer-Eds-Shed/Heart-Rate-Alarm

Repository files navigation

❤️ Heart Rate Alarm

Heart Rate Alarm is an open-source Android application designed to monitor heart rate and issue audible alerts when predefined thresholds are exceeded. This tool is particularly aimed at assisting in the detection of nocturnal epileptic seizures by leveraging compatible fitness heart rate monitors.

⚠️ Disclaimer: I am not a medical professional. This software has not undergone clinical trials. Use it at your own risk. Seizure characteristics vary among individuals, and no alarm system can guarantee detection of all seizure types, including severe ones.

I am developing this software to help monitor our daughters nocturnal epileptic seizures. We have tried using a commercial device, but it is not working for us as it goes into a low sensitivity mode if the wearer gets up and our daughter often sits or even stands up out of bed immediately prior to her seizures due to a feeling of nausea. We have also looked at other commercial devices and decided against for a number of reasons including:

  • low sensitivity modes.
  • Loudness of alarm - we want to be woken but some devices suited for hospitals / care homes are just too loud.
  • Accelerometers - movement is not a big feature of our daughters seizures and we found they only raise false alarms for us.

This works by detecting a heartrate over a definable threshold for a definable number of samples. This way it can be tunned to detect heartrates outside of the wearers normal sleep pattern. So far this has been working very well for us at detecting even minor seizures with much fewer false alarms than we were having with the commercial device. Not everyone with epilepsy will have the same heartrate changes, there are options with more complex algorithms available, including the device we tried previously, but we found they were prone to more false alarms due to looking for more subtle changes in heartrate. Our daughter has a very distinct increase in heartrate at the start of her seizures.

If you are looking for an opensource solution based on heartrate and movement monitoring I would suggest looking at https://github.com/OpenSeizureDetector.


Devices

Devices Tested

  • Fitcent Heart Rate Monitor Works fine, but needs to be manually turned on, may switch off automatically if not detecting heart rate for a few min.
  • Bangle JS 2 OK for testing but heart rate is very inaccurate.
  • COROS Heart Rate Monitor Looks Promising as it has an auto wear detection feature, so shouldn't need to worry about manual power on or auto power off.

Android Devices

Software

Cordova install

$ cordova platform add android

$ cordova run

Node-Red

Node-Red is being used a server to monitor the App via a WebSocket. This will be used for graphing heart rate over night as well as test and debug of the App. May also be used in conjunction with a Notification service such as NTFY to alert if the App itself crashes.

Disable Power Saving Options

Android Permissions are required to allow app to run in background and provide notification services, all power saving options should be turned off or set to least restrictive.

Some devices may require more drastic steps - see: https://dontkillmyapp.com/

  • adb shell
  • dumpsys deviceidle disable
  • exit

Grafana Graphs

A Typical Night

drawing

  • Typical uneventful night.

Single Focal Impaired Seizure

drawing

  • Peaks at beginning of night are a normal active child before settling down to sleep, these are the reason there is a mute button in the app.
  • 2 Peaks after midnight, first did not cross threshold value so did not alarm, second crossed the threshold and raised the alarm. This was a genuine seizure but effects were relatively minor, a little confusion and nausea for a few min.

Seizure Activity Building Through Night

drawing

  • Multiple Alarms in night, built up to a severe focal impaired seizure.
  • Lasted several minuets with a long recovery with nausea and vomiting.
  • Child seemed OK for first couple of alarms but heartrate was increasing with each one.

Focal Impaired leading to Tonic Clonic Seizures

drawing

  • One of our daughters most severe cluster of seizures lasting hours beyond where graph stops.
  • This Seizure was Recorded by the device we were using previously.
  • Alarm did not sound due to operating in Low Sensitivity Mode as the child got out of bed before seizure.
  • This event was the reason for developing the app.

Screenshots

drawing

drawing

drawing

drawing

Credits: