Installing the Android App

14 Sep

Revision for “Installing the Android App” created on June 3, 2018 @ 22:43:29

Title
Installing the Android App
Content
<!-- AMC: 2/6/16 Some changes made to reflect changes in setup, rest api, etc. Not all content updated; not all code cleaned up. --> <!-- Removed after discussion with JW on 4/20/16 <h4><em>There is a YouTube video corresponding to this step: <a href="http://youtu.be/BkOPn8GhOeo" target="_blank">http://youtu.be/BkOPn8GhOeo</a></em> NOTE: The video is not up to date and does note show the required configuration of REST API for upload.</h4> --> <div class="page-content"> <p id="moto-g">In this step, you're setting up the Android phone to act as an uploader from your Dexcom G4 to Mongolab, the database in the cloud where CGM data will be stored. The basic steps are:</p> <ol> <li>Installing Nightscout on the uploader phone.</li> <li>Configuring the uploader application using the Mongolab connection strings.</li> </ol> <strong><span style="color: #ff0000;"><em>As a prerequisite to installing the Nightscout app on your uploader phone(s), we recommend that you install any and all available Android software updates.  If you do not, the Nightscout app may stop uploading data when an Android system update notification pops up.  To install updates on a Moto G phone, go to System &gt; System Update &gt; Update Motorola Software.</em></span></strong> <h2 id="setup">1. Installing Nightscout on Your Phone</h2> <h3>On your Android Phone</h3> <strong><em>A cell plan is not required for this step.  We recommend you use wifi only during installation.</em></strong> <strong>All of these steps are performed on your uploader phone/device.</strong>  It will not work to do this from a computer. It must be from the uploader phone. Please choose the option for downloading the app: <strong>Option 1: Direct installation (click <a title="Installation" href="http://www.nightscout.info/installation">here</a>)</strong> (download and install the app and then continue with step 10 below) <strong>Option 1:  Install Using Google Play Store App:</strong> (follow steps 1-9 below) <ol> <li>Using the uploader phone, connect to the internet via wifi or cell connection.</li> <li>Click on the Google Play Store icon on your uploader phone.</li> <li>Input your email address and password in the appropriate boxes.</li> <li>Select OK to agree to the terms of service.</li> <li>Unselect the boxes to Backup &amp; Restore (This will try to download all the apps and data from a personal android device if you have one. You do not want this to happen) and Communication.</li> <li>Search for <span class="redText">Nightscout</span> in the search box at the top of the screen.</li> <li>Select <span class="redText">Nightscout Uploader</span></li> <li>Select INSTALL (or UPDATE).</li> <li>Select Accept and the app will download and install.</li> </ol> <a name="continue"></a> <ol> <li class="listPad" value="10">  Click on Open. <a href="http://www.nightscout.info/wp-content/uploads/2014/09/open.jpg"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2014/09/open-300x288.jpg" alt="open" width="300" height="288" /></a></li> <li class="listPad">If it does not open, go to the menu on the home screen and scroll until you see Nightscout.<img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2014/07/1-nightscout_app-169x300.png" alt="1-nightscout_app" width="169" height="300" /></li> <li class="listPad">Read and respond to the "Donate Data" pop-up screens.<a href="http://www.nightscout.info/wp-content/uploads/2014/09/donate.png"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2014/09/donate-169x300.png" alt="donate" width="169" height="300" /></a></li> <li class="listPad"><span style="color: #ff0000;"><strong>PLEASE READ</strong></span> and agree to the "I UNDERSTAND" disclosure by selecting <strong>YES</strong>.<a href="http://www.nightscout.info/wp-content/uploads/2014/09/understand.png"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2014/09/understand-169x300.png" alt="understand" width="169" height="300" /></a></li> <li class="listPad">Once the Nightscout app is open, open the <span class="redText">Preferences</span> screen.Your uploader screen may not look the same as this.  The Preferences (3 vertical dots) may be in the upper right or in the lower middle of the screen—depending on which Android phone/device you are using. Or you might need to tap the menu button on the phone itself, not on the screen. <img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2014/09/Screenshot_2014-11-07-10-35-36-168x300.png" alt="Screenshot_2014-11-07-10-35-36" width="168" height="300" /></li> <li class="listPad" style="text-align: left;"><strong>API Upload (REST)  is the upload method </strong> (<strong>Note:</strong> Any reference you see to mongoDB upload is out of date for the Nightscout upload ap as of 10/1/15. If you are using a different uploader that supports mongoDB upload, consult uploader-specific directions for configuration.)<strong style="line-height: 1.5;">To configure API Upload (REST): </strong><span style="line-height: 1.5;">Ensure that "Enabled"  is ON, or the slider switched to the On position</span><strong style="line-height: 1.5;"> </strong><span style="line-height: 1.5;">In the field that pops up, you will need to enter a string that combines your API_SECRET value (minimum 12 characters) and your website address.</span> You can type these in manually or use the <a href="http://nightscout.github.io/pages/configure/" target="_blank"> auto configure tool</a>. Select the "REST API" tab: <a href="http://www.nightscout.info/wp-content/uploads/2015/09/ns-restapi-string.png"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2015/09/ns-restapi-string-196x300.png" alt="ns-restapi-string" width="196" height="300" /></a> <a href="http://www.nightscout.info/wp-content/uploads/2015/09/rest-ns-dreamsicle-enterstring.png"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2015/09/rest-ns-dreamsicle-enterstring-300x260.png" alt="rest-ns-dreamsicle-enterstring" width="300" height="260" /></a> <span style="line-height: 1.5;">Configure the BASE URL for REST API as follows: </span> <span style="line-height: 1.5;">If using an Azure site: https://</span><strong style="line-height: 1.5;">YOURAPISECRET</strong><span style="line-height: 1.5;">@</span><strong style="line-height: 1.5;">YOURSITENAME</strong><span style="line-height: 1.5;">.azurewebsites.net/api/v1</span> <span style="line-height: 1.5;">If using a Heroku site: https://</span><strong style="line-height: 1.5;">YOURAPISECRET</strong><span style="line-height: 1.5;">@</span><strong style="line-height: 1.5;">YOURSITENAME</strong><span style="line-height: 1.5;">.herokuapp.com/api/v1</span> <span style="line-height: 1.5;">If you have set up your elements out of order, you may need to come back to this step after setting up the Azure or Heroku website. You will need the API_SECRET that is used in Azure or Heroku and you will need your website name to configure the REST API upload.</span> <!-- <span style="line-height: 1.5;"> For additional information regarding configuring API Upload (REST), see: </span><a style="line-height: 1.5;" href="/wiki/labs/rest-api">REST API – How to upgrade to the new upload technique</a><span style="line-height: 1.5;">.</span> --> <blockquote>Earlier Nightscout installations used <a href="http://www.nightscout.info/wiki/mongo-direct-upload" target="_blank">MongoDB as upload method </a>—this method will no longer work for the Nightscout app.</blockquote> </li> <li class="listPad">If you want your website and/or Pebble to display raw data, enable the Sensor Data and Calibration Data checkboxes.For more information about raw data please see: <a title="Interpreting raw Dexcom data" href="http://www.nightscout.info/wiki/labs/interpreting-raw-dexcom-data">Interpreting raw Dexcom data </a><a href="http://www.nightscout.info/wp-content/uploads/2014/09/data.png"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2014/09/data-169x300.png" alt="data" width="169" height="300" /></a><a title="Interpreting raw Dexcom data" href="http://www.nightscout.info/wiki/labs/interpreting-raw-dexcom-data"> </a></li> <li class="listPad">If you need to change the units from mg/dL to mmol, tap Unit Option and then select your choice in the pop-up menu.<img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2014/09/Screenshot_2014-11-08-16-05-53-168x300.png" alt="Screenshot_2014-11-08-16-05-53" width="168" height="300" /></li> <li class="listPad">Touch the Back button to exit the Preference Menu.</li> <li class="listPad">You are now ready to connect your Dexcom.</li> <li class="listPad">When everything is properly connected and input you should see a screen that resembles this (<strong><em>YOURS WILL NOT HAVE NUMBERS OR A GRAPH AT THIS POINT</em></strong>):<img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2014/09/Screenshot_2014-11-08-16-11-08-168x300.png" alt="Screenshot_2014-11-08-16-11-08" width="168" height="300" /></li> </ol> <!-- <h2>PLEASE double check and triple check the above entries and MAKE SURE THEY ARE CORRECT!  <span style="text-decoration: underline;">This is where MOST issues occur.</span></h2> --> With Mongolab now set up, the application should be able to start uploading in the next steps. <h2>Connect the Dexcom Receiver to the Uploader Phone</h2> <a name="continue"></a> <ul> <li class="listPad">On your Dexcom, click into the Utilities/Date &amp; Time and verify that every part of the time hh:mm am/pm and date mm/dd/yyyy are correct.</li> <li class="listPad">Check your uploader time setting.  Make sure it is set to the correct timezone and has the correct time and matches the Dexcom.</li> </ul> <span style="text-decoration: underline;">Do NOT move on until you have checked the time/date setting.</span> <strong>Connect the Dexcom receiver to your Android phone.</strong> <blockquote><strong>IMPORTANT</strong>: when connecting the phone to the Dexcom, the <strong>OTG cable plugs into the phone.</strong> The regular USB cable plugs into the Dexcom.<strong> It will not work the other way</strong>.</blockquote> During the initial connection, there may be a pop-up asking if the app should have permission to run / access services. Tap <strong>OK</strong>. <img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2014/07/ns-use-default.png" alt="ns-use-default" width="314" height="123" /> The Nightscout app should load. Do you see the Dexcom reading on the screen of the Nightscout app?  <!-- When your Nightscout app is reporting the <span style="text-decoration: underline;"><strong>same BG number reading as the Dexcom, and the time stamp is current,</strong></span> you should now log back into MongoLab.com and make sure your Collection is receiving documents, using the below steps.  IF NOT, review the troubleshooting steps below. --> It will look like this if the cables are connected correctly: <a href="http://www.nightscout.info/wp-content/uploads/2014/09/Screenshot_2014-11-08-16-11-08.png"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2014/09/Screenshot_2014-11-08-16-11-08-168x300.png" alt="Screenshot_2014-11-08-16-11-08" width="168" height="300" /></a> <h2>If Your Nightscout Uploader Is Not Displaying the Same BG Reading As Your Dexcom</h2> <ol> <li class="listPad">Is the CGM showing a charging symbol on the display when you plug the cables together? Are any of the icons at the bottom of the Nightscout app screen red? <ul> <li class="listPad">If Dex is not charging or the uploader has a red icon, make sure the cable connections are secure, and that you have the OTG cable connected to the phone, and the regular MicroUSB cable connecting to the CGM</li> <li class="listPad">If this does not resolve, try disconnecting the cables and reconnecting them (<strong><span style="color: #ff0000;">CAUTION:</span> BE EXTRA CAREFUL</strong> when connecting to the CGM because of the fragile USB port on the DEX)</li> <li class="listPad">If it doesn't resolve, try powering down the Dex, and powering back up (DO NOT select Stop Sensor! Just power down and back on)</li> <li class="listPad">If you're still not getting a connection to the CGM, it could be due to bad cables.  THIS IS NOT UNCOMMON! Try swapping out new cables and continue to test.</li> </ul> </li> <li class="listPad"><strong>You WILL NOT be able to proceed until you achieve a current BG number reading on your Nightscout app.</strong></li> </ol> <h2>Verifying That Data is Flowing to Mongolab</h2> If you followed the <strong>recommended sequence of steps</strong> to set up Nightscout, you have already configured your Azure (or Heroku) website and confirmed that the site was loading with a black page showing time and dashes before installing the uploader app. Now that the app is configured, you need to confirm that the website is receiving data from the uploader. First, wait 10-15 minutes after setting up the uploader app and then try reloading the page in a browser. <strong>If you see current data, your installation is complete.</strong> If you do not see current data, continue to the next troubleshooting steps. <h2>What to Do If Your Site Has No Data</h2> If your new site is not showing current data, look at the bottom of the uploader app screen on the phone.  The "upload" icon shows whether or not your phone is actually connecting and uploading documents.  If it is red, your phone is not able to upload documents.  You need to find why your phone is not successfully uploading data. <a href="http://www.nightscout.info/wp-content/uploads/2014/09/Screenshot_2014-11-08-16-11-08.png"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2014/09/Screenshot_2014-11-08-16-11-08-168x300.png" alt="Screenshot_2014-11-08-16-11-08" width="168" height="300" /></a> <strong>Verify that you have a working Internet connection on your phone.</strong>  If you also have a cellular data plan on your phone, and are currently using WiFi, try turning off WiFi and see if makes any difference running off of cellular.  If you don't have cellular data, but possibly have another WiFi hotspot to connect to (i.e. another smartphone with hotspot feature or tethering), attempt connecting to that as well. If you are sure your phone is connected to the Internet and you still do not see current data, you will need to <strong>carefully doublecheck your <span class="redText">base url</span> for the REST API upload</strong>. Does the API SECRET match what you used in Azure? Is the API SECRET at least 12 characters? Is your base url using the correct syntax for your uploader app (e.g., <span class="redText">https://YOURSECRET01@YOURSITE.azurewebsites.net/api/v1</span>). <strong>After checking the API SECRET and base url, restart the site in Azure.</strong> (It may take as much as 10 minutes for the site to fully restart and data to flow from the uploader, to the Azure site, and through to the Mongo database. If you still do not have data, go to the <strong><a href="https://www.facebook.com/groups/cgminthecloud/">CGM in the Cloud group at Facebook</a></strong> where a member of the support team can help.) (<strong>Note:</strong> Even if you had everything configured properly, if you created the website on a different day, you may need to "restart" the website in Azure (or Heroku) to get the flow of data started.) <h2>Next: <a title="Your Nightscout Website Features" href="http://www.nightscout.info/wiki/welcome/website-features">Your Nightscout Website Features</a></h2> </div>
Excerpt


OldNewDate CreatedAuthorActions
June 3, 2018 @ 22:43:29 Kate Farnsworth
April 20, 2016 @ 21:10:43 Amy Cowen
February 6, 2016 @ 19:48:14 Amy Cowen
February 6, 2016 @ 19:47:09 [Autosave] Amy Cowen
February 6, 2016 @ 19:44:25 Amy Cowen
February 6, 2016 @ 19:36:23 Amy Cowen
February 6, 2016 @ 19:34:48 Amy Cowen
February 6, 2016 @ 19:26:48 Amy Cowen
February 6, 2016 @ 19:25:17 Amy Cowen
February 6, 2016 @ 19:11:07 Amy Cowen
February 6, 2016 @ 19:07:01 Amy Cowen
September 14, 2015 @ 23:34:52 [Autosave] Melanie Clegg
September 14, 2015 @ 23:34:43 Melanie Clegg
September 14, 2015 @ 23:33:32 Melanie Clegg
September 14, 2015 @ 23:32:42 Melanie Clegg
September 14, 2015 @ 23:28:52 Melanie Clegg
September 14, 2015 @ 23:26:56 Melanie Clegg
September 14, 2015 @ 23:20:41 Melanie Clegg
September 14, 2015 @ 23:19:46 Melanie Clegg
September 14, 2015 @ 23:13:57 Melanie Clegg
September 14, 2015 @ 23:12:21 Melanie Clegg
September 14, 2015 @ 23:10:36 Melanie Clegg
September 14, 2015 @ 23:09:25 Melanie Clegg
September 14, 2015 @ 23:09:13 Melanie Clegg
August 11, 2015 @ 22:49:30 Amy Cowen
August 11, 2015 @ 22:36:29 Amy Cowen
March 3, 2015 @ 15:59:49 David Waghalter
March 3, 2015 @ 15:26:34 [Autosave] David Waghalter
February 23, 2015 @ 17:08:16 Gail DeVore
February 23, 2015 @ 17:07:49 [Autosave] Gail DeVore
January 19, 2015 @ 19:06:58 Jim Sifferle
January 4, 2015 @ 19:47:16 Gail DeVore
November 13, 2014 @ 12:45:16 Gail DeVore
November 13, 2014 @ 12:30:59 Gail DeVore
November 13, 2014 @ 12:18:30 Gail DeVore
November 13, 2014 @ 11:13:12 Gail DeVore
November 13, 2014 @ 11:10:58 Gail DeVore
November 13, 2014 @ 11:01:14 Gail DeVore
November 13, 2014 @ 10:59:37 Gail DeVore
November 9, 2014 @ 17:49:32 Gail DeVore
November 9, 2014 @ 17:48:09 Gail DeVore
November 9, 2014 @ 10:36:51 Gail DeVore
November 8, 2014 @ 16:53:53 Gail DeVore
November 8, 2014 @ 16:07:47 Gail DeVore
November 8, 2014 @ 15:33:46 Rachel Sandlain
November 8, 2014 @ 15:14:10 [Autosave] Rachel Sandlain
November 8, 2014 @ 10:27:48 Gail DeVore
November 7, 2014 @ 09:10:24 Gail DeVore
November 7, 2014 @ 09:02:50 Gail DeVore
September 14, 2014 @ 10:08:15 Patrick Drews
September 14, 2014 @ 10:07:42 [Autosave] Patrick Drews
September 5, 2014 @ 06:49:23 Patrick Drews
August 22, 2014 @ 20:57:12 Patrick Drews
August 15, 2014 @ 15:45:54 James Wedding
August 15, 2014 @ 15:45:54 James Wedding
August 10, 2014 @ 16:43:53 James Wedding
August 8, 2014 @ 17:16:05 Patrick Drews
August 8, 2014 @ 07:25:49 Patrick Drews
August 8, 2014 @ 07:25:07 Patrick Drews
August 8, 2014 @ 07:24:09 Patrick Drews
August 8, 2014 @ 07:23:55 Patrick Drews
August 8, 2014 @ 07:21:40 Patrick Drews
August 8, 2014 @ 07:21:11 Patrick Drews
August 8, 2014 @ 07:20:18 Patrick Drews
August 8, 2014 @ 07:16:11 Patrick Drews
August 8, 2014 @ 07:15:10 Patrick Drews
August 8, 2014 @ 07:14:45 Patrick Drews
August 8, 2014 @ 07:13:56 Patrick Drews
August 8, 2014 @ 07:13:13 Patrick Drews
August 8, 2014 @ 07:11:58 Patrick Drews
August 8, 2014 @ 07:10:03 Patrick Drews
August 8, 2014 @ 07:09:08 Patrick Drews
August 8, 2014 @ 07:08:45 Patrick Drews
August 8, 2014 @ 07:07:57 Patrick Drews
August 8, 2014 @ 07:07:03 Patrick Drews
August 8, 2014 @ 07:06:30 Patrick Drews
August 8, 2014 @ 07:04:34 Patrick Drews
August 8, 2014 @ 07:00:17 Patrick Drews
August 8, 2014 @ 06:51:01 Patrick Drews
August 8, 2014 @ 06:49:02 Patrick Drews
August 8, 2014 @ 06:48:25 Patrick Drews
August 8, 2014 @ 06:40:09 Patrick Drews
August 8, 2014 @ 06:35:53 Patrick Drews
August 8, 2014 @ 06:35:10 Patrick Drews
August 8, 2014 @ 06:34:17 Patrick Drews
August 8, 2014 @ 06:32:56 Patrick Drews
August 8, 2014 @ 06:31:58 Patrick Drews
August 8, 2014 @ 06:30:38 Patrick Drews
August 8, 2014 @ 06:29:46 Patrick Drews
August 8, 2014 @ 06:29:19 Patrick Drews
August 8, 2014 @ 06:27:12 Patrick Drews
August 8, 2014 @ 06:10:09 Patrick Drews
August 8, 2014 @ 06:09:31 Patrick Drews
August 8, 2014 @ 06:05:10 Patrick Drews
August 8, 2014 @ 05:55:30 Patrick Drews
August 8, 2014 @ 05:48:47 Patrick Drews
August 8, 2014 @ 05:39:54 Patrick Drews
August 7, 2014 @ 22:39:38 Patrick Drews
August 7, 2014 @ 22:38:27 Patrick Drews
August 7, 2014 @ 22:32:35 Patrick Drews
August 7, 2014 @ 22:31:49 Patrick Drews
August 7, 2014 @ 22:31:10 Patrick Drews
August 7, 2014 @ 20:51:47 James Wedding
August 7, 2014 @ 20:51:07 [Autosave] James Wedding
August 5, 2014 @ 14:51:07 Patrick Drews
August 5, 2014 @ 14:50:13 Patrick Drews
August 5, 2014 @ 14:49:02 Patrick Drews
August 5, 2014 @ 14:47:48 Patrick Drews
August 5, 2014 @ 14:47:06 Patrick Drews
August 5, 2014 @ 14:44:30 Patrick Drews
August 5, 2014 @ 14:42:55 Patrick Drews
August 4, 2014 @ 11:41:48 Gail DeVore
August 3, 2014 @ 18:10:54 Gail DeVore
August 3, 2014 @ 17:52:39 Gail DeVore
August 1, 2014 @ 22:30:58 James Wedding
August 1, 2014 @ 22:21:54 James Wedding
August 1, 2014 @ 08:38:20 Gail DeVore
July 31, 2014 @ 16:59:58 Gail DeVore
July 28, 2014 @ 22:41:21 Gail DeVore
July 28, 2014 @ 21:51:45 James Wedding
July 28, 2014 @ 21:46:39 James Wedding
July 28, 2014 @ 21:44:46 James Wedding
July 28, 2014 @ 21:43:46 James Wedding
July 26, 2014 @ 09:43:07 Gail DeVore
July 23, 2014 @ 22:45:10 Gail DeVore
July 23, 2014 @ 22:43:19 Gail DeVore
July 23, 2014 @ 22:40:06 Gail DeVore
July 23, 2014 @ 12:52:02 Gail DeVore
July 23, 2014 @ 09:44:17 Gail DeVore
July 21, 2014 @ 16:40:19 Gail DeVore
July 21, 2014 @ 16:36:09 Gail DeVore
July 21, 2014 @ 16:23:31 Gail DeVore
July 21, 2014 @ 16:18:10 Gail DeVore
July 21, 2014 @ 16:15:15 Gail DeVore
July 21, 2014 @ 16:12:15 Gail DeVore
July 21, 2014 @ 10:12:18 James Wedding
July 21, 2014 @ 10:01:23 James Wedding
July 21, 2014 @ 09:53:31 James Wedding
July 20, 2014 @ 21:07:34 James Wedding
July 17, 2014 @ 13:27:09 James Wedding