Skip to content

Commit

Permalink
Merge pull request #868 from marionbarker/working-docs
Browse files Browse the repository at this point in the history
Update iOS 18 password feature, Trio references
  • Loading branch information
marionbarker authored Oct 5, 2024
2 parents 8a3b95f + e3d9cf0 commit e0977f5
Show file tree
Hide file tree
Showing 6 changed files with 26 additions and 14 deletions.
4 changes: 2 additions & 2 deletions docs/faqs/loop-faqs.md
Original file line number Diff line number Diff line change
Expand Up @@ -183,9 +183,9 @@ One exception - if you've chosen to use a CGM source that does require the inter

## What happened to FreeAPS?

[FreeAPS](https://www.loopandlearn.org/freeapsdoc){: target="_blank" } hasn't really had an owner to develop it for several years, but many depended on it. Because of that, the *Loop and Learn* team kept it on life-support. It was updated in early 2023 to include DASH, but that was the last improvement. It is strongly recommended people switch to `Loop 3` or `iAPS`. Do not use an application without an owner.
[FreeAPS](https://www.loopandlearn.org/freeapsdoc){: target="_blank" } was last updated in early 2023 to include DASH, but that was the last improvement. It is strongly recommended people switch to `Loop 3` or [`Trio`](https://diy-trio.org/){: target="_blank" }. Do not use an application without an owner.

Many features people used with FreeAPS are now included in `Loop 3` or can be added with customization. The `dev` branch has Libre support, see [Build *Loop* Dev](../version/build-dev.md).
The features people used with FreeAPS are now included in `Loop 3` or can be added with customization.

The addition of customizations has been simplified.

Expand Down
6 changes: 4 additions & 2 deletions docs/loop-3/services.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ If you have an existing *Nightscout* site, it's still a good idea to review that

The graphic below shows the steps needed to add your *Nightscout* site to the *Loop* app. See the tip below about using stored passwords on the phone. If you have your credentials stored in passwords, simply tap the URL row to show the password option and select it.

1. Select Settings in the *Loop* app and scroll down to Services and tap the Add Service Row
1. While in the *Loop* app, tap on the Settings icon, scroll down to Services and tap the Add Service Row
2. Choose Nightscout Service
3. Tap on the URL row
* If your credentials are not saved in your Passwords, enter the URL including https:// in this row
Expand Down Expand Up @@ -49,7 +49,9 @@ The two most common errors in filling out this section are:
!!! tip "Add a Password"
To make it easy to access your Nightscout URL and API_SECRET, add a password to your iPhone:

1. iOS Settings, Password
1. The first step depends on iOS Version:
* For iOS 17 and earlier, use iOS Settings, Passwords
* For iOS 18 and newer, use the *Apple* [Password app](https://support.apple.com/en-us/104955){: target="_blank" }
1. Tap + to add
* Enter a name, e.g., "Nightscout" in the Title row
* Enter the URL without the "https://" in the Website row
Expand Down
2 changes: 1 addition & 1 deletion docs/nightscout/overview.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
## Overview

*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*.)
*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 *Trio*. *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.

Expand Down
11 changes: 8 additions & 3 deletions docs/nightscout/remote-commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Options:
![example screen for nightscout and qr code](img/qr-code-example.png ){width="650"}
{align="center"}

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.
While you are on the *Loop* 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

Expand All @@ -52,7 +52,10 @@ To set up your *Nightscout* credentials in &nbsp;<span translate="no">Apple Keyc

On the Caregivers device (iPhone or Mac):

* Go to Apple Settings -> Passwords
* The first step depends on iOS version
* For iOS 17 and earlier, use iOS Settings, Passwords
* For iOS 18 and newer, use the *Apple* [Password app](https://support.apple.com/en-us/104955){: target="_blank" }

* Tap the + Button up top to add a new Password

![add password screen for apple keychain](img/add-password-apple-keychain.png ){width="500"}
Expand All @@ -65,7 +68,9 @@ On the Caregivers device (iPhone or Mac):
* 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
* For iOS 17 and earlier, use iPhone Settings -> Passwords
* For iOS 18 and newer, use the *Apple* [Password app](https://support.apple.com/en-us/104955){: target="_blank" }
* -> Tap the row with your *Nightscout* URL
* Tap “Setup Verification Code”
* This is where you can scan your QR code from the&nbsp;_<span translate="no">Loop</span>_&nbsp;phone or the saved QR screenshot
* As soon as the camera reads the QR code, an OTP will begin to appear
Expand Down
4 changes: 2 additions & 2 deletions docs/troubleshooting/red-loop.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,9 +32,9 @@ Some of the reasons listed below cause Loop to go Red and stay Red until you fix

### Lost Pod Information

We have not seen this issue since the update of the *Loop* app from version 2 to version 3 when the method for saving data was updated. Some other applications in the open-source sets of codes might still have this issue. (It was reported in iAPS, for example.) The warning below is left in LoopDocs but if you are running *Loop* version 3.x.x, you do not need to worry about reboots.
We have not seen this issue since the update of the *Loop* app from version 2 to version 3 when the method for saving data was updated. Some other applications in the open-source sets of codes might still have this issue. (It was reported in iAPS, for example. It has been fixed in Trio.) The warning below is left in LoopDocs but if you are running *Loop* version 3.x.x, you do not need to worry about reboots.

* Before attempting to resolve a red-loop with a phone reboot; please review this section. It can affect the stored CGM information as well as the stored pump information.
* Before attempting to resolve a red-loop with a phone reboot when you are running a `Loop` version older than version 3.0 (or iAPS); please review this section. It can affect the stored CGM information as well as the stored pump information.

!!! warning "Be Careful with Phone Reboots with Loop 2 or iAPS"

Expand Down
13 changes: 9 additions & 4 deletions docs/version/releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -180,10 +180,15 @@ For example:

## Remove Apps with Shared App Group

The storage of data with Loop 3 is not backward compatible. In other words, if you attempt to build Loop 2.2.x (or FreeAPS) on a phone which has been upgraded to Loop 3, you will not be able to run that app. You can successfully build the app, which will overwrite Loop 3 on the phone, but the app will crash and you will not be able to Loop.
There are a number of Open Source apps which use the Loop App Group to share data.

At this point, you can restore your Loop 3 build on your phone and continue using Loop 3 or you delete all apps on your phone with a shared app group. This list includes Loop, FreeAPS, FreeAPS X, iAPS, xDrip4iOS, Glucose-Direct, and the g5 Transmitter Reset app.
One consequence of this is that if you delete one of those apps, there may be saved information on the phone that is **not** discarded. Normally this is not a problem, but sometimes you really want to wipe out all the stored information.

If you tried to delete "all" the apps and still have something causing an issue; you can follow the directions to [Review Provisioning Profiles](https://www.loopandlearn.org/loop-expiration-date){: target="_blank" } and then delete the profiles for all the apps by using the - sign.
If you are in a situation where you want to completely wipe all data from your phone for any of these apps which use the Loop App Group, you might need to delete all of them:

You do not need to delete LoopFollow, so if you use LoopFollow - do not delete that provisioning profile.
* Active Apps: *`Loop`*, *`xDrip4iOS`*, *`Glucose-Direct`*, *`iAPS`*
* Old Apps that might be hanging around: *`FreeAPS`*, *`FreeAPS X`* and the *`G5 Transmitter Reset`* app

These apps either have their own App Group or do not use an App Group and do not need to be deleted:

* *`LoopFollow`*, *`LoopCaregiver`*, *`Trio`*

0 comments on commit e0977f5

Please sign in to comment.