Nightscout with xDrip and Dexcom Share (Wireless)

27 Sep
Guides > Setup Guides > Nightscout with xDrip and Dexcom Share (Wireless)

Requirements

To use xDrip (or xDrip+) with Dexcom Share, you need an Android phone that has Bluetooth LE (BLE) and a Dexcom Share receiver. If your device has the option to update to Lollipop (version of Android), it is recommended that you do so. Lollipop is better at maintaining connection with the Share receiver and can reconnect on its own when necessary. (KitKat can be used with xDrip and Dexcom Share, but you may experience problems staying connected.)

Note: xDrip or xDrip+ can also be used with G5. Configuring the app may differ from the directions and screenshots below, but setting up Nightscout for use with xDrip or xDrip+ remains the same. For assistance pairing a G5 with xdrip or xdrip+, please join the xDrip G5 group at Facebook.

Install and Configure xDrip

  1. Download and install the current beta of xDrip or xDrip+ on the uploader phone.
  2. Note: If your uploader phone is using Marshmallow (Android 6), you must do this step for xDrip to pair with your sensor: “A note regarding Marshmallow (Android 6) in Cyanogen-Mod and Google Nexus flavour: These versions of Android have the “privacy guard” that by default has location services disabled for the app and will only ask you if you want to allow them if xDrip would actually access GPS services (which it doesn’t). You have to enable the permission for location services manually in the system settings (Settings > apps > xdrip > Permissions).”
  3. On the Dexcom receiver, go to Settings/Share and turn the Share feature on.
  4. Open the xDrip app, click the three bars in the top left corner to open the menu.
  5. Select Settings.
  6. Set the Hardware Data Source to DexcomShare. (See #1 in the image below.) (Note: earlier versions of xDrip refer to this as the Collection Method.)
    xdrip-setupshare
  7. Enter your 10-character Dexcom receiver serial number or use the option to scan the Share barcode. (See #2 in the image above.) (Note: your serial number is on the back of the Dexcom receiver and should start with 2 letters.)
  8. Return to the menu and select Scan for BT.
  9. On the screen that loads, tap Scan in the top right hand corner.
    xdrip-scan
  10. When it appears, select DEXCOMRX.
    xdrip-scanselect
  11. The first time you connect with Share, you may be returned to the main xDrip screen and told to start your sensor. This means to start your sensor in the xDrip app. Go into the menu again and choose Start Sensor. Then enter the approximate time and date the Dexcom sensor was started.
  12. Note: When your xDrip is successfully paired with the Dexcom receiver, the Dexcom receiver will show a solid (not flashing) Bluetooth icon in the top left corner. In xDrip, when clicking System Status, the status will also indicate the device is connected (as shown below).
    xdrip-systemstatus
  13. Return to the settings screen and check the option to run in foreground.
    xdrip-foreground
  14. If you want to use raw data, check the box to interpret raw values.
    xdrip-raw

Connect to Nightscout

If you already have a Nightscout site, you can configure xDrip to upload to your Nightscout site by configuring the Data Sync settings. You can configure your Data Sync settings manually or use the Auto Configure tool and scan the information into xDrip. To use the Auto Configure tool, select the Auto Configure option. Follow these directions to use the tool (in a browser) to generate a QR code of your configuration settings.

xdrip-autoconfigure

If you want to enter your BASE URL manually, select API Upload (REST) as the upload method under Data Sync and enter your BASE URL. (As long as you are using a beta version, REST API in xDrip uses the “new” syntax when setting up the base url. Sample: https://YOURSECRET123@yoursitename.azurewebsites.net/api/v1)
xdrip-restapi

Note: If you are using xDrip beta 4 (or newer), you have the option to upload via mongodb. This setting is an alternative to using API Upload (REST). Both methods can be used if you are uploading to separate databases for redundancy.

Setting Up Nightscout for the First Time

If you do not have a Nightscout site and want to set one up, you will need to follow the steps for standard setup, but you will use the xDrip application as the “uploader” instead of the Nightscout uploader app.

The following steps are required to set up a Nightscout site:

  1. Mongolab
    Set up a free sandbox account at www.mongolab.com, and create a user and database as specified here. Be sure to write down all names and passwords as this information is required in the next steps.

  2. Github
    Your Github account allows you to create a personal copy of the Nightscout code. You will use this copy in the creation of your website. When updates are released for the code, you will return to Github to update your copy. To begin, set up a free account at www.github.com and then create (“fork”) a copy of the CGM-remote-monitor repository, as follows:

    • Sign up for a free account at github.com. You will see the following screen that confirms you have a free account:
      github setup
    • WRITE DOWN YOUR USERNAME & PASSWORD.
    • After creating your account and are logged in, open the master repository by clicking here -> cgm-remote-monitor
    • Make a copy (“Fork”) of the nightscout/cgm-remote-monitor to your own repository by clicking on the ‘Fork‘ button on top right
      OR – just click here -> fork the cgm-remote-monitor
    • When prompted with ‘Where should we fork this repository?‘, select your @<gitaccountname>, and it will Fork to your repository.
      At the top of the page, you will now see <gitaccountname>/cgm-remote-monitor indicating you have your own copy forked from Nightscout.
  3. Create an Azure Website (or Heroku)

    Your Azure website will be the website you use to view your Nightscout data. The url for this website will also be used if you use a Pebble watch to access your Nightscout data.

    To set up your Nightscout website, follow Steps 2-5 on this page: Setting Up Your Nightscout Website on Azure. These steps will guide you through creating an Azure site, deploying your GitHub code to Azure, configuring your site to use Mongo (Mlab), setting the API SECRET, and verifying your site.

  4. Verify that Your Nightscout Site Works

    In a browser, go to your site: http://YOURSITE.azurewebsites.net. If your deployment and configuration of your mongo variables was successful, you will see a black screen with the time. If you have correctly configured your upload method in xDrip (and set the matching API_SECRET), you should also see your current CGM data.

    If you do not see a black screen, your deployment may have failed. You may also have an error in the entry of the mongo connection strings, or your API SECRET may be less than 12 characters.

    If you see a black screen with the time but no data, wait 5-10 minutes and then refresh your site. If you still do not have data, there may be a problem with the configuration of your upload method in xDrip.

  5. Switch to Pay-as-You-Go
  6. See this document for important information about changing your Azure account to Pay-as-You-Go.

Optional: Upload to Share Servers

Using xDrip with Dexcom Share, you have the option to upload the data to the Share servers so that you can use the Dexcom Follow app. This method also enables you to use the Simple CGM watchface for Pebble and the Dexcom watchface for Apple Watch.

  1. Under the Dexcom Share Server Upload section in xDrip settings, check the box to Upload BG values as Dexcom Share.
    xdrip-share
  2. Enter the name and password for the Dexcom Share account.
  3. xDrip also has tools to enable you to send Follow invites, if needed.

xDrip Features

There are numerous features built into xDrip and xDrip+, so be sure and explore the optional settings to configure xDrip for your use.

For additional xDrip information, see the xDrip Project Site. For additional xDrip+ information, see https://jamorham.github.io/#xdrip-plus

xDrip for Pebble

The current betas of xDrip and xDrip+ include a build-in watchface for Pebble for offline viewing. (Users of older versions of xDrip can use the xDrip watchface for offline viewing.)