Skip to content

Commit 09366b3

Browse files
authored
Update LoopDocs for release v3.14.8 (#1066)
* updates for dev branch, now at 3.14.8 * update LoopDocs for release 3.14.8 * more PKA cleanup
1 parent 7148c3f commit 09366b3

7 files changed

Lines changed: 133 additions & 109 deletions

File tree

docs/browser/automatic.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ The instructions provided for building with a browser include settings to automa
99

1010
* The new file: build_loop_auto.yml has the same content as the older build_loop.yml
1111
* It appears that just giving it a new name was enough to prevent GitHub from disabling the build process
12-
* Once you update to v3.14.7, your automatic building will be restored
12+
* Once you update to v3.14.7 or newer, your automatic building will be restored
1313
* The old file: build_loop.yml is still in your LoopWorkspace folder for your convenience
1414
* It no longer has the instructions to run automatically (that did not work anyway)
1515
* If you had customization lines in build_loop.yml, they should still be there

docs/build/phone.md

Lines changed: 14 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -33,23 +33,26 @@ You need a minimum version of the mobile operating software, called the *iOS*, t
3333

3434
All the devices listed below are currently compatible with Loop. They are separated by the available *iOS* for the phone.
3535

36-
These phones require *iOS* 26 and `Loop version 3.8.x` or newer
36+
These phones require *iOS* 27 and `Loop version 3.14.8` or newer
3737

38-
- iPhone 17, all variants except 17e
39-
- iPhone 17e models are compatible but **not recommended for use with Omnipod DASH**
40-
* See [Keep Alive: Atlas or InPlay DASH pod](../faqs/omnipod-faqs.md#keep-alive-atlas-or-inplay-dash-pods){: target="_blank" } warning
38+
- iPhone 18, all variants
39+
* Note we only assume this is true - there have been no complaints
4140

42-
!!! important "iOS 26 requires `Loop v3.8.2` or newer"
43-
Any iPhone 17 must run iOS 26. You must install `Loop v3.8.2` or newer before updating to iOS 26. `Loop v3.7.x` and earlier do not to support iOS 26.
41+
These phones require *iOS* 26 and support *iOS* 27
4442

45-
**Do not attempt to run an older version of Loop on any iOS 26 phone, use `Loop v3.8.2` or newer.**
43+
- iPhone 17, all variants
44+
- iPhone 17e works with v3.14.8 or newer
45+
- Older versions of the Loop app did not work as well with some DASH pods with iPhone 17e
46+
* See [Keep Alive: Atlas or InPlay DASH pod](../faqs/omnipod-faqs.md#keep-alive-atlas-or-inplay-dash-pods){: target="_blank" } warning
4647

47-
These phones require *iOS* 18 and are compatible with *iOS* 26.
48+
These phones require *iOS* 18 and are compatible with *iOS* 26 and 27.
4849

49-
- iPhone 16 models are compatible but **not recommended for use with Omnipod DASH**
50+
- iPhone 16, all variants
51+
- iPhone 16 models work with v3.14.8 or newer
52+
- Older versions of the Loop app did not work well with some DASH pods with iPhone 16
5053
* See [Keep Alive: Atlas or InPlay DASH pod](../faqs/omnipod-faqs.md#keep-alive-atlas-or-inplay-dash-pods){: target="_blank" } warning
5154

52-
These phones are compatible with *iOS* 17, 18 and 26. The next version of the *Loop* app will require *iOS* 18 as a minimum.
55+
These phones are compatible with *iOS* 17, 18, 26 and 27. The next version of the *Loop* app will require *iOS* 18 as a minimum.
5356

5457
- iPhone 15, all variants
5558
- iPhone 14, all variants
@@ -62,13 +65,7 @@ These phones are compatible with *iOS* 17, 18 and 26. The next version of the *L
6265

6366
### Not Supported
6467

65-
**The [Older Devices](#older-devices) listed below are no longer supported by some CGM vendors and should be considered incompatible**
66-
67-
* **Please update your phone hardware and iOS as soon as possible**
68-
69-
### Older Devices
70-
71-
These phones are limited to *iOS* 16. No longer supported by *Dexcom*. Update ASAP. The next version of the *Loop* app will require *iOS* 18 as a minimum.
68+
**The phone listed below are no longer supported.**
7269

7370
- iPhone X, without an extra letter
7471
- iPhone 8, all variants

docs/build/pump.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,7 @@ These types of pumps are compatible with the *Loop* app.
2828

2929
* [Omnipod Classic (or Eros) Pods](pump.md#omnipod-pumps)
3030
* [Omnipod DASH Pods](#omnipod-dash)
31+
* With the v3.14.8 release of the Loop app, the issues with iPhone 16/17e are improved
3132
* See caveat about [iPhone 16 and 17e](phone.md#compatible-device){: target="_blank" }
3233
* [Omnipod 5 Pods](#omnipod-5)
3334
* [Medtrum Touchcare Nano](#medtrum-nano) (v3.14.2 or newer)

docs/faqs/omnipod-faqs.md

Lines changed: 27 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
## Why are there so many Omnipod Pump Manager versions?
1+
## Why were there so many Omnipod Pump Manager versions?
22

3-
The code used to control Pods was modified in the summer of 2026.
3+
The code used to control Pods was modified several times during the summer of 2026.
44

55
You can skip ahead to the [Table of OmnipodKit Versions](#table-of-omnipodkit-versions), or keep reading for more details.
66

@@ -51,34 +51,38 @@ OmnipodKit provides support for Classic, DASH and Omnipod 5 Pods
5151

5252
For details about the different Bluetooth connection methods nicknamed *keep-connected*, *ble-heartbeat* and *eager-connect*, please read [OS-AID Omnipod History](#os-aid-omnipod-history).
5353

54-
The table below references which *Loop* version is associated with which Bluetooth connection method in OmnpodKit. The released *Loop* version, 3.14.7, is recommended for the general user. Please update as soon as possible if your version is 3.14.2 or older. The development branches are suitable only for expert testers.
54+
The table below references which *Loop* version is associated with which Bluetooth connection method in OmnpodKit. The released *Loop* version, 3.14.8, is recommended for the general user. Please update as soon as possible if your version is 3.14.2 or older. The development branches are suitable only for expert testers.
5555

5656
| Loop Version | Branch | OmnipodKit BLE Method<br>- known issues | Supports |
5757
|:--|:--|:--|:--|
58-
| Loop 3.14.7 | `main`<br>- current release | *ble-heartbeat*<br>- iPhone 16/17e + Atlas DASH needs Pod Keep Alive | Classic, DASH, Omnipod 5 |
59-
| Loop 3.14.7 | `dev` | same as `main` but subject to change<br>- will use for *eager-connect* testing soon | Classic, DASH, Omnipod 5 |
60-
| Loop 3.14.8 | `update_dev_to_3.14.8` | *eager-connect*<br>- iPhone 16/17e connect delay improved | Classic, DASH, Omnipod 5 |
58+
| Loop 3.14.8 | `main`<br>- current release | *eager-connect*<br>- iPhone 16/17e connect delay improved | Classic, DASH, Omnipod 5 |
6159
| Loop 3.15.2 | `next-dev` | *eager-connect*<br>- iPhone 16/17e connect delay improved | Classic, DASH, Omnipod 5 |
62-
| Loop 3.14.2 | - previous release | *keep-connected*<br>- increased 203 faults with Atlas DASH<br>- iPhone 16/17e + Atlas DASH needs Pod Keep Alive | Classic, DASH |
60+
| Loop 3.14.7 | - previous release| *ble-heartbeat*<br>- iPhone 16/17e + Atlas DASH needs Pod Keep Alive | Classic, DASH, Omnipod 5 |
61+
| Loop 3.14.2 | - older release | *keep-connected*<br>- increased 203 faults with Atlas DASH<br>- iPhone 16/17e + Atlas DASH needs Pod Keep Alive | Classic, DASH |
6362

6463
Versions before Loop 3.14.2 used the older repositories of OmniKit or OmniBLE, which are no longer included in the *Loop* app. The Bluetooth communications used the *keep-connected* method and was subject to increased 203 faults with Atlas DASH for all phone models. The combination of iPhone 16/17e with Atlas DASH required use of [Pod Keep Alive](../loop-3/omnipod.md#pod-keep-alive-feature){: target="_blank" }.
6564

6665
#### Map of OmnipodKit SHA
6766

6867
Users do not need this but developers may find this helpful in selecting which version of OmnipodKit to use for their release and development branches.
6968

70-
**OmnipodKit Branches / SHA as of 2026-09-17**
69+
**OmnipodKit Branches / SHA as of 2026-09-19**
7170

7271
* subject to modification - be sure to check [GitHub](https://github.com/loopandlearn/OmnipodKit/branches)
7372
* all these branch support Classic, DASH, and Omnipod 5 Pods
7473
* all these branches support a connect-on-demand Bluetooth method
7574

7675
**At this snapshot in time**, all the OmnipodKit branches, `main`, `dev` and `next-dev` support the *eager-connect* method. Both the `dev` and `next-dev` branches are subject to rapid change.
7776

77+
Recent changes to OmnipodKit `main` and `dev`, which have the same code with different SHA include
78+
79+
* Silence Pod message indicates if your current pod is a Black-Dot Omnipod 5 Pod that cannot be completely silenced
80+
* Reworked Pod Keep Alive - default behavior is to use When Open mode; the other selections should not be required with *eager-connect* and will be removed soon
81+
7882
| Branch | Date | SHA | BLE Method |
7983
|:--|:--|:--|:--|
80-
| main | 17 Sep 2026 | `05dd725` | *eager-connect* |
81-
| dev | 15 Sep 2026 | `305c84d` | *eager-connect* |
84+
| main | 19 Sep 2026 | `4e923d7` | *eager-connect* |
85+
| dev | 19 Sep 2026 | `79991df` | *eager-connect* |
8286
| next-dev | 13 Sep 2026 | `d9b5966` | *eager-connect* |
8387

8488
## Is Omnipod 5 available?
@@ -99,11 +103,10 @@ This is all handled for you automatically. You simply need to ensure you have in
99103

100104
That's a personal decision and may be affected by your ability to change prescriptions and get insurance coverage. The new connect-on-demand methods for Omnipod Bluetooth communications reduced the frequency of 203 faults for Atlas DASH pods.
101105

102-
There is still an issue, in the v3.14.7 released code, for iPhone 16/17e users with Atlas DASH pods.
103-
104-
* Note that this build resets the Pod Keep Alive setting, so you need to turn it back on again.
106+
There was still an issue, in a previous release, v3.14.7, for iPhone 16/17e users with Atlas DASH pods.
105107

106-
The next release, coming soon, will provide a new connection method, nicknamed *eager-connect* is under test, that will handle iPhone 16/17e in a better manner. Final testing of this is in process.
108+
* The v3.14.8 release provides much faster connection for iPhone 16/17e models with Atlas DASH pods
109+
* If you use that combination, update to v3.14.8 as soon as possible
107110

108111
### How can I switch to Omnipod 5?
109112

@@ -178,9 +181,9 @@ It took a while, but we modified the method of connecting to Pods with release v
178181

179182
### Status for released code
180183

181-
If you experience increased 203 faults with Atlas DASH pods, please rebuild to the released code, v3.14.7 or newer.
184+
If you experience increased 203 faults with Atlas DASH pods, please rebuild to the released code, v3.14.8 or newer.
182185

183-
This is found in the `main` branch and provides a connect-on-demand Bluetooth method to resolve this issue. Plus there are other [updates to the *Loop* app with this release](../version/releases.md#loop-v3147){: target="_blank" }.
186+
This is found in the `main` branch and provides a connect-on-demand Bluetooth method to resolve this issue. Plus there are other [updates to the *Loop* app with this release](../version/releases.md#loop-v3148){: target="_blank" }.
184187

185188
### Status for older code
186189

@@ -196,14 +199,11 @@ We have looked at the analytics reported from Loop users who [share their data](
196199

197200
### Keep Alive: Atlas or InPlay DASH Pods
198201

199-
!!! warning "iPhone 16 (all models) and 17e model with Omnipod DASH"
200-
**iPhone 16 all models** and **iPhone 17e model only** can be slow to reconnect to Atlas versions of DASH Pods. This can cause delays to automatic and manual insulin dosing.
202+
!!! success "Loop v3.14.8 and newer greatly improves Bluetooth connection speed for iPhone 16/17e with Atlas DASH"
201203

202-
**Other phones, including iPhone 17 models other than 17e, do not have the reconnection problems with InPlay DASH Pods** - but see [Increase in DASH Faults](#increase-in-dash-faults) when using the *keep-connected* Bluetooth method which affects all phone models and seems to be box specific.
204+
> * Note that the BLE Management modifications, known as *ble-heartbeat*, found in released code v3.14.7 did not fix the slow reconnection time for Atlas DASH Pods using iPhone 16 and 17e.
203205
204-
> * Note that the BLE Management modifications, known as *ble-heartbeat*, found in released code v3.14.7 or newer does not fix the slow reconnection time for Atlas DASH Pods using iPhone 16 and 17e.
205-
206-
> * Another version of connect on demand, nicknamed *eager-connect*, is under test in `next-dev` and will soon be in another development branch for those expert testers not ready to switch to `next-dev`. It senses if the connection is taking too long, quits the attempt and retries until the connection goes through. For iPhone 16/17e, this can still be a few seconds, but much faster than before.
206+
> * Update to v3.14.8 to get the method for connect on demand, nicknamed *eager-connect*. It senses if the connection is taking too long, quits the attempt and retries until the connection goes through. For iPhone 16/17e, this can still be a few seconds, but much faster than before.
207207
208208
#### Historical Information about 203 Fault increase with Atlas DASH pods
209209

@@ -220,6 +220,10 @@ Beginning in 2025, DASH Pods began using the newer version of chips and firmware
220220

221221
#### Characteristics of Atlas with iPhone 16 or 17e
222222

223+
!!! success "Loop v3.14.8 and newer greatly improves Bluetooth connection speed for iPhone 16/17e with Atlas DASH Pods"
224+
225+
For older code, v3.14.7 and earlier:
226+
223227
* The Atlas DASH Pods, which advertise a Bluetooth Device name of `InPlay BLE` and indicate `-Atlas` in small print on the paper pod cover are fully compatible with all iPhone models except iPhone 16 and iPhone 17e
224228
* Although `InPlay` Pods do work with the iPhone 16 and 17e you may notice some communication issues
225229
* It can take many attempts to get the pod to initially connect when pairing; just keep hitting retry
@@ -228,16 +232,12 @@ Beginning in 2025, DASH Pods began using the newer version of chips and firmware
228232
* With other models, the reconnect happens in about 1 sec
229233
* With iPhone 16 or 17e, this can take many seconds and sometimes a few minutes
230234
* When the pod is not connected, neither automatic nor manual commands can be sent to the pod to modify insulin delivery
231-
* No solution to this issue is known
232-
* There is a work-around to keep these Pods more connected by issuing a keep-alive message before the 3-minute BLE disconnect; but it uses extra battery for the phone.
233-
* Although it does increase the number of messages to the pod slightly, this is not thought to be a big issue. Pods with marginal batteries are as likely to fault without this feature as with the feature.
234-
* If you are forced to use an iPhone 16 or 17e with InPlay Pods, please read the [Pod Keep Alive Feature](../loop-3/omnipod.md#pod-keep-alive-feature){: target="_blank" } section.
235235

236236
> DASH Pods that advertise a Bluetooth Device name of `TWI Board` and indicate `-SAW` in small print on the paper pod cover are fully compatible with all phones including the iPhone 16 and 17e.
237237
238238
> The earliest `Atlas` DASH Pods noticed by the OS-AID community were manufactured in Feb 2025. Some TWI DASH Pods were manufactured in May 2025. Later in 2025, `Atlas` DASH Pods with July 2025 and later manufacture dates were seen.
239239
240-
**The *eager-connect* method, currently under test, may be a fix for the iPhone 16/17e connection issue.**
240+
**The *eager-connect* method, released in v3.14.8 resolves the slow connection for iPhone 16/17e with Atlas DASH Pods.**
241241

242242
- - -
243243

0 commit comments

Comments
 (0)