Welcome to the Android APS documentation
What is AndroidAPS?
AndroidAPS is a app that acts as an artificial pancreas system (APS) on an Android smartphone. What is an artificial pancreas system? It is a software program that aims to do what a living pancreas does: keep blood sugar levels within healthy limits automatically. An APS can't do the job as well as a biological pancreas does, but it can make type 1 diabetes easier to manage using devices that are commercially available and software that is simple and safe. Those devices include a continuous glucose monitor (CGM) to tell AndroidAPS about your blood sugar levels and an insulin pump which AndroidAPS controls to deliver appropriate doses of insulin. The app communicates with those devices via bluetooth. It makes its dosing calculations using an algorithm, or set of rules, developed for another artificial pancreas system, called OpenAPS, which has thousands of users and has accumulated millions of hours of use.
A note of caution: AndroidAPS is not regulated by any medical authority in any country. Using AndroidAPS is essentially carrying out a medical experiment on yourself. Setting up the system requires determination and technical knowledge. If you don't have the technical know-how at the beginning, you will by the end. All the information you need can be found in these documents, elsewhere online, or from others who have already done it -- you can ask them in Facebook groups or other forums. Many people have successfully built AndroidAPS and are now using it entirely safely, but it is essential that every user: * Builds the system themselves so that they thoroughly understand how it works * Adjusts the settings to suit their own diabetes * Maintains and monitors the system to ensure it is working properly If you're ready for the challenge, please read on.
Primary goals behind AndroidAPS:
- An app with safety built in. To read about the safety features of the algorithms, known as oref0 and oref1, click here (https://openaps.org/reference-design/)
- An all-in-one app for managing type 1 diabetes with an artificial pancreas and Nightscout
- An app to which users can easily add or remove modules as needed
- An app with different versions for specific locations and languages.
- An app which can be used in open- and closed-loop mode
- An app that is totally transparent: users can input parameters, see results, and make the final decision
- An app which is independent of particular pump drivers and contains a "virtual pump" so users can safely experiment before using it on themselves
- An app closely integrated with Nightscout
- An app in which the user is in control of safety constraints
What you need to get started:
- An Android smartphone with Android 5.0 or later. See this spreadsheet to learn which phones work best with AndroidAPS.
- A continuous clucose monitor (CGM): Dexcom G4/G5/G6, Freestyle Libre, Eversense, Medtronic Guardian, or PocTech
- An app on the phone to receive CGM data: xDrip/ xDrip+, Glimp , G5 patched app, PochTech app or 600SeriesAndroidUploader
- AndroidAPS itself installed on the phone
- Nightscout cgm-remote-monitor 0.10.2 or later
- A supported pump: Dana-R or Dana-RS from Sooil, or Accu-Chek Combo or Insight from Roche (unless you are able to build your own driver for another insulin pump)
Disclaimer And Warning
- All information, thought, and code described here is intended for informational and educational purposes only. Nightscout currently makes no attempt at HIPAA privacy compliance. Use Nightscout and AndroidAPS at your own risk, and do not use the information or code to make medical decisions.
- Use of code from github.com is without warranty or formal support of any kind. Please review this repository's LICENSE for details.
- All product and company names, trademarks, servicemarks, registered trademarks, and registered servicemarks are the property of their respective holders. Their use is for information purposes and does not imply any affiliation with or endorsement by them.
Getting Started with AndroidAPS
.. toctree:: :maxdepth: 1 :glob: Safety First <./Getting-Started/Safety-first.md> Screenshots <./Getting-Started/Screenshots.md> Phones <./Getting-Started/Phones.md> Pump choices <./Getting-Started/Pump-Choices.md> Possible future pump drivers <./Getting-Started/Future-possible-Pump-Drivers.md> Sample Setup: Samsung S7, Dana-R, Dexcom G5 and Sony Smartwatch <./Getting-Started/Sample-Setup.md> FAQ for loopers <./Getting-Started/FAQ.md> Glossary <./Getting-Started/Glossary.md>
How to Install AndroidAPS
.. toctree:: :maxdepth: 1 :glob: Building the APK <./Installing-AndroidAPS/Building-APK.md> Update to a new version or branch <./Installing-AndroidAPS/Update-to-new-version.md> Release notes <./Installing-AndroidAPS/Releasenotes.md> Dev branch <./Installing-AndroidAPS/Dev-branch.md> Nightscout setup <./Installing-AndroidAPS/Nightscout.md>
.. toctree:: :maxdepth: 1 :glob: Config Builder <./Configuration/Config-Builder.md> BG Source <./Configuration/BG-Source.md> Dana-R pump <./Configuration/DanaR-Insulin-Pump.md> Dana-RS pump <./Configuration/DanaRS-Insulin-Pump.md> Accu-Chek Combo pump <./Configuration/Accu-Chek-Combo-Pump.md> Accu-Chek Insight pump <./Configuration/Accu-Chek-Insight-Pump.md> Watchfaces <./Configuration/Watchfaces.md> Preferences <./Configuration/Preferences.md> Sensitivity Detection and COB <./Configuration/Sensitivity-detection-and-COB.md>
.. toctree:: :maxdepth: 1 :glob: Objectives <./Usage/Objectives.md> OpenAPS features <./Usage/Open-APS-features.md> Profile switch <./Usage/Profiles.md> Temp-targets <./Usage/temptarget.md> SMS commands <./Usage/SMS-Commands.md> Extended Carbs <./Usage/Extended-Carbs.md> Crossing timezones with pumps <./Usage/Timezone-traveling.md> Accessing logfiles <./Usage/Accessing-logfiles.md> Smoothing blood glucose data <./Usage/Smoothing-Blood-Glucose-Data-in-xDrip.md> Accu-Chek Combo tips for basic usage <./Usage/Accu-Chek-Combo-Tips-for-Basic-usage.md> Troubleshooting NSClient <./Usage/Troubleshooting-NSClient.md> Android auto <./Usage/Android-auto.md> Huawei phones special configuration <./Usage/huawei.md> Automation <./Usage/Automation.md>
Where to go for help
.. toctree:: :maxdepth: 1 :glob: Useful resources to read before you start <./Where-To-Go-For-Help/Background-reading.md> Where to go for help <./Where-To-Go-For-Help/Connect-with-other-users.md>
.. toctree:: :maxdepth: 1 :glob: :caption: Resources/Reference Resources <./Resources/index> For Clinicians <./Resources/clinician-guide-to-AndroidAPS>
How to help
.. toctree:: :maxdepth: 1 :glob: How to help <./Getting-Started/How-can-I-help.md> How to translate the app <./translations.md> How to edit the wiki <./make-a-PR>