Implement customizable BG speech alerts based on user-defined conditions

[bjorkert]

Advanced Customization in Speech Announcements for BG Levels

This PR enhances the speech announcement functionality for monitoring blood glucose (BG) levels with advanced customization options, giving users precise control over the conditions that trigger verbal alerts. These improvements aim to support diverse user needs for BG monitoring and alerts.

Enhancements include:

• Always Speak: Ensures continuous verbal updates of BG levels at every data refresh, ideal for constant monitoring.

• Low BG Alert: Triggers announcements for BG levels at or below the user-defined alertLowBG threshold, including a confirmation announcement when levels return to normal, enhancing user reassurance during hypoglycemic events.

• Proactive Low BG Alert: A significant update providing early warnings for potential low BG scenarios:

  • Announces if the immediate next predicted BG value is at or below the alertLowBG threshold, offering a predictive alert to preemptively manage potential lows.
  • Includes alerts for rapid BG decreases towards the low threshold, even if current levels are within range, helping users anticipate and mitigate rapid declines in BG.
  • Ensures announcements when transitioning from low conditions back to normal levels, providing a clear update on BG status.

• High BG Alert: Informs users when BG levels reach or surpass the alertHighBG threshold, with an additional alert when returning to the desired range, aiding in high BG level management.

Implementation Details:

The evaluateSpeakConditions function centralizes the logic for these enhancements, checking against user preferences and current BG conditions to determine the necessity and type of announcement. This approach ensures a modular and easily adaptable system for future refinements or additions to speech alerts.

These updates aim to empower users with more nuanced control over BG alerts, supporting proactive management of glucose levels with timely and relevant information.

[marionbarker]

Tested using mg/dL.

Enable Always: the speak BG low and high limits can be modified
Disable Always: additional settings are available

• Low and High, speaks when exceeds that range
• Predictive Low, speaks when either low level is tripped or fast drop limit is exceeded

I see the words above: "announcements when transitioning from low/high conditions back to normal levels,"

I was thinking that was a logic error when I was testing - but it sounds like that is by design.

[marionbarker]

Going to merge to dev to make it easy for people to build and test. We made a new PR for further improvements.