From e5c01e72c4fb48657f90c8a24ddc80f8c54756d6 Mon Sep 17 00:00:00 2001 From: marionbarker Date: Sat, 9 Sep 2023 16:14:39 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20LoopKit/?= =?UTF-8?q?loopdocs@a803e8587add706a1fcbff9e311acc7d62db975a=20?= =?UTF-8?q?=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 404.html | 66 +- build/build-free-loop/index.html | 66 +- build/build_errors/index.html | 66 +- build/code_customization/index.html | 72 +- build/health/index.html | 66 +- build/overview/index.html | 66 +- build/step1/index.html | 66 +- build/step10/index.html | 66 +- build/step11/index.html | 68 +- build/step12/index.html | 66 +- build/step14/index.html | 66 +- build/step2/index.html | 66 +- build/step3/index.html | 66 +- build/step4/index.html | 66 +- build/step5/index.html | 66 +- build/step6/index.html | 68 +- build/step8/index.html | 66 +- build/step9/index.html | 66 +- build/testflight-xcode/index.html | 68 +- build/updating/index.html | 66 +- faqs/FAQs/index.html | 66 +- faqs/algorithm-faqs/index.html | 68 +- faqs/apple-health-faqs/index.html | 66 +- faqs/cgm-faqs/index.html | 66 +- faqs/glossary/index.html | 70 +- faqs/omnipod-faqs/index.html | 68 +- faqs/overview-faqs/index.html | 72 +- faqs/rileylink-faqs/index.html | 66 +- faqs/safety-faqs/index.html | 66 +- faqs/update-faqs/index.html | 66 +- gh-actions/gh-customize/index.html | 66 +- gh-actions/gh-deploy/index.html | 66 +- gh-actions/gh-errors/index.html | 82 +- gh-actions/gh-first-time/index.html | 108 +- gh-actions/gh-other-apps/index.html | 220 +- gh-actions/gh-overview/index.html | 66 +- gh-actions/gh-update/index.html | 66 +- gh-actions/img/action-02-add-identifiers.svg | 380 +- gh-actions/img/action-03-create-certs.svg | 383 +- gh-actions/img/action-04-build-loop.svg | 712 ++-- index.html | 66 +- intro/loopdocs-how-to/index.html | 66 +- intro/overview-intro/index.html | 66 +- intro/requirements/index.html | 66 +- loop-3/add-cgm/index.html | 68 +- loop-3/add-pump/index.html | 66 +- loop-3/displays_v3/index.html | 81 +- loop-3/features/index.html | 66 +- loop-3/loop-3-overview/index.html | 66 +- loop-3/medtronic/index.html | 66 +- loop-3/omnipod/index.html | 68 +- loop-3/onboarding/index.html | 66 +- loop-3/services/index.html | 66 +- loop-3/settings/index.html | 66 +- loop-3/therapy-settings/index.html | 66 +- .../img/add-password-apple-keychain.png | Bin 0 -> 21067 bytes nightscout/img/lcg-add-looper.png | Bin 0 -> 66859 bytes nightscout/img/qr-code-example.png | Bin 0 -> 70766 bytes nightscout/img/site-build-mismatch.png | Bin 0 -> 98143 bytes nightscout/loop-caregiver/index.html | 2706 +++++++++++++++ nightscout/new_user/index.html | 68 +- nightscout/ns_crossref/index.html | 132 +- nightscout/overview/index.html | 179 +- nightscout/remote-commands/index.html | 2902 ++++++++++++++++ nightscout/remote-config/index.html | 2755 +++++++++++++++ nightscout/remote-errors/index.html | 2670 ++++++++++++++ nightscout/remote-overrides/index.html | 3082 +---------------- nightscout/remote-overview/index.html | 2568 ++++++++++++++ nightscout/troublehoot/index.html | 2390 +------------ nightscout/troubleshoot/index.html | 2435 +++++++++++++ nightscout/update_user/index.html | 70 +- operation/algorithm/bolus/index.html | 66 +- operation/algorithm/overview/index.html | 66 +- operation/algorithm/prediction/index.html | 66 +- operation/algorithm/temp-basal/index.html | 66 +- operation/features/battery/index.html | 66 +- operation/features/bolus/index.html | 70 +- operation/features/carbs/index.html | 66 +- operation/features/ice/index.html | 66 +- operation/features/notifications/index.html | 72 +- operation/features/overrides/index.html | 2819 +++++++++++++++ operation/features/premeal/index.html | 66 +- operation/features/watch/index.html | 70 +- operation/features/widget/index.html | 66 +- operation/features/workout/index.html | 2774 +-------------- operation/loop-settings/cgm/index.html | 66 +- .../loop-settings/configurations/index.html | 66 +- operation/loop-settings/displays/index.html | 70 +- operation/loop-settings/mdt-pump/index.html | 66 +- .../loop-settings/omnipod-pump/index.html | 66 +- .../loop-settings/pump-commands/index.html | 66 +- operation/loop-settings/rileylink/index.html | 66 +- .../loop-settings/services_v2/index.html | 66 +- operation/loop/close-loop/index.html | 66 +- operation/loop/looptips/index.html | 66 +- operation/loop/open-loop/index.html | 66 +- operation/overview/index.html | 66 +- search/search_index.json | 2 +- sitemap.xml.gz | Bin 127 -> 127 bytes translate/index.html | 66 +- troubleshooting/loop-crashing/index.html | 66 +- troubleshooting/omnipod-faults/index.html | 66 +- troubleshooting/overview/index.html | 66 +- troubleshooting/pod-pairing/index.html | 66 +- troubleshooting/pump-errors/index.html | 66 +- troubleshooting/time-change/index.html | 66 +- troubleshooting/yellow-red-loop/index.html | 66 +- version/build-dev/index.html | 66 +- version/development/index.html | 66 +- version/loopworkspace/index.html | 66 +- version/overview-version/index.html | 66 +- version/releases/index.html | 72 +- version/simulator/index.html | 66 +- 113 files changed, 25729 insertions(+), 9519 deletions(-) create mode 100644 nightscout/img/add-password-apple-keychain.png create mode 100644 nightscout/img/lcg-add-looper.png create mode 100644 nightscout/img/qr-code-example.png create mode 100644 nightscout/img/site-build-mismatch.png create mode 100644 nightscout/loop-caregiver/index.html create mode 100644 nightscout/remote-commands/index.html create mode 100644 nightscout/remote-config/index.html create mode 100644 nightscout/remote-errors/index.html create mode 100644 nightscout/remote-overview/index.html create mode 100644 nightscout/troubleshoot/index.html create mode 100644 operation/features/overrides/index.html diff --git a/404.html b/404.html index f320c2e92ee..b5e0b0a3f11 100644 --- a/404.html +++ b/404.html @@ -1356,7 +1356,7 @@
  • - + Overrides
    • @@ -1901,7 +1901,7 @@
  • - + Nightscout Troubleshooting
    • @@ -1915,7 +1915,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -1929,8 +1971,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/build-free-loop/index.html b/build/build-free-loop/index.html index 7a08be73ac3..b46dd10ba10 100644 --- a/build/build-free-loop/index.html +++ b/build/build-free-loop/index.html @@ -1480,7 +1480,7 @@
  • - + Overrides
    • @@ -2025,7 +2025,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2039,7 +2039,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2053,8 +2095,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/build_errors/index.html b/build/build_errors/index.html index a76dea92b50..835cd5b1e28 100644 --- a/build/build_errors/index.html +++ b/build/build_errors/index.html @@ -1663,7 +1663,7 @@
  • - + Overrides
    • @@ -2208,7 +2208,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2222,7 +2222,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2236,8 +2278,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/code_customization/index.html b/build/code_customization/index.html index b618753f11d..ae283717c6c 100644 --- a/build/code_customization/index.html +++ b/build/code_customization/index.html @@ -1367,7 +1367,7 @@
  • - + Overrides
    • @@ -2280,7 +2280,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2294,7 +2294,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2308,8 +2350,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • @@ -3014,7 +3070,7 @@

    Build-Time FeaturesRemote Command requirements are configured +Remote commands: override, carbs or boluses will not be accepted even if all the Remote Command requirements are configured

    If you do configure this and later try to set up remote commands, they will not work and there is no error message. Remote Errors: Loop REMOTE_OVERRIDES_DISABLED OBSERVE_HEALTH_KIT_CARB_SAMPLES_FROM_OTHER_APPS_ENABLED @@ -3236,10 +3292,10 @@

    Modify Loop 2.2.x
  • Not available in FreeAPS (based off Loop 2.2.x)
    • -
  • Select 1% Insulin Needs
    • +
  • Select 1% Insulin Needs
    • -

    Any override more than a factor of 2 from 100% can cause Loop predictions to be wrong – especially if a carb count is entered. (An override is NOT the same as a manual temp basal - it changes insulin sensitivity factor and carb ratio in addition to the basal rate needed for zero change in IOB for the duration of the override.)

    +

    Any override more than a factor of 2 from 100% can cause Loop predictions to be wrong – especially if a carb count is entered. (An override is NOT the same as a manual temp basal - it changes insulin sensitivity factor and carb ratio in addition to the basal rate needed for zero change in IOB for the duration of the override.)

    A Sensitivity of 0% is NOT Valid

    Do not set the lower level of the sensitivity range to be 0%.

    diff --git a/build/health/index.html b/build/health/index.html index 2054cdb230c..544d1193247 100644 --- a/build/health/index.html +++ b/build/health/index.html @@ -1424,7 +1424,7 @@
  • - + Overrides
    • @@ -1969,7 +1969,7 @@
  • - + Nightscout Troubleshooting
    • @@ -1983,7 +1983,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -1997,8 +2039,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/overview/index.html b/build/overview/index.html index e47b89cf8a5..6a0649338ca 100644 --- a/build/overview/index.html +++ b/build/overview/index.html @@ -1442,7 +1442,7 @@
  • - + Overrides
    • @@ -1987,7 +1987,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2001,7 +2001,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2015,8 +2057,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/step1/index.html b/build/step1/index.html index edb90d1acad..eb7f467c1a3 100644 --- a/build/step1/index.html +++ b/build/step1/index.html @@ -1457,7 +1457,7 @@
  • - + Overrides
    • @@ -2002,7 +2002,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2016,7 +2016,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2030,8 +2072,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/step10/index.html b/build/step10/index.html index e5578613645..84e8a411cb4 100644 --- a/build/step10/index.html +++ b/build/step10/index.html @@ -1443,7 +1443,7 @@
  • - + Overrides
    • @@ -1988,7 +1988,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2002,7 +2002,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2016,8 +2058,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/step11/index.html b/build/step11/index.html index db93cab6bb6..64dd0b37921 100644 --- a/build/step11/index.html +++ b/build/step11/index.html @@ -1422,7 +1422,7 @@
  • - + Overrides
    • @@ -1967,7 +1967,7 @@
  • - + Nightscout Troubleshooting
    • @@ -1981,7 +1981,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -1995,8 +2037,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • @@ -2330,7 +2386,7 @@

    Data OptionsFor those who assist someone who is Looping, Nightscout enables the caregiver to provide remote commands to the Looper's phone diff --git a/build/step12/index.html b/build/step12/index.html index 2c9efec8a39..33295fb91a3 100644 --- a/build/step12/index.html +++ b/build/step12/index.html @@ -1490,7 +1490,7 @@
  • - + Overrides
    • @@ -2035,7 +2035,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2049,7 +2049,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2063,8 +2105,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/step14/index.html b/build/step14/index.html index c3bf49e8609..bfe9df9fb39 100644 --- a/build/step14/index.html +++ b/build/step14/index.html @@ -1640,7 +1640,7 @@
  • - + Overrides
    • @@ -2185,7 +2185,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2199,7 +2199,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2213,8 +2255,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/step2/index.html b/build/step2/index.html index fb13a1a8dfb..8f43f65448e 100644 --- a/build/step2/index.html +++ b/build/step2/index.html @@ -1482,7 +1482,7 @@
  • - + Overrides
    • @@ -2027,7 +2027,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2041,7 +2041,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2055,8 +2097,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/step3/index.html b/build/step3/index.html index 03bd0dd3d13..54de49cf502 100644 --- a/build/step3/index.html +++ b/build/step3/index.html @@ -1518,7 +1518,7 @@
  • - + Overrides
    • @@ -2063,7 +2063,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2077,7 +2077,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2091,8 +2133,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/step4/index.html b/build/step4/index.html index d76c1656cf1..df0baf84cb0 100644 --- a/build/step4/index.html +++ b/build/step4/index.html @@ -1471,7 +1471,7 @@
  • - + Overrides
    • @@ -2016,7 +2016,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2030,7 +2030,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2044,8 +2086,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/step5/index.html b/build/step5/index.html index 694cddd906c..7d0c757ea02 100644 --- a/build/step5/index.html +++ b/build/step5/index.html @@ -1443,7 +1443,7 @@
  • - + Overrides
    • @@ -1988,7 +1988,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2002,7 +2002,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2016,8 +2058,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/step6/index.html b/build/step6/index.html index 50b643bb74a..5bdf622374a 100644 --- a/build/step6/index.html +++ b/build/step6/index.html @@ -1463,7 +1463,7 @@
  • - + Overrides
    • @@ -2008,7 +2008,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2022,7 +2022,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2036,8 +2078,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • @@ -2407,7 +2463,7 @@

    Free Developer AccountYou must use the Mac-Xcode Build method to build Loop.
  • Loop apps signed with a free developer account will expire after 7 days. On the 7th day, your Loop app will simply turn white when you open it and then immediately close. To rebuild the Loop app, you will have to find a computer and rebuild the app onto your iPhone again. You cannot rebuild the app on day 5 (when it is convenient, for example), hoping to reset the 7-day clock. The app will still expire on the 7th day from when it was first signed and created.
  • If you decide to switch to a paid account after trying out the free account, you will need to rebuild your Loop app to sign it with the new paid account. Furthermore, switching from a Free to a Paid account requires entering all the settings again (and starting a fresh pod).
    • -
  • You will have to do an extra step during the build process to remove Siri and Apple Push capabilities to build with free accounts. Because free accounts do not have access to Apple Push notifications, you will also not be able to use Remote Commands through Nightscout.
    • +
  • You will have to do an extra step during the build process to remove Siri and Apple Push capabilities to build with free accounts. Because free accounts do not have access to Apple Push notifications, you will also not be able to use Remote Commands through Nightscout.

    • If you decide to use a PAID developer account, here's what you need to know:

    diff --git a/build/step8/index.html b/build/step8/index.html index f171fa29680..ed9b08b125f 100644 --- a/build/step8/index.html +++ b/build/step8/index.html @@ -1476,7 +1476,7 @@
  • - + Overrides
    • @@ -2021,7 +2021,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2035,7 +2035,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2049,8 +2091,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/step9/index.html b/build/step9/index.html index 6b4bc054c68..1d75d232c88 100644 --- a/build/step9/index.html +++ b/build/step9/index.html @@ -1470,7 +1470,7 @@
  • - + Overrides
    • @@ -2015,7 +2015,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2029,7 +2029,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2043,8 +2085,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/build/testflight-xcode/index.html b/build/testflight-xcode/index.html index 425ec7aca10..163a72e06a6 100644 --- a/build/testflight-xcode/index.html +++ b/build/testflight-xcode/index.html @@ -1476,7 +1476,7 @@
  • - + Overrides
    • @@ -2021,7 +2021,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2035,7 +2035,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2049,8 +2091,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • @@ -2392,7 +2448,7 @@

    IntroductionUse the GitHub Browser Build method to build and distribute your own Loop app
  • Use TestFlight as a remote distribution (and backup) for an app you build using Xcode
    • -

    This guide can also be followed to install other apps you build with Xcode via TestFlight. Examples include LoopFollow, LoopCaregiver, xDrip4iOS and GlucoseDirect.

    +

    This guide can also be followed to install other apps you build with Xcode via TestFlight. Examples include Loop Follow, Loop Caregiver, xDrip4iOS and GlucoseDirect.

    Some useful features of using TestFlight to install Loop:

    Perhaps in subsequent versions of Loop, auto-adjustment of settings or machine learning could be incorporated. Until then, you will need to tell Loop if your underlying settings change or make temporary adjustments for short term issues.

    -

    The use of Overrides can be quite helpful for short-term changes.

    +

    The use of Overrides can be quite helpful for short-term changes.

    What does negative Active Insulin mean?

    When Loop withholds or suspends some of your scheduled basal insulin, that starts an accumulation of insulin deficit. If you have a kinked cannula and insulin is not delivered, you'd call yourself "lacking insulin" (negative IOB).

    When Loop reports negative IOB, it is a sign that Loop has been actively helping you prevent a low blood sugar. If you find significant negative IOB regularly, you probably need to adjust/test your settings. Glucose that continues to decrease (away from a meal) when IOB goes negative is typically a sign that the scheduled basal rate is too high.

    diff --git a/faqs/apple-health-faqs/index.html b/faqs/apple-health-faqs/index.html index 71db53f96b7..0065150f698 100644 --- a/faqs/apple-health-faqs/index.html +++ b/faqs/apple-health-faqs/index.html @@ -1367,7 +1367,7 @@
  • - + Overrides
    • @@ -1912,7 +1912,7 @@
  • - + Nightscout Troubleshooting
    • @@ -1926,7 +1926,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -1940,8 +1982,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/faqs/cgm-faqs/index.html b/faqs/cgm-faqs/index.html index fc48e06b71b..e6dd1cab2ea 100644 --- a/faqs/cgm-faqs/index.html +++ b/faqs/cgm-faqs/index.html @@ -1367,7 +1367,7 @@
  • - + Overrides
    • @@ -1912,7 +1912,7 @@
  • - + Nightscout Troubleshooting
    • @@ -1926,7 +1926,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -1940,8 +1982,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/faqs/glossary/index.html b/faqs/glossary/index.html index 241c642a28f..db4a3fc587d 100644 --- a/faqs/glossary/index.html +++ b/faqs/glossary/index.html @@ -1367,7 +1367,7 @@
  • - + Overrides
    • @@ -1912,7 +1912,7 @@
  • - + Nightscout Troubleshooting
    • @@ -1926,7 +1926,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -1940,8 +1982,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • @@ -2270,8 +2326,9 @@

    GlossaryLock your Phone: click the button on the side of the phone to lock it - prevent accidental touch, i.e., accidental Loop command

    Loop 3: Latest release with major updates

    Loop Cycle: typically 5 minutes: new CGM reading, prediction update, pump update and, if in Closed Loop, dosing update if needed

    +

    Loop Caregiver: An app you can build to provide remote commands to Loop using Nightscout

    +

    Loop Follow: An app you can build to provide extra alarms and views of important information - can use Dexcom Share or Nightscout to include Loop information

    Loop: With a capital L, Loop is one of several do-it-yourself artifical pancreas systems

    -

    LoopCaregiver: An app you can build to provide remote commands to Loop using Nightscout

    Match-Secrets: a private repository you must create in your github account, stores keys required to build with github Build Actions

    MTB: Manual Temp Basal: user initiated temporary basal, Omnipod Common feature

    MDT: common abbreviation for Medtronic pumps

    @@ -2292,6 +2349,7 @@

    GlossaryPre-Meal Range: modify the correction range for up to one hour by tapping on an icon in the toolbar

    Provisioning Profile: associates your app with your Developer ID and limits app lifetime to 1 year (paid) or 1 week (free)

    Pull Request: formal method to request changes to a repository

    +

    QR: a machine-readable code consisting of an array of black and white squares

    Quit the Loop App: quit out of the app - different from closing the app - typically you swipe up in the app switcher

    repository: contains project files and each file's revision history

    RileyLink: radio-frequency device Loop uses to control Eros pods (aka. Gen 3) and older Medtronic pumps

    diff --git a/faqs/omnipod-faqs/index.html b/faqs/omnipod-faqs/index.html index d98b35a6d3e..c644ef5a1e4 100644 --- a/faqs/omnipod-faqs/index.html +++ b/faqs/omnipod-faqs/index.html @@ -1367,7 +1367,7 @@
  • - + Overrides
    • @@ -1912,7 +1912,7 @@
  • - + Nightscout Troubleshooting
    • @@ -1926,7 +1926,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -1940,8 +1982,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • @@ -2507,7 +2563,7 @@

    Is there an increase in po
  • Loop 2.2.x updates the pod state when CGM updates (approximately 5 minutes) - same as when app is in the background
    • -
  • Use an alternate display method such as Nightscout or Loop Follow instead of keeping the Loopers phone unlocked with Loop app open
    • +
  • Use an alternate display method such as Nightscout or Loop Follow instead of keeping the Loopers phone unlocked with Loop app open
    • diff --git a/faqs/overview-faqs/index.html b/faqs/overview-faqs/index.html index 65e774a0880..a62ddc03065 100644 --- a/faqs/overview-faqs/index.html +++ b/faqs/overview-faqs/index.html @@ -9,7 +9,7 @@ - + @@ -1367,7 +1367,7 @@
  • - + Overrides
    • @@ -1912,7 +1912,7 @@
  • - + Nightscout Troubleshooting
    • @@ -1926,7 +1926,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -1940,8 +1982,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • @@ -2293,7 +2349,7 @@

    Frequently Asked Questions (FA

    diff --git a/faqs/rileylink-faqs/index.html b/faqs/rileylink-faqs/index.html index a6cce0387d4..43a738401a0 100644 --- a/faqs/rileylink-faqs/index.html +++ b/faqs/rileylink-faqs/index.html @@ -1367,7 +1367,7 @@
  • - + Overrides
    • @@ -1912,7 +1912,7 @@
  • - + Nightscout Troubleshooting
    • @@ -1926,7 +1926,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -1940,8 +1982,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/faqs/safety-faqs/index.html b/faqs/safety-faqs/index.html index 3ade86d3ed4..23ffea1fb73 100644 --- a/faqs/safety-faqs/index.html +++ b/faqs/safety-faqs/index.html @@ -1367,7 +1367,7 @@
  • - + Overrides
    • @@ -1912,7 +1912,7 @@
  • - + Nightscout Troubleshooting
    • @@ -1926,7 +1926,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -1940,8 +1982,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/faqs/update-faqs/index.html b/faqs/update-faqs/index.html index d5fa65dbace..3e3089a8810 100644 --- a/faqs/update-faqs/index.html +++ b/faqs/update-faqs/index.html @@ -1367,7 +1367,7 @@
  • - + Overrides
    • @@ -1912,7 +1912,7 @@
  • - + Nightscout Troubleshooting
    • @@ -1926,7 +1926,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -1940,8 +1982,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/gh-actions/gh-customize/index.html b/gh-actions/gh-customize/index.html index 6c12ea0918e..412f5de613d 100644 --- a/gh-actions/gh-customize/index.html +++ b/gh-actions/gh-customize/index.html @@ -1367,7 +1367,7 @@
  • - + Overrides
    • @@ -2076,7 +2076,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2090,7 +2090,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2104,8 +2146,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/gh-actions/gh-deploy/index.html b/gh-actions/gh-deploy/index.html index a0095ef37cc..6413be36384 100644 --- a/gh-actions/gh-deploy/index.html +++ b/gh-actions/gh-deploy/index.html @@ -1463,7 +1463,7 @@
  • - + Overrides
    • @@ -2008,7 +2008,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2022,7 +2022,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2036,8 +2078,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • diff --git a/gh-actions/gh-errors/index.html b/gh-actions/gh-errors/index.html index aa8392b9ce1..a97c5f626d7 100644 --- a/gh-actions/gh-errors/index.html +++ b/gh-actions/gh-errors/index.html @@ -75,7 +75,7 @@
    - + Skip to content @@ -724,8 +724,8 @@
    diff --git a/gh-actions/gh-first-time/index.html b/gh-actions/gh-first-time/index.html index c857f0b418d..294a3a5ba68 100644 --- a/gh-actions/gh-first-time/index.html +++ b/gh-actions/gh-first-time/index.html @@ -703,8 +703,8 @@
  • - - New Terms with GitHub Build + + New Terms with GitHub Browser Build
    • @@ -1697,7 +1697,7 @@
  • - + Overrides
    • @@ -2242,7 +2242,7 @@
  • - + Nightscout Troubleshooting
    • @@ -2256,7 +2256,49 @@
  • - + + Nightscout Cross Ref + +
    • + + + + + + + + + +
  • + + Remote Overview + +
    • + + + + + + + + + +
  • + + Remote Configuration + +
    • + + + + + + + + + +
  • + Remote Commands
    • @@ -2270,8 +2312,22 @@
  • - - Nightscout Cross Ref + + Remote Errors + +
    • + + + + + + + + + +
  • + + Loop Caregiver
    • @@ -2536,8 +2592,8 @@
  • - - New Terms with GitHub Build + + New Terms with GitHub Browser Build
    • @@ -2913,7 +2969,7 @@

    Tips and TricksPrerequisites

    Prerequisites to Build Loop

    -

    There are two prerequisites to build Loop using GitHub Browser Build.

    +

    There are two prerequisites to build Loop using GitHub Browser Build.

    1. Paid Apple Developer account ($99/year)
    2. Free GitHub account
      3. @@ -2922,9 +2978,9 @@

      Prerequisites to Install Loop, you need the TestFlight app, from the Apple App Store, installed on your Compatible Phone.

      Prerequisites to Use Loop

      To use Loop, you need a Compatible Pump and Compatible CGM. For pumps other than Omnipod DASH, you also need a RileyLink Compatible Device.

      -

      New Terms with GitHub Build

      +

      New Terms with GitHub Browser Build

      You can read details about new terms with GitHub build or skip ahead to Save Your Information.

      -

      The GitHub Build may use new and unfamiliar terms.

      +

      The GitHub Browser Build may use new and unfamiliar terms.

      Some of these terms have ToolTips, so hover your mouse over those - or review them in the Glossary.

    -

    The Add Identifier Action should complete (succeed or fail) in a few minutes.

    +

    The Add Identifier Action should succeed or fail in a few minutes.

    @@ -2271,13 +2320,6 @@ Nightscout Documentation - - -
  • - - IFTTT Integration - -
  • @@ -2332,20 +2374,10 @@

    Nightscout Cross Ref

    Nightscout Documentation

    -

    A number of pages that used to be in LoopDocs have been moved to the Nightscout documentation and are in the process of being integrated into their menu structure. To prevent duplication and inconsistency, those pages have been removed from LoopDocs. A cross-reference to the Nightscout pages is provided below.

    +

    A number of pages that used to be in LoopDocs have been moved to the Nightscout documentation. To prevent duplication and inconsistency, those pages have been removed from LoopDocs. A cross-reference to the Nightscout pages is provided below.

      -
    • Warning: As of Sep 2021, some of the pages moved from LoopDocs to Nightscout documentation are not yet in the Nightscout menu structure
    • You can always use the search function of Nightscout: Documentation to find any topic
    -

    IFTTT Integration

    -

    If This, Then That (IFTTT) integration is a useful Nightscout capability. By using IFTTT, you can have single button presses on your iPhone that will set an override, log a cannula change, log a sensor change and much more.

    -

    Remote Notifications

    While the Loop app sends notifications locally on the Loop user's iPhone, parents and caregivers may want those messages on their phones, too. We can achieve this functionality through a combination of Nightscout, IFTTT, Google, and Pushover.

      @@ -2355,11 +2387,11 @@

      Remote NotificationsLoop Follow

      -

      Loop Follow was created by Jon Fawcett who took ideas from multiple other apps to create a single app to assist in his caregiving role. It is popular with Loopers who like the display and notifications as well as Loop caregivers. It can work with just the Dexcom Share credentials and/or the Nightscout URL and allows for easy customization of alerts and alarms. Jon has handed over maintenance of this app to the Loop and Learn team.

      +

      Loop Follow

      +

      Loop Follow was created by Jon Fawcett who took ideas from multiple other apps to create a single app to assist in his caregiving role. It is popular with Loopers who like the display and notifications as well as Loop caregivers. It can work with just the Dexcom Share credentials and/or the Nightscout URL and allows for easy customization of alerts and alarms. Jon handed over maintenance of this app to the Loop and Learn team.

      • Please see
        • @@ -2406,7 +2438,7 @@

        Reports -

        - Remote Commands + Nightscout Troubleshooting -
      • + Overrides
        • @@ -2049,7 +2049,7 @@
      • - + Nightscout Troubleshooting
        • @@ -2063,7 +2063,49 @@
      • - + + Nightscout Cross Ref + +
        • + + + + + + + + + +
      • + + Remote Overview + +
        • + + + + + + + + + +
      • + + Remote Configuration + +
        • + + + + + + + + + +
      • + Remote Commands
        • @@ -2077,8 +2119,22 @@
      • - - Nightscout Cross Ref + + Remote Errors + +
        • + + + + + + + + + +
      • + + Loop Caregiver
        • @@ -2442,22 +2498,22 @@

        Nightscout Overview

        Overview

        -

        Nightscout is an excellent tool for remotely viewing Loop's actions. Nightscout can act as a stand-alone tool or be integrated with Loop. (Nightscout also integrates with other open-source hybrid closed loop systems such as OpenAPS, AndroidAPS and FreeAPS X. LoopDocs focuses on Loop.)

        -

        When integrated with Loop, Nightscout provides monitoring of Loop activities such as viewing history of glucose, carbs, boluses, temp basals and overrides; troubleshooting Loop errors; and provides extensive reports for analyzing data trends and patterns. These reports assist when Loop Therapy Settings need to be adjusted.

        -

        For caregivers, Nightscout enables remote monitoring and even the ability to issue remote commands through Nightscout when both Loop and Nightscout are properly configured. There is a whole page devoted to LoopDocs: Remote Commands. If you are a caregiver, this summary of remote capabilities may encourage you to look into Nightscout.

        +

        Nightscout is an excellent tool for remotely viewing Loop actions. Nightscout can act as a stand-alone tool or be integrated with Loop. (Nightscout also integrates with other open-source hybrid closed loop systems such as OpenAPS, AndroidAPS and iAPS. LoopDocs focuses on Loop.)

        +

        When integrated with Loop, Nightscout provides monitoring of Loop activities such as viewing history of glucose, carbs, boluses, temp basals and overrides; troubleshooting Loop errors; and provides extensive reports for analyzing data trends and patterns. These reports assist when Loop Therapy Settings need to be adjusted.

        +

        For caregivers, Nightscout enables remote monitoring and even the ability to issue remote commands through Nightscout when both Loop and Nightscout are properly configured. There are several pages starting at LoopDocs: Remote Overview that provide documentation on this feature. If you are a caregiver, this summary of remote capabilities may encourage you to look into Nightscout.

        Remote Commands

          -
        • Loop 2.2.x
            +
          • Loop 2.2.x
            • Overrides can be enabled and disabled
            • -
          • Loop 3
              +
            • Loop 3
              • Overrides can be enabled and disabled
              • Carbs can be entered
              • Boluses can be commanded
                • -
              • LoopCaregiver app (under development, iOS only) enables the following from the caregiver's phone
                  -
                • monitor Loop
                  • +
                • Loop Caregiver app (under development, iOS only) enables the following from the caregiver's phone
                    +
                  • monitor Loop
                  • issue remote commands for carbs, bolus and overrides
                  • @@ -2465,82 +2521,79 @@

                  OverviewNightscout is useful for all Loopers. Adults who take care of themselves find the reports and analysis methods from the Nightscout site provide effective tools to monitor their settings and provide reports for their health care provider. It also stores Loop configurations so they can be reviewed. With Loop 3, the saved Nightscout profiles can be downloaded to a new app for quick onboarding, should you ever need to start fresh.

                  -

                  Setting up a Nightscout site is described in a separate web site: Nightscout: Documentation.

                  -

                  There are Nightscout apps in your iPhone App Store that allow you to view the Nightscout site after you've configured it, or you can use a web browser to view the data. The app alone is not enough - you need to follow the steps to configure your own Nightscout site and obtain your specific Nightscout URL.

                  +

                  Nightscout is useful for many who use Loop. Adults who take care of themselves find the reports and analysis methods from the Nightscout site provide effective tools to monitor their settings and provide reports for their health care provider. It also stores Loop configurations so they can be reviewed. With Loop 3, the saved Nightscout profiles can be downloaded to a new app for quick onboarding, should you ever need to start fresh.

                  +

                  Setting up a Nightscout site is described in a separate web site: Nightscout: Documentation.

                  +

                  There are Nightscout apps in your iPhone App Store that allow you to view the Nightscout site after you've configured it, or you can use a web browser to view the data. The app alone is not enough - you need to follow the steps to configure your own Nightscout site and obtain your specific Nightscout URL.

                    -
                  • Nightscout is highly recommended for Loop users, especially those using Loop as caregivers
                    • -
                  • Nightscout displays are often the easiest way to troubleshoot Loop settings if you are having problems and seeking input from others
                    • -
                  • Nightscout provides reporting features for longer-term review and preparing information for your physician
                    • +
                  • Nightscout is highly recommended for Loop users, especially those using Loop as caregivers
                    • +
                  • Nightscout displays are often the easiest way to troubleshoot Loop settings if you are having problems and seeking input from others
                    • +
                  • Nightscout provides reporting features for longer-term review and preparing information for your physician
                  -

                  Nightscout Documentation

                  -

                  There used to be a lot of Nightscout information found only in LoopDocs, but that was transferred and subsequently updated in Nightscout: Documentation. The information that remains in LoopDocs is Loop specific. So you may be jumping back and forth between the two sets of documents.

                  +

                  Nightscout Documentation

                  +

                  There used to be a lot of Nightscout information found only in LoopDocs, but that was transferred and subsequently updated in Nightscout: Documentation. The information that remains in LoopDocs is Loop specific. So you may be jumping back and forth between the two sets of documents.

                    -
                  • If you see the Nightscout Owl logo in upper left you are in the Nightscout website
                    • -
                  • If you see the LoopDocs green-loop logo in upper left you are in the LoopDocs website
                    • -
                  • While in the Nightscout tab of LoopDocs, most links have a Nightscout: or LoopDocs: in the link name to let you know which website has the link of interest
                    • -
                  • Suggestion: open the Nightscout: Documentation in a separate tab or window of your browser for easy access to both websites
                    • +
                  • If you see the Nightscout Owl logo in upper left you are in the Nightscout website
                    • +
                  • If you see the LoopDocs green-loop logo in upper left you are in the LoopDocs website
                    • +
                  • While in the Nightscout tab of LoopDocs, most links have a Nightscout or LoopDocs in the link name
                    • +
                  • Suggestion: open the Nightscout: Documentation in a separate tab or window of your browser for easy access to both websites
                  -

                  Nightscout with Loop

                  -

                  This page provides general discussion about the Nightscout display, as well as some Loop-specific display information. Over time, interactions between Loop and Nightscout were improved. The information on this page has been updated for Loop 3 and Nightscout version 14.2.6 (or later). Older versions may exhibit some differences in display of Loop information on the Nightscout site.

                  -

                  Loop Uploads to Nightscout

                  -
                  -

                  Loop 3

                  -

                  The Nightscout display updates when the Looper's phone is connected to the internet via WiFi or cellular service. When the uploads stop, the Loop pill becomes "stale" (cannot open it) after 15 minutes.

                  -

                  "Pills" are the little information boxes. They are Nightscout: Plugins that must be enabled with configuration variables and then the display for each pill can be turned on or off within your Nightscout site.

                  -

                  If upload to Nightscout is interrupted, Loop stores up to 7 days of Nightscout information in a local buffer on the phone, and will attempt to upload later when access is restored. Once access is restored, a stale Loop Pill may require 15 minutes before it will open to display additional Loop information.

                  -

                  The Carb pill on the Nightscout site is populated by Loop when Loop is actively uploading to Nightscout - but it may lag the value displayed in the Loop pill by one loop cycle and it will display 0 COB within 5 to 10 minutes if upload is interrupted. In other words, if the COB pill shows 0 unexpectedly and Loop pill is active, you can believe the value shown in the Loop pill.

                  -
                  -

                  Loop 2 Red Loop Warning

                  -

                  With Loop 2.2.9 and earlier versions, when Loop has a Nightscout site added in Loop Services AND is unable to upload messages to that site, it can fill up a buffer of stored upload messages. This may lead to sluggish behavior in Loop or even Red Loops. This can happen if the Nightscout site is "down" or if the database is full so it is not accepting messages.

                  -

                  Step 1: Remove Nightscout URL from Loop Services

                  -

                  Step 2: Figure out why the Nightscout site is not accepting uploads from Loop and fix that problem.

                  +

                  Nightscout with Loop

                  +

                  This page provides general discussion about the Nightscout display, as well as some Loop-specific display information. Over time, interactions between Loop and Nightscout were improved. The information on this page has been updated for Loop 3 and Nightscout version 14.2.6 (or later). Older versions may exhibit some differences in display of Loop information on the Nightscout site.

                  +

                  Loop Uploads to Nightscout

                  +

                  The Nightscout display updates when the Loop phone is connected to the internet via WiFi or cellular service. When the uploads stop, the Loop pill becomes "stale" (cannot open it) after 15 minutes.

                  +

                  "Pills" are the little information boxes. They are Nightscout: Plugins that must be enabled with configuration variables and then the display for each pill can be turned on or off within your Nightscout site.

                  +

                  If upload to Nightscout is interrupted, Loop stores up to 7 days of Nightscout information in a local buffer on the phone, and will attempt to upload later when access is restored. Once access is restored, a stale Loop Pill may require 15 minutes before it will open to display additional Loop information.

                  +

                  The Carb pill on the Nightscout site is populated by Loop when Loop is actively uploading to Nightscout - but it may lag the value displayed in the Loop pill by one loop cycle and it will display 0 COB within 5 to 10 minutes if upload is interrupted. In other words, if the COB pill shows 0 unexpectedly and Loop pill is active, you can believe the value shown in the Loop pill.

                  +

                  Loop 2 Red Loop Warning

                  +

                  With Loop 2.2.9 and earlier versions, when Loop has a Nightscout site added in Loop Services AND is unable to upload messages to that site, it can fill up a buffer of stored upload messages. This may lead to sluggish behavior in Loop or even cause a Red Loop. This can happen if the Nightscout site is "down" or if the database is full so it is not accepting messages.

                  +

                  Step 1: Remove Nightscout URL from Loop Services

                  +

                  Step 2: Figure out why the Nightscout site is not accepting uploads from Loop and fix that problem.

                  -

                  Step 3: Add Nightscout URL to Loop Services

                  -
                  -

                  More Information

                  +

                  Step 3: Add Nightscout URL to Loop Services

                  +
                  +Do you want to know more? (Click to open)

                  For those who want to know more:

                  -

                  There is a big architectural change between Loop 2 and Loop 3 for remote data services like Nightscout.

                  -

                  It used to be that data would be “held on” to be uploaded, and a non functional service could cause large backlogs. The new system does not allow for this. Uploaders individually keep track of where they are in the upload stream via a lightweight “query handle”, and if the data in Loop’s data stores expires before they upload, then they’ll just not be able to upload that data.

                  -

                  The default data store for Loop 3 is 7 days.

                  -
                  -

                  Nightscout Dashboard

                  +

                  There is a big architectural change between Loop 2 and Loop 3 for remote data services like Nightscout.

                  +

                  It used to be that Loop would keep trying to upload data to Nightscout. If a site could not be reached or would not accept data, that could cause large backlogs. Loop 2 could slow down by trying to keep uploading the backlog. The new system does not allow for this. Uploaders individually keep track of where they are in the upload stream via a lightweight “query handle”, and if the data in Loop data store expires before upload, that data will be missing in Nightscout.

                  +

                  Loop 3 saves 7 days of information in the data store.

                  + +

                  Nightscout Dashboard

                  img/example.jpg

                  Blood Glucose

                  -

                  Glucose readings from the CGM are shown in green, yellow, or red in the main Dashboard of Nightscout. (The graphic above was generated with Colors enabled in Nightscout; there are other display options.) You can adjust your high and low glucose alarm thresholds in Nightscout by modifying configuration variables. This is optional - defaults are provided if you do not set them. The alarm thresholds affect the color of the displayed CGM data points and, if enabled, determine when an audible and visible alarm sounds. The Nightscout alarm thresholds will not affect Loop performance. Loop only uses the glucose correction ranges in the Loop app settings.

                  -

                  The main dashboard (upper section) for Nightscout displays the time duration you have selected (in the example above, 12 hours). The bottom of the screen shows the last 48-hours of glucose trends. You can scan backward by dragging the bottom timeline to the left, if you want to review specific Loop actions or data in the last two days.

                  +

                  Glucose readings from the CGM are shown in green, yellow, or red in the main Dashboard of Nightscout. (The graphic above was generated with Colors enabled in Nightscout; there are other display options.) You can adjust your high and low glucose alarm thresholds in Nightscout by modifying configuration variables. This is optional - defaults are provided if you do not set them. The alarm thresholds affect the color of the displayed CGM data points and, if enabled, determine when an audible and visible alarm sounds. The Nightscout alarm thresholds will not affect Loop performance. Loop only uses the glucose correction ranges in the Loop app settings.

                  +

                  The main dashboard (upper section) for Nightscout displays the time duration you have selected (in the example above, 12 hours). The bottom of the screen shows the last 48-hours of glucose trends. You can scan backward by dragging the bottom timeline to the left, if you want to review specific Loop actions or data in the last two days.

                  SAGE, CAGE, BAGE pills

                  -

                  The SAGE, CAGE, and BAGE pills are for Sensor Age, Cannula Age, and (pump) Battery Age. These optional pills track the time since your CGM sensor, Pump site, and Pump battery were last changed. You can set up custom alerts to remind you when it is time to change the devices, or simply use the visuals to keep track of your particular timing for site/sensor changes. These fields will not auto-update from pump or CGM devices, instead you will have to update them using Nightscout Careportal so that the pill information is accurate.

                  +

                  The SAGE, CAGE, and BAGE pills are for Sensor Age, Cannula Age, and (pump) Battery Age. These optional pills track the time since your CGM sensor, Pump site, and Pump battery were last changed. You can set up custom alerts to remind you when it is time to change the devices, or simply use the visuals to keep track of your particular timing for site/sensor changes. These fields will not auto-update from pump or CGM devices, instead you will have to update them using Nightscout Careportal so that the pill information is accurate.

                  Carbs

                  -

                  Carbs are automatically uploaded to Nightscout by the Loop app. The amount of carbs on board (active carbs or COB) can be seen by clicking the Loop pill. The size of a white carb dot on the graph is proportional to the amount of carbs entered...bigger meals get bigger dots. Loop does not read carbs from Nightscout for use in looping calculations, it only uploads carbs to Nightscout that have been entered in the Loop app.

                  +

                  Carbs are automatically uploaded to Nightscout by the Loop app. The amount of carbs on board (active carbs or COB) can be seen by clicking the Loop pill. The size of a white carb dot on the graph is proportional to the amount of carbs entered...bigger meals get bigger dots. Loop does not read carbs from Nightscout for use in looping calculations, it only uploads carbs to Nightscout that have been entered in the Loop app.

                  Boluses

                  -

                  Insulin boluses are automatically uploaded to Nightscout by the Loop app. The bolus is shown as a filled-in blue lower-half of the dot, and the specific amount of the bolus is also shown. There may be a separation between the bolus and the carb entry, especially if the user preboluses a meal.

                  -

                  The bolus is uploaded to Nightscout as soon as it starts and Insulin on board (active insulin or IOB) is updated in the Loop pill. Should the bolus be interrupted, the Nightscout information is updated when the Loop information updates (assuming internet access is active).

                  +

                  Insulin boluses are automatically uploaded to Nightscout by the Loop app. The bolus is shown as a filled-in blue lower-half of the dot, and the specific amount of the bolus is also shown. There may be a separation between the bolus and the carb entry, especially if the user preboluses a meal.

                  +

                  The bolus is uploaded to Nightscout as soon as it starts and Insulin on board (active insulin or IOB) is updated in the Loop pill. Should the bolus be interrupted, the Nightscout information is updated when the Loop information updates (assuming internet access is active).

                  Temp Basals

                  -

                  Your current basal profile is automatically updated to Nightscout whenever it is changed by Loop. The dashed blue line represents the scheduled basal profile. The solid blue lines indicate the actual basal amounts set for a given time...so as Loop sets temp basals higher or lower than your scheduled basal rate. If the graph and Loop pill do not agree, you should believe the Loop pill.

                  +

                  Your current basal profile is automatically updated to Nightscout whenever it is changed by Loop. The dashed blue line represents the scheduled basal profile. The solid blue lines indicate the actual basal amounts set for a given time...so as Loop sets temp basals higher or lower than your scheduled basal rate. If the graph and Loop pill do not agree, you should believe the Loop pill.

                  Predicted BG

                  -

                  The purple line to the right of the BG is Loop's predicted BG. Watching the behavior of that purple line can help you understand why Loop is making decisions regarding high or low temps. You can read more on that topic in the LoopDocs: Algorithm section of these docs. If you don't see the prediction (and all other Nightscout and Loop settings are configured), tap on the 3 dots to the right of the 24 to reveal the choice to display AR2 prediction or Loop prediction. Adjust the check boxes to show just the Loop prediction.

                  -

                  Loop pill

                  -

                  The Loop pill is the little display box which, when hovered over or clicked, will provide additional information about recent Loop activities and status. Information included is the last time Loop ran, the temp basal set, IOB, and COB. Looking at the Loop pill is a quick method for assessing if your loop is currently active, as well.

                  +

                  The purple line to the right of the BG is Loop predicted BG. Watching the behavior of that purple line can help you understand why Loop is making decisions regarding high or low temps. You can read more on that topic in the LoopDocs: Algorithm section of these docs. If you don't see the prediction (and all other Nightscout and Loop settings are configured), tap on the 3 dots to the right of the 24 to reveal the choice to display AR2 prediction or Loop prediction. Adjust the check boxes to show just the Loop prediction.

                  +

                  Loop pill

                  +

                  The Loop pill is the little display box which, when hovered over or clicked, will provide additional information about recent Loop activities and status. Information included is the last time Loop ran, the temp basal set, IOB, and COB. Looking at the Loop pill is a quick method for assessing if your loop is currently active, as well.

                  -

                  Loop Pill status indicator symbols

                  +

                  Loop Pill status indicator symbols

                  X   -Error in Loop

                  +Error in Loop

                  ϕ   Recommending basal, but not enacting (open loop or pump suspended)

                  ⌁   Enacted a new temp basal

                  ↻   -Loop is continuing with last temp basal, no change

                  +Loop is continuing with last temp basal, no change

                  ⚠   -Warning indicating Loop is either red or has failed to upload to Nightscout for a longer period of time.

                  +Warning indicating Loop is either red or has failed to upload to Nightscout for a longer period of time.

                  -

                  Mouse over or Touch the Loop pill to view a tool tip containing one or more of the latest status messages. The most up-to-date Nightscout also includes information in the Loop pill for the minimum and maximum predicted BG, eventual and predicted BG.

                  +

                  Mouse over or Touch the Loop pill to view a tool tip containing one or more of the latest status messages. The most up-to-date Nightscout also includes information in the Loop pill for the minimum and maximum predicted BG, eventual and predicted BG.

                  img/loop_pill_message.png

                  diff --git a/nightscout/remote-commands/index.html b/nightscout/remote-commands/index.html new file mode 100644 index 00000000000..2d2c1a12adb --- /dev/null +++ b/nightscout/remote-commands/index.html @@ -0,0 +1,2902 @@ + + + + + + + + + + + + + + + + + + + + + + Remote Commands - LoopDocs + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + +
                  + + + + + + +
                  + + + + + + + +
                  + +
                  + + + + +
                  +
                  + + + +
                  +
                  +
                  + + + + + + +
                  +
                  +
                  + + + +
                  +
                  +
                  + + + + + +
                  +
                  +
                  + + + +
                  +
                  + + + + +

                  Remote Commands

                  + +

                  Requirements

                  +

                  All remote commands require the configuration steps from Remote Configuration.

                  +
                    +
                  • A new One-Time Password (OTP) is required for each remote command that issues a bolus or adds a carb entry
                      +
                    • The OTP updates every 30 seconds
                      • +
                    • Both the sending device and the Looper's phone must have automatic time enabled
                      • +
                    +
                    • +
                  • Remote Overrides do not require a One-Time Password (OTP)
                      +
                    • There are some versions of Nightscout that provide a row for entry of an OTP for Temporary Override in the Nightscout Careportal
                      • +
                    • Leave that row blank
                      • +
                    +
                    • +
                  +
                  +

                  Do I have to use Loop Caregiver?

                  +

                  There are a number of methods for using remote commands.

                  +

                  Things everyone needs to know are covered on this page, so you should read it regardless of how you plan to issue remote commands.

                  +

                  If you decide on Loop Caregiver, review both this page and Loop Caregiver page.

                  +
                  +

                  QR Code

                  +

                  On the Looper's phone, Nightscout must be included under the Loop -> Settings -> Services section. Navigate to Services and select Nightscout. Tap on the One-Time Password row to view the QR code.

                  +

                  When you need to configure your authentication method, you can either use a saved QR screenshot or scan the QR on the Looper's phone.

                  +

                  Options:

                  +
                    +
                  • Have your Looper (or at least their phone) available
                    • +
                  • Save a screen shot of their QR code
                      +
                    • Keep this secure
                      • +
                    • Do not share the QR screen shot when asking for help
                      • +
                    +
                    • +
                  +

                  example screen for nightscout and qr code

                  +

                  While you are on the Settings -> Services -> NightScout screen, notice that the 6-digit number on the One-Time Password row updates every 30 seconds.

                  +

                  Set up an Authentication App

                  +

                  You need to set up an authentication app to generate one-time-passwords for remote bolus and carbs.

                  +

                  One of the nice features of Loop Caregiver is that it handles the one-time password (OTP) requirements for you.

                  +

                  But even if you choose to use Loop Caregiver, you should configure an authentication app for cases where you don't have access to your Loop Caregiver phone.

                  +

                  There are several authentication apps that support one-time passwords.

                  +

                  Apple Keychain

                  +

                  If you are using a iPhone or Mac to issue remote commands through a browser or Nightscout app, you can use the Apple Keychain which has native support to store passwords and generate one-time passwords.

                  +

                  To setup your Nightscout credentials in Apple Keychain:

                  +

                  On the Caregivers device (iPhone or Mac):

                  +
                    +
                  • Go to Apple Settings -> Passwords
                    • +
                  • +

                    Tap the + Button up top to add a new Password

                    +

                    add password screen for apple keychain

                    +
                    • +
                  • +

                    You will enter your Nightscout credentials

                    +
                      +
                    • Website: Enter a portion of the Nightscout URL, without the leading “https://”
                      • +
                    • Username: Enter the full Nightscout URL including the leading “https://” part
                      • +
                    • Password: Enter the API_SECRET for the Looper's Nightscout site
                      • +
                    • Tap Done
                      • +
                    +
                    • +
                  • Next, you are offered a screen that allows you to set up a Verification Code
                      +
                    • If you need to come back later, you can find that screen again
                      • +
                    • Go to Apple Settings -> Passwords -> Tap the row with your Nightscout URL
                      • +
                    +
                    • +
                  • Tap “Setup Verification Code”
                      +
                    • This is where you can scan your QR code from the Looper's phone or the saved QR screenshot
                      • +
                    • As soon as the camera reads the QR code, an OTP will begin to appear
                      • +
                    • If the Looper's phone is handy, wait a cycle or two and ensure the 6-digit OTP on the password screen matches that on the Looper's phone and they update at the same time
                      • +
                    • Click Passwords on upper left to return to the prevous screen
                      • +
                    +
                    • +
                  • Select Passwords Options
                      +
                    • Enable the Autofill Passwords and check Keychain
                      • +
                    +
                    • +
                  +

                  Using Safari

                  +
                    +
                  • When you use Safari to view your Looper's Nightscout site and choose the Careportal ()
                      +
                    • Choose a remote command from Event Type drop-down menu (remote commands are at the bottom of the list)
                      • +
                    • The OTP will be offered to you for every row - ignore it when entering Carb amount or Absorption Time, or Bolus Amount
                      • +
                    • Select it for the OTP row
                      • +
                    • Note that OTP is not required for Remote Overrides - leave that row blank
                      • +
                    +
                    • +
                  +

                  Other Authentication Apps

                  +

                  There are other Authentication apps available. Here’s a few options that you can download from your phone’s app store:

                  +
                    +
                  • 1Password
                    • +
                  • Authenticator
                    • +
                  • Authy
                    • +
                  +

                  FAQs for all Remote Commands

                  +
                    +
                  1. +

                    If I have multiple Nightscout sites because I support multiple people with T1D looping, do I need multiple APNs Keys?
                    +Answer: No. If you support multiple people using Loop, you can use the one APNs key in each of their Nightscout sites.

                    +
                    2. +
                  2. +

                    How can I tell if it worked?
                    +Answer: You should see your override pill in Nightscout, with the NEXT Loop cycle, reflecting that the desired remote action took place. If you are near the Loop app, you should see the new override within less than 30 seconds or so.

                    +
                    3. +
                  +

                  FAQs on Remote Overrides

                  +

                  Don't forget to read Loopdocs: Overrides.

                  +

                  For remote overrides in particular:

                  +
                    +
                  1. +

                    Can I set a different override in Nighscout than I have programmed into Loop app?
                    +Answer: No. You will only be able to enact override presets already programmed into the Loop app.

                    +
                    2. +
                  2. +

                    If I didn't start the override in Nightscout (it was started in Loop itself), can I still use Nightscout to cancel it?
                    +Answer: Yes. You can cancel an override set in Loop with a Nightscout-set cancel "temporary override" command in the careportal.

                    +
                    3. +
                  3. +

                    Can I replace an override set in Loop with an override set in Nightscout?
                    +Answer: Yes.

                    +
                    4. +
                  4. +

                    Can I see on Nightscout when a temporary override has been set using the looper’s phone?
                    +Answer: Yes. There will be a grey bar with the name of the override noted and the Loop Pill will display the targets and duration. Remember, there is a KNOWN issue with the grey bars, so use the pill as your best guide.

                    +
                    5. +
                  5. +

                    Can a looper cancel a remote override?
                    +Answer: Yes. They can tap the heart icon in Loop so that it is no longer highlighted. This turns off the override, regardless of where it was initiated.

                    +
                    6. +
                  6. +

                    I set a remote override in Nightscout but the Looper tapped the heart symbol in the Loop app, so the override turned off. Will the override get reinstated the next time Loop completes with internet access?
                    +Answer: No. The APN is only sent once. You can set the remote override again if need be.

                    +
                    7. +
                  7. +

                    Can I schedule a remote override ahead of time using Nightscout?
                    +Answer: No. When you set a remote override in Nightscout, it starts immediately and lasts for the duration programmed for that override in the Loop app. You can only set an override in advance using the Loop app.

                    +
                    8. +
                  +

                  Remote Commands

                  +

                  Remote Commands to deliver a bolus or add a carb entry require a One Time Passcode (OTP).

                  +
                  +

                  Minimum Versions:  Loop 3 and  Nightscout 14.2.6

                  +

                  If your Nightscout version does not meet that minimum requirement, remote commands might be accepted but if they are, the time for the commands is always the current time. In other words, Carbs in the Past or Future might be accepted, but would be entered at the current time on the looper's phone.

                  +
                  +

                  Warnings on Remote Commands

                  +
                  +

                  Duplicate Delivery Risk

                  +

                  We want to highlight a very important risk before you get started.

                  +

                  For safety, always assume a previous remote carbs/bolus was delivered. For motivation think of the following example:

                  +
                    +
                  • You send a 5-unit remote bolus.
                    • +
                  • The bolus is delivered to the Looper.
                    • +
                  • Nightscout is having a temporary technical issue and doesn't show the bolus was received.
                    • +
                  • You are watching Nightscout and you don’t see a delivery so you assume it failed.
                    • +
                  • You send another remote 5-unit bolus.
                    • +
                  • The second 5-unit bolus is delivered to the Looper (10 Units total).
                    • +
                  +
                  +

                  You can see the danger of sending duplicate bolus/carbs so be careful. If a remote bolus/carb entry doesn’t show in Nightscout, use your own judgment on whether enough time has passed to try again.

                  +

                  Remote Bolus, Then Remote Carb

                  +
                  +

                  If sending both, choose Bolus then Carbs

                  +

                  If you plan to send a carb command remotely and later decide to issue a bolus command - STOP and consider.

                  +

                  There are 2 scenarios of concern that could lead to too much insulin:

                  +
                    +
                  • Looper is using the Temp Basal (temporary basal) Dosing Strategy
                      +
                    • Loop will initiate a max Temp Basal when it receives the carbs remote command
                      • +
                    • Your bolus will be accepted and take place in addition to the high temporary basal
                      • +
                    +
                    • +
                  • Looper is using Automatic Bolus Dosing Strategy
                      +
                    • Loop will initiate 40% of the recommended dose when it receives the carbs remote command
                      • +
                    • Your bolus will be accepted and take place in addition to an automatic boluses
                      • +
                    +
                    • +
                  +

                  Typically, sending a remote carb entry alone is sufficient for Loop to know about the carbs and begin to dose for them.

                  +

                  If you really want to both bolus for carbs and enter carbs, then do it in that order.

                  +
                    +
                  1. The bolus, when accepted, will cause Loop to issue a 0 Temp Basal (temporary basal) (which is "safer")
                    2. +
                  2. The carbs, when accepted, will cause Loop to respond to the carbs while including the bolus already delivered and included in the Looper' IOB
                    3. +
                  +

                  ❗️ Remember - you should pause at least 60 seconds between remote commands or the One-Time-Password (OTP) will be rejected as having already been used.

                  +
                  +

                  Using Remote Commands

                  +

                  There are four ways you can trigger your commands remotely; Loop Caregiver (link takes you to a new page), Nightscout Careportal, Shortcuts, and IFTTT.

                  +

                  Loop Caregiver

                  +

                  Click the link above to read more about Loop Caregiver.

                  +

                  Nightscout Careportal

                  +

                  To use remote commands in the Careportal, you must configure Nightscout site according to the directions here in Loopdocs in addition to setting up the Remote Configuration.

                  +

                  Pay particular attention to these entries in the ENABLE line: override careportal Loop. The order of the words in the ENABLE line is not important.

                  +

                  You'll also need to have your site authenticated so that your Careportal is active to send remote overrides .

                  +

                  Once authenticated by entering your API_SECRET, there is a plus sign () in the upper right corner of your site. That is your Careportal. Tap the Careportal plus sign () and then scroll down in the event type menu to find Temporary Override.
                  +Within there, you will find all your Loop override presets already loaded for you.

                  +

                  Start and End Remote Override

                  +

                  img/careportal-overrides.PNG

                  +

                  The Looper will see a banner notification that a remote command has been sent with details about that command and whether it succeeded (or not).

                  +

                  img/override_notification.jpg

                  +

                  Canceling an override through Nightscout careportal is as simple as selecting the event type Temporary Override Cancel and submitting.

                  +

                  Command Remote Bolus or Carb Entry

                  +

                  Open your Nightscout site in a browser or app.

                  +
                    +
                  • Tap the Careportal plus sign () and then scroll down in the event type dropdown menu to find Remote Carb Entry or Remote Bolus Entry
                    • +
                  • Fill out the treatment log until you get to the OTP row
                      +
                    • When using Safari, the OTP code is automatically offered - might need to tap twice
                      • +
                    • For other authentication apps (Authenticator, 1Password, etc)
                        +
                      • Tap on the code in the authentication app and copy to your clipboard
                        • +
                      • In Nightscout and paste that code into the OTP box
                        • +
                      +
                      • +
                    • Click “Submit Form”
                      • +
                    +
                    • +
                  +

                  Note that Loop will honor both the current OTP code and the one that just expired.

                  +

                  If the Looper is with you, you can see the notification on their phone. You can see the entry on the Loop carbohydrate or the insulin displays to see if it went through.

                  +

                  If the Looper is not with you, you should see the result in the Nightscout dashboard within 5 minutes.

                  +

                  Shortcuts

                  +

                  If you want to make your life SUPER AMAZING, check out using the iPhone's Shortcuts app. The Shortcuts app is for making little automations (like mini apps) that can integrate parts of your life. In this case, we've written a couple of shortcuts for you that integrate  Loop  overrides with Nightscout.

                  +
                  +

                  Important Note

                  +

                  Before you click on the download file below...save yourself some trouble.

                  +
                    +
                  1. Download the Shortcuts app if you don't have it yet
                    2. +
                  2. Choose to run any shortcut from the Gallery. It can be the laundry timer...I don't care, just pick one shortcut and run it.
                    3. +
                  3. THEN, go to download the shortcut of your choice below.
                    + ℹ️ The shortcuts that aren't run through the Gallery option are called "untrusted". And you need a slider in your iPhone to trust the "untrusted" shortcuts you would be downloading here.
                    + But...in a lovely iOS glitch...that slider doesn't appear unless you've run a trusted shortcut first. So, run one now.
                    4. +
                  4. Then, this slider will now be visible in the iPhone Settings app under the Shortcuts app menu.
                    5. +
                  5. When you will see the message "This shortcut cannot be opened because your Shortcuts security system settings don't allow untrusted shortcuts"
                    6. +
                  6. Open iPhone Settings and scroll down the list and tap the Shortcuts menu to turn on "Allow Untrusted Shortcuts".
                    7. +
                  +
                  +

                  Click these links on your iPhone and you'll be prompted to download the premade shortcuts (assuming you open the links in Safari browser on iPhone):

                  +

                  Comprehensive Loop Shortcut + includes Set Remote Override, Cancel Override, Loop Troubleshooting Tips, Quick Text options, Manual BG entry, Bookmarks to websites, etc.

                  +

                  And if you want to save one click to get to these one functions more directly: these shortcuts are simplified to offer only one function:

                  +

                  Set Remote Override only shortcut

                  +

                  Cancel Override only shortcut

                  +
                  +

                  A couple notes about these shortcuts:

                  +

                  You need to open those links in the Safari browser on your iPhone. A confirmation will show to initiate the download.

                  +

                  After the download finishes, tap the button marked AA near your Safari address bar and tap Downloads (downloads) to find and open the downloaded Shortcut.

                  +

                  Wait a bit, and the shortcut's inner guts will be there...scroll ALL the way down to the bottom to click the button to save the untrusted shortcut

                  +
                  +
                    +
                  1. When you enter your Nightscout URL in the URL field of the  Loop  shortcut setup, make sure you don't include a trailing /, or the API calls to Heroku will error out.
                    2. +
                  2. When a remote override is set properly, you'll see an ok message displayed. If there is an error, you'll see an error message. Most errors will be that you have an API_SECRET wrong (make sure there isn't a space at the end of your API_SECRET that you don't see) or you failed to do the steps to setup Nightscout and update your Loop app as described in steps 1-3 above.
                    3. +
                  3. You can absolutely customize these bits and pieces within the shortcut. Change the text messages, and change the links... It is totally up to you.
                    4. +
                  +

                  IFTTT

                  +

                  If you want to walk uphill both ways in the snow carrying bags of uneven groceries, you can also set overrides remotely by using If This, Then That (IFTTT) integration. By using IFTTT, you can have single button presses on your phone that will set an override, log a cannula change, log a sensor change and much more.

                  + + + + + + + +
                  +
                  + + +
                  + + + +
                  + + + +
                  +
                  +
                  +
                  + + + + + + + + + + + + + \ No newline at end of file diff --git a/nightscout/remote-config/index.html b/nightscout/remote-config/index.html new file mode 100644 index 00000000000..5e902c8658e --- /dev/null +++ b/nightscout/remote-config/index.html @@ -0,0 +1,2755 @@ + + + + + + + + + + + + + + + + + + + + + + Remote Configuration - LoopDocs + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + +
                  + + + + + + +
                  + + + + + + + +
                  + +
                  + + + + +
                  +
                  + + + +
                  +
                  +
                  + + + + + + +
                  +
                  +
                  + + + +
                  +
                  +
                  + + + + + +
                  +
                  +
                  + + + +
                  +
                  + + + + +

                  Remote Configuration

                  + +
                  +

                  Page Summary

                  +
                    +
                  1. Update the Looper's iPhone Settings
                    2. +
                  2. Create a Key for an Apple Push Notifications service (APNs)
                    3. +
                  3. Update Nightscout site and add some "config vars" lines in Nightscout site settings
                    4. +
                  4. Test Remote Overrides
                    5. +
                  +
                  +

                  Set Up Remote for Nightscout

                  +

                  You can use the Looper's Nightscout site to remotely set and cancel override presets in your Looper's Loop app.

                  +

                  With  Loop 3, you can also send remote commands to add carbs and command a bolus. Remote bolus/carb commands have a minimum requirement of  Nightscout 14.2.6. If your Looper's Nightscout version does not meet that minimum requirement, remote commands might be accepted, but the time for the commands is always the current time. In other words, Carbs in the Past or Future might be accepted, but would be entered at the current time on the Loop phone.

                  +

                  After you complete the configuration, read the entire Remote Commands page - pay attention to the warnings and caveats. Test this while your Looper is sitting next to you so you can watch their phone.

                  +
                  +

                  Remote Nightscout Interface Caveats

                  +
                    +
                  • Must use a paid Apple Developer account to build Loop
                      +
                    • Apple Push Notifications (APN) service is not available with a Free account
                      • +
                    +
                    • +
                  • When you build Loop, the required APN information is tied to your Apple Developer account
                      +
                    • You add your APN information to your Looper's Nightscout site
                      • +
                    • If you support multiple Looper's, you add the same APN variables to each of their Nightscout sites
                      • +
                    +
                    • +
                  • There are many choices for building your own or paying someone to build a Nightscout site
                      +
                    • The directions for only one of the options is documented on this page
                      • +
                    • Use that as a guide for your site
                      • +
                    +
                    • +
                  • Nightscout Docs: Comparison Table
                      +
                    • Warning: examine the Loop remote carbs/bolus row
                      • +
                    • If a green check is missing, it might just be too new for evaluation
                      • +
                    +
                    • +
                  +
                  +

                  Step 1: Update the Looper's iPhone settings

                  +

                  For remote commands to successfully deploy to a Looper's iPhone when the phone is locked, they must have Background App Refresh enabled.

                  +
                    +
                  • The slider in iPhone -> Settings -> General -> Background App Refresh -> Loop must be enabled
                    • +
                  +

                  Consequence if Looper's phone is not configured correctly:

                  +
                    +
                  • If Background app refresh is not enabled, the remote overrides might only enact if the Loop app is open and the phone is unlocked
                    • +
                  +
                  +

                  Keep Notifications Turned on for Looper's Phone

                  +

                  Typically, the Looper's phone has Notifications enabled for Loop. In fact, if they don't, a red warning bar is prominently displayed.

                  +

                  There may be times when you really need Loop to be quiet, so you can turn off Notifications. The remote commands still go through but the Looper does not see a notification that this happened.

                  +

                  Best practice is to keep Loop Notifications enabled.

                  +
                  +

                  Step 2: Apple Push Notifications

                  +

                  The step is required for the Loop app to give permissions to your Nightscout site to remotely interact with it. To enable this, you need to create a key and grant it access to the Apple Push Notification Service (APNS).

                  +
                  +

                  Reminder

                  +

                  This only works with the paid Apple Developer ID.

                  +
                  +
                    +
                  1. To get started, go to the Keys section under Apple Developer's Certificates, Identifiers & Profiles and login with the Apple ID associated with your developer team that you used to build the Loop app.
                    2. +
                  2. If not already open in your browser (compare with the below screenshot),
                      +
                    • Click on Keys (located in the left-hand column).
                      • +
                    • Either click on the blue Create a new key button OR the plus button () to add a new key.
                      +

                      img/apns-add-key.png

                      +
                      +
                      • +
                    +
                    3. +
                  3. In the form that appears, do the following:
                      +
                    • Click the checkbox for enabling Apple Push Notifications service (APNs)
                      • +
                    • Enter a name for the key such as Nightscout (you can name it however you want, just make sure you know what the key is for by the name you choose).
                      • +
                    • Then click the Continue button in the upper right of the screen.
                      +

                      img/key-apns.png

                      +
                      +
                      • +
                    +
                    4. +
                  4. In the screen that follows, click the blue Register button.
                    +

                    img/apns-register.png

                    +
                    +
                    5. +
                  5. In the screen that follows, click the blue Download button.
                    + This step will download a file with a name that starts with AuthKey and ends with .p8.
                    +

                    img/apns-download.png

                    +
                    +
                    6. +
                  6. Find your AuthKey downloaded file in your downloads folder.
                    + Double-click to open it and you will be presented a message asking how you'd like to open it. The graphic and instructions below are for a Mac. Make sure your editor does not change any characters in your APN key; use a text-only editor like NotePad (PC) or TextEdit (Mac). + Click on Choose Application... and then select TextEdit as your application to open it with.
                    +

                    img/apns-open.png +img/apns-textedit.png

                    +
                    +
                    7. +
                  7. +

                    When the file opens, it will look similar to the screenshot below. In a few minutes, after we do a few other steps first, we will need to highlight ALL OF THE CONTENTS of that file and copy it because we will be pasting it in Heroku or whichever Nightscout provider you are using. Yes, allllll of the contents.
                    + So, the easiest way is to:

                    +
                      +
                    • Click inside that file
                      • +
                    • Highlight all the text, and then
                      • +
                    • Copy all the text to the clipboard (Cf. screenshot below).
                        +
                      • On a Mac, press Cmd+A to select all, then press Cmd+C to copy the selection.
                        • +
                      • On a PC, press Ctrl+A to select all, then press Ctrl+C to copy the selection.
                        • +
                      +
                      • +
                    +

                    You don't have to do it right now...just keep that window open in the background for now until we need it a little further down. Then we will copy all that text.

                    +
                    +

                    img/apns-copy-key.png

                    +
                    +
                    8. +
                  +

                  Step 3: Add APN to Nightscout

                  +

                  Update Nightscout Site

                  +

                  You'll need to make sure your Nightscout site version is version 13.0.1 or newer for remote overrides and version 14.2.6 or newer for access to all the remote command features.

                  +
                  +

                  What is my Nightscout Version Number?

                  +

                  To find your Nightscout version number:

                  +
                    +
                  • Tap on (☰) the hamburger button (3 horizontal lines stacked on each other) at the upper right, near the authentication button.
                    • +
                  • A context menu slides in from below the hamburger.
                    • +
                  • Scroll to the very bottom of this menu.
                    • +
                  • The version is located in the About section after the Settings section, (below the Save button).
                    • +
                  +
                  +

                  This link should be used if you want to Nightscout: Update your Nightscout site.

                  +
                  +

                  Note for Google Cloud Users

                  +

                  The Xdrip: Google Cloud Nightscout instructions include information about updating your site.
                  +Scroll down to the line (on that page) that says Update Nightscout.

                  +
                  +

                  Add APN Variables to Nightscout

                  +

                  In order to use remote overrides, you must add a couple of new variables. If you don't know how to update your Nightscout configuration, review Nightscout: Setup Variables and then come back.

                  +

                  The instructions in this section show Heroku images. If you are using a different method, you should be able to "translate" the steps.

                  +

                  Go to the Settings tab near the top of the screen on your Heroku app and then click on Reveal Config Vars.

                  +
                  +

                  img/heroku5.png

                  +
                  +

                  Scroll down the bottom of the Config Vars lines until you find the last blank one. You are going to add three new rows of config vars for remote overrides as shown below:

                  +
                  +

                  img/add_vars.jpg

                  +
                  + + + + + + + + + + + + + + + + + + + + + + + + + +
                  KEY
                  		VALUE
                  LOOP_APNS_KEYEnter the ENTIRE contents of the downloaded .p8 file including the BEGIN and END lines. Here's where you can use the Cmd+A and Cmd+C to highlight and copy all the text in that file so you can paste it into Heroku here for this new variable you are creating. img/apns-copy-key2.png
                  LOOP_APNS_KEY_IDString of characters on the .p8 download file immediately following the underscore (_) and not including the file extension (.p8), or you can get it from your saved key in your developer account as shown next step, too. This is a part of the downloaded filename located after the underscore (_) and before the file extension (.p8). img/apns-open2.png
                  LOOP_DEVELOPER_TEAM_IDGet this value from Loop app signing or in your Apple Developer account's top right corner under your name img/apns-vars.png
                  LOOP_PUSH_SERVER_ENVIRONMENT(optional) Set this to production if you installed Loop remotely such as with TestFlight, Diawi, AppCenter, or an IPA.
                  If you built directly to your phone in XCode with your phone plugged into to your computer, do not include this variable.
                  +

                  Remote Build Config Var Requirement

                  +

                  That last row of the table above is needed if you are using a remote build option such as LoopDocs: GitHub Build Actions or downloaded an archived file via Loop and Learn: Remote Build with Diawi. If you later return to a direct Xcode build to your phone, you must remove that config var or remote commands will not work.

                  +

                  When executed properly, you should have something that looks like this for the three (or four) new variables that you added:

                  +
                  +

                  the 3 or 4 config vars required for <span translate="no">Nightscout</span> remote commands to work

                  +
                  +

                  BadDeviceToken

                  +

                  When the Nightscout config var LOOP_PUSH_SERVER_ENVIRONMENT does not match the Loop app build method; the error message contains the phrase APNs delivery failed: BadDeviceToken.

                  +
                    +
                  • If Loop was installed remotely (typically from TestFlight following GitHub Browser Build), you must have Nightscout config var LOOP_PUSH_SERVER_ENVIRONMENT set to production
                    • +
                  • If Loop was built using Mac-Xcode, you cannot have LOOP_PUSH_SERVER_ENVIRONMENT as one of your Nightscout config vars
                    • +
                  +

                  Do Not Confuse Your Keys

                  +
                  +

                  API Key vs APN Key

                  +

                  If you build with the GitHub Browser Build, you may notice the Application Programming Interface (API) key has the same type of format as the Apple Push Notification (APN) key. The keys for both purposes are of type p8, but should not be confused.

                  +

                  The Secrets for building with GitHub use the API Key.

                  +

                  The config vars for Nightscout use the APN Key.

                  +
                    +
                  • If you are using remote commands with Nightscout and building with the GitHub Browser build method, you must also add the config var of LOOP_PUSH_SERVER_ENVIRONMENT with a value of production to your Nightscout site or the remote commands will not work.
                    • +
                  • If you are using the Mac-Xcode build method, you should not have a config var of LOOP_PUSH_SERVER_ENVIRONMENT entered - remove it if it is present.
                    • +
                  +
                  +

                  Step 4: Test Remote Overrides

                  +

                  If remote overrides do not function, remote commands for delivering a bolus or adding a carb entry will not work either.

                  +

                  After you finish setting up your Nightscout site:

                  +
                    +
                  1. Use the Looper's phone to set an override
                    2. +
                  2. Make sure that override shows up on the Nightscout site
                    3. +
                  3. Then using the Nightscout Careportal, test that you can turn off that override
                    4. +
                  +

                  Things to Check:

                  +
                    +
                  • Remote overrides will not start working until after you activate an override in the app at least once
                      +
                    • Activating an override from the Loop interface will upload the necessary push notification token to Nightscout which will enable remote commands to work
                      • +
                    • If your Looper gets a new phone - be sure to activate an override from the new phone before trying to use remote commands
                      • +
                    +
                    • +
                  • Notifications must be allowed in Loop
                    • +
                  • Give loop access to all health data
                    • +
                  • Enable Background App Refresh
                    • +
                  • Double check your Nightscout credentials
                    • +
                  • Low Power Mode may prevent background notifications from working
                    • +
                  • Some have found that activating the “Focus” and Do-Not-Disturb features on iOS can prevent push notifications from being delivered
                      +
                    • Turn these off when troubleshooting to eliminate this as a source of problems
                      • +
                    +
                    • +
                  • iOS 15.3.x: Note there are reports of Remote notifications not being received to the Loopers device for iOS version 15.3 and 15.3.1; this is fixed in iOS version 15.4
                    • +
                  • If you distribute the app remotely (i.e. TestFlight, Diawi, AppCenter), you must set a special Nightscout variable, LOOP_PUSH_SERVER_ENVIRONMENT to “production”, to enable push notifications +
                    • +
                  + + + + + + +
                  +
                  + + +
                  + + + +
                  + + + +
                  +
                  +
                  +
                  + + + + + + + + + + + + + \ No newline at end of file diff --git a/nightscout/remote-errors/index.html b/nightscout/remote-errors/index.html new file mode 100644 index 00000000000..4b44d7d5877 --- /dev/null +++ b/nightscout/remote-errors/index.html @@ -0,0 +1,2670 @@ + + + + + + + + + + + + + + + + + + + + + + Remote Errors - LoopDocs + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + +
                  + + + + + + +
                  + + + + + + + +
                  + +
                  + + + + +
                  +
                  + + + +
                  +
                  +
                  + + + + + + +
                  +
                  +
                  + + + +
                  +
                  +
                  + + + + + +
                  +
                  +
                  + + + +
                  +
                  + + + + +

                  Remote Errors

                  + +

                  Loop data is not showing in Nightscout

                  + +

                  Improper Configuration

                  +

                  Nightscout Config and Loop Build Method

                  +

                  Ensure your Nightscout version is at least version 14.2.6.

                  +

                  Verify that you performed all the Remote Configuration steps for the Nightscout site including sending an override from the Loop phone to Nightscout.

                  +

                  BadDeviceToken

                  +

                  When the Nightscout config var LOOP_PUSH_SERVER_ENVIRONMENT does not match the Loop app build method; the error message contains the phrase APNs delivery failed: BadDeviceToken.

                  +
                    +
                  • If Loop was installed remotely (typically from TestFlight following GitHub Browser Build), you must have Nightscout config var LOOP_PUSH_SERVER_ENVIRONMENT set to production
                    • +
                  • If Loop was built using Mac-Xcode, you cannot have LOOP_PUSH_SERVER_ENVIRONMENT as one of your Nightscout config vars
                    • +
                  +

                  If you attempt to issue a command from Nightscout Careportal; after you hit submit and then OK, you will see the error message:

                  +
                  Error: APNs delivery failed: BadDeviceToken
+
                  +

                  If you attempt to issue a command using Loop Caregiver; after you authenticate the command, you will see the error message listed below and shown in the screen shot.

                  +
                  HTTP Error
+Status Code: 500
+body: APNs delivery failed: BadDeviceToken
+
                  +

                  site and build method mismatch

                  +

                  Loop REMOTE_OVERRIDES_DISABLED

                  +

                  You can build Loop with Build-Time Features as part of code customization.

                  +

                  If you added this Build-Time Flag: REMOTE_OVERRIDES_DISABLED

                  +

                  You will not see any errors, but nothing will happen when you issue any kind of remote command.

                  +

                  Solution: Remove REMOTE_OVERRIDES_DISABLED from LoopConfigOverride.xcconfig file and rebuild the Loop app.

                  +

                  Incorrect Password (OTP) Error

                  +

                  The references to Caregiver below is the person sending the commands. There are specific Loop Caregiver app insructions that you modify for your authenticator. You must have the Loop phone with you to troubleshoot this problem.

                  +
                    +
                  • The Apple clock should be set to automatic on both the Looper's phone and Caregiver’s device.
                      +
                    • If the clock is incorrect, even slightly, remote commands will fail.
                      • +
                    +
                    • +
                  • Check if One-Time Passwords (OTP) align between Caregiver and Loop.
                      +
                    • In Loop: Settings -> Services -> Nightscout
                      • +
                    • In Loop Caregiver: Settings -> Tap on Loopers Name
                      • +
                    • Observe the 6-digit OTP as they change
                      • +
                    +
                    • +
                  • If the OTP don't match, you can reset it:
                      +
                    • Warning: If there are multiple devices (or people) sending remote commands, this procedure resets the OTP for all
                      • +
                    • Loop: Settings -> Services -> Nightscout -> One-Time Password -> Tap Reload button
                        +
                      • The QR code is different as soon as you hit Reload
                        • +
                      +
                      • +
                    • Loop Caregiver: Delete the Looper's profile from Loop Caregiver and add the Looper again by scanning their new QR code
                      • +
                    • Authenticators for every device used to send remote commands must be updated
                        +
                      • Delete the OTP configuration
                        • +
                      • Add the new QR code
                        • +
                      +
                      • +
                    +
                    • +
                  +

                  Undelivered or Expired Commands

                  +

                  Apple Push Notifications will often not make it to an app, either due to your settings or intentional limitations by Apple. This error can appear in various forms:

                  +
                    +
                  • Push notification banner never shows on Looper’s device.
                    • +
                  • Push notification banner shows but nothing happens in Loop (no error or success message afterwards)
                    • +
                  • Error message shows that Password (OTP) is expired
                    • +
                  +

                  While Loop does not have control over Push Notification timely delivery, there are things that can be done to mitigate these issues. Note that rebuilding Loop, Loop Caregiver or Nightscout is generally not going to help.

                  +

                  Check these settings on the Looper’s device, not the Caregivers. Several of these are related to Apple suppressing notifications.

                  +
                    +
                  • Notifications
                      +
                    • Settings -> Notifications -> Loop
                      • +
                    • Turn on “Allow Notifications”
                      • +
                    • Turn on “Time Sensitive Notifications”
                      • +
                    +
                    • +
                  • Focus Modes
                      +
                    • For all focus modes (ex: Do Not Disturb, Sleep), make sure Loop is listed as an app allowing Notifications.
                      • +
                    • To Adjust
                        +
                      • Settings -> Focus
                        • +
                      • Select the focus mode (ex: Do Not Disturb, Sleep)
                        • +
                      • Under “Allow Notifications, tap “Apps”
                        • +
                      • Add “Loop” to the list.
                        • +
                      • Turn on “Time Sensitive Notifications”.
                        • +
                      +
                      • +
                    +
                    • +
                  • Background App Refresh
                      +
                    • Settings -> General -> Background App Refresh
                      • +
                    • Select “On” up top
                      • +
                    • Activate Loop toggle in list
                      • +
                    +
                    • +
                  • Lower Power Mode
                      +
                    • Turn off if able
                      • +
                    +
                    • +
                  +

                  Some other things to try on the Looper’s phone:

                  +
                    +
                  • Reboot phone
                      +
                    • This sometimes resets Apple’s push notification limit.
                      • +
                    +
                    • +
                  • Try wifi instead of cellular, if able
                      +
                    • Apple may not deliver notifications on cellular as often as wifi.
                      • +
                    +
                    • +
                  • Charge the phone
                      +
                    • If the battery is low, iOS may not deliver notifications to save battery life.
                      • +
                    +
                    • +
                  • Limit the number of Loop commands you send in a short period. Apple may throttle notifications if too many are received. (i.e. no more than 1 or 2 per hour may help).
                    • +
                  • Consider disabling “spammy” notifications from other apps. This is only a theory, but it is possible that other apps can cause the system to throttle all notifications, including Loop’s.
                    • +
                  • Wait 24 hours or so as it often just takes time for the push notification limits to “reset”.
                    • +
                  • iOS 15.3.x: Note there are reports of Remote notifications not being received to the Loopers device for iOS version 15.3 and 15.3.1. This is fixed in iOS version 15.4.
                    • +
                  +

                  How to Ask for Help

                  +

                  This is helpful information to share when requested by helpers. If you are not using Loop Caregiver, review the response seen on the Nightscout site.

                  +
                    +
                  1. Activate an override from within Loop. Does Nightscout show the active override?
                    2. +
                  2. Activate an override from Nightscout. Does it change the active override in Loop?
                    3. +
                  3. Do errors show in Loop Caregiver or Nightscout Careportal when you send a remote command?
                      +
                    • Share screenshots of error if any
                      • +
                    +
                    4. +
                  4. Do errors show in iOS Notifications on the Looper’s device?
                      +
                    • Check their Notification history in iOS by swiping down
                      • +
                    • Share screenshots of errors if any
                      • +
                    +
                    5. +
                  5. What Loop version are you using? Released (main) or development (dev)? Approximately when did you update last?
                      +
                    • The minimum version that support remote bolus and carbs is Loop 3
                      • +
                    +
                    6. +
                  6. What iOS version is being used on the Looper’s device?
                      +
                    • Note that iOS 15.3.x had notification issues
                      • +
                    • Update to a newer version
                      • +
                    +
                    7. +
                  7. How did you build Loop?
                      +
                    • Build with Xcode to device (typical)?
                      • +
                    • Using AppCenter or Diawai? A special environment variable must be set LOOP_PUSH_SERVER_ENVIRONMENT=production
                      • +
                    +
                    8. +
                  +

                  Mention which troubleshooting steps you have completed so we know whether to ask about these again.

                  +

                  Other Errors

                  +

                  Once you've set up remote commands, you may encounter errors when trying to run them via Nightscout or iOS Shortcuts. Below are the most common and typical solutions.

                  +
                    +
                  1. Error: <span translate="no">Loop</span> notification failed: Could not find deviceToken in loopSettings You might see this in either Nightscout or Shortcuts. The error is most commonly caused by Loop not pointing to the right Nightscout instance or you haven't yet run an override locally (with the Loop app) before trying to run one remotely.
                    +Solution: Confirm the Loop app is pointing to the right Nightscout site (and there are no extra spaces or a slash (/) at the end, and always run an override for a few seconds in the Loop app before you try to run one remotely.
                    2. +
                  2. Error: cannot POST/api/v2/notifications/loop You might see this in iOS Shortcuts. This means Nightscout is not updated correctly and you are running a version of Nightscout that doesn't yet support remote overrides.
                    +Solution: Follow the Remote Configuration documentation.
                    3. +
                  3. Error: {“status”:401,”message”:”Unauthorized”,”description”:Invalid\\/Missing”} You might see this in iOS Shortcuts. This is caused by having an incorrect API_SECRET in the shortcut.
                    +Solution: Double check the API_SECRET is correct and that there are no spaces at the end.
                    4. +
                  4. Error: APNs delivery failed: InvalidProviderToken You might see this in either Nightscout or Shortcuts. This is caused because your LOOP_APNS_KEY_ID and LOOP_DEVELOPER_TEAM_ID are swapped in Heroku.
                    +Solution: Double check what's listed in your Apple Developer Account and compare it to the config variables in Heroku. Your Team_ID is next to your name in the top right corner. The other code is your Key_ID. Get the IDs in the correct location in Heroku to resolve the error.
                    5. +
                  + + + + + + +
                  +
                  + + +
                  + + + +
                  + + + +
                  +
                  +
                  +
                  + + + + + + + + + + + + + \ No newline at end of file diff --git a/nightscout/remote-overrides/index.html b/nightscout/remote-overrides/index.html index 29ad0c301bb..528bfa49d8f 100644 --- a/nightscout/remote-overrides/index.html +++ b/nightscout/remote-overrides/index.html @@ -1,3071 +1,15 @@ - - - - - - - - - - - - - - - - - - - - Remote Commands - LoopDocs - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                  - -
                  - - - - - - -
                  - - - - - - - -
                  - -
                  - - - - -
                  -
                  - - - -
                  -
                  -
                  - - - - - - -
                  -
                  -
                  - - - -
                  -
                  -
                  - - - - - -
                  -
                  -
                  - - - -
                  -
                  - - - - -

                  Remote Commands

                  - -

                  Set Up Remote for Nightscout

                  -

                  You can use your Nightscout site to remotely set and cancel your override presets in your Loop app. What?! Yes, really...you can set/cancel an override remotely for your child's Loop.

                  -

                  If you are using  Loop 3, then you can also send remote commands to add carbs and command a bolus. Remote commands have a minimum requirement of  Nightscout 14.2.6. If your Nightscout version does not meet that minimum requirement, remote commands might be accepted but if they are, the time for the commands is always the current time. In other words, Carbs in the Past or Future might be accepted, but would be entered at the current time on the looper's phone.

                  -
                  -

                  Remote Nightscout Interface Caveats

                  -
                    -
                  • Requires Apple Push Notifications service (APNs) - not available with a Free account
                    • -
                  • When you build Loop, the required APN information is tied to your Apple Developer account
                      -
                    • You add your APN information to your Nightscout site (directions on this page)
                      • -
                    • Nightscout sites, in general, allow you to add the required APN information
                      • -
                    -
                    • -
                  • If you use T1Pal for Nightscout and want to use remote commands, contact T1Pal about enabling them for a subscription fee.
                    • -
                  -
                  -
                  -

                  Remote Builds

                  -

                  There are several methods for building remotely for your family members (or even yourself).

                  - -

                  Both of these remote options require this Nightscout: Config Var to be added to Nightscout:

                  -

                  LOOP_PUSH_SERVER_ENVIRONMENT = production

                  -

                  Be aware that if you then return to building directly from Xcode, you must disable that config var from Nightscout and restart the server.

                  -

                  Note - this is covered in detail in step 3 below when you LoopDocs: Add APN Variables to Nightscout.

                  -
                  -
                  -

                  What you will need to do..

                  -
                    -
                  1. -

                    Update the Looper's iPhone Settings

                    -
                    2. -
                  2. -

                    Create a Key for an Apple Push Notifications service (APNs)

                    -
                    3. -
                  3. -

                    Update your Nightscout site and add some "config vars" lines in your Nightscout site settings.

                    -
                    4. -
                  -

                  And read this entire page - focus on warnings and caveats.

                  -
                  -
                  -

                  New Feature in Loop 3

                  -

                  Remote bolus and remote carb capability are added with Loop version 3. In order to support this capability, there are new minimum versions:

                  -
                    -
                  • Loop 3  or newer
                    • -
                  • iOS 15.1 or newer
                    • -
                  • Nightscout version 14.2.6 or newer
                    - Required to get all the features
                    • -
                  -

                  Not required and is still under development, but users who are testing this separate app are pleased

                  -
                    -
                  • LoopCaregiver app (iOS 16 or higher) enables the following from the caregiver's phone:
                      -
                    • monitor  Loop
                      • -
                    • issue remote commands for carbs, bolus, and overrides
                      • -
                    -
                    • -
                  • To clarify minimum versions for using updated remote features with LoopCaregiver
                      -
                    • LoopCaregiver phone: iOS 16
                      • -
                    • Loop phone: iOS 15.1 running Loop 3
                      • -
                    • Nightscout  14.2.6
                      • -
                    -
                    • -
                  -

                  The expanded capabilities for remote commands in  Loop 3  are currently documented in this Remote Carb/Bolus Guide. That information will be incorporated into LoopDocs soon.

                  -
                  -

                  Step 1: Update the Looper's iPhone settings

                  -

                  For remote commands to successfully deploy to a Looper's iPhone, they will need to have two settings on the iPhone enabled.

                  -
                    -
                  1. The slider in iPhone -> Settings -> Loop -> Notifications needs to be turned to Allow Notifications
                    2. -
                  2. The slider in iPhone -> Settings -> General -> Background App Refresh -> Loop must be enabled
                    3. -
                  -

                  Error messages if Looper's phone is not configured correctly:

                  -
                    -
                  • Without notifications, the person trying to set a remote override will see a message about "no deviceToken" and no remote override will actually enact
                    • -
                  • If Background app refresh is not enabled, the remote overrides will only enact if the Loop app is open and the phone is unlocked.
                    • -
                  -

                  Step 2: Apple Push Notifications

                  -

                  The next part of this will help your Loop app give permissions to your Nightscout site to remotely interact with it. To enable this, you need to create a key and grant it access to the Apple Push Notification Service (APNS).

                  -
                  -

                  Reminder

                  -

                  This only works with the paid Apple Developer ID.

                  -
                  -
                    -
                  1. To get started, go to the Keys section under Apple Developer's Certificates, Identifiers & Profiles and login with the Apple ID associated with your developer team that you used to sign your Loop app.
                    2. -
                  2. If not already open in your browser (compare with the below screenshot),
                      -
                    • Click on Keys (located in the left-hand column).
                      • -
                    • Either click on the blue Create a new key button OR the plus button () to add a new key.
                      -

                      img/apns-add-key.png

                      -
                      -
                      • -
                    -
                    3. -
                  3. In the form that appears, do the following:
                      -
                    • Click the checkbox for enabling Apple Push Notifications service (APNs)
                      • -
                    • Enter a name for the key such as Nightscout (you can name it however you want, just make sure you know what the key is for by the name you choose).
                      • -
                    • Then click the Continue button in the upper right of the screen.
                      -

                      img/key-apns.png

                      -
                      -
                      • -
                    -
                    4. -
                  4. In the screen that follows, click the blue Register button.
                    -

                    img/apns-register.png

                    -
                    -
                    5. -
                  5. In the screen that follows, click the blue Download button.
                    - This step will download a file with a name that starts with AuthKey and ends with .p8.
                    -

                    img/apns-download.png

                    -
                    -
                    6. -
                  6. Find your AuthKey downloaded file in your downloads folder.
                    - Double-click to open it and you will be presented a message asking how you'd like to open it.
                    - Click on Choose Application... and then select TextEdit as your application to open it with.
                    -

                    img/apns-open.png -img/apns-textedit.png

                    -
                    -
                    7. -
                  7. -

                    When the file opens, it will look similar to the screenshot below. In a few minutes, after we do a few other steps first, we will need to highlight ALL OF THE CONTENTS of that file and copy it because we will be pasting it in Heroku or whichever Nightscout provider you are using. Yes, allllll of the contents.
                    - So, the easiest way is to:

                    -
                      -
                    • Click inside that file
                      • -
                    • Highlight all the text, and then
                      • -
                    • Copy all the text to the clipboard (Cf. screenshot below).
                        -
                      • On a Mac, press Cmd+A to select all, then press Cmd+C to copy the selection.
                        • -
                      • On a PC, press Ctrl+A to select all, then press Ctrl+C to copy the selection.
                        • -
                      -
                      • -
                    -

                    You don't have to do it right now...just keep that window open in the background for now until we need it a little further down. Then we will copy all that text.

                    -
                    -

                    img/apns-copy-key.png

                    -
                    -
                    8. -
                  -

                  Step 3: Add APN to Nightscout

                  -

                  Update Nightscout Site

                  -

                  You'll need to make sure your Nightscout site version is version 13.0.1 or newer for remote overrides and version 14.2.6 or newer for access to all the remote command features.

                  -
                  -

                  What is my Nightscout Version Number?

                  -

                  To find your Nightscout version number:

                  -
                    -
                  • Tap on (☰) the hamburger button (3 horizontal lines stacked on each other) at the upper right, near the authentication button.
                    • -
                  • A context menu slides in from below the hamburger.
                    • -
                  • Scroll to the very bottom of this menu.
                    • -
                  • The version is located in the About section after the Settings section, (below the Save button).
                    • -
                  -
                  -

                  This link should be used if you want to Nightscout: Update your Nightscout site.

                  -
                  -

                  Note for Google Cloud Users

                  -

                  The Xdrip: Google Cloud Nightscout instructions include information about updating your site.
                  -Scroll down to the line (on that page) that says Update Nightscout.

                  -
                  -

                  Add APN Variables to Nightscout

                  -

                  In order to use remote overrides, you must add a couple of new variables. If you don't know how to update your Nightscout configuration, review Nightscout: Setup Variables and then come back.

                  -

                  The instructions in this section show Heroku images. If you are using a different method, you should be able to "translate" the steps.

                  -

                  Go to the Settings tab near the top of the screen on your Heroku app and then click on Reveal Config Vars.

                  -
                  -

                  img/heroku5.png

                  -
                  -

                  Scroll down the bottom of the Config Vars lines until you find the last blank one. You are going to add three new rows of config vars for remote overrides as shown below:

                  -
                  -

                  img/add_vars.jpg

                  -
                  - - - - - - - - - - - - - - - - - - - - - - - - - -
                  KEY
                  		VALUE
                  LOOP_APNS_KEYEnter the ENTIRE contents of the downloaded .p8 file including the BEGIN and END lines. Here's where you can use the Cmd+A and Cmd+C to highlight and copy all the text in that file so you can paste it into Heroku here for this new variable you are creating. img/apns-copy-key2.png
                  LOOP_APNS_KEY_IDString of characters on the .p8 download file immediately following the underscore (_) and not including the file extension (.p8), or you can get it from your saved key in your developer account as shown next step, too. This is a part of the downloaded filename located after the underscore (_) and before the file extension (.p8). img/apns-open2.png
                  LOOP_DEVELOPER_TEAM_IDGet this value from Loop app signing or in your Apple Developer account's top right corner under your name img/apns-vars.png
                  LOOP_PUSH_SERVER_ENVIRONMENT(optional) Set this to production if you installed Loop remotely such as with TestFlight, Diawi, AppCenter, or an IPA.
                  If you built directly to your phone in XCode with your phone plugged into to your computer, do not include this variable.
                  -

                  Remote Build Config Var Requirement

                  -

                  That last row of the table above is needed if you are using a remote build option such as LoopDocs: GitHub Build Actions or downloaded an archived file via Loop and Learn: Remote Build with Diawi. If you later return to a direct Xcode build to your phone, you must remove that config var or remote commands will not work.

                  -

                  When executed properly, you should have something that looks like this for the three (or four) new variables that you added:

                  -
                  -

                  the 3 or 4 config vars required for Nightscout remote commands to work

                  -
                  -

                  Do Not Confuse Your Keys

                  -
                  -

                  API Key vs APN Key

                  -

                  If you build with the GitHub Browser Build, you may notice the Application Programming Interface (API) key has the same type of format as the Apple Push Notification (APN) key. The keys for both purposes are of type p8, but should not be confused.

                  -

                  The Secrets for building with GitHub use the API Key.

                  -

                  The config vars for Nightscout use the APN Key.

                  -
                    -
                  • If you are using remote commands with Nightscout and building with the GitHub build, you must also add the config var of LOOP_PUSH_SERVER_ENVIRONMENT with a value of production to your Nightscout site or the remote commands will not work.
                    • -
                  • If you are using the Mac-Xcode build method, do not have a config var of LOOP_PUSH_SERVER_ENVIRONMENT entered - remove it if it is present.
                    • -
                  -
                  -

                  FAQs on Remote Overrides

                  -

                  Don't forget to read Loopdocs: Overrides. For remote overrides in particular:

                  -
                    -
                  1. -

                    Can I set a different override in Nighscout than I have programmed into Loop app?
                    -Answer: No. You will only be able to enact override presets already programmed into the Loop app.

                    -
                    2. -
                  2. -

                    If I didn't start the override in Nightscout (it was started in Loop itself), can I still use Nightscout to cancel it?
                    -Answer: Yes. You can cancel an override set in Loop with a Nightscout-set cancel "temporary override" command in the careportal.

                    -
                    3. -
                  3. -

                    Can I replace an override set in Loop with an override set in Nightscout?
                    -Answer: Yes.

                    -
                    4. -
                  4. -

                    If I have multiple Nightscout sites because I have multiple kiddos with T1D looping, do I need multiple APNs Keys?
                    -Answer: No. If you have multiple kids using Loop, you can use the one APNs key in each of their Nightscout sites.

                    -
                    5. -
                  5. -

                    How can I tell if it worked?
                    -Answer: You should see your override pill in Nightscout, with the NEXT Loop cycle, reflecting that the desired override action took place. If you are near the Loop app, you should see the new override within less than 30 seconds or so.

                    -
                    6. -
                  6. -

                    Can I see on Nightscout when a temporary override has been set using the looper’s phone?
                    -Answer: Yes. There will be a grey bar with the name of the override noted and the Loop Pill will display the targets and duration. Remember, there is a KNOWN issue with the grey bars, so use the pill as your best guide.

                    -
                    7. -
                  7. -

                    Can a looper cancel a remote override?
                    -Answer: Yes. They can tap the heart icon in Loop so that it is no longer highlighted. This turns off the override, regardless of where it was initiated.

                    -
                    8. -
                  8. -

                    I set a remote override in Nightscout but the Looper tapped the heart symbol in the Loop app, so the override turned off. Will the override get reinstated the next time Loop completes with internet access?
                    -Answer: No. The APN is only sent once. You can set the remote override again if need be.

                    -
                    9. -
                  9. -

                    Can I schedule a remote override ahead of time using Nightscout?
                    -Answer: No. When you set a remote override in Nightscout, it starts immediately and lasts for the duration programmed for that override in the Loop app. You can only set an override in advance using the Loop app.

                    -
                    10. -
                  -

                  Warnings for Remote Commands

                  -
                  -

                  Minimum Versions:  Loop 3 and  Nightscout 14.2.6

                  -

                  If your Nightscout version does not meet that minimum requirement, remote commands might be accepted but if they are, the time for the commands is always the current time. In other words, Carbs in the Past or Future might be accepted, but would be entered at the current time on the looper's phone.

                  -
                  -
                  -

                  Duplicate Delivery Risk

                  -

                  We want to highlight a very important risk before you get started.

                  -

                  For safety, always assume a previous remote carbs/bolus was delivered. For motivation think of the following example:

                  -
                    -
                  • You send a 5-unit remote bolus.
                    • -
                  • The bolus is delivered to the Looper.
                    • -
                  • Nightscout is having a temporary technical issue and doesn't show the bolus was received.
                    • -
                  • You are watching Nightscout and you don’t see a delivery so you assume it failed.
                    • -
                  • You send another remote 5-unit bolus.
                    • -
                  • The second 5-unit bolus is delivered to the Looper (10 Units total).
                    • -
                  -
                  -

                  You can see the danger of sending duplicate bolus/carbs so be careful. If a remote bolus/carb entry doesn’t show in Nightscout, use your own judgment on whether enough time has passed to try again.

                  -
                  -

                  If sending both, choose Bolus then Carbs

                  -

                  If you plan to send a carb command remotely and later decide to issue a bolus command - STOP and consider.

                  -

                  There are 2 scenarios of concern that could lead to too much insulin:

                  -
                    -
                  • Looper is using the Temp Basal (temporary basal) Dosing Strategy
                      -
                    • Loop will initiate a max Temp Basal when it receives the carbs remote command
                      • -
                    • Your bolus will be accepted and take place in addition to the high temporary basal
                      • -
                    -
                    • -
                  • Looper is using Automatic Bolus Dosing Strategy
                      -
                    • Loop will initiate 40% of the recommended dose when it receives the carbs remote command
                      • -
                    • Your bolus will be accepted and take place in addition to an automatic boluses
                      • -
                    -
                    • -
                  -

                  Typically, sending a carbs command alone is sufficient for Loop to know about the carbs and begin to dose for them.

                  -

                  If you really want to both bolus for carbs and enter carbs, then do it in that order.

                  -
                    -
                  1. The bolus, when accepted, will cause Loop to issue a 0 Temp Basal (temporary basal) (which is "safer")
                    2. -
                  2. The carbs, when accepted, will cause Loop to respond to the carbs while including the bolus already delivered and included in the Looper' IOB
                    3. -
                  -

                  ❗️ Remember - you should pause at least 60 seconds between remote commands or the One-Time-Password (OTP) will be rejected as having already been used.

                  -
                  -

                  Using Remote Commands

                  -

                  There are four ways you can trigger your commands remotely; LoopCaregiver (under development), Nightscout Careportal, Shortcuts, and IFTTT.

                  -
                  -

                  Config Var Reminder

                  -
                    -
                  • If you used a remote method for your build of Loop, don't forget you must add LOOP_PUSH_SERVER_ENVIRONMENT config variable to your Nightcout site or remote commands will not work. LoopDocs: Remote Build Config Var Requirement
                    • -
                  • If you then return to Xcode build, you must remove the LOOP_PUSH_SERVER_ENVIRONMENT config var.
                    • -
                  -
                  -

                  LoopCaregiver icon for LoopCaregiver app

                  -

                  The LoopCaregiver app is under development to make remote commands easier to implement and monitor.

                  -
                  -

                  Configuration Update with Breaking Change on January 24, 2023

                  -

                  What does that mean? Sounds scary!

                  -

                  This is an app under development. Sometimes, when improvements are added, you have to start over with a fresh download and enter all your information again to take advantage of the update. The app on your phone keeps working until you are ready to update.

                  -
                    -
                  • The location of the repository has moved
                    • -
                  • The ability to build with GitHub as well as Xcode has been added
                    • -
                  • The bundle ID has been modified
                    • -
                  -

                  Because the bundle ID has changed:

                  -
                    -
                  • If you already have LoopCaregiver running and do a fresh download and build, you will be building a separate app and will need to delete the old one and add your Looper(s) in again
                    • -
                  • If you haven't built LoopCaregiver, the app you download and build today has the new format for the bundle ID
                    • -
                  -
                  - -
                  -

                  Older Nightscout Versions

                  -

                  If you ignore this minimum version requirement - what happens:

                  -
                    -
                  • If you attempt to use the carb entry in the past or future, the caregiver app accepts it but the remote commands accepted by the Loopers phone show up at the current time - not when the caregiver intended to insert carbs
                    • -
                  • Please take the time to update your Nightscout site to master
                    • -
                  • Nightscout 14.2.6 was released 30-Sep-2022 as Classic Liquorice
                    • -
                  -
                  -

                  If you plan to use LoopCaregiver, please join Loop Caregiver App Zulipchat stream.

                  -

                  As with all development code, monitor Zulipchat for announcements, report any problems you experience, be prepared to build frequently, and pay attention.

                  -

                  Build LoopCaregiver

                  -

                  A build script is available to assist in building LoopCaregiver. This should be straightforward for anyone who has previously built  Loop 3  using the script. You may also choose to build it with the GitHub build method as documented on the Browser Build: Other Apps page.

                  -
                    -
                  • Open a terminal window.
                    • -
                  • Spot the line below that starts with /bin/bash
                    • -
                  • Click the gray copy button () located near the bottom right side of that line (should say Copy to Clipboard when you hover the mouse over it).
                    - Once clicked, a confirmation message that says Copied to Clipboard will appear on your screen. -
                    Copy and Paste to start the BuildLoopCaregiver.sh script
                    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/loopandlearn/lnl-scripts/main/BuildLoopCaregiver.sh)"
-
                    • -
                  • Important: Click anywhere in the terminal before trying to paste
                    • -
                  • Paste the line into the Terminal window.
                      -
                    • on Mac, you can do this in one of the following ways:
                        -
                      • Press Cmd+V
                        • -
                      • or Press Ctrl+click and select Paste from the menu
                        • -
                      • or select Edit => Paste (i.e. click the Edit menu at the top of the Mac screen then click Paste).
                        • -
                      -
                      • -
                    • on PC:
                        -
                      • Press Ctrl+V
                        • -
                      -
                      • -
                    -
                    • -
                  • Once the line is pasted, hit Return (Enter) to execute the script.
                    • -
                  • The script displays the directions for downloading and building.
                    - Please read them carefully.
                    • -
                  -
                  -

                  Not  Loop

                  -

                  The output you see in the Terminal may look very similar to when you build  Loop 3  from a script.

                  -

                  It is pulling down a clone from a different location (LoopKit/LoopCaregiver). It uses some modules from Loop. The target and scheme are automatically selected for LoopCaregiver and if you follow directions for a paid Developer account, the signing is automatic.

                  -
                  -

                  Use LoopCaregiver

                  -

                  Some limited directions for using the LoopCaregiver app are provided - please also read the Zulipchat stream.

                  -

                  LoopCaregiver  Main Screen

                  -

                  LoopCaregiver uses a lot of features from Loop with some Nightscout-like features in the Timeline.

                  -

                  The Timeline:

                  -
                    -
                  • Autoscales the vertical display for glucose reported over the last 24 hours (plus the forecast if that is turned on)
                      -
                    • Show Prediction for Timeline is turned off in the graphic below.
                      • -
                    -
                    • -
                  • Horizontal display can be adjusted with spreading/pinching and scrolling.
                    • -
                  • A double tap on the Timeline provides a factor of 2 expansion horizontally if at default
                    • -
                  • A double tap on the Timeline returns the display to default if expanded
                    • -
                  -

                  main screen of the LoopCaregiver app

                  -

                  Add a Looper to LoopCaregiver

                  -

                  You add each Looper under settings. (LoopCaregiver can monitor more than one Looper).

                  -
                    -
                  • On the Looper' phone:
                      -
                    • Tap on Loop -> Settings -> Services -> Nightscout
                      • -
                    • Tap on the One-Time-Password row to see the QR code
                      • -
                    • -
                      -

                      Pro-tip

                      - Take a screenshot and store it on your computer.
                      - You can then add view the QR code in LoopCaregiver without bothering your Looper.
                      -
                      • -
                    -
                    • -
                  • On the LoopCaregiver' phone:
                      -
                    • Tap on LoopCaregiver -> Settings
                      • -
                    • Tap on the plus sign to add a Looper
                      • -
                    • Enter the name of the Looper, the Nightscout URL (use https://) and API_SECRET
                      • -
                    • Touch the QR code row - this opens the camera - point the camera at the QR code from Looper's phone
                      • -
                    -
                    • -
                  -

                  You can also use the LoopCaregiver -> Settings screen to modify:

                  -
                    -
                  • Units used for glucose display: mg/dL or mmol/L
                    • -
                  • Include the  Loop forecast display on the Timeline chart as well as the Glucose chart of the main display (Show Prediction is turned off in the graphic above)
                    • -
                  -

                  Issue Remote Commands with  LoopCaregiver

                  -

                  You issue override, carb, and bolus commands using a toolbar similar to the one seen on Loop. In the example graphic above, the carb and bolus entries visible were issued remotely. (Note that: Adam 6 is a test phone.)

                  -

                  Carb and bolus commands each require authorization before they are accepted. The authorization (FaceID, Fingerprint, or passcode) matches that required to unlock the LoopCaregiver's phone.

                  -

                  The use of LoopCaregiver makes remote commands much easier and more reliable.

                  -

                  Go back and read the warnings again before using the app. Warnings for Remote Commands

                  -

                  Nightscout Careportal

                  -

                  To use remote commands, I'm assuming you've set up your Nightscout site according to the directions here in Loopdocs. Especially the part about your ENABLE line including each of the words: override careportal Loop (in addition to other variables you'd be interested in - the order of the words in the ENABLE line is not important).
                  -You'll also need to have your site authenticated so that your careportal is active to send remote overrides.
                  -Once authenticated by entering your API_SECRET, then there will be a plus sign () in the upper right corner of your site. That is your careportal. Tap the careportal plus sign () and then scroll down in the event type menu to find Temporary Override.
                  -Within there, you will find all your Loop override presets already loaded for you.

                  -

                  img/careportal-overrides.PNG

                  -

                  The Looper will see a banner notification that a remote command has been sent with details about that command and whether it succeeded (or not).

                  -

                  img/override_notification.jpg

                  -

                  Canceling an override through Nightscout careportal is as simple as selecting the event type Temporary Override Cancel and submitting.

                  -

                  Shortcuts

                  -

                  If you want to make your life SUPER AMAZING, check out using the iPhone's Shortcuts app. The Shortcuts app is for making little automations (like mini apps) that can integrate parts of your life. In this case, we've written a couple of shortcuts for you that integrate  Loop  overrides with Nightscout.

                  -
                  -

                  Important Note

                  -

                  Before you click on the download file below...save yourself some trouble.

                  -
                    -
                  1. Download the Shortcuts app if you don't have it yet
                    2. -
                  2. Choose to run any shortcut from the Gallery. It can be the laundry timer...I don't care, just pick one shortcut and run it.
                    3. -
                  3. THEN, go to download the shortcut of your choice below.
                    - ℹ️ The shortcuts that aren't run through the Gallery option are called "untrusted". And you need a slider in your iPhone to trust the "untrusted" shortcuts you would be downloading here.
                    - But...in a lovely iOS glitch...that slider doesn't appear unless you've run a trusted shortcut first. So, run one now.
                    4. -
                  4. Then, this slider will now be visible in the iPhone Settings app under the Shortcuts app menu.
                    5. -
                  5. When you will see the message "This shortcut cannot be opened because your Shortcuts security system settings don't allow untrusted shortcuts"
                    6. -
                  6. Open iPhone Settings and scroll down the list and tap the Shortcuts menu to turn on "Allow Untrusted Shortcuts".
                    7. -
                  -
                  -

                  Click these links on your iPhone and you'll be prompted to download the premade shortcuts (assuming you open the links in Safari browser on iPhone):

                  -

                  Comprehensive Loop Shortcut - includes Set Remote Override, Cancel Override, Loop Troubleshooting Tips, Quick Text options, Manual BG entry, Bookmarks to websites, etc.

                  -

                  And if you want to save one click to get to these one functions more directly: these shortcuts are simplified to offer only one function:

                  -

                  Set Remote Override only shortcut

                  -

                  Cancel Override only shortcut

                  -
                  -

                  A couple notes about these shortcuts:

                  -
                    -
                  1. You will need iOS 13 at a minimum on the phone you'd like to trigger these shortcuts from. Looper's phone can still be lower than iOS 13, but your phone as the shortcut user would need iOS 13.
                      -
                    • For  Loop 3, the minimum iOS is iOS 15.1
                      • -
                    -
                    2. -
                  2. You need to open those links in the Safari browser on your iPhone. A confirmation will show to initiate the download. After the download finishes, tap the button marked AA near your Safari address bar and tap Downloads (downloads) to find and open the downloaded Shortcut. Then wait a bit, and the shortcut's inner guts will be there...scroll ALL the way down to the bottom to click the button to save the untrusted shortcut.
                    3. -
                  -
                  -
                    -
                  1. When you enter your Nightscout URL in the URL field of the  Loop  shortcut setup, make sure you don't include a trailing /, or the API calls to Heroku will error out.
                    2. -
                  2. When a remote override is set properly, you'll see an ok message displayed. If there is an error, you'll see an error message. Most errors will be that you have an API_SECRET wrong (make sure there isn't a space at the end of your API_SECRET that you don't see) or you failed to do the steps to setup Nightscout and update your Loop app as described in steps 1-3 above.
                    3. -
                  3. You can absolutely customize these bits and pieces within the shortcut. Change the text messages, and change the links... It is totally up to you.
                    4. -
                  -

                  IFTTT

                  -

                  If you want to walk uphill both ways in the snow carrying bags of uneven groceries, you can also set overrides remotely by setting up IFTTT, too.

                  -

                  Known Issues

                  -

                  Just a brief mention so you are aware:

                  -
                    -
                  1. The override pill will display information about what override is currently active in the Looper's phone. BUT, there can be a slight delay as that information is only transmitted every 5 minutes at best (it is tied to Loop runs and Nightscout upload events in Loop). So, wait 5 minutes to see that the information has gone through a refresh cycle before assuming the override message failed to enact.
                    2. -
                  2. When you add a new override preset in Loop, that preset has to be uploaded to Nightscout before it will be available as a remote override. To trigger that upload, you can simply enact that new override for a few seconds and turn it off again. That will get the Nightscout upload going.
                    3. -
                  -

                  Common Errors

                  -

                  Once you've set up remote overrides, you may encounter errors when trying to run them via Nightscout or iOS Shortcuts. Below are the most common and typical solutions.

                  -
                    -
                  1. Error: Loop notification failed: Could not find deviceToken in loopSettings You might see this in either Nightscout or Shortcuts. The error is most commonly caused by Loop not pointing to the right Nightscout instance or you haven't yet run an override locally (with the Loop app) before trying to run one remotely.
                    -Solution: Confirm the Loop app is pointing to the right Nightscout site (and there are no extra spaces or a slash (/) at the end, and always run an override for a few seconds in the Loop app before you try to run one remotely.
                    2. -
                  2. Error: cannot POST/api/v2/notifications/loop You might see this in iOS Shortcuts. This means Nightscout is not updated correctly and you are running a version of Nightscout that doesn't yet support remote overrides.
                    -Solution: Follow the steps above again on how to update to the version of Nightscout that supports remote overrides.
                    3. -
                  3. Error: {“status”:401,”message”:”Unauthorized”,”description”:Invalid\\/Missing”} You might see this in iOS Shortcuts. This is caused by having an incorrect API_SECRET in the shortcut.
                    -Solution: Double check the API_SECRET is correct and that there are no spaces at the end.
                    4. -
                  4. Error: APNs delivery failed: InvalidProviderToken You might see this in either Nightscout or Shortcuts. This is caused because your LOOP_APNS_KEY_ID and LOOP_DEVELOPER_TEAM_ID are swapped in Heroku.
                    -Solution: Double check what's listed in your Apple Developer Account and compare it to the config variables in Heroku. Your Team_ID is next to your name in the top right corner. The other code is your Key_ID. Get the IDs in the correct location in Heroku to resolve the error.
                    5. -
                  - - - - - - -
                  -
                  - - -
                  - - - -
                  - - - -
                  -
                  -
                  -
                  - - - - - - - - - - - - - \ No newline at end of file + + + + Redirecting... + + + + + + +Redirecting... + + diff --git a/nightscout/remote-overview/index.html b/nightscout/remote-overview/index.html new file mode 100644 index 00000000000..ea6f0a27771 --- /dev/null +++ b/nightscout/remote-overview/index.html @@ -0,0 +1,2568 @@ + + + + + + + + + + + + + + + + + + + + + + Remote Overview - LoopDocs + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + +
                  + + + + + + +
                  + + + + + + + +
                  + +
                  + + + + +
                  +
                  + + + +
                  +
                  +
                  + + + + + + +
                  +
                  +
                  + + + +
                  +
                  +
                  + + + + + +
                  +
                  +
                  + + + +
                  +
                  + + + + +

                  Remote Overview

                  + +

                  Remote Caregivers

                  +

                  With Loop 3, a caregiver can provide remote commands to assist in diabetes care, including modifying overrides, issuing remote bolus commands and adding remote carb entries. With Loop 2, only overrides can be turned on or off remotely.

                  +

                  Remote commands to the Loop phone go through their Nightscout site. For security, any command to deliver a bolus or add a carb entry requires a one-time-password (OTP) to be used with each remote command. These codes are unique to your combined Loop and Nightscout configuration. An authentication app needs to be installed on the device sending the remote boluses/carbs. The Loop Caregiver app can be used. It handles authentication requirements and offers a Loop-like user interface.

                  +

                  Remote Commanding Requirements:

                  +
                    +
                  • Loop version 3.2.0 or newer
                      +
                    • version 3.0 works but is not recommended for other reasons
                      • +
                    +
                    • +
                  • Apple Push Notifications (APN) created with the Apple Developer ID that built the Loop app
                    • +
                  • Nightscout version 14.2.6 or newer
                      +
                    • Several configuration variables must be added
                      • +
                    +
                    • +
                  • Ability to generate a One-Time-Password (OTP)
                    • +
                  +
                  +

                  What about Older Versions?

                  +

                  Caregivers for those using older versions of Loop can modify Overrides remotely but cannot send remote bolus or carb commands.

                  +

                  If your Nightscout site is an older version, you should limit your remote commands to Overrides, even with Loop 3.

                  +
                  +
                  +

                  Loop Caregiver

                  +

                  There is a new companion app, Loop Caregiver that makes remote commands and reviewing status of your looper much easier.

                  +
                  +

                  How does this work?

                  +

                  Loop and Nightscout work using Apple Push Notifications (APN).

                  +
                    +
                  • The Apple Developer ID used to build the Loop app must be configured to enable Apple Push Notifications +
                    • +
                  • Most providers who supply Nightscout as a service or Hosted Nightscout will assist you, if needed, in getting your APN information added to your Nightscout variables; one provider requires an added monthly subscription fee +
                    • +
                  +

                  Next Steps

                  +

                  There are a number of steps to follow to set this up. Each page is linked below:

                  +

                  Set Up Remote for Nightscout

                  +

                  Using Remote Commands

                  +

                  Remote Errors

                  +

                  Loop Caregiver App

                  + + + + + + +
                  +
                  + + +
                  + + + +
                  + + + +
                  +
                  +
                  +
                  + + + + + + + + + + + + + \ No newline at end of file diff --git a/nightscout/troublehoot/index.html b/nightscout/troublehoot/index.html index ff2e3027160..b27c8123391 100644 --- a/nightscout/troublehoot/index.html +++ b/nightscout/troublehoot/index.html @@ -1,2379 +1,15 @@ - - - - - - - - - - - - - - - - - - - - Nightscout Troubleshooting - LoopDocs - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                  - -
                  - - - - - - -
                  - - - - - - - -
                  - -
                  - - - - -
                  -
                  - - - -
                  -
                  -
                  - - - - - - -
                  -
                  -
                  - - - -
                  -
                  -
                  - - - - - -
                  -
                  -
                  - - - -
                  -
                  - - - - -

                  Nightscout Troubleshooting

                  - -

                  Setup Troubleshooting

                  -

                  If you have just tried to set up your Nightscout site and have problems with seeing all your data, please check out the Nightscout: Troubleshooting page.

                  -

                  Dexcom data not showing

                  -

                  If you use a Dexcom and get your CGM data into Nightscout using Dexcom Share (bridge in Nightscout) and everything was working but the Dexcom data stops showing, please review Nightscout: Dexcom bridge Troubleshooting.

                  -

                  As part of that troubleshooting, you may need to remove the Nightscout service credentials from Loop. You may need to remove Dexcom credential from all third-party apps that get data from Dexcom Share. Be sure to add them back after the CGM data to Nightscout is restored.

                  -

                  You do not need to use Share or bridge with Nightscout. You can choose to have Loop update your CGM readings to Nightscout directly. There's a check box in the Loop CGM setting screen to select this. You must select that check box every time you update your transmitter for Dexcom G5 or G6.

                  -

                  Loop data not showing

                  -

                  If your BG data is showing, but Loop data is not (like Loop pill is empty and carbs and boluses are not showing), please delete your Nightscout account in Loop settings area. Enter the information in Loop again. Make sure to use https:// to start the site URL. Make sure there is no trailing slash at the end of the URL. Enter your API_SECRET correctly. Make sure you have loop on the ENABLE line in Heroku settings.

                  - - - - - - -
                  -
                  - - -
                  - - - -
                  - - - -
                  -
                  -
                  -
                  - - - - - - - - - - - - - \ No newline at end of file + + + + Redirecting... + + + + + + +Redirecting... + + diff --git a/nightscout/troubleshoot/index.html b/nightscout/troubleshoot/index.html new file mode 100644 index 00000000000..3cddfa185d2 --- /dev/null +++ b/nightscout/troubleshoot/index.html @@ -0,0 +1,2435 @@ + + + + + + + + + + + + + + + + + + + + + + Nightscout Troubleshooting - LoopDocs + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + +
                  + + + + + + +
                  + + + + + + + +
                  + +
                  + + + + +
                  +
                  + + + +
                  +
                  +
                  + + + + + + +
                  +
                  +
                  + + + +
                  +
                  +
                  + + + + + +
                  +
                  +
                  + + + +
                  +
                  + + + + +

                  Nightscout Troubleshooting

                  + +

                  Setup Troubleshooting

                  +

                  If you have just tried to set up your Nightscout site and have problems with seeing all your data, please check out the Nightscout: Troubleshooting page.

                  +

                  Dexcom data not showing

                  +

                  If you use a Dexcom and get your CGM data into Nightscout using Dexcom Share (bridge in Nightscout) and everything was working but the Dexcom data stops showing, please review Nightscout: Dexcom bridge Troubleshooting.

                  +

                  As part of that troubleshooting, you may need to remove the Nightscout service credentials from Loop. You may need to remove Dexcom credential from all third-party apps that get data from Dexcom Share. Be sure to add them back after the CGM data to Nightscout is restored.

                  +

                  You do not need to use Share or bridge with Nightscout. You can choose to have Loop update your CGM readings to Nightscout directly. There's a check box in the Loop CGM setting screen to select this. You must select that check box every time you update your transmitter for Dexcom G5 or G6.

                  +

                  Loop data not showing

                  +

                  If your BG data is showing, but Loop data is not (like Loop pill is empty and carbs and boluses are not showing), please delete your Nightscout account in Loop settings area. Enter the information in Loop again. Make sure to use https:// to start the site URL. Make sure there is no trailing slash at the end of the URL. Enter your API_SECRET correctly. Make sure you have loop on the ENABLE line in Heroku settings.

                  + + + + + + +
                  +
                  + + +
                  + + + +
                  + + + +
                  +
                  +
                  +
                  + + + + + + + + + + + + + \ No newline at end of file diff --git a/nightscout/update_user/index.html b/nightscout/update_user/index.html index d8ee79b00eb..40d871a6d32 100644 --- a/nightscout/update_user/index.html +++ b/nightscout/update_user/index.html @@ -12,7 +12,7 @@ - + @@ -1367,7 +1367,7 @@
                • - + Overrides
                  • @@ -1995,7 +1995,7 @@
                • - + Nightscout Troubleshooting
                  • @@ -2009,7 +2009,49 @@
                • - + + Nightscout Cross Ref + +
                  • + + + + + + + + + +
                • + + Remote Overview + +
                  • + + + + + + + + + +
                • + + Remote Configuration + +
                  • + + + + + + + + + +
                • + Remote Commands
                  • @@ -2023,8 +2065,22 @@
                • - - Nightscout Cross Ref + + Remote Errors + +
                  • + + + + + + + + + +
                • + + Loop Caregiver
                  • @@ -2513,7 +2569,7 @@

                  More Variables for Loopers
                • + Overrides
                  • @@ -1962,7 +1962,7 @@
                • - + Nightscout Troubleshooting
                  • @@ -1976,7 +1976,49 @@
                • - + + Nightscout Cross Ref + +
                  • + + + + + + + + + +
                • + + Remote Overview + +
                  • + + + + + + + + + +
                • + + Remote Configuration + +
                  • + + + + + + + + + +
                • + Remote Commands
                  • @@ -1990,8 +2032,22 @@
                • - - Nightscout Cross Ref + + Remote Errors + +
                  • + + + + + + + + + +
                • + + Loop Caregiver
                  • diff --git a/operation/algorithm/overview/index.html b/operation/algorithm/overview/index.html index cd3c0c10eed..3d861eeaed8 100644 --- a/operation/algorithm/overview/index.html +++ b/operation/algorithm/overview/index.html @@ -1369,7 +1369,7 @@
                • - + Overrides
                  • @@ -1969,7 +1969,7 @@
                • - + Nightscout Troubleshooting
                  • @@ -1983,7 +1983,49 @@
                • - + + Nightscout Cross Ref + +
                  • + + + + + + + + + +
                • + + Remote Overview + +
                  • + + + + + + + + + +
                • + + Remote Configuration + +
                  • + + + + + + + + + +
                • + Remote Commands
                  • @@ -1997,8 +2039,22 @@
                • - - Nightscout Cross Ref + + Remote Errors + +
                  • + + + + + + + + + +
                • + + Loop Caregiver
                  • diff --git a/operation/algorithm/prediction/index.html b/operation/algorithm/prediction/index.html index 1b05b2f17f9..08fb48ac5ad 100644 --- a/operation/algorithm/prediction/index.html +++ b/operation/algorithm/prediction/index.html @@ -1369,7 +1369,7 @@
                • - + Overrides
                  • @@ -2086,7 +2086,7 @@
                • - + Nightscout Troubleshooting
                  • @@ -2100,7 +2100,49 @@
                • - + + Nightscout Cross Ref + +
                  • + + + + + + + + + +
                • + + Remote Overview + +
                  • + + + + + + + + + +
                • + + Remote Configuration + +
                  • + + + + + + + + + +
                • + Remote Commands
                  • @@ -2114,8 +2156,22 @@
                • - - Nightscout Cross Ref + + Remote Errors + +
                  • + + + + + + + + + +
                • + + Loop Caregiver
                  • diff --git a/operation/algorithm/temp-basal/index.html b/operation/algorithm/temp-basal/index.html index 1f45934688b..5404fe33356 100644 --- a/operation/algorithm/temp-basal/index.html +++ b/operation/algorithm/temp-basal/index.html @@ -1369,7 +1369,7 @@
                • - + Overrides
                  • @@ -2037,7 +2037,7 @@
                • - + Nightscout Troubleshooting
                  • @@ -2051,7 +2051,49 @@
                • - + + Nightscout Cross Ref + +
                  • + + + + + + + + + +
                • + + Remote Overview + +
                  • + + + + + + + + + +
                • + + Remote Configuration + +
                  • + + + + + + + + + +
                • + Remote Commands
                  • @@ -2065,8 +2107,22 @@
                • - - Nightscout Cross Ref + + Remote Errors + +
                  • + + + + + + + + + +
                • + + Loop Caregiver
                  • diff --git a/operation/features/battery/index.html b/operation/features/battery/index.html index 7d528365f53..48efc943f53 100644 --- a/operation/features/battery/index.html +++ b/operation/features/battery/index.html @@ -1367,7 +1367,7 @@
                • - + Overrides
                  • @@ -1988,7 +1988,7 @@
                • - + Nightscout Troubleshooting
                  • @@ -2002,7 +2002,49 @@
                • - + + Nightscout Cross Ref + +
                  • + + + + + + + + + +
                • + + Remote Overview + +
                  • + + + + + + + + + +
                • + + Remote Configuration + +
                  • + + + + + + + + + +
                • + Remote Commands
                  • @@ -2016,8 +2058,22 @@
                • - - Nightscout Cross Ref + + Remote Errors + +
                  • + + + + + + + + + +
                • + + Loop Caregiver
                  • diff --git a/operation/features/bolus/index.html b/operation/features/bolus/index.html index 682d3b34f99..19500ffe8ed 100644 --- a/operation/features/bolus/index.html +++ b/operation/features/bolus/index.html @@ -12,7 +12,7 @@ - + @@ -1489,7 +1489,7 @@
                • - + Overrides
                  • @@ -2034,7 +2034,7 @@
                • - + Nightscout Troubleshooting
                  • @@ -2048,7 +2048,49 @@
                • - + + Nightscout Cross Ref + +
                  • + + + + + + + + + +
                • + + Remote Overview + +
                  • + + + + + + + + + +
                • + + Remote Configuration + +
                  • + + + + + + + + + +
                • + Remote Commands
                  • @@ -2062,8 +2104,22 @@
                • - - Nightscout Cross Ref + + Remote Errors + +
                  • + + + + + + + + + +
                • + + Loop Caregiver
                  • @@ -2607,7 +2663,7 @@