Loop 3 Displays¶
This page has detailed information about Loop 3 Displays.
If you are running Loop v2.2.x, follow this link: Loop v2.2.x Displays.
Main Loop Screen¶
The main Loop screen contains a Heads-Up Display (HUD) at the top (when in portrait mode) with various charts in the middle and a toolbar at the bottom.
When the device is in landscape mode, the HUD is no longer visible, but the chart history is increased. In landscape, each chart displays the last 8 hours of history along with the next 6 hours of glucose prediction. The toolbar is always visible while the chart display can be scrolled up and down to view charts of interest.
The Heads-Up Display (HUD) shows 3 icons:
There is a
Status Row underneath those three icons that is used to display bolus progress, some alerts and important messages. The
Status Row is also a button that performs an action depending on the message. These are described in the table in the HUD Status Row section. The
Status Row is only visible in portrait mode, so make sure to orient your device to look for these messages.
There are several charts on the main screen to help you navigate and understand Loop. Tapping on a chart on your phone opens up additional information.
The Glucose Chart displays glucose values in your preferred units.
mg/dL or mmol/L
If your preferred glucose unit are not displayed, follow these instructions to Change Glucose Units.
The vertical scale is automatically adjusted by Loop to be as useful as possible while including the highest and lowest readings in the chart.
The horizontal axis is set to go forward from the current time until your DIA (insulin duration) forward (so you can see what Loop thinks glucose will be eventually). It then goes back in time as far as it can, based upon the width in pixels of your screen. Note, if you turn your device to landscape mode you will have more screen real estate and thus will be able to see further back in time.
The glucose Correction Range is shown as a blue bar on the glucose chart. Single-value ranges (such as 100-100 mg/dL), will have a narrower blue bar. When a temporary override range is enabled, a darker blue bar where the overrides are set will be displayed, as well as the normal correction range in lighter blue.
Negative Glucose Predition
If you have a crazy negative glucose prediction - it is likely that you set an Override with a tiny sensitivity.
- Do not panic - this is a prediction only; not reality.
- Open the loop until the prediction settles down.
- In future, do not choose a tiny sensitivity to force less insulin
- Increase the correction range in your override with a moderate change in sensitivity (50% to 90%)
- Loop will reduce your basal rate at the next cycle (within 5 minutes)
- Be cautious adding carbs during an override - make sure you understand the effects first
If you tap on the Glucose Chart itself, it will open the Predicted Glucose chart described below.
Predicted Glucose Chart¶
The predicted glucose view is a great way to gain insight into the various components’ importance in Loop’s prediction of eventual glucose.
The graph at the top of this view will match your Glucose Chart. Below this chart you will see an explanation of the variables Loop takes into account in predicting your future glucose value: Carbohydrates, Insulin, Glucose Momentum and Retrospective Correction. You can tap on any of the entries to see the effects of that component by looking at the dashed lines.
These elements are not turned on and off in the Loop predictions. They just modify the graph so you can view the relative effects.
Active Insulin Chart¶
The Active Insulin chart displays the total insulin contribution from both temp basals and boluses. Active IOB can be either positive or negative. Negative IOB results from the suspension of normally scheduled basals. The active insulin displayed in the upper right corner of the chart does NOT include insulin contributions from a recently enacted temp basal or bolus until the (for Medtronic) pump’s reservoir volume is read and confirms a drop in reservoir volume (confirming the insulin has actually been delivered). The opposite is true for Omnipods. If a message is sent from Loop, it assumes the pod got the message and enacted it - even if the acknowledgement is not received. Later, when communication is restored, if a command was not enacted by the pod, the Event History is updated.
Medtronic Only: So long as you have Event History as the Preferred Data Source in Loop settings, primed insulin deliveries (e.g., cannula fills or manual primes) will not be counted towards IOB.
Insulin Delivery Chart¶
The Insulin Delivery chart displays a history of the temp basals enacted by Loop. The display is relative to the scheduled basal rates entered in the Loop settings. So, a rate displayed in this chart as
+0 units would indicate no temp basal was set, and Loop defaulted to the scheduled basal rate. Individual boluses are indicated by an orange triangle on the chart (shown in the graphic above, near the left-most time). The total insulin delivered since midnight, including all basals and boluses AND (Medtronic Only) priming insulin, is given in the upper right corner of the graph.
Please note that for safety reasons, Loop will assume a bolus was successful, even if it is not sure that the pump responded as expected. Once the communications with the pump settle down, Loop will (almost always) be able to reconcile whether a dose went through as expected. Occasionally, the bolus may be temporarily rendered (drawn) as a very high temp basal rate vs. a (triangle) discrete bolus event. This does NOT mean that the Loop actually enacted a high temp basal rate...only that the bolus is being drawn on the chart in the equivalent of a high temp basal rate.
Event History, Reservoir and Non-Pump Insulin¶
Clicking on either the Active Insulin or Insulin Delivery charts will open your Insulin Delivery history. The top of the screen will display the current IOB and the total insulin delivered for the day since midnight (or since the time the loop became active if you started Loop after midnight). There are three tabs that can be viewed, with Event History shown by default:
Event History: Event history is a detailed accounting of all pump/pod actions. Both Medtronic and Omnipod users will have a detailed record of event history. If you tap on an event, you get more detail. Turn your phone to landscape to improve readability.
- Omnipod users should not worry if the reservoir display is blank. Pods do not report or track insulin remaining until their reservoirs get below 50 units remaining. When a pod is deactivated, the reservoir history for that pod is no longer displayed.
- Medtronic users will have reservoir history displayed in 5-minute increments, unless Loop has been having communication issues.
Non-Pump Insulin: The user can enter insulin taken by another method such as inhaled or by injection. The user can choose a different insulin model than used by the pump. This is explained further at this link.
Previous Pod Insulin History
For those who want to delete some recorded insulin near the end of a pod because the site was not absorbing properly, this can be done in Apple Health.
Before attempting that modification, please read this entire section on Loop and Apple HealthKit in detail.
Pay special attention to Insulin and Apple HealthKit
The Carbohydrate chart displays the carbs used by Loop to predict glucose changes. The active COB is displayed in the upper right corner of the chart. Clicking on the chart will open the Carb Entries history and you can edit/delete any previous entries through that screen. Please read the Meal Entry page for more information about entering and editing carb entries.
Click this link for even more details about Insulin Counteraction Effects. It's a good idea to read both the Meal Entry and ICE pages - this is an important concept.
The toolbar is always found at the bottom of the main Loop screen in both portrait and landscape orientation. By tapping on one of these icons, you can begin a Meal Entry, start a Pre-Meal Range, initiate a Manual Bolus, select an Override or go to the Loop Settings screen.
From left to right, the icons are:
Meal Entry- click on this icon to enter meals. Detailed info regarding how to enter, save, and edit meal entries can be found in the Meal Entry page.
- For those used to entering carbs on a Medtronic pump or coming from non-Loop DIY systems, Loop will not read carb entries from a Medtronic pump or Nightscout, so you must use the meal entry tool.
Pre-Meal Range - click on this icon to start the Pre-Meal Range for one hour or until carbs are entered. (plate symbol turns dark green when active)
Bolus - click on this icon to open the Bolus tool.
Overrides - click on this icon to select a saved or custom Override or to cancel an override if one is active (heat symbol turns dark blue when active)
Loop Settings - click on this icon to make changes to any of your Loop settings.
Very Detailed Section
This section is packed with an incredible amount of detail. Remember it exists and come back when you need a reference to Loop 3 icons and messages.
If you are a new looper your eyes may glaze over the first time through. Don't worry. But do come back and read this section again after you've used the system in Open Loop mode (before you enable Closed Loop mode). And then come back again after a day or so of closed loop testing.
Experienced loopers need to read the detail on this page. There are important changes from Loop 2.2.x.
The Heads-Up-Display, visible in portrait mode, shows the Glucose Status on the left, the Loop Status in the middle and the Pump Status on the right. Once a CGM and pump have been added to Loop, the Loop Status icon will update and ideally be similar to the graphic below.
- The Glucose is displayed in the same units as the selected CGM
- If units are incorrect, quit Loop, allow your CGM app to update and then restart Loop
- The green Loop icon indicates that within the last 5 minutes Loop completed a cycle
- The Pump Status indicates the scheduled basal rate is running
- The 0.0 U display means the basal currently running is 0 U/hr different from the scheduled basal
Loop Status Icon¶
The Loop Status Icon is the colored circle in the center of the main Loop display. The three colors displayed are Green, Yellow or Red. In all cases, more information is displayed by tapping on the Loop Status Icon, which brings up a modal message indicating the last time a loop cycle completed and other descriptive text.
A complete Loop cycle, at high level, includes these steps:
- Current Glucose is updated
- Glucose prediction is calculated along with any recommended change to insulin delivery to maintain future glucose above safety threshold and within correction range
- Messages are sent to the pump to modify insulin delivery if required and request current pump status
- Pump acknowledges the loop messages
This table shows examples of Loop Status Icons and what the icon means.
|A green circle indicates the app is in Closed Loop mode and it completed a cycle within the last 5 minutes.|
|A yellow circle indicates the app is in Closed Loop mode and it has completed a cycle in the last 5-15 minutes.
It is not unusual to have a few instances of yellow loops per day. They can be caused by being out of range (physically), Bluetooth or RileyLink “noise” interference, or even that the pump was giving a bolus.
Most yellow loops will self-resolve without needing any special troubleshooting.
|A red circle indicates the Loop has not completed in over 15 minutes.
This is not a typical state, and you should troubleshoot the problem.
In this case, either the Glucose Icon or the Pump Icon or both will display an
|When the circle is open at the top, Loop is operating in “open-loop” mode. The color code is the same as for closed loop except the cycle involves updating predictions from available blood glucose values and obtaining pump status; but the app will not make any automated changes in insulin delivery.
While Manual Temp Basal (MTB) is active, the Open Loop icon will be displayed until MTB expires or is cancelled. Note that MTB is only implemented in Loop 3 for Omnipod and Omnipod DASH, at the current time.
The loop status icon will pulse slightly when Loop is communicating with the pump. The pulsing will stop when the communication has completed (green loop) or given up (yellow or red loop).
Glucose Status Icon¶
The table below shows examples of the Glucose Status Icon and what the icon means. The Glucose Color Code is provided below the table.
|The current glucose reading is displayed. It can be from the CGM or from a finger stick. The value must have been updated within the last 15 minutes to be displayed.
For the example shown, a valid trend arrow is available and is blue. Color codes are explained at this link.
|The last glucose reading from the CGM or from a finger stick is stale, i.e., it was acquired more than 15 minutes ago. In this case, the glucose prediction will stop updating.
The HUD Status Row message enables user to enter fingerstick glucose value if desired.
If in closed-loop mode, no changes will be made to insulin delivery. If a temporary basal is running, it continues running for the scheduled duration. Once the temporary basal expires, the pump resumes the scheduled basal rate.
When the app issues a temporary basal, the duration is always 30 minutes.
The user can enter a manual temporary basal duration up to the limits of their pump.
|If no CGM is currently selected, the Add CGM icon is displayed. The user can add a CGM following these instructions.|
|If no CGM is currently selected, but a glucose value was acquired within the last 15 minutes (from fingerstick or a different CGM), that value is displayed along with a plus sign. By tapping on the icon, the user can add a CGM following these instructions.|
Glucose Color Code¶
|Glucose Range||Glucose Value Color||Trend Arrow Color|
|55 mg/dL (3.0 mmol/L) or below||red regardless of background color||red|
|56 to 79 mg/dL (3.1 and 4.4 mmol/L)||black (light mode) / white (dark mode)||yellow|
|80 to 199 mg/dL (4.4 to 11.0 mmol/L)||black (light mode) / white (dark mode)||blue|
|200 mg/dL (11.1 mmol/L) or above||black (light mode) / white (dark mode)||yellow|
Tapping on the CGM icon in the HUD shows more information about the last CGM reading.
For Dexcom G5/G6 and Share, the same screen is obtained by tapping on Loop Settings->CGM.
For Nightscout Remote CGM, the Nightscout URL is opened when tapping on the CGM icon in the HUD, while the credential sections is shown when tapping on Loop Settings->CGM.
The graphic below shows the result of tapping on the CGM icon when using a Dexcom G6. It includes the time of the last reading to the nearest second, along with other information about that sensor and transmitter. It also has an option to go to the Dexcom app on the same device.
Pump Status Icon¶
The nominal pump icon displays high-level status information for the pump with two main components: left side is the basal delivery status and right side is the reservoir status. For Pods, a lifecycle line is displayed underneath the pump icon during the last 24 hours of nominal pod life.
- The basal delivery status displays the enacted temp basal change relative to the scheduled basal. For example, for a scheduled basal of 0.45 U/hr
- If Loop sets a temp basal rate of 0.2 U/hr, the icon displays -0.25 U
- If Loop sets a temp basal rate of 1.5 U/hr, the icon displays +1.05 U
- When scheduled basal is running, the icon displays 0.0 U
- But what about Overrides?
- Using scheduled basal of 0.45 U/hr with override set to 70%, the "override basal rate" is 0.315 U/hr
- That is a value that cannot be set in the pump, but Loop uses it for IOB calculations
- If Loop sets a temp basal rate of 0.2 U/hr, the icon displays -0.115 U
- If Loop sets a temp basal rate of 1.5 U/hr, the icon displays +1.185 U
- The reservoir status indicates insulin remaining graphically and displays a value when less than 50 U remain.
- For Medtronic Pumps, the reservoir display indicates the level graphically.
- For Pods, the reservoir graphic is constant until the pod begins to report reservoir level when less than 50 U remain.
The table below shows examples for a few nominal Pump Status Icons and Alert messages that might be shown. In all cases, tapping on the Pump Status Icon opens the Pump Settings screen with more information.
|This nominal pump status graphic is for a Pod with temp basal less than scheduled basal rate and no reported reservoir level.|
|This nominal pump status graphic is for a Medtronic pump running scheduled basal rate and with a half-full reservoir.|
|This nominal pump status graphic is for a pump running a high temp basal rate with the reservoir level reported.
When the reservoir level is above the notification level, the reservoir graphic is orange.
|This pump status graphic indicates 2 alerts: (1) the 15 U reservoir level is less than the notification level of 20 U selected by this user and (2) a small clock icon is added to the display to indicate the phone time zone and pump time zone do not match.
When the reservoir level is below the notification level, the reservoir graphic is yellow.
Follow the link for time zone information.
|This alert message indicates the reservoir reports 0 U. Although pumps will continue to deliver some insulin after this point (max of 4 U for pods, or until all insulin is gone for both pods and Medtronic), the user should be aware that insulin delivery could stop at any moment.
Note that if you see a display of 0 U in yellow, that means there is 0.5 U or less reported by the pump.
|This alert message indicates no pod is currently paired so no insulin is being delivered.
Tap on the icon to reach the pod setting screen and pair a new pod, or switch to a different source for providing insulin.
|This alert message indicates all insulin delivery has been suspended.
A Status Row message appears to enable the user to resume delivery with one tap.
Alternatively, insulin can be resumed by tapping on the Pump Icon to enter the Pump Setting display and resume from that screen.
|This alert message indicates the user has initiated a manual temp basal (MTB). While the MTB is active, the Loop Icon Status will also display an Open Loop symbol to indicate no automatic adjustments are made until MTB expires or is canceled.
The lifecycle indicator across the bottom of the pod status indicates a pod within the final 24 hours of nominal life.
Tapping on the icon takes the user to the pump settings display where the rate and duration of the MTB are displayed.
|This alert message indicates it has been more than 15 minutes since the app was able to communicate with the pump.
Follow these troubleshooting steps.
|This alert message indicates no pump has been added.
Follow the instruction for adding a pump.
Loop allows your pump to have a different time zone from your phone.
- For Medtronic - the pump time shows on the pump display
- Always use Loop to set your pump time
- For Omnipod Common - there isn't a clock on pods, but Loop has a concept of "pump" time for that pod
Your daily schedule for basal rates, correction ranges, insulin sensitivity factors and carb ratios is displayed with respect to midnight on the "pump" time zone. When you first Add Pump to Loop, the pump and phone are in the same time zone, but it's important to understand what happens when the time zone changes on the phone.
The scheduled rates for basal, correction range, ISF and CR follow the pump time, even if you and your phone change time zones or daylight savings time occurs.
To change the pump time to match your phone, select the Pump Settings display and scroll down to Change Time Zone
- Make sure your gear is close together (phone, pump and RileyLink, if needed)
- Touch the time zone offset to change to the current time zone
- Medtronic: Loop sets the pump time to the current phone time
- Omnipod Common: Loop sends your scheduled basal rates to your pod based on phone time
- Graphic below is from Loop 2.2.x
You can choose to leave the pump and phone time zones different, the pump icon on the HUD will show the clock icon to remind you. Maybe people do this for short trips.
HUD Status Row¶
The Status Row is located immediately below the CGM, Loop and Pump Icons and is used to provide status, action buttons and information. The messages in the table are in order of priority. For example, a
No Recent Glucose message is displayed even when an
Override is active.
Bolus In Progress
The bolus messages are displayed with the highest priority:
- If another message is shown when a bolus starts, the bolus message is displayed instead
- To return to the other message, such as Override or
No Recent Glucose, you must either wait for the bolus to complete or cancel the bolus by tapping on the
- To ensure you do not accidentally cancel a bolus, keep the phone locked when not in use
|Status Row / Meaning|
|When the user issues a manual bolus through the app, a
As soon as the app issues a command to the pump (or sends it to the RileyLink to be delivered to the pump), the bolus in progress message appears.
|As soon as a bolus is started, from either a manual command or an automatic bolus, the bolus in progress message is displayed. Tapping on the
The message says
In case of a fault, the user can tap on the pump icon to force a new pump status reading. For the case of pods, this allows you to silence a screaming pod quickly. Once the app communicates with the pump, the actual delivery status will be updated.
|If the user taps on the bolus in progress message in the
|As soon the app determines that the pump is suspended, the
Medtronic pump users who suspend directly on the pump will notice a delay before this message is displayed. It is best to use the app Pump Settings screen to suspend the pump.
|If a higher priority message is not displayed in the
Note that if you choose not to accept a recommended bolus on this screen but you want to save the Fingerstick value, you need to tap the Bolus line to force it to 0 U and then tap
|If a higher priority message is not displayed in the
Tapping on the
|If a higher priority message is not displayed in the
New with Loop 3: The Pre-Meal Preset can be engaged with an Override. When both are active, the Pre-Meal Range supersedes the range of the active Override, but the other settings for that Override still apply. When both are active, the
Loop Widget on Lock Screen¶
Loop has a widget which can be added to the lock screen. The example graphic below shows the Dexcom G6 widget above the Loop 3 (old-style) widget.
New to Loop or never added a widget before:"
- There is a difference in behavior between "new-style" Widgets and "old-style" Widgets
- New-Style Widgets: always appear at the top of your Today View, can be changed by long-pressing on one and then dragging around, or added with the + button in edit mode
- Old-Style Widgets: like that for Loop use a different method to install
- Make sure your phone is unlocked, then swipe from the Home Screen to get to Today View
- You can't edit the screen if you start from a locked phone
- Start the Edit mode (where all of the icons are shaking), either by long-pressing on one of the new-style widgets, or by scrolling all the way to the bottom of Today View and pressing Edit.
- Scroll all the way to the bottom again to find and select the button labeled "Customize"
- Now you can configure (add, remove, rearrange) the "old-style" widgets for your screen.
- The Loop widget should appear in the list available there.
Experienced Looper who already had a widget should not need to modify anything to see it.
Still stuck trying to set up a widget, please do an internet search, such as "Add old-style widget to your iOS 15 Home Screen" for instructions.