Skip to content

Commit 8271c81

Browse files
authored
Merge pull request LoopKit#886 from bastiaanv/main
docs: Update DanaKit docs
2 parents 43ecaf6 + e4645f9 commit 8271c81

File tree

9 files changed

+138
-98
lines changed

9 files changed

+138
-98
lines changed

docs/loop-3/add-pump.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -323,14 +323,14 @@ Some pumps can also provide a heartbeat if the CGM you choose cannot provide one
323323

324324
DanaKit doesn't provide a heartbeat by default.
325325

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).
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-faq.md).
327327

328328

329329
## Change Pump Type
330330

331331
Before changing from one pump type to another pump type, you must delete the old pump type.
332332

333-
* If you are using Medtronic, scroll to the bottom of the pump screen and select `Delete Pump`
333+
* If you are using Medtronic or Dana (RS/-i), scroll to the bottom of the pump screen and select `Delete Pump`
334334

335335
* Before switching between Omnipod and Omnipod DASH or any kind of Omnipod to Medtronic, you must deactivate your current pod
336336
* This does not include changing a pod, so long as the pods are of the same type
Lines changed: 135 additions & 95 deletions
Original file line numberDiff line numberDiff line change
@@ -1,96 +1,136 @@
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](../browser/bb-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"}
1+
# Dana (RS/-i) FAQ
2+
3+
## Q: Help I frequently encounter signal loss or orange loops
4+
5+
First of all, lets check you CGM, since the dana driver trusts your CGM to provide a heartbeat.
6+
7+
If you are using an internet CGM (like NightScout remote CGM, Dexcom Share), you lack a heartbeat inside the *Loop* app.
8+
You must look into one of the heartbeat modes of the Dana driver:
9+
10+
- Continuous mode - [Please read this paragraph before activating it](#continuous-bluetooth-mode). This mode will keep a connection at all times, this will decrease your pump's & phone's battery life by a bit
11+
- Background sound - [link](#background-sound). This mode will keep loop alive by playing soundless music in the background. This has a big impact on your phone's battery, but little to no impact on your pumps battery life.
12+
13+
If you are running a bluetooth CGM, it might be worth to look into [continuous heartbeat mode](#continuous-bluetooth-mode).
14+
Some Dexcom users have reported to have less issue/orange loops using the continuous mode, then in normal mode.
15+
16+
Please note that orange loops aren't nice, they are also not fully preventable.
17+
If you are experiencing issues with orange loops, please post your issue and the Dana logs on Loop's Zulip forums.
18+
19+
![Dana share logs](./img/dana-share-logs.png){width="250"}
20+
{align="center"}
21+
22+
## Q: Help I see double insulin entries in the *Loop* app
23+
24+
![Dana double insulin entries](./img/dana-double-entry-example.jpeg){width="250"}
25+
{align="center"}
26+
27+
First, check the pump time against the time of your phone.
28+
Go to the bottom of the pump settings and check if there is no bigger gap between `Pump time` and `Checked at` of 10 seconds.
29+
If there is, use the `Manual sync pump time` button to fix the issue.
30+
31+
If this issue keeps happening, and the `Nightly pump time sync` feature is disabled, please re-enable it.
32+
This feature is enabled by default and will sync the pump time during the first Loop cycle of the day (somewhere between 00:00 and 00:05).
33+
This will prevent the time drift of the pump.
34+
35+
If the issue is still happening, you can disable `Bolus syncing` by long pressing the `Battery level`, and then disable the feature.
36+
Please note, you will have to enter a bolus manually into the *Loop* app, whenevery you do a bolus outside the *Loop* app.
37+
Disabling this feature will prevent the Dana driver of syncing a newly found bolus back to the *Loop* app.
38+
39+
![Dana double insulin entries](./img/dana-bolus-syncing.jpeg){width="250"}
40+
{align="center"}
41+
42+
## Q: Help I just found out my pump screen doesn't work
43+
44+
First of all, do not panic :)
45+
46+
The Dana driver has a few tricks to work around this issue, but always check with your insurance or Dana distributor to see if you can get a replacement pump.
47+
48+
Now for the tricks, the Dana driver has the following available for you:
49+
50+
- All the user settings in the pump can be changed via the *Loop* app.
51+
Go to the pump settings -> User options to see all the settings which can be changed.
52+
You can check your display settings here, just to make sure the screen isn't broken, or you can your reservoir level for example.
53+
54+
![Dana user options](./img/dana-user-options.png){width="250"}
55+
{align="center"}
56+
57+
- The Dana driver also allow you to do blind reservoir refill or cannula changes.
58+
You will get a full wizard based on the type of refill you want to do!
59+
60+
![Dana Blind refill](./img/dana-blind-refill.png){width="250"}
61+
{align="center"}
62+
63+
## Heartbeat modes
64+
65+
### Background sound
66+
67+
An extra feature available for the Dana pumps is the background sound.
68+
This feature was developed in order to keep the *Loop* app running in the background.
69+
70+
Normally, your CGM will have an active Bluetooth connection, which prevent the *Loop* app from being put into a suspended state.
71+
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.
72+
73+
In order to activate, follow these steps:
74+
75+
1. Activate the [UIBackgroundMode - audio](https://developer.apple.com/documentation/bundleresources/information_property_list/uibackgroundmodes):
76+
* When [building with Mac](../build/overview.md), go to the LoopWorkspace Xcode project and select the Loop project.
77+
Go to "Targets" -> "Loop" -> "Signing & Capabilities" and scroll down to "Background modes".
78+
Enable the checkbox for "Audio, AirPlay, and Picture in Picture".
79+
Then rebuild the app and go to step 2.
80+
![Xcode background sound example](./img/background-sound-xcode.png)
81+
82+
* When [building with Browser](../browser/bb-overview.md), you will need to make a change to the GitHub Actions workflow.
83+
Go to your LoopWorkspace fork on GitHub and press `.` on your keyboard.
84+
You will be redirected to a `github.dev` page with the code of your LoopWorkspace.
85+
Now go to ".github" -> "workflows" -> "build_loop.yml".
86+
Scroll down till you see the `- name: Fastlane Build & Archive` command.
87+
Just before this command, add the following to this script ([example](https://github.com/bastiaanv/LoopWorkspace/commit/67a1e42b9b771550afc14adf914ff98c37d96e67)):
88+
89+
```
90+
- name: Update entitlement background sound
91+
run: sed -i -e 's/<string>bluetooth-central<\/string>/<string>bluetooth-central<\/string><string>audio<\/string>/g' Loop/Loop/Info.plist
92+
```
93+
94+
* 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).
95+
Enter a message and press the green "Commit & Push"-button.
96+
By pressing this button, GitHub will automatically make a new browser build for you and push it to TestFlight
97+
![Github web ide example](./img/background-sound-web-ide.png)
98+
99+
2. After you have done the onboarding of the pump (see steps above), go to the pump settings.
100+
Scroll down the "Pump name" and long-press this row.
101+
A modal should pop-up with the question, whether you want to toggle Silent tones.
102+
103+
In order to activate this feature, the modal should say something like: `Yes, Enable silent tones`.
104+
When it says: `Yes, Disable silent tones`, it will disable the background sounds.
105+
![Loop example background sound](./img/background-sound-loop.jpeg){width="250"}
106+
{align="center"}
107+
108+
3. Done!
109+
Every time you put the *Loop* app in the background, it will play a toneless sound, which prevents it from suspending the *Loop* app
110+
111+
### Continuous bluetooth mode
112+
113+
This mode replicates how a CGM works: it keeps the bluetooth connection open even though no commands are being executed.
114+
115+
#### How to unblock the pump's UI
116+
If you want to replace the reservoir or want to interact with the pump's UI, you have three options to temporarily disable *Continuous bluetooth mode*:
117+
118+
- Disable bluetooth on your phone (not recommended)
119+
- Kill the *Loop* app (not recommended)
120+
- Using the disconnect feature (recommended)
121+
122+
To use the disconnect feature, go to the Dana pump settings and use the *Disconnect from pump* button.
123+
You will get prompt to set a notification reminder.
124+
This reminder will be sent to you if you haven't reconnected the pump within the given time.
125+
This feature is fully optional, but is recommended.
126+
127+
![Dana continuous disconnect](./img/dana-disconnect.png){width="400"}
128+
{align="center"}
129+
130+
#### How to enable Continuous bluetooth mode
131+
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.
132+
Go to the Dana settings and long press the Firmware version row.
133+
You will be prompted to enable or disable the feature, choose `Yes, Switch to continuous mode` and the feature has been enabled!
134+
135+
![Dana continuous disconnect](./img/dana-hidden-enable.png){width="250"}
96136
{align="center"}
477 KB
Loading
44.3 KB
Loading
Loading
Loading
298 KB
Loading
130 KB
Loading

mkdocs.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -213,7 +213,7 @@ nav:
213213
- 'Omnipod Faults': 'troubleshooting/omnipod-faults.md'
214214
- 'MDT Pump Errors': 'troubleshooting/pump-errors.md'
215215
- 'MDT Pump Battery': 'operation/features/battery.md'
216-
- 'Dana Heartbeat': 'troubleshooting/dana-heartbeat.md'
216+
- 'Dana (RS/-i) FAQ': 'troubleshooting/dana-faq.md'
217217
- 'Version':
218218
- 'Version Overview': 'version/overview-version.md'
219219
- 'Releases': 'version/releases.md'

0 commit comments

Comments
 (0)