Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion docs/build/cgm.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,6 @@
* *Dexcom* ONE (based off G6 sensor) is available in some countries, but will be discontinued soon
- *Dexcom* G7 or ONE+ CGM systems
* *Dexcom* ONE+ (based off G7 sensor) is available in some countries
- *Medtronic* sensors connected to a Loop-compatible *Medtronic* pumps
- Some *Libre* sensors
- Eversense E3 and 365 sensors

Expand All @@ -38,6 +37,12 @@ The *Dexcom* ONE, available in some countries, acts just like the G6 as far as t

If the *Dexcom* app is on the same device as the *Loop* app, your system can function without an internet connection. See Offline Use below.

!!! tip "Anubis Support"
*Anubis* support is available in the dev branch (v3.14.5) and will be in the next release.

* *Abubis* is a retrofitted Dexcom G6 transmitter that has different characteristics for warmup time and sensor life
* The support allows you to enter your expected sensor life and provides access to transmitter battery levels

!!! warning "*Dexcom* G5 Support"

[*Dexcom* has stopped supporting the G5 system in the US](https://www.dexcom.com/obsolescence). In the US, and some other countries, the G5 is not available for download from the Apple Store. There are countries in which *Dexcom* does supply and support G5. The G5 capability will continue to be supported in Loop.
Expand Down
4 changes: 1 addition & 3 deletions docs/build/pump.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ The DASH system has the newer, slimmer locked-android Personal Diabetes Manager
![img/dash.png](img/dash.png){width="750"}
{align="center"}

[See warning about iPhone 16 with DASH](phone.md#compatible-device){: target="_blank" }.
[See warning about iPhone 16/17e with DASH](phone.md#compatible-device){: target="_blank" }.

### Omnipod 5

Expand All @@ -79,8 +79,6 @@ Loop does not support Omnipod 5 Pods in the released code.
* You must build a development branch to test Omnipod 5 - we encourage most people to wait while experienced users test this implementation
* Be sure to read the [Omnipod 5 FAQs](../faqs/omnipod-faqs.md#is-omnipod-5-available-for-open-beta-testing){: target="_blank" }
* See [Updates in dev](../version/development.md#updates-in-dev){: target="_blank" } if you are an experienced user who wants to help with testing and are willing to build frequently and report any issues to the development team
* Omnipod 5 code is experimental and does not provide a heartbeat
* This means you rely on your CGM to wake up the app when it is in the background or the phone is locked

- - -

Expand Down
2 changes: 2 additions & 0 deletions docs/faqs/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,8 @@ When Google Translate is selected:

**<span translate="no">Hamburger Menu</span>**&nbsp; (Hamburger Menu): three parallel lines that, when tapped, open a new menu

**<span translate="no">hotfix</span>**&nbsp; (hotfix): An urgent fix that is applied to both the released and development branches at the same time

**<span translate="no">HUD</span>**&nbsp; (HUD): Heads-Up Display at top of Loop main screen, phone in portrait mode

**<span translate="no">ICE</span>**&nbsp; (ICE): Insulin Counteraction Effect - Refers to the difference between observed change in blood glucose and the change in blood glucose that Loop models based on the effects of insulin.
Expand Down
79 changes: 44 additions & 35 deletions docs/faqs/omnipod-faqs.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ OmnipodKit replaces the need for OmniKit and OmniBLE submodules and provides sup
* If you read the PR, you may see language about the system getting "wedged" where the iOS and Pod states were not communicating and suffered from a very-long timeout before trying again
* The *eager-connect* method, senses if the connection is taking too long and restarts the process
* With iPhone 16/17e, the connection is much faster: a few seconds instead of seconds to minutes
* For all other phones, the *eager-connection* is ready to communicate with the pod in a few seconds, so the user can still notice a slight delay compared to the *keep-connected* method, but faster than with *ble-heartbeat* method
* For all other phones, the *eager-connection* is ready to communicate with the pod in a few seconds, so the user can still notice a slight connection delay compared to the *keep-connected* method, but faster than with *ble-heartbeat* method


### Table of OmnipodKit Versions
Expand All @@ -55,9 +55,26 @@ For details about the different Bluetooth connection methods nicknamed *keep-con
|:--|:--|:--|:--|:--|
| before Loop 3.14.2 | released | OmniKit<br>OmniBLE | *keep-connected*| Classic, DASH |
| Loop 3.14.2 | released | OmnipodKit | *keep-connected* | Classic, DASH |
| Loop 3.14.4 | dev | OmnipodKit | *ble-heartbeat* | Classic, DASH, Omnipod 5 |
| Loop 3.14.5 | dev | OmnipodKit | *ble-heartbeat* | Classic, DASH, Omnipod 5 |
| Loop 3.15.2 | next-dev | OmnipodKit | *eager-connect* | Classic, DASH, Omnipod 5 |

#### Map of OmnipodKit SHA

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.

**OmnipodKit Branches / SHA as of 2026-09-06**

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

**At this snapshot in time**, the OmnipodKit `main` and `dev` branches have the same code with two different SHA. There are open PR to modify `dev` so that additional *eager-connect* testing can start.

| Branch | Date | SHA | BLE Method |
|:--|:--|:--|:--|
| main | 5 Sep 2026 | `1d1f21b` | *ble-heartbeat* |
| dev | 6 Sep 2026 | `8df0b2b` |*ble-heartbeat* |
| next-dev | 31 Aug 2026 | `6106c1c` | *eager-connect* |

## Is Omnipod 5 available for open-beta testing?

Expand All @@ -77,12 +94,7 @@ This is all handled for you automatically. You simply need to ensure you have in

### Should I switch to Omnipod 5 now?

1. Don't be in a rush
1. This is new code that has been tested by a dozen developers in closed-beta testing
1. Consider waiting a few weeks and letting experienced people do the testing
1. There are a few known issues but we expect more will be revealed when we get a bigger group of testers
* The current implementation for Omnipod 5 requires you to [use a CGM with a heartbeat](#what-are-the-known-issues)
* If you are using something like Nightscout as a CGM, your app goes to sleep and does not wake up if it is not in the foreground with the phone unlocked
Don't be in a rush, the open beta testing is almost completed and Omnipod 5 will be in released code soon

### How can I switch to Omnipod 5?

Expand Down Expand Up @@ -130,32 +142,27 @@ You are not required to upload a Loop Report following each successful Pod chang

These are known issues for the `dev` branch of Loop.

* The `dev` branch uses a connect-on-demand method for connecting to both DASH and Omnipod 5 Pods so you may notice a slight delay in connecting, getting status and then responding to a command from Loop
* This is normal, be patient
* [Will I still get 203 errors?](#will-i-still-get-203-errors) - there have always been some reports of 203 faults with DASH that ramped up significantly with the Atlas version of DASH. Early testing indicates reduced frequency of 203 faults for Atlas DASH Pods with the newer Bluetooth protocols.
* If you are using an iPhone 16/17e, the connection delay is variable and can be quite severe (up to minutes to connect)
* Use the [Pod Keep Alive Feature](../loop-3/omnipod.md#pod-keep-alive-feature){: target="_blank" } - unless you have a RileyLink device, select the Silent Tune option for Atlas DASH pods with an iPhone 16/17e

#### Updates in `next-dev` branch only

A new BLE management protocol is under test in the `next-dev` branch. This branch fixes the following issues:

* [No Pump Heartbeat](#no-pump-heartbeat) - the `next-dev` branch provides a heartbeat
* [More frequent pod not connected messages](#more-frequent-pod-not-connected-messages) - limited testing, but this is no longer observed
* [Will I still get 203 errors?](#will-i-still-get-203-errors) - we do not know but because the new method communicates much less frequently with Pods (DASH and Omnipod 5), it is possible this will reduce the frequency of 203 faults
* [Will I still get 203 errors?](#will-i-still-get-203-errors) - there have always been some reports of 203 faults with DASH that ramped up significantly with the Atlas version of DASH. Early testing indicates reduced frequency of 203 faults for Atlas DASH Pods with the newer Bluetooth protocols.
* If you are using an iPhone 16/17e, the connection delay has been dramatically redused using the new *eager-connect* connect-on-demand method
* Early testing indicates the Pod Keep Alive option might not be needed, but it is available if you have difficulty with the iPhone 16/17e plus Atlas DASH combination

#### No Pump Heartbeat

* The current implementation for Omnipod 5 requires you to [use a CGM with a heartbeat](#what-are-the-known-issues)
* If you are using something like Nightscout as a CGM, your app goes to sleep and does not wake up if it is not in the foreground with the phone unlocked

> see [Updates in `next-dev` branch only](#updates-in-next-dev-branch-only)

#### More frequent pod not connected messages

The private-beta testers noticed more frequent notifications that the pod is not connected. But the app continues to work. There are more periods when the spacing between automatic adjustments is 10 minutes instead of 5 minutes, but the majority of the time, every CGM reading triggers an automatic calculation.

> see [Updates in `next-dev` branch only](#updates-in-next-dev-branch-only)
* An early implementation (dev v3.14.3) did not provide an Omnipod 5 heartbeat; please rebuild if your CGM does not provide a hearbeat

### Will I still get 203 errors?

The increased frequency of faults noticed with DASH Atlas Pods has not been observed in the Ominpod 5 Pods tested to date. Considering just the Pods that are not expired, there is a 3% failure rate with the failure being an occlusion (105) fault. There were testers in the private beta group using DASH instead of Omnipod 5. They had a 20% failure rate on a small sample of DASH Pods, all 203 faults near the 72 hours time frame.

> see [Updates in `next-dev` branch only](#updates-in-next-dev-branch-only)
Both the `dev` and `next-dev` branches use a new connect-on-demand method that appears to reduce the frequency of 203 faults for Atlas DASH pod. In addition, no 203 faults have been observed to date by any of the Omnipod 5 testers.

## Which Pods work with the *Loop* app?

Expand Down Expand Up @@ -185,33 +192,36 @@ You do not need the Omnipod Personal Diabetes Manager (PDM), just the pod suppli
DASH and Omnipod 5 pumps communicate with the phone via Bluetooth so they do not require a RileyLink compatible device.
You may find the Omnipod 5 a little slower when pairing than the DASH because of the extra layer of security added to these Pods.

!!! tip "To date, no iPhone model specific issues have been found with Omnipod 5 Pods"
* Omnipod 5 code is experimental and does not provide a heartbeat
* This means you rely on your CGM to wake up the app when it is in the background or the phone is locked

**To date, no iPhone model specific issues have been found with Omnipod 5 Pods variants tested.**

### Increase in DASH Faults

There have been a number of lots of Atlas DASH Pods that exhibit an increase in the frequency of certain DASH Faults when used with iOS Open-Source Automated Insulin Delivery Systems (OS-AID). This is different from the Bluetooth connection issues for some iPhone models: see [Keep Alive: Atlas or InPlay DASH Pods](#keep-alive-atlas-or-inplay-dash-pods).

To the best of our knowledge this is not something that we (as OS-AID developers and users) can control. People who have boxes that fail early find most Pods in that box fail early.
It took a while, but we are testing (in `dev` and `next-dev` branches) a different method of connecting to Pods that appears to reduce the frequency of 203 Faults. There are faults that can happen with any pods, including 203, but the Atlas DASH pods exhibited almost 20 times the rate of 203 faults as earlier pods and that particular problem is improved.

#### Status for released code

This section remains valid for folks using released code, v3.14.2 or earlier, which used the *keep-connected* method for Bluetooth between the phone and pod. The new methods under test, which connect on demand, provide reduced frequency for 203 faults.

People who have boxes that fail early find most Pods in that box fail early.

* The 203 fault is the most common one to exhibit an increase in frequency; occuring on the third day of Pod life
* The 016 fault also exhibits an increased frequency and this one happens early in Pod life
* You may be able to get Insulet to replace these, but there is no guarantee

We have looked at the analytics reported from Loop users who [share their data](../loop-3/onboarding.md#usage-data-sharing){: target="_blank" }. The increase in fault rate appears to go along with the increased used of Atlas Pods. Reports from users that their Pods failed early started in November/December of 2025 and continues to increase through at least May 2026. Note that 203 and 016 faults have been around for a long time. The increased fault rate (almost 20 times more likely for 203 and 4 times more likely for 016) is associated with the Atlas DASH Pods which use a different internal card with different firmware.

> see [Updates in `next-dev` branch only](#updates-in-next-dev-branch-only)

### Keep Alive: Atlas or InPlay DASH Pods

!!! warning "iPhone 16 (all models) and 17e model with Omnipod DASH"
**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.

**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) which affects all phone models and seems to be box specific.
**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.

> Note that the BLE Management updates found in the `next-dev` branch, see [Updates in `next-dev` branch only](#updates-in-next-dev-branch-only), cannot fix the slow reconnection time for Atlas DASH Pods using iPhone 16 and 17e. The `next-dev` code still offers Pod Keep Alive, which works by always keeping the Pod connected via Bluetooth.
> * Note that the BLE Management modifications found in the `dev` branch, known as *ble-heartbeat*. cannot fix the slow reconnection time for Atlas DASH Pods using iPhone 16 and 17e.

> * The `next-dev` code offers yet another version of 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.

Beginning in 2025, DASH Pods began using the newer version of chips and firmware. The only way to tell the difference before use is to examine the paper cover over the Pods inside the box for the word `Atlas` (newer) or `SAW` (older) as shown in the graphic below. These `Atlas` Pods, which report electronically as `InPlay BLE`, are the new version.

Expand Down Expand Up @@ -243,8 +253,7 @@ Beginning in 2025, DASH Pods began using the newer version of chips and firmware

> 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.

We have no insight into the deployment plans from Insulet. Just pay attention if you have an iPhone 16 or iPhone 17e. Otherwise, you won't notice a difference.

**The *eager-connect* method, currently under test, may be a fix for the iPhone 16/17e connection issue.**

- - -

Expand Down
22 changes: 18 additions & 4 deletions docs/loop-3/add-cgm.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,9 +48,14 @@ With Loop 3, the data-store on the Loop phone keeps a full week of data. If ther

Some people use Dexcom Share to feed their remote services. There have been outages with Share. When those occur, the data is not back-filled like it is with Loop.

This is the reason why there's a comment under each CGM below to select Upload Readings.
This is the reason why there's an option under each CGM, as shown in the G7 example below, to enable Upload Readings if desired.

This setting is **off by default** so if you want to ensure you have CGM data in Tidepool, for example, enable this option.
* This setting was set **off by default** for earlier versions of Loop.
* With Loop v3.14.2 and newer, it is **on by default**.
* The default setting is what is selected when you install the app on your phone for the first time.
* If you modified this setting to be **on**, it should remain **on** through a rebuild.

It's a good idea to check this setting to ensure you have CGM data in Tidepool and Nightscout.

* Tap on the CGM pill in the top left corner of Loop
* Scroll down and tap the **Upload Readings** toggle under **CONFIGURATION**
Expand Down Expand Up @@ -148,6 +153,15 @@ Part of the problem with Libre sensors is that there are differences in region,
Libre sensors that are unsupported: Libre Pro, Libre H, and Libre Sense Glucose Sport Biosensors.

### Eversense E3/365

!!! warning "Eversense Transmitter Connects to a Single App"
You can move back and forth between your OS-AID app with Eversense or the Eversense native app but you can only use one at a time.

When transitioning:

* Disconnect the Transmitter from the app you are leaving
* Go into phone settings: Bluetooth, find the Transmitter ID and select "Forget this device"
* Go to the app you want to use with Eversense, log in if needed and select the Transmitter

With Eversense added to *Loop* you get direct connection to your transmitter for glucose readings and can configure alert notifications. Because the transmitter can only connect to one app at a time, you must first disconnect from the Eversense app before you can connect to the *Loop* app.

Expand Down Expand Up @@ -178,10 +192,10 @@ Step 3: Once connected to the Eversense Transmitter, tap on the row that says DM

#### Troubleshooting

If you are having trouble with connecting to the Eversense, try these steps.
If you are having trouble with connecting to the Eversense, try these steps, one at a time.

* Make sure the official Eversense app is not connected to the Transmitter
* In your phone settings, find the Transmitter name and forget that device
* In your phone settings under Bluetooth, find the Transmitter name and forget that device
* Reboot your phone

#### Important Information
Expand Down
6 changes: 4 additions & 2 deletions docs/loop-3/eversense.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,11 +45,13 @@ If you want to upload your readings to the Eversense servers tap on the DMS Sett
* Enable Upload
* Enter your Eversense Credentials

If you want to share your readings using Eversense NOW, you can invite them from this same screen.
The default delay is 1 hour but can be selected with a delay of "None" as an option.

![eversense calibration status](img/eversense-dms.png){width="300"}
![eversense dms status](img/eversense-dms.png){width="300"}
{align="center"}

If you want to share your readings using Eversense NOW, scroll down on this same screen and tap the *Invite follower* row.

- - -

## *Loop* Main Screen
Expand Down
Binary file added docs/loop-3/img/eversense-dms.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading