Skip to content

Commit 35b03e0

Browse files
authored
update docs to match feature branch updates (#1019)
* update docs to match feature branch updates * update for consistency between Dana and Medtrum
1 parent 217fd2b commit 35b03e0

4 files changed

Lines changed: 67 additions & 64 deletions

File tree

docs/build/pump.md

Lines changed: 6 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,8 @@ These types of pumps are compatible with the *Loop* app.
3030

3131
You must build a special branch to test these pumps. Please only test if you are willing to update frequently, pay close attention and return to open loop as needed.
3232

33-
* [Dana-i / DanaRS-v3](#sooil-dana-pumps) (experts only, work in progress)
34-
* [Medtrum Touchcare Nano](#medtrum-nano) (experts only, work in progress)
33+
* [Dana-i / DanaRS-v3](#sooil-dana-pumps) (new pump manager, work in progress)
34+
* [Medtrum Touchcare Nano](#medtrum-nano) (new pump manager, work in progress)
3535

3636
## Check Medtronic Pump Version
3737

@@ -195,8 +195,8 @@ Loop does not support Omnipod 5 pods.
195195

196196
## Sooil Dana pumps
197197

198-
!!! warning "You must build `feat/dev-dana-medtrum` branch to use Dana pumps"
199-
This branch is experimental and requires careful attention to bolus accounting and IOB reporting.
198+
!!! warning "You must build a feature branch to use Dana pumps"
199+
Dana is supported in both of [these feature branches](../version/development.md#feature-branch-dana-and-medtrum-support){: target="_blank" }, `feat/dev-dana-medtrum` or `feat/eversense`.
200200

201201
* You must follow [zulipchat DanaKit topic](https://loop.zulipchat.com/#narrow/channel/144182-development/topic/DanaKit.20Troubleshooting/with/547829260)
202202

@@ -211,8 +211,6 @@ Loop does not support Omnipod 5 pods.
211211

212212
The Dana-i is the latest and greatest from the Korean pump manufacturer Sooil, released in 2020.
213213

214-
> The `feat/dev-dana-medtrum` branch supports Dana-i.
215-
216214
![Dana-i](img/dana-i.png){width="250"}
217215
{align="center"}
218216

@@ -221,15 +219,13 @@ The Dana-i is the latest and greatest from the Korean pump manufacturer Sooil, r
221219
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.
222220
[Check here](../loop-3/add-pump.md#dana-i-danars-v3) to see how to check your firmware version.
223221

224-
> The `feat/dev-dana-medtrum` branch supports DanaRS-v3.
225-
226222
![DanaRS-v3](img/danars.png){width="250"}
227223
{align="center"}
228224

229225
## Medtrum Nano
230226

231-
!!! warning "You must build `feat/dev-dana-medtrum` branch to use Medtrum pumps"
232-
This branch is experimental and requires careful attention to bolus accounting and IOB reporting.
227+
!!! warning "You must build a feature branch to use Medtrum pumps"
228+
Medtrum Nano is supported in both of [these feature branches](../version/development.md#feature-branch-dana-and-medtrum-support){: target="_blank" }, `feat/dev-dana-medtrum` or `feat/eversense`.
233229

234230
* You must follow [zulipchat Medtrum channel](https://loop.zulipchat.com/#narrow/channel/144182-development/topic/Medtrum.20Nano.20-.20pumps.20for.20development.20use/with/481836247)
235231

docs/loop-3/add-pump.md

Lines changed: 28 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,9 @@ Loopers can choose from 5 pumps and a simulator:
1717
* Please refer to [Compatible Pump](../build/pump.md#check-medtronic-pump-version) for additional details
1818
* Omnipod
1919
* Omnipod DASH
20-
* Dana-i / DanaRS-v3 (**work-in-progress; experts only**)
20+
* Dana-i / DanaRS-v3 (**work-in-progress; new pump manager, use with care**)
2121
* Note: DanaRS-v1 or any Dana Korean versions are not supported
22-
* Medtrum Nano patch pump (**work-in-progress; experts only**)
22+
* Medtrum Nano patch pump (**work-in-progress; new pump manager, use with care**)
2323
* Insulin Pump Simulator
2424

2525
!!! info "Omnipod Terms"
@@ -55,7 +55,7 @@ Here is an overview of the different steps for adding each pump. Before changin
5555

5656
#### Other Pumps
5757

58-
> Experts only, `feat/dev-dana-medtrum` branch required
58+
> These are new pump managers that can be built using one of [two feature branches](../version/development.md#feature-branch-dana-and-medtrum-support){: target="_blank" }, `feat/dev-dana-medtrum` or `feat/eversense`.
5959
6060
* [Dana-i / DanaRS-v3](#dana-i-danars-v3)
6161
* [Medtrum Nano](#medtrum-nano)
@@ -235,40 +235,34 @@ The Medtronic status and commands available are shown in the [Pump Settings](med
235235

236236
## Dana-i / DanaRS-v3
237237

238-
### Dana in Loop Requires Expert Testing
238+
### Check Dana Pump Version
239239

240-
**WARNING: Dana support in Loop is a work-in-progress; only experts should consider testing this.**
240+
!!! info "Support for Dana-i"
241+
All versions of the Dana-i are supported at the moment!
241242

242-
> **A pump manager that works for Trio must be separately tested for Loop**
243+
!!! warning "Check your DanaRS version before starting"
244+
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).
245+
To check your DanaRS version, please go to "Analyze" -> "Model information". The version should be at least `xxx-3.0.0`.
243246

244-
* Several issues were reported regarding bolus accounting and IOB reporting for Loop
245-
* For this reason, the Dana pump support, available in v3.8.1, was removed from the `main` and `dev` branches for v3.8.2 (3.9.2)
246-
* Please do not use Dana with Loop unless you are willing to test and communicate with [developers on zulipchat in this DanaKit channel](https://loop.zulipchat.com/#narrow/channel/144182-development/topic/DanaKit.20Troubleshooting/with/547829260)
247+
![DanaRS-v3 version menu](img/danars-v3-version.jpeg){width="450"}
248+
{align="center"}
247249

248-
### Before Testing Dana
250+
### Dana is a New Pump Manager
249251

250-
The branch needed to get Dana in Loop is: `feat/dev-dana-medtrum`.
252+
**WARNING: Dana support in Loop is a work-in-progress; this is one of several new pump managers.**
251253

252-
This branch is subject to rapid updates.
254+
### Before Testing Dana
253255

254-
Please refer to [zulipchat DanaKit topic](https://loop.zulipchat.com/#narrow/channel/144182-development/topic/DanaKit.20Troubleshooting/with/547829260) before building this branch.
256+
You must build a feature branch to get Dana support in Loop. You can use either one of two feature branches: `feat/dev-dana-medtrum` or `feat/eversense`.
255257

256-
### When Testing Dana
258+
* Please refer to information summarized at [Feature Branch: Dana and Medtrum Support](../version/development.md#feature-branch-dana-and-medtrum-support){: target="_blank" }.
257259

258-
!!! warning "You must build feat/dev-dana-medtrum branch to use Dana pumps"
259-
This branch is experimental and requires careful attention to bolus accounting and IOB reporting.
260-
261-
* You must follow [zulipchat DanaKit topic](https://loop.zulipchat.com/#narrow/channel/144182-development/topic/DanaKit.20Troubleshooting/with/547829260)
262260

263-
!!! info "Support for Dana-i"
264-
All versions of the Dana-i are supported at the moment!
261+
### When Testing Dana
265262

266-
!!! warning "Check your DanaRS version before starting"
267-
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).
268-
To check your DanaRS version, please go to "Analyze" -> "Model information". The version should be at least `xxx-3.0.0`.
263+
* Please do not use Dana with Loop unless you are willing to test and communicate with [developers on zulipchat in this DanaKit channel](https://loop.zulipchat.com/#narrow/channel/144182-development/topic/DanaKit.20Troubleshooting/with/547829260)
269264

270-
![DanaRS-v3 version menu](img/danars-v3-version.jpeg){width="450"}
271-
{align="center"}
265+
### Add Dana Pump
272266

273267
You can only add the Dana when no pump is selected. If you already have a pump selected, you must first delete the pump as detailed in [Change Pump Type](#change-pump-type).
274268

@@ -378,30 +372,20 @@ Therefore, it is important to check if your CGM provides a heartbeat. If it does
378372
## Medtrum Nano
379373

380374

381-
### Medtrum in Loop Requires Expert Testing
382-
383-
**WARNING: Medtrum support in Loop is a work-in-progress; only experts should consider testing this.**
375+
### Medtrum is a New Pump Manager
384376

385-
> **A pump manager that works for Trio must be separately tested for Loop**
377+
**WARNING: Medtrum support in Loop is a work-in-progress; this is one of several new pump managers.**
386378

387-
* Several issues were reported regarding bolus accounting and IOB reporting for Loop
388-
* For this reason, the Medtrum pump support is only found in a special branch
389-
* Please do not use Medtrum with Loop unless you are willing to test and communicate with [developers on zulipchat in the Medtrum channel](https://loop.zulipchat.com/#narrow/channel/144182-development/topic/Medtrum.20Nano.20-.20pumps.20for.20development.20use/with/481836247)
379+
You must build a feature branch to get Medtrum support in Loop. You can use either one of two feature branches: `feat/dev-dana-medtrum` or `feat/eversense`.
390380

391-
### Before Testing Medtrum
381+
* Please refer to information summarized at [Feature Branch: Dana and Medtrum Support](../version/development.md#feature-branch-dana-and-medtrum-support){: target="_blank" }.
392382

393-
The branch needed to get Medtrum in Loop is: `feat/dev-dana-medtrum`.
394383

395-
This branch is subject to rapid updates.
384+
### When Testing Medtrum Nano
396385

397-
Please refer to the [zulipchat Medtrum channel](https://loop.zulipchat.com/#narrow/channel/144182-development/topic/Medtrum.20Nano.20-.20pumps.20for.20development.20use/with/481836247) before building this branch.
386+
* Please do not use Medtrum Nano with Loop unless you are willing to test and communicate with [developers on zulipchat in the Medtrum channel](https://loop.zulipchat.com/#narrow/channel/144182-development/topic/Medtrum.20Nano.20-.20pumps.20for.20development.20use/with/481836247)
398387

399-
### When Testing Medtrum
400-
401-
!!! warning "You must build feat/dev-dana-medtrum branch to use Medtrum patch pumps"
402-
The Medtrum patch pump is experimental and requires careful attention to bolus accounting and IOB reporting.
403-
404-
* You must follow [zulipchat Medtrum channel](https://loop.zulipchat.com/#narrow/channel/144182-development/topic/Medtrum.20Nano.20-.20pumps.20for.20development.20use/with/481836247)
388+
### Confirm Patch and Pump Base are Compatible
405389

406390
!!! info "All versions are supported!"
407391
Both 200U (MD0201 & MD8201) and 300U (MD8301) version are supported with the correct version of the *Loop* app.
@@ -414,6 +398,8 @@ Please refer to the [zulipchat Medtrum channel](https://loop.zulipchat.com/#narr
414398
![Medtrum REF](img/medtrum-ref.JPG){width="450"}
415399
{align="center"}
416400

401+
### Add Medtrum Nano Pump
402+
417403
You can only add the Medtrum patch pump when no pump is selected.
418404
If you already have a pump selected, you must first delete the pump as detailed in [Change Pump Type](#change-pump-type).
419405

docs/loop-3/settings.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -161,10 +161,10 @@ The information about the pump section is detailed on several different pages. F
161161
* [Omnipod or Omnipod DASH](omnipod.md) Status and Commands
162162
* [Medtronic](medtronic.md) Status and Commands
163163

164-
For experts only, requires a special branch:
164+
There are several new pump managers available when you [build a feature branch](../version/development.md#feature-branch-dana-and-medtrum-support){: target="_blank" }:
165165

166-
* [Dana Pumps](add-pump.md#dana-i-danars-v3)
167-
* [Medtrum Pumps](add-pump.md#medtrum-nano)
166+
* [Dana Pumps](dana.md)
167+
* [Medtrum Pumps](medtrum.md)
168168

169169
### [CGM Settings](add-cgm.md)
170170

docs/version/development.md

Lines changed: 30 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -46,9 +46,9 @@ The table below lists active branches. Note that updates may occur and be announ
4646
|:--|:--|:--|:--|
4747
| main | 3.12.1 | 03 Apr 2026 | release|
4848
| dev | 3.13.1 | 02 Apr 2026 | code is currently the same as `main` |
49-
| [feat/pod-keep-alive](#feature-branch-pod-keep-alive-feature)<br>- SHA `4612426` | 3.13.1 | 31 Mar 2026| - uses the OmniBLE pod-keep-alive branch to support users of iPhone 16 or 17e phones with InPlay BLE (-Atlas) DASH pods<br> - SHA for OmniBLE is `dade6ed`<br>**Please read [Feature Branch: Pod Keep Alive Feature](#feature-branch-pod-keep-alive-feature)** |
50-
| [feat/dev-dana-medtrum](#feature-branch-dana-and-medtrum-support) <br>- SHA `31fe9f6` | 3.13.1 | 31 Mar 2026 | - adds support for Dana and Medtrum pumps<br> - SHA for DanaKit is `0158fc8`<br> - SHA for MedtrumKit is `b7f3d44`<br>**Medtrum User Interface Redesigned** to be more like the Omnipod User Interace |
51-
| [feat/eversense](#feature-branch-eversense-support) <br>- SHA `126c4a6` | 3.13.1 | 31 Mar 2026 | - adds experimental support for Eversense (includes Dana and Medtrum pumps support too)<br>- this branch is ready for expert testers to evaluate and report back<br> - SHA for Eversense is `0bf3cf4` |
49+
| [feat/pod-keep-alive](#feature-branch-pod-keep-alive-feature)<br>- SHA `6b7cf86` | 3.13.1 | 16 Apr 2026| OmniBLE dev was updated to include the pod-keep-alive feature with [PR 165](https://github.com/LoopKit/OmniBLE/pull/165).<br>The LoopWorkspace main and dev branches are not yet updated.<br>Keep using the feature branch in the meantime if you use iPhone 16 or 17e phones with InPlay BLE (-Atlas) DASH pods<br> - SHA for OmniBLE is `14c03be`<br>**Please read [Feature Branch: Pod Keep Alive Feature](#feature-branch-pod-keep-alive-feature)** |
50+
| [feat/dev-dana-medtrum](#feature-branch-dana-and-medtrum-support) <br>- SHA `58758c5` | 3.13.1 | 30 Apr 2026 | - adds support for Dana and Medtrum pumps<br> - SHA for DanaKit is `5148f19`<br> - SHA for MedtrumKit is `64f716c`<br>**Medtrum User Interface Redesigned** to be more like the Omnipod User Interac.<br>Several fixes added for MedtrumKit, not yet in DanaKit |
51+
| [feat/eversense](#feature-branch-eversense-support) <br>- SHA `63684de` | 3.13.1 | 30 Apr 2026 | - adds experimental support for Eversense (includes Dana and Medtrum pumps support - same SHA as above)<br>- this branch is ready for use to evaluate and report back<br> - SHA for Eversense is `eaca3a7` |
5252

5353
!!! important "Eversense Support"
5454
The Eversense CGM is now supported by the *Loop* app in a feature branch. To simplify maintenance, the branch which supports Eversense also supports the two new pumps: Dana and Medtrum.
@@ -186,13 +186,13 @@ While RileyLink is selected, the app is triggered by the RileyLink one minute he
186186

187187
### Feature Branch: Dana and Medtrum Support
188188

189-
Anyone using Dana or Medtrum pumps must build one of these branches. The pump manager support is identical. The difference is the second one includes support for the Eversense CGM.
189+
Anyone using Dana or Medtrum pumps must build one of these branches. The pump manager support is identical. The difference is the second one includes support for the Eversense CGM. Build instructions are found here: [How to Build Feature Branches](#how-to-build-feature-branches).
190190

191191
* `feat/dev-dana-medtrum`
192192
* `feat/eversense`
193193

194-
!!! important "Experts Only"
195-
Please only use a feature branch if you are prepared to follow along in zulipchat and are willing to help test and resolve issues. This is critical when using new pump managers.
194+
!!! important "New Pump Managers"
195+
These are new Pump Managers and may have known or unknown bugs. Please only use a feature branch if you are prepared to follow along in zulipchat and are willing to help test and resolve issues. This is critical when using new pump managers.
196196

197197
* Please ensure you have the latest version of a given branch by synching before you build:
198198
* Browser Build: be sure you select `feat/dev-dana-medtrum` or `feat/eversense` branch
@@ -203,14 +203,22 @@ Anyone using Dana or Medtrum pumps must build one of these branches. The pump ma
203203
* See [Mac-Xcode Build](#mac-xcode-build) for fresh download instructions
204204

205205
!!! important "Bluetooth Connection Issues for Dana and Medtrum"
206-
Both the Dana and Medtrum pumps are designed to stay in continuous Bluetooth commnication with the pump controller. The behavior of your OS-AID system needs to properly handle boluses in progress if that communication is interrupted. This can happen if someone walks away from their phone during a bolus.
206+
Both the Dana and Medtrum pumps are designed to stay in continuous Bluetooth commnication with the pump controller. This is quite different from the older Pod and Medtronic pumps.
207+
208+
The behavior of your OS-AID system needs to properly handle bolus and temp basal rate events in progress if that communication is interrupted. This can happen if someone walks away from their phone during a bolus or while a temp basal rate is in progress.
207209

208210
Please read the rest of this section to learn about how this might affect an older or current version of your OS-AID app.
209211

210-
#### Closed Issue for Medtrum
212+
#### Recently Closed Issue for Medtrum
211213

212214
!!! success "Medtrum Bluetooth Comms Loss Updated"
213215

216+
#### MedtrumKit - fixed on 29 April 2026
217+
218+
[MedtrumKit Issue 112](https://github.com/jbr7rr/MedtrumKit/issues/112) reported that MedtrumKit did not properly handle a Temp Basal Rate (TBR) event if BLE comms was lost at the time the TBR completed.
219+
220+
[MedtrumKit PR 118](https://github.com/jbr7rr/MedtrumKit/pull/118) provided an updated management of TBR providing accurate handling of TBR when BLE was interrupted and later restored.
221+
214222
#### MedtrumKit - fixed on 25 March 2026
215223

216224
[MedtrumKit Issue 92](https://github.com/jbr7rr/MedtrumKit/issues/92) reported that when the Medtrum moved out of Bluetooth range, the app reported an interrupted bolus when in fact the bolus continued. This led to underreported values for Active Insulin, also known as Insulin on Board (IOB).
@@ -223,7 +231,9 @@ Anyone using Dana or Medtrum pumps must build one of these branches. The pump ma
223231

224232
#### DanaKit - Issue is still open
225233

226-
The Medtrum Issue report led to testing for DanaKit. It has a slighlty different error signature. This one is an open Issue, so Dana users need to be aware of this.
234+
The Medtrum Issue report led to testing for DanaKit. The bolus issue has a slightly different error signature. This two issues are still open, so Dana users need to be aware of them.
235+
236+
[DanaKit Issue 36](https://github.com/bastiaanv/DanaKit/issues/36) reported that DanaKit did not properly handle a Temp Basal Rate (TBR) event if BLE comms was lost at the time the TBR completed.
227237

228238
[DanaKit Issue 34](https://github.com/bastiaanv/DanaKit/issues/34)
229239

@@ -252,6 +262,16 @@ Anyone using Dana or Medtrum pumps must build one of these branches. The pump ma
252262

253263
### Feature Branch: Eversense Support
254264

265+
#### Recently Closed Issue for Eversense
266+
267+
!!! success "Eversense Placement Guide updated"
268+
269+
#### EversenseKit - fixed on 30 April 2026
270+
271+
[EversenseKit Issue 26](https://github.com/bastiaanv/EversenseKit/issues/26) reported that the placement guide graph was not updating when attaching the Transmitter over the sensor.
272+
273+
[EversenseKit PR 30](https://github.com/bastiaanv/EversenseKit/pull/30) fixed the problem. The solution was to enable debug mode while using the placement guide and disable debug mode when done.
274+
255275
There is a new feature branch available, `feat/eversense` which supports the Eversense E365 and E3 transmitters. In addition to Eversense support, this branch also has the same pump support as the `feat/dev-dana-medtrum` branch.
256276

257277
For anyone who tests this branch with Eversense, if there are issues with your use of Loop with Eversense please report in this [zulipchat channel](https://loop.zulipchat.com/#narrow/channel/144182-development/topic/Eversense.20CGM/with/569969251).
@@ -276,6 +296,7 @@ If you prefer to create an issue directly at the Eversense repo, create it here:
276296
> * This enabled testing the Eversense behavior with Loop on a test phone
277297
> * No testing with the E3 (3-month, 90-day) sensor has been performed
278298
299+
279300
## Older updates
280301

281302
### Updates from v3.8 to v3.10

0 commit comments

Comments
 (0)