Nightscout with xDrip and Dexcom Share (Wireless)

27 Sep

Revision for “Nightscout with xDrip and Dexcom Share (Wireless)” created on March 29, 2017 @ 13:03:03

Title
Nightscout with xDrip and Dexcom Share (Wireless)
Content
<h2>Requirements</h2> 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.) <strong>Note:</strong> 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 <a href="https://www.facebook.com/groups/1021594524580709/">xDrip G5 group at Facebook</a>. <h2>Install and Configure xDrip</h2> <ol> <li style="padding-bottom: 8px;">Download and install the current beta of <a href="https://github.com/StephenBlackWasAlreadyTaken/xDrip/wiki/xDrip-Beta">xDrip</a> or <a href="https://jamorham.github.io/#xdrip-plus">xDrip+</a> on the uploader phone.</li> <li style="padding-bottom: 8px;"><strong>Note:</strong> 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)."</li> <li style="padding-bottom: 8px;">On the Dexcom receiver, go to <span style="color: red;" class="redText">Settings/Share</span> and turn the Share feature on.</li> <li style="padding-bottom: 8px;">Open the xDrip app, click the three bars in the top left corner to open the menu. <!-- <a href="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-preferences.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-preferences.png" alt="xdrip-preferences" width="500" height="850" class="alignnone size-full wp-image-3109" /></a> --></li> <li style="padding-bottom: 8px;">Select <span style="color: red;" class="redText">Settings</span>.</li> <li style="padding-bottom: 8px;">Set the <span style="color: red;" class="redText">Hardware Data Source</span> to <span style="color: red;" class="redText">DexcomShare</span>. (<em>See #1 in the image below.</em>) (Note: earlier versions of xDrip refer to this as the Collection Method.) <a href="http://www.nightscout.info/wp-content/uploads/2015/10/xdrip-setupshare.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/10/xdrip-setupshare.png" alt="xdrip-setupshare" width="500" height="445" class="alignnone size-full wp-image-3101" /></a></li> <li style="padding-bottom: 8px;">Enter your 10-character Dexcom receiver serial number or use the option to scan the Share barcode. (<em>See #2 in the image above.</em>) (Note: your serial number is on the back of the Dexcom receiver and should start with 2 letters.)</li> <li>Return to the menu and select <span style="color: red;" class="redText">Scan for BT</span>.</li> <li style="padding-bottom: 8px;">On the screen that loads, tap <span style="color: red;" class="redText">Scan</span> in the top right hand corner. <a href="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-scan.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-scan.png" alt="xdrip-scan" width="500" height="254" class="alignnone size-full wp-image-3102" /></a></li> <li style="padding-bottom: 8px;">When it appears, select DEXCOMRX. <a href="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-scanselect.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-scanselect.png" alt="xdrip-scanselect" width="500" height="219" class="alignnone size-full wp-image-3103" /></a></li> <li style="padding-bottom: 8px;">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 <strong>in the xDrip app</strong>. Go into the menu again and choose Start Sensor. Then enter the approximate time and date the Dexcom sensor was started.</li> <li style="padding-bottom: 8px;"><strong>Note:</strong> 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 (<em>as shown below</em>). <a href="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-systemstatus.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-systemstatus.png" alt="xdrip-systemstatus" width="500" height="408" class="alignnone size-full wp-image-3105" /></a></li> <li style="padding-bottom: 8px;">Return to the settings screen and check the option to <span style="color: red;" class="redText">run in foreground</span>. <a href="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-foreground.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-foreground.png" alt="xdrip-foreground" width="500" height="198" class="alignnone size-full wp-image-3108" /></a> </li> <li style="padding-bottom: 8px;">If you want to use raw data, check the box to <span style="color: red;" class="redText">interpret raw values</span>. <a href="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-raw.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-raw.png" alt="xdrip-raw" width="500" height="136" class="alignnone size-full wp-image-3114" /></a> </ol> <h2>Connect to Nightscout</h2> If you already have a Nightscout site, you can configure xDrip to upload to your Nightscout site by configuring the <span style="color: red;" class="redText">Data Sync</span> 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 <span style="color: red;" class="redText">Auto Configure</span> option. Follow <a href="/wiki/labs/mongodb-upgrade-to-3-0/using-auto-configure-for-rest-api">these directions</a> to use the tool (in a browser) to generate a QR code of your configuration settings. <br /> <a href="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-autoconfigure.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-autoconfigure.png" alt="xdrip-autoconfigure" width="500" height="213" class="alignnone size-full wp-image-3107" /></a> <br /> If you want to enter your BASE URL manually, select API Upload (REST) as the upload method under <span style="color: red;" class="redText">Data Sync</span> 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: <span style="color: red;" class="redText">https://YOURSECRET123@yoursitename.azurewebsites.net/api/v1</span>) <!--(Note: xDrip Beta 4 v2.0.3 supports mongo 3 upload.)--> <a href="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-restapi1.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-restapi1.png" alt="xdrip-restapi" width="500" height="446" class="alignnone size-full wp-image-3106" /></a> <strong>Note:</strong> 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. <h2>Setting Up Nightscout for the First Time</h2> If you do not have a Nightscout site and want to set one up, you will need to follow the <a href="/wiki/welcome/nightscout">steps for standard setup</a>, <strong>but</strong> you will use the xDrip application as the "uploader" <strong>instead of the Nightscout uploader app</strong>. The following steps are required to set up a Nightscout site: <ol> <li style="padding-bottom: 10px;"><strong>Mongolab</strong> Set up a free sandbox account at <a href="http://www.mongolab.com/plans">www.mongolab.com</a>, and create a user and database as <a href="http://www.nightscout.info/wiki/welcome/configuring-the-data-backend">specified here</a>. Be sure to write down all names and passwords as this information is required in the next steps.<br /><br /></li> <li style="padding-bottom: 10px;"><strong>Github</strong> 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 <a href="https://www.github.com">www.github.com</a> and then create ("fork") a copy of the CGM-remote-monitor repository, as follows: <blockquote> <ul> <li>Sign up for a free account at <a href="https://github.com/" target="_blank">github.com</a>. You will see the following screen that confirms you have a free account: <a href="http://www.nightscout.info/wp-content/uploads/2014/08/github-setup1.jpg"><img class=" aligncenter wp-image-1750 size-thumbnail" src="http://www.nightscout.info/wp-content/uploads/2014/08/github-setup1-150x150.jpg" alt="github setup" width="150" height="150" /></a></li> <li><span style="color: red;"><strong>WRITE DOWN YOUR USERNAME &amp; PASSWORD</strong></span>.</li> <li>After creating your account and are logged in, open the master repository by clicking here -&gt; <a href="https://github.com/nightscout/cgm-remote-monitor" target="_blank">cgm-remote-monitor</a></li> <li>Make a copy ("Fork") of the nightscout/cgm-remote-monitor to your own repository by clicking on the '<strong>Fork</strong>' button on top right OR - just click here -&gt; <a href="https://github.com/nightscout/cgm-remote-monitor/fork"><img src="http://i.imgur.com/gR4wJ24.png" alt="fork" /> the cgm-remote-monitor</a></li> <li>When prompted with '<strong><em>Where should we fork this repository?</em></strong>', select your <strong>@&lt;gitaccountname&gt;</strong>, and it will Fork to your repository. At the top of the page, you will now see <strong>&lt;gitaccountname&gt;/cgm-remote-monitor</strong> indicating you have your own copy forked from Nightscout.</li> </ul> </blockquote> </li> <li style="padding-bottom: 10px;"><strong>Create an Azure Website (or <a href="http://www.nightscout.info/wiki/welcome/set-up-nightscout-using-heroku">Heroku</a>)</strong> 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: <a href="http://www.nightscout.info/wiki/welcome/monitor-cgm-web#azure">Setting Up Your Nightscout Website on Azure</a>. 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. </li> <li style="padding-bottom: 10px;"><strong>Verify that Your Nightscout Site Works</strong> In a browser, go to your site: <span style="color: red;">http://YOURSITE.azurewebsites.net</span>. 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. <strong>If you do not see a black screen</strong>, 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. <strong>If you see a black screen with the time but no data</strong>, 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. <li style="padding-bottom: 10px;"><strong>Switch to Pay-as-You-Go</strong></li> See <a href="http://www.nightscout.info/wiki/faqs-2/azure-2/azure-management">this document</a> for important information about changing your Azure account to Pay-as-You-Go.<br /><br /> </li> </ol> <h2>Optional: Upload to Share Servers</h2> 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. <ol> <li style="padding-bottom: 8px;">Under the <span style="color: red;" class="redText">Dexcom Share Server Upload</span> section in xDrip settings, check the box to <span style="color: red;" class="redText">Upload BG values as Dexcom Share</span>. <a href="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-share.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/xdrip-share.png" alt="xdrip-share" width="500" height="582" class="alignnone size-full wp-image-3110" /></a></li> <li style="padding-bottom: 8px;">Enter the name and password for the Dexcom Share account.</li> <li>xDrip also has tools to enable you to send Follow invites, if needed.</li> </ol> <h2>xDrip Features</h2> 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 <a href="http://stephenblackwasalreadytaken.github.io/xDrip/">xDrip Project Site</a>. For additional xDrip+ information, see <a href="https://jamorham.github.io/#xdrip-plus">https://jamorham.github.io/#xdrip-plus</a> <h2>xDrip for Pebble</h2> 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 <a href="https://apps.getpebble.com/applications/55b97282a06a0eb253000094">xDrip watchface</a> for offline viewing.)
Excerpt


OldNewDate CreatedAuthorActions
March 29, 2017 @ 13:03:03 Amy Cowen
March 22, 2017 @ 14:45:05 Amy Cowen
March 22, 2017 @ 14:32:05 Amy Cowen
March 22, 2017 @ 14:31:14 [Autosave] Amy Cowen
July 27, 2016 @ 13:45:37 Amy Cowen
July 27, 2016 @ 13:44:14 Amy Cowen
April 14, 2016 @ 23:47:39 Amy Cowen
April 14, 2016 @ 23:45:59 Amy Cowen
February 24, 2016 @ 19:53:25 Amy Cowen
December 29, 2015 @ 09:14:10 Amy Cowen
December 29, 2015 @ 09:12:40 Amy Cowen
December 29, 2015 @ 09:09:45 Amy Cowen
December 29, 2015 @ 09:06:37 Amy Cowen
December 21, 2015 @ 18:30:55 Amy Cowen
October 19, 2015 @ 06:45:12 Amy Cowen
October 17, 2015 @ 13:02:00 Amy Cowen
October 17, 2015 @ 13:01:17 Amy Cowen
October 16, 2015 @ 09:39:07 Amy Cowen
October 16, 2015 @ 09:07:26 Amy Cowen
October 16, 2015 @ 09:06:13 Amy Cowen
October 16, 2015 @ 08:58:26 Amy Cowen
September 27, 2015 @ 11:26:16 Amy Cowen
September 27, 2015 @ 11:25:33 Amy Cowen
September 27, 2015 @ 11:25:28 Amy Cowen