Skip to content

Commit 2b44122

Browse files
authored
Merge pull request #848 from marionbarker/working-docs
Updates after release 3.4.1
2 parents 6aa10e3 + 33cba2f commit 2b44122

14 files changed

+6607
-3354
lines changed

docs/build/pump.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -203,7 +203,7 @@ The special fork (see [link](#sooil-dana-pumps) for details) works with the Dana
203203
![Dana-i](img/dana-i.png){width="250"}
204204
{align="center"}
205205

206-
### DanaRS-v3
206+
### DanaRS
207207

208208
The DanaRS was first released in 2002, with firmware version v1 which is not supported at this time. Only firmware version v3 and onwards are supported with the *Loop* app.
209209
[Check here](../loop-3/add-pump.md#dana-i-danars-v3) to see how to check your firmware version.

docs/gh-actions/gh-update.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -242,7 +242,7 @@ In your fork of LoopWorkspace:
242242
* Run the Action: `Add Identifier`
243243
* Wait for it to succeed
244244

245-
??? tip "For detailed instructions (Click to open/close)"
245+
???+ tip "Detailed instructions (Click to open/close)"
246246
Refer to the graphic below for the numbered steps:
247247

248248
1. Click on the `Actions` tab of your <code>LoopWorkspace</code> repository
@@ -270,7 +270,7 @@ In your fork of LoopWorkspace:
270270
|-------|------------|
271271
| `Loop Widget Extension` | `com.TEAMID.loopkit.Loop.LoopWidgetExtension` |
272272

273-
??? tip "For detailed instructions (Click to open/close)"
273+
???+ tip "Detailed instructions (Click to open/close)"
274274
* Open the [Certificates, Identifiers & Profiles: Identifiers List](https://developer.apple.com/account/resources/identifiers/list){: target="_blank" } page.
275275
* Click on the "`LoopWidgetExtension`" identifier to open the `Edit Your App ID Configuration` screen.
276276

@@ -304,7 +304,7 @@ In your fork of LoopWorkspace:
304304

305305
You must run the action `Create Certificates` again because the `Identifiers` were updated. Wait for this to succeed before trying to build.
306306

307-
??? tip "For detailed instructions (Click to open/close)"
307+
???+ tip "Detailed instructions (Click to open/close)"
308308
Refer to the graphic below for the numbered steps:
309309

310310
1. Click on the "<code>Actions</code>" tab of your <code>LoopWorkspace</code> repository

docs/loop-3/add-cgm.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,13 @@ Loop can be connected to the following CGMs:
1111

1212
* CGMs that reside on the same phone (internet not required)
1313
* [Dexcom G5](#dexcom-g5-g6-one)
14-
* [Dexcom G6](#dexcom-g5-g6-one) (use this for Dexcom ONE)
15-
* [Dexcom G7](#dexcom-g7) **(Loop 3 only)**
14+
* [Dexcom G6 or ONE](#dexcom-g5-g6-one)
15+
* [Dexcom G7 or ONE+](#dexcom-g7-or-one)
1616
* [Libre](#libre) **(Loop 3.4 and later)**
1717
* Only some Libre sensors are supported; some have encryption that limits DIY use
1818
* [Minimed Enlite CGM](#medtronic-enlite-cgm)
1919
* Medtronic Pump only
20-
* **You must [add pump](add-pump.md) first**
20+
* **You must [add the Medtronic pump](add-pump.md) first**
2121
* If Enlite is connected to Medtronic pump and that pump is connected to Loop, then an option for Enlite shows up when choosing a CGM, _not visible in graphic below_
2222
* CGMs that require active internet (WiFi or Cell)
2323
* [*Dexcom Share*](#dexcom-share-as-a-cgm)
@@ -112,7 +112,7 @@ Your selection to enable [Remote Upload from Loop](#remote-upload-from-loop) mus
112112

113113
You do **NOT** need your Share account info listed in Loop settings if you are using a G5 or G6 system. The transmitter ID is sufficient. In fact, you should leave your Share credentials blank so that you don't accidentally become internet-dependent for CGM data if you forget to update your transmitter ID when you start a new transmitter.
114114

115-
### Dexcom G7
115+
### Dexcom G7 or ONE+
116116

117117
This is only available on Loop 3.
118118

docs/loop-3/add-pump.md

Lines changed: 9 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Loopers can choose from 4 pumps and a simulator:
1818
* Omnipod
1919
* Omnipod DASH
2020
* Dana-i / DanaRS-v3 (Coming soon)
21-
* Note: DanaRS-v1 or any Dana korean versions are not supported (or is untested)
21+
* Note: DanaRS-v1 or any Dana korean versions are not supported
2222
* A special fork is required at this time (see [link](../build/pump.md#sooil-dana-pumps) for details)
2323
* Insulin Pump Simulator
2424

@@ -239,8 +239,8 @@ The Medtronic status and commands available are shown in the [Pump Settings](med
239239
All versions of the Dana-i are supported at the moment!
240240

241241
!!! warning "Check your DanaRS version before starting"
242-
Only the DanaRS-v3 is supported, every other version is not supported or is untested (The korean versions are untested for example).
243-
To check your DanaRS version, please go to "Analyze" -> "Model information". The version should be at least `xxx-3.0.0`
242+
Only the DanaRS firmware v3.0 or higher is supported, every other version is not supported or is untested (The korean versions are untested for example).
243+
To check your DanaRS version, please go to "Analyze" -> "Model information". The version should be at least `xxx-3.0.0`.
244244

245245
![DanaRS-v3 version menu](img/danars-v3-version.jpeg){width="450"}
246246
{align="center"}
@@ -314,59 +314,16 @@ Sadly, only the Dana distributors know how to enable this feature at the moment.
314314
But we do know you need to set your alarm to sound.
315315
You can do this via: "Settings" -> "User options" -> "4. Alarm"
316316

317-
### (Optional) Enable background sound
317+
### (Optional) Check if you need a heartbeat
318318

319-
An extra feature available for the Dana pumps is the background sound.
320-
This feature was developed in order to keep the *Loop* app running in the background.
319+
Most CGM provide a live Bluetooth connection, which the *Loop* app uses as a heartbeat to wake the app with each CGM reading.
320+
Without a heartbeat, the *Loop* app will not run the algorithm when the app is in the background or the phone is locked.
321321

322-
Normally, your CGM will have an active Bluetooth connection, which prevent the *Loop* app from being put into a suspended state.
323-
But when you are planning on using a CGM, like [NightScout remote CGM](./add-cgm.md#nightscout-remote-cgm), [Dexcom Share](./add-cgm.md#dexcom-share-as-a-cgm), etc, you rely on a active internet connection, and not on an active Bluetooth connection.
322+
Some pumps can also provide a heartbeat if the CGM you choose cannot provide one.
324323

325-
The Dana pump cannot provide a Bluetooth heartbeat, because it will block the pump's UI.
326-
This will cause issue with regards to battery drain of the pump, but also when you want to replace the reservoir or cannula.
327-
For this reason, the background sound feature is made available.
324+
DanaKit doesn't provide a heartbeat by default.
328325

329-
!!! warning "Only activate this if truly needed"
330-
Enabling this feature will put a big load on your iPhone's battery.
331-
Therefore, only use it if your sensor doesn't provide a heartbeat, i.e. the NightScout remote CGM, Dexcom Share, etc
332-
333-
In order to activate, follow these steps:
334-
335-
1. Activate the [UIBackgroundMode - audio](https://developer.apple.com/documentation/bundleresources/information_property_list/uibackgroundmodes):
336-
* When [building with Mac](../build/overview.md), go to the LoopWorkspace Xcode project and select the Loop project.
337-
Go to "Targets" -> "Loop" -> "Signing & Capabilities" and scroll down to "Background modes".
338-
Enable the checkbox for "Audio, AirPlay, and Picture in Picture".
339-
Then rebuild the app and go to step 2.
340-
![Xcode background sound example](./img/background-sound-xcode.png)
341-
342-
* When [building with Browser](../gh-actions/gh-overview.md), you will need to make a change to the GitHub Actions workflow.
343-
Go to your LoopWorkspace fork on GitHub and press `.` on your keyboard.
344-
You will be redirected to a `github.dev` page with the code of your LoopWorkspace.
345-
Now go to ".github" -> "workflows" -> "build_loop.yml".
346-
Scroll down till you see the `- name: Fastlane Build & Archive` command.
347-
Just before this command, add the following to this script ([example](https://github.com/bastiaanv/LoopWorkspace/commit/67a1e42b9b771550afc14adf914ff98c37d96e67)):
348-
349-
```
350-
- name: Update entitlement background sound
351-
run: sed -i -e 's/<string>bluetooth-central<\/string>/<string>bluetooth-central<\/string><string>audio<\/string>/g' Loop/Loop/Info.plist
352-
```
353-
354-
* To save your changes to the "build_loop.yml", go to the Source Control tab on the left (should show up with a blue 1, see image below).
355-
Enter a message and press the green "Commit & Push"-button.
356-
By pressing this button, GitHub will automatically make a new browser build for you and push it to TestFlight
357-
![Github web ide example](./img/background-sound-web-ide.png)
358-
359-
2. After you have done the onboarding of the pump (see steps above), go to the pump settings.
360-
Scroll down the "Pump name" and long-press this row.
361-
A modal should pop-up with the question, whether you want to toggle Silent tones.
362-
363-
In order to activate this feature, the modal should say something like: `Yes, Enable silent tones`.
364-
When it says: `Yes, Disable silent tones`, it will disable the background sounds.
365-
![Loop example background sound](./img/background-sound-loop.jpeg){width="250"}
366-
{align="center"}
367-
368-
3. Done!
369-
Every time you put the *Loop* app in the background, it will play a toneless sound, which prevents it from suspending the *Loop* app
326+
Therefore, it is important to check if your CGM provides a heartbeat. If it does not, there are battery-intensive work-around methods for Dana pump. See [Dana Heartbeat Modes](../troubleshooting/dana-heartbeat.md).
370327

371328

372329
## Change Pump Type

docs/loop-3/features.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,11 @@ Loop 3 has a Remote Carb and Remote Bolus feature to enable remote caregivers to
2525

2626
## **New with Loop 3.4.0**
2727

28+
Additional details about the 3.4.0 release are found here: [Version: Releases: 3.4.0](../version/releases.md#loop-v340){: target="_blank" }
29+
2830
## Algorithm Experiments
2931

30-
Two algorithm experiments have been added to dev. These are _<span translate="no">Glucose Based Partial Application</span>_ and _<span translate="no">Integral Retrospective Correction</span>_. They can be viewed on the Loop Settings screen just below Therapy Settings and Usage Data Sharing as shown in the graphic below:
32+
Two algorithm experiments are now available in the *Loop* app (version 3.4.0 or later). These are _<span translate="no">Glucose Based Partial Application</span>_ and _<span translate="no">Integral Retrospective Correction</span>_. They can be viewed on the Loop Settings screen just below Therapy Settings and Usage Data Sharing as shown in the graphic below:
3133

3234
![algorithm experiments](img/algorithm-experiments.svg){width="650"}
3335
{align="center"}
Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
## Dana(RS-v3 / -i) heartbeat modes
2+
3+
!!! warning "Please read the full page and only activate this if truly needed"
4+
Enabling this feature will put a big load on your iPhone's battery or your pump's battery.
5+
Therefore, only use it if your sensor doesn't provide a heartbeat, i.e. the NightScout remote CGM, Dexcom Share, etc
6+
7+
Danakit provides two ways to enable a heartbeat:
8+
9+
- Background sound
10+
- Continuous Bluetooth mode
11+
12+
### Which mode to choose?
13+
14+
You should choose *Background sound* when:
15+
16+
- You prefer a higher phone battery drain over a higher pump battery drain
17+
- You are able to change the permission of the *Loop* app in Xcode or change the Github action build step
18+
19+
You should choose *Continuous Bluetooth mode* when:
20+
21+
- You prefer a higher pump battery drain over a higher phone battery drain
22+
- You are aware that the pump's UI will be blocked 24/7 unless you: disconnect in the *Loop* app, kill the *Loop* app, or disable bluetooth on your phone
23+
24+
## Background sound
25+
26+
An extra feature available for the Dana pumps is the background sound.
27+
This feature was developed in order to keep the *Loop* app running in the background.
28+
29+
Normally, your CGM will have an active Bluetooth connection, which prevent the *Loop* app from being put into a suspended state.
30+
But when you are planning on using a CGM, like [NightScout remote CGM](../loop-3/add-cgm.md#nightscout-remote-cgm), [Dexcom Share](../loop-3/add-cgm.md#dexcom-share-as-a-cgm), etc, you rely on a active internet connection, and not on an active Bluetooth connection.
31+
32+
In order to activate, follow these steps:
33+
34+
1. Activate the [UIBackgroundMode - audio](https://developer.apple.com/documentation/bundleresources/information_property_list/uibackgroundmodes):
35+
* When [building with Mac](../build/overview.md), go to the LoopWorkspace Xcode project and select the Loop project.
36+
Go to "Targets" -> "Loop" -> "Signing & Capabilities" and scroll down to "Background modes".
37+
Enable the checkbox for "Audio, AirPlay, and Picture in Picture".
38+
Then rebuild the app and go to step 2.
39+
![Xcode background sound example](./img/background-sound-xcode.png)
40+
41+
* When [building with Browser](../gh-actions/gh-overview.md), you will need to make a change to the GitHub Actions workflow.
42+
Go to your LoopWorkspace fork on GitHub and press `.` on your keyboard.
43+
You will be redirected to a `github.dev` page with the code of your LoopWorkspace.
44+
Now go to ".github" -> "workflows" -> "build_loop.yml".
45+
Scroll down till you see the `- name: Fastlane Build & Archive` command.
46+
Just before this command, add the following to this script ([example](https://github.com/bastiaanv/LoopWorkspace/commit/67a1e42b9b771550afc14adf914ff98c37d96e67)):
47+
48+
```
49+
- name: Update entitlement background sound
50+
run: sed -i -e 's/<string>bluetooth-central<\/string>/<string>bluetooth-central<\/string><string>audio<\/string>/g' Loop/Loop/Info.plist
51+
```
52+
53+
* To save your changes to the "build_loop.yml", go to the Source Control tab on the left (should show up with a blue 1, see image below).
54+
Enter a message and press the green "Commit & Push"-button.
55+
By pressing this button, GitHub will automatically make a new browser build for you and push it to TestFlight
56+
![Github web ide example](./img/background-sound-web-ide.png)
57+
58+
2. After you have done the onboarding of the pump (see steps above), go to the pump settings.
59+
Scroll down the "Pump name" and long-press this row.
60+
A modal should pop-up with the question, whether you want to toggle Silent tones.
61+
62+
In order to activate this feature, the modal should say something like: `Yes, Enable silent tones`.
63+
When it says: `Yes, Disable silent tones`, it will disable the background sounds.
64+
![Loop example background sound](./img/background-sound-loop.jpeg){width="250"}
65+
{align="center"}
66+
67+
3. Done!
68+
Every time you put the *Loop* app in the background, it will play a toneless sound, which prevents it from suspending the *Loop* app
69+
70+
## Continuous bluetooth mode
71+
72+
This mode replicates how a CGM works: it keeps the bluetooth connection open even though no command's are being executed.
73+
Like stated before, this will drain your pump's battery more than usual.
74+
75+
### How to unblock the pump's UI
76+
If you want to replace the reservoir or want to interact with the pump's UI, you have three options to temporary disable *Continuous bluetooth mode*:
77+
78+
- Disable bluetooth on your phone (not recommended)
79+
- Kill the *Loop* app (not recommended)
80+
- Using the disconnect feature (recommended)
81+
82+
To use the disconnect feature, go to the Dana pump settings and use the *Disconnect from pump* button.
83+
You will get prompt to set a notification reminder.
84+
This reminder will be sent to you if you haven't reconnected the pump within the given time.
85+
This feature is fully optional, but is recommended.
86+
87+
![Dana continuous disconnect](./img/dana-disconnect.png){width="400"}
88+
{align="center"}
89+
90+
### How to enable Continuous bluetooth mode
91+
Now that you know what the risks are of this feature and how to unblock the pump's UI, can we talk about enabling the feature.
92+
Go to the Dana settings and long press the Firmware version row.
93+
You will be prompted to enable or disable the feature, choose `Yes, Switch to continuous mode` and the feature has been enabled!
94+
95+
![Dana continuous disconnect](./img/dana-hidden-enable.png){width="250"}
96+
{align="center"}
442 KB
Loading

0 commit comments

Comments
 (0)