Skip to content

Add CGM

CGM Choices

A CGM can be added from the Heads-Up-Display (HUD) or from the Loop Settings screen ⚙️.

The HUD will look like the graphic below if no CGM or Pump is connected with Loop:

Loop HUD when CGM and Pump have not been added

Loop can be connected to the following CGMs:

Add CGM

To add a CGM, go to the Settings screen ⚙️, tap on Add CGM, and tap on your CGM.

graphic showing some of the CGMs available with Loop 3

If you later decide to use a different CGM type, you must first delete the CGM and then add CGM to choose the new one.

  • For Dexcom G5, G6 or ONE, you must delete the CGM when you change transmitters (about once every 90 days)

Set up Focus Mode

Don't forgot to check your iOS Focus Notifications when you add or change your CGM.

  • Dexcom CGM must have the app for G6 or G7 added separately
  • Libre CGM (dev branch only) must have Loop notifications turned on to get CGM alerts
  • Nightscout or other alerts: if you use another app to provide alerts, be sure to add them to Focus as well

Remote Upload from Loop

Loop provides an option to upload CGM values to a remote service like Nightscout or Tidepool. In many cases this can be a preferred solution.

With Loop 3, the data-store on the Loop phone keeps a full week of data. If there is an interruption in the upload, when it is restored, Loop will fill in up to 1-week of CGM data that was not previously uploaded.

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 setting is off by default so if you want to ensure you have CGM data in Tidepool, for example, enable this option.

  • Tap on the CGM pill in the top left corner of Loop
  • Scroll down and tap the Upload Readings toggle under CONFIGURATION

Toggle for Upload Readings in CGM Settings

Dexcom G5, G6, ONE

To use the Dexcom G5, G6 or ONE:

  • Select Dexcom model, use Dexcom G6 for either G6 or ONE
  • Dexcom app must be running on the Loop iPhone and paired to an active transmitter
  • User must enter that active transmitter ID in the location indicated by the red rectangle in the graphic below
  • Do not enter your Share Credentials
    • The graphic below shows Tap to set
    • Do not tap, leave it alone
  • Only add the transmitter ID to Loop after it is paired with the Dexcom app on your phone

interface to add transmitter ID for Dexcom

Where to get the Transmitter ID for Dexcom G6?

You can find the transmitter ID in your Dexcom G6 app or on the back of the transmitter box (please refer to the below screenshots).

  • In your Dexcom G6 app
  • Tap "⚙️ Settings"
  • The transmitter ID is located under section "CGM" where it says "Transmitter" with a the 6-digit string.
  • Alternatively, while in Settings, tap on the > in the "Transmitter" row: your transmitter ID is the 6-digit identifier next to "SN" (short for serial number).

dexcom app settings to retrieve transmitter id

  • On the back of your transmitter box
  • Your transmitter ID is the 6-digit number next to "SN" and the QR code on the back of the carton.

picture of transmitter box with arrow and marking of transmitter id (sn)

It is suggested that you enable Remote Upload from Loop.

Change Dexcom Sensor

When you change a Dexcom G5, G6 or ONE sensor, you do this in the Dexcom app. When the sensor completes warmup and CGM values are once again reported in the Dexcom app, Loop picks these values up because you are using the same Dexcom Transmitter.

Change Dexcom Transmitter

When you change the Dexcom G5, G6 or ONE Transmitter, you need to delete your CGM selection from Loop and then add it back after you complete the pairing with the transmitter in your Dexcom app.

FYI: When You Change Dexcom Transmitters (click to open)

Before you change Dexcom transmitters, select the Delete CGM button at the very bottom of the CGM info page in Loop. If you leave the transmitter connected in Loop, you may have trouble pairing your new transmitter. If pairing does work, then Loop will not get CGM data from the Dexcom app on your phone.

Follow the instructions here: What do I do when I switch Dexcom transmitters?.

The Dexcom G7 is handled differently - Loop automatically detects when a new sensor/transmitter pair is added to the Dexcom G7 app.

Your selection to enable Remote Upload from Loop must be repeated with each new Transmitter. The default setting is disabled.

About Dexcom Share credentials

You do NOT need your Share account info listed in Loop settings if you are using a G5 or G6 system. The transmitter ID is sufficient. In fact, you should leave your Share credentials blank so that you don't accidentally become internet-dependent for CGM data if you forget to update your transmitter ID when you start a new transmitter.

Dexcom G7 or ONE+

This is only available on Loop 3.

You must have the G7 app on the same phone as Loop. When the G7 app switches to the next sensor/transmitter assembly, Loop automatically switches too.

It is suggested that you enable Remote Upload from Loop.

graphic showing Loop searching for G7

Don't forget Health Permissions

For those switching from Dexcom G6 to Dexcom G7, you might forget to add permission for the G7 app to write to Apple Health. If you want long-term history of those CGM readings to persist in Apple Health, turn on the permission for the Dexcom app to write glucose to Health.

If either the G6 or the G7 has permission to write to Apple Health, then Loop will delete the Loop glucose data in Apple Health that are older than 3 hours and newer than 1 week. The Dexcom app will write its glucose values to Health when each value is 3 hours old.

Libre

The Libre plugin for Loop, LibreTransmitter, connects directly via Near Field Communication (NFC) during pairing (for some sensors) and via Bluetooth (direct to sensor or direct to a transmitter attached to the sensor) for regular readings. No other app is needed.

  • Libre 1 are supported but must use a third-party transmitter (miaomiao and bubble transmitters are supported)
  • European Libre 2 can be used directly or via transmitter
  • American Libre 2 is not supported
  • Libre 3 is not supported

Connecting to Libre

First reading for a new sensor will often take 2-4 minutes. This is due to some technicalities on how the Libre sensor announces its presence via bluetooth.

There are solutions for some Libre 3 but they cannot reside on an iPhone. The Android solution can be uploaded to Nightscout, with Loop using Nightscout as a Remote CGM; but this requires internet access to continue closed-loop performance.

Part of the problem with Libre sensors is that there are differences in region, type and "security generations" which makes it hard to account for all variants. For example, the Libre 2 US has a different "security generation" than European Libre 2 sensors (different encryption in the data transmitted over bluetooth).

Libre 3 sensors have started appearing as well, but are unsupported. Other Libre sensors that are unsupported: Libre Pro, Libre H, Libre Sense Glucose Sport Biosensors.

Medtronic Enlite CGM

The Medtronic Enlite CGM is only available if you have connected it to your compatible Medtronic Pump.

  • Make sure your pump reports the Enlite CGM results
  • Go through the Add Pump to Loop steps with that Medtronic pump
  • Then do the Add CGM steps and the sensor should be presented as an option

Dexcom Share as a CGM

If you need to use Dexcom Share

If the dexcom is on another phone, you can use Share if internet / cell coverage is good.

Dexcom Share is not available for Dexcom ONE CGM.

The Dexcom Share credentials (in other words, account login) is the same as what you used to log in to the active Dexcom app on your iPhone. Dexcom Share account is not always the same login info as your Dexcom Clarity account. The information is entered when you first log in to the app and then is never displayed again, nor visible under any information screens. If you have forgotten your G5/G6 account info, you can delete the Dexcom app and redownload it to try logging in again. This will not cause a restart of any sensor sessions in progress.

If you do not enter your Share credentials correctly into Loop, you will get an error when Loop tries to access your Share account to backfill CGM data. An example of the error message is shown in the graphic below. If you see that message, delete your Share account from Loop settings and try again.

img/shareclient.jpg

Nightscout Remote CGM

If the user is already uploading CGM data to their Nightscout URL, they can select that as a source for CGM data for Loop. The user must acknowledge they understand the risks of using a remote source that requires internet, as shown in the graphic below.

In addition to the risks of missing data, if the internet is not reliable, you must also make sure the CGM data sent to Nightscout is reliable.

DANGER - Make sure Nightscout CGM Data is Reliable

Just because you can use Nightscout as a CGM source does not mean you should.

If you decide to use Nightscout as a CGM source, make sure the data stored in Nightscout is reliable. If the app you choose uploads bad results to Nightscout, you don't want Loop to use that bad data.

Sensors that can be added to Nightscout via other apps include Dexcom, some Libre, and some Medtronic sensors. Please refer to Nightscout Docs: Configure your Uploader.

There are third-party apps that bring some models of Libre data to your Loop phone. Customization instructions are provided at the Loop and Learn website: New CGM and Pump that explain how to modify Loop to add a CGM or Pump that is not part of the released Loop code.

It is suggested that you use Open Loop during warmup until the new sensor begins to provide reasonable data. This is especially important with European Libre 2 using a direct Bluetooth connection.

The xDrip4iOS app (which can also be found in the app store under the name Shuggah) may have a problem during the warmup of a new sensor (European Libre 2 using a direct Bluetooth connection). There were two instances of crazy high values being reported and picked up by Loop 3. One Shuggah user and one xDrip4iOS user who connected via Nighscout as a CGM with Loop 3 had a serious overdose of insulin because of bad readings with a new sensor. The developers of xDrip4iOS fixed their application - so make sure you have the latest version. Those developers have no control over what is provided by Shuggah.

Nightscout Remote CGM acknowledgement screen

The user must enter both the URL and API_SECRET for their site to ensure the security of the data. The URL must start with https:// and cannot have any extra spaces in the line.

Nightscout Remote CGM entry screen

When using Nightscout Remote CGM, if the user needs to change credentials or switch to a different CGM, the user must go through the Loop->Settings ⚙️->CGM menu.

Change CGM

To change CGM Types, you first delete your existing CGM selection and then add a new CGM.

Change a Nightscout Remote CGM

For Nightscout Remote CGM, the Nightscout URL is opened when tapping on the CGM icon in the Heads-Up Display, while the credential sections with the Delete CGM row are shown when tapping on Loop Settings ⚙️, and selecting CGM.

After deleting a CGM, the Head-Up-Display at the top of the Loop main screen will show the Add CGM icon.

Change Other CGM

Other CGM, you can tap on the CGM from either the Heads-Up Display or tap on Settings ⚙️, and select your CGM.

Scroll to the bottom of the screen and select Delete CGM.

Dexcom G5, G6 and One (not G7)

For older Dexcom sensors, the transmitter is replaced separately about once every three months. In order to enter a new transmitter number, you must first delete the CGM and then add the CGM.

Detailed instructions are found at CGM FAQs: What do I do when I switch Dexcom transmitters?.

With the Dexcom G7, the user only needs to let the Dexcom G7 app know when to use the new sensor. The Loop app automatically switches to the new sensor with no additional steps required by the Looper.