NightscoutData2 NS xDrip+ CGM data field
· v0.3.4
About
----------------- Disclaimers, please read:
- CGM App is not intended to serve as or to replace the real-time display of CGM data of the primary device or standard blood glucose home monitoring. All therapeutic decisions, including those regarding calculating insulin or other drug dosages, should be based on blood glucose measurements obtained from a blood glucose meter and not on data from the CGM App.
- The CGM app is not intended to analyze, interpret, or modify the CGM data received from the primary device.
- The CGM App is not intended to replace self-monitoring practices as advised by a physician.
--------------------------------------------------
(Note: the wording, "a blood glucose meter", is from Garmin directly - In my opinion I believe they meant to say "approved therapeutic device" instead, in case you are using a CGM approved for dosing.)
Data field app that uses ConnectIQ 2 background API to fetch CGM data from your personal Nightscout site or a local web service from xDrip+, Spike, DiaBox, or OpenAPS rig.
Logs BG values to Fit Data and Connect app charting.
Setup guide for Nightscout users: https://tynbendad.wixsite.com/garmindexcom/post/see-your-nightscout-data-on-your-garmin
This is a new version of the NightscoutData data field. The previous version is still available (for the devices it supported) at https://apps.garmin.com/en-US/apps/2be02a1d-1d52-4db6-8bd5-6f66fe5ca992
----------------- Further disclaimers:
THIS APP MUST NOT BE USED TO MAKE MEDICAL DECISIONS.
There is no warranty for this program.
This app is not supported or endorsed by Dexcom, Abbott, Libre, Medtronic, Nightscout, or any other party.
--------------------------------------------------
Requirements:
- Requires a Nightscout site, or Spike, xDrip+, Diabox, Gluroo or OpenAPS.
- No watchface settings are required for Spike or xDrip+, but you must enable the phone app's (Spike or xDrip+) inter-app web services option.
- Make sure the Connect IQ app on your phone is able to stay active and using data in the background - there are usually system settings on your phone that allow that, for both battery and mobile data.
- Be sure to have your Garmin device setting for "Time Source" set to "Auto" (and not "Manual"), to ensure the watchface can sync up properly to the CGM data.
- If using mmol units with Nightscout, make sure your site's configuration variable DISPLAY_UNITS is set to mmol (and not mmol/L).
- If using a Libre 3 or other CGM which gives readings every minute (vs every 5 minutes), change the app setting "Seconds past each 5 minutes of time to refresh BG data" to 0 to get more consistent updates (or other number between 0 and 59.)
- For help with setup, try https://medium.com/trit1dtech/how-to-view-cgm-data-on-a-garmin-watch-or-bike-computer-6846b06801e2
- Still have questions? Contact me via the Connect IQ app "App Support" button.
What's new
NOTICE (Nov. 2021): Sometime in the fall of 2021 Dexcom made changes that broke Sugarmate's connection to CGM data. Unfortunately at this time (Nov. 2021) it looks that while Sugarmate may return, its JSON functionality likely will not. To use my Garmin apps you will need either a local webserver (from an app on your phone such as xDrip+ or Diabox), or a Nightscout website.
NOTICE (July 2020): The Fenix 6 has been reported to not work properly with Connect IQ apps using the background API. Please refer to the Garmin forum bug report: https://forums.garmin.com/developer/connect-iq/i/bug-reports/fenix-6-with-background-app-watchface-doesn-t-update
NOTICE (June 2020): Garmin is having an issue auto-migrating data field apps to support the new Edge 1030 Plus. If they require an SDK update I will release a version as soon as they release the new SDK. In the meantime, please see https://forums.garmin.com/developer/connect-iq/f/discussion/230036/edge-1030-plus-support.
NOTICE (Nov. 2019): Firmware for the Vivoactive 3 (7.0) and Vivoactive 3 Music (5.20) breaks internet data within watchfaces. Newer firmware has been released to fix this issue. See https://forums.garmin.com/developer/connect-iq/i/bug-reports/makewebrequest-stopped-working-on-vivoactive-3-firmware-7-00.
NOTICE (Sept. 2019): iOS Garmin Connect recently had a settings bug, it is fixed if you update Connect to version 4.22.2: https://forums.garmin.com/developer/connect-iq/b/news-announcements/posts/garmin-connect-ios-app-settings-fixed-in-4-22-2-hotfix-release
NOTICE (June 2019): Android Garmin Connect 4.20 thru 4.21.1 broke support for http requests, which is required by xDrip+ and Spike local web services. Connect 4.22 is the latest version that works properly. Refer to https://forums.garmin.com/developer/connect-iq/i/bug-reports/connect-version-4-20-broke-local-http-access
0.3.4 - new devices (Fenix 8 Pro, Instinct Crossover AMOLED, Venu 4, Venu X1, Edge 550, Edge 850, Edge MTB)
0.3.3 - new devices (forerunner 570, 970)
0.3.2 - new devices (instinct 3/e, vivoactive 6, others); support for gluroo sites; add setting to force to mmol units
0.3.1 - new devices (fenix8, others) - data field now supported on 252 different devices!
0.3.0 - support all the new devices (too many to list)
0.2.9b/0.2.9 - support new devices (Edge 540/540 Solar/840/840 Solar, Forerunner 265/265S/965, GPSMAP 67/67i, Instinct 2X Solar)
0.2.8/0.2.7 - bug fix for delta of 1-minute CGM updates with SGV data source
0.2.6 - cleanup BG display for uploaders that send numerical vs string data
0.2.5 - support new devices (D2 Air X10, D2 Mach 1, Descent G1, Edge 1040, Edge Explore 2, Forerunner 255*, Forerunner 955, Instinct 2*, Venu Square 2*.)
0.2.4 - support new devices (Fenix 7, etc.)
0.2.3 - improve parsing of NS and Sugarmate URLs
0.2.2 - support new devices (Venu 2, etc)
0.2.1 - bug fix for under 3 BG data points available
0.2.0 - improve sugarmate.io json validation
0.1.9 - for sugarmate.io, convert "http://" to "https://"
0.1.8 - add Sugarmate support (see https://sugarmate.io/)
0.1.7 - add manual sync setting, fix longstanding bug with autosync (yikes, my apologies!)
0.1.6 - SDK 3.1.9, support Nightscout token authentication (set NS URL to yoursite?token=yourtoken).
0.1.5 - SDK 3.1.7, fix bug dealing with BG data uploaded direct from Loop app
beta0.1.4: first non-beta release (ignore the "beta" naming), update to SDK 3.1.6, support latest devices.
beta0.1.3: bug fix
beta0.1.2: rewrote layout code due to data field memory limitations; changes to improve visibility by separating the arrow from the delta; strike-through for old BG data. SDK update, support for newest devices.
beta0.1.1: major display changes to adjust font size to the available space; direction arrow (vs text); xDrip+ and Spike auto-detection.