Depending on your settings you can open Config Builder through a tab at the top of the screen or through hamburger menu.
Config Builder (Conf) is the tab where you turn the modular features on and off. The boxes on the left-hand side (A) allow you to select which one to use, the boxes on the right-hand side (C) allow you to view these as a tab (E) in AndroidAPS. In case the right box is not activated you can reach the function by using the hamburger menu (D) on the top left of the screen.
Where there are additional settings available within the module, you can click on the cog wheel (B) which will take you to the specific settings within preferences.
First configuration: Since AAPS 2.0 a Setup wizard guides you through the process of setting up AndroidAPS. Push 3-dots-menu on the upper right-hand side of the screen (F) and select ‘Setup Wizard’ to use it.
Select the basal profile you wish to use. See Profiles page for more setup information.
Local profile (recommended)¶
Local profile uses the basal profile manually entered in phone. As soon as it is selected, a new tab appears in AAPS, where you can change the profile data read out from the pump if necessary. With the next profile switch they are then written to the pump in profile 1. This profile is recommended as it does not rely on internet connectivity.
Your local profiles are part of exported settings. So make sure to have a backup in a safe place.
- green plus: add
- red X: delete
- blue arrow: duplicate
If you make any changes to your profile, make sure, you are editing the correct profile. In profile tab there is not always shown the actual profile beeing used - e.g. if you made a profile switch by using the profile tab on homescreen it may differ from the profile actually shown in profile tab as there is no connection between these.
Clone profile switch¶
You can easily create a new local profile from a profile switch. In this case timeshift and percentage will be applied to the new local profile.
- Go to treatments tab.
- Select ProfileSwitch.
- Press “Clone”.
- You can edit the new local profile in Local Profile (LP) tab or via the hamburger menu.
If you want to switch from Nightscout profile to local profile just do a profile switch on your NS profile and clone the profile switch as described above.
Upload local profiles to Nightscout¶
Local profiles can also be uploaded to Nightscout. The settings can be found in NSClient preferences.
- no internet connection necessary to change profile settings
- profile changes can be made directly on the phone
- new profile can be created from profile switch
- local profiles can be uploaded to Nightscout
Profile helper offers two functions:
- Find a profile for kids
- Compare two profiles or profile switches in order to clone a new profile
Details are explained on the separate profile helper page.
NS Profile uses the profiles you have saved on your Nightscout site (https://[yournightscoutsiteaddress]/profile). You can use the Profile Switch to change which of those profiles is active, this writes the profile to the pump in case of AndroidAPS failure. This allows you to easily create multiple profiles in Nightscout (i.e.. work, home, sports, holidays, etc.). Shortly after clicking on “Save” they will be transferred to AAPS if your smartphone is online. Even without an Internet connection or without a connection to Nightscout, the Nightscout profiles are available in AAPS once they have been synchronized.
Do a profile switch to activate a profile from Nightscout. Press and hold the current profile in the AAPS homescreen at the top (grey field between the light blue “Open/Closed Loop” field and the dark blue target area field) > Profile switch > Select profile > OK. AAPS also writes the selected profile into the pump after the profile change, so that it is available without AAPS in an emergency and continues to run.
- multiple profiles
- easy to edit via PC or tablet
- no local changes to profile settings
- profile cannot be changed directly on the phone
Select the type of insulin curve you are using. The options ‘Rapid-Acting Oref’, Ultra-Rapid Oref’ and ‘Free-Peak Oref’ all have an exponential shape. More information is listed in the OpenAPS docs, the curves will vary based on the DIA and the time to peak.
The DIA is not the same for each person. That’s why you have to test it for yourself. But it must always be at least 5 hours. You can read more about that in the Insulin Profile section of this page.
For Rapid-Acting and Ultra-Rapid, the DIA is the only variable you can adjust by yourself, the time to peak is fixed. Free-Peak allows you to adjust both the DIA and the time to peak, and must only be used by advanced users who know the effects of these settings.
The insulin curve graph helps you to understand the different curves. You can view it by enabling the tickbox to show it as a tab, otherwise it will be in the hamburger menu.
- recommended for Humalog, Novolog and Novorapid
- DIA = at least 5.0h
- Max. peak = 75 minutes after injection (fixed, not adjustable)
- recommended for FIASP
- DIA = at least 5.0h
- Max. peak = 55 minutes after injection (fixed, not adjustable)
For a lot of people there is practically no noticeable effect of FIASP after 3-4 hours any more, even if 0.0xx units are available as a rule then. This residual amount can still be noticeable during sports, for example. Therefore, AndroidAPS uses minimum 5h as DIA.
Free Peak Oref¶
With the “Free Peak 0ref” profile you can individually enter the peak time. The DIA is automatically set to 5 hours if it is not specified higher in the profile.
This effect profile is recommended if an unbacked insulin or a mixture of different insulins is used.
Select the blood glucose source you are using - see BG Source page for more setup information.
Select the pump you are using.
- Dana R
- Dana R Korean (for domestic DanaR pump)
- Dana Rv2 (DanaR pump with unofficial firmware upgrade)
- Dana RS
- Accu Chek Insight
- Accu Chek Combo (requires ruffy installation)
- MDI (receive AAPS suggestions for your multiple daily injections therapy)
- Virtual pump (open loop for pump which don’t have any driver yet - AAPS suggestions only)
For dana pumps, use Advanced settings to activate BT watchdog if necessary. It switches off bluetooth for one second if no connection to the pump is possible. This may help on some phones where the bluetooth stack freezes.
Password for Dana RS pump must be entered correctly. Password was not checked in previous versions.
Select the type of sensitivity detection. For more details of different designs please read on here. This will analyze historical data on the go and make adjustments if it recognizes that you are reacting more sensitively (or conversely, more resistant) to insulin than usual. More details about the Sensitivity algorithm can be read in the OpenAPS docs.
You can view your sensitivity on the homescreen by selecting SEN and watching the white line. Note, you need to be in Objective 8 in order to let Sensitivity Detection/Autosens automatically adjust the amount of insulin delivered. Before reaching that objective, the Autosens percentage / the line in your graph is displayed for information only.
If you use Oref1 with SMB you must change min_5m_carbimpact to 8. The value is only used during gaps in CGM readings or when physical activity “uses up” all the blood glucose rise that would otherwise cause AAPS to decay COB. At times when carb absorption can’t be dynamically worked out based on your bloods reactions it inserts a default decay to your carbs. Basically, it is a failsafe.
Select the desired APS algorithm for therapy adjustments. You can view the active detail of the chosen algorithm in the OpenAPS(OAPS) tab.
- OpenAPS AMA (advanced meal assist, state of the algorithm in 2017)More detail about OpenAPS AMA can be found in the OpenAPS docs. In simple terms the benefits are after you give yourself a meal bolus the system can high-temp more quickly IF you enter carbs reliably.
- OpenAPS SMB (super micro bolus, most recent algorithm for advanced users)Note you need to be in Objective 10 in order to use OpenAPS SMB and min_5m_carbimpact must be set to 8 in Config builder > Sensitivity detection > Sensitivity Oref1 settings.
- Switch between Open Loop, Closed Loop and Low Glucose Suspend (LGS).
- AAPS continuously evaluates all available data (IOB, COB, BG...) and makes treatment suggestions on how to adjust your therapy if necessary.
- The suggestions will not be executed automatically (as in closed loop) have to be entered manually into the pump or by using a button in case you are using a compatible pump (Dana R/RS or Accu Chek Combo).
- This option is for getting to know how AndroidAPS works or if you are using an unsupported pump.
- AAPS continuously evaluates all available data (IOB, COB, BG...) and automatically adjusts the treatment if necessary (i.e. without further intervention by you) to reach the set target range or value (bolus delivery, temporary basal rate, insulin switch-off to avoid hypo etc.).
- The Closed Loop works within numerous safety limits, which you can be set individually.
- Closed Loop is only possible if you are in Objective 6 or higher and use a supported pump.
- Please note: In closed loop mode a single target instead of target range (i.e. 5,5 mmol or 100 mg/dl instead of 5,0 - 7,0 mmol or 90 - 125 mg/dl) is recommended.
Low Glucose Suspend (LGS)¶
- maxIOB is set to zero
- This means if blood glucose is dropping it can reduce basal for you.
- But if blood glucose is rising no automatic correction will be made. Your basal rates will remain the same as your selected profile.
- Only if basal IOB is negative (from a previous Low Glucose Suspend) additional insulin will be given to lower BG.
Minimal request change¶
- When using open loop you will receive notifications every time AAPS recommends to adjust basal rate.
- To reduce number of notifications you can either use a wider bg target range or increase percentage of the minimal request rate.
- This defines the relative change required to trigger a notification.
Objectives (learning program)¶
AndroidAPS has a leraning program (objectives) that you have to fulfill step by step. This should guide you safely through setting up a closed loop system. It guarantees that you have set everything up correctly and understand what the system does exactly. This is the only way you can trust the system.
You should export your settings (including progress of the objectives) on a regularly basis. In case you have to replace your smartphone later (new purchase, display damage etc.) you can simply import those settings.
See Objectives page for more information.
If you view the Treatments (Treat) tab, you can see the treatments that have been uploaded to nightscout. Should you wish to edit or delete an entry (e.g. you ate less carbs than you expected) then select ‘Remove’ and enter the new value (change the time if necessary) through the carbs button on the home screen.
Displays the current state of your loop and buttons for most common actions (see section The Homescreen for details). Settings can be accessed by clicking the cog wheel.
Keep screen on¶
Option ‘Keep screen on’ will force Android to keep the screen on at all times. This is useful for presentations etc. But it consumes a lot of battery power. Therefore, it is recommended to connect the smartphone to a charger cable.
Create a button for a certain standard meal (carbs and calculation method for the bolus) which will be displayed on the home screen. Use for standard meals frequently eaten. If different times are specified for the different meals you will always have the appropriate standard meal button on the home screen, depending on the time of day.
Note: Button will not be visible if outside the specified time range or if you have enough IOB to cover the carbs defined in the QuickWizard button.
Choose default temp-targets (duration and target). Preset values are:
- eating soon: target 72 mg/dl / 4.0 mmol/l, duration 45 min
- activity: target 140 mg/dl / 7.8 mmol/l, duration 90 min
- hypo: target 125 mg/dl / 6.9 mmol/l, duration 45 min
Fill/Prime standard insulin amounts¶
Choose the default amounts of the three buttons in fill/prime dialogue, depending on the length of your catheter.
Range of visualization¶
Choose the high and low marks for the BG-graph on AndroidAPS overview and smart watch. It is only the visualization, not the target range for your BG. Example: 70 - 180 mg/dl or 3.9 - 10 mmol/l
Shorten tab titles¶
Choose either the tab titles in AndroidAPS are long (e.g. ACTIONS, LOCAL PROFILE, AUTOMATION) or short (e.g. ACT, LP, AUTO)
Show notes field in treatment dialogs¶
Choose if you want to have a notes field when entering treatments or not.
Choose if you want to have status lights on overview for canula age, insulin age, sensor age, battery age, reservoir level or battery level. When warning level is reached, the color of the status light will switch to yellow. Critical age will show up in red.
Deliver this part of bolus wizard result: When using SMB, many people do not meal-bolus 100% of needed insulin, but only a part of it (e.g. 75 %) and let the SMB with UAM (unattended meal detection) do the rest. In this setting, you can choose a default value for the percenteage the bolus wizard should calculate with. If this setting is 75 % and you had to bolus 10u, the bolus wizard will propose a meal bolus of only 7.5 units.
Enable super bolus functionality in wizard (It is different from super micro bolus!): Use with caution and do not enable until you learn what it really does. Basically, the basal for the next two hours is added to the bolus and a two hour zero-temp activated. AAPS looping functions will be disabled - so use with care! If you use SMB AAPS looping functions will be disabled according to your settings in “Max minutes of basal to limit SMB to”, if you do not use SMB looping functions will be disabled for two hours. Details on super bolus can be found here.
Some buttons to quickly access common features:
- Profiles Switch (see Profiles page for more setup information)
- Temporary targets
- Set / cancel temp. basal rate
- Extended bolus (DanaR/RS or Combo pump only)
- Record for any specific care entries
- BG check
- Prime / fill - record pump site change and prime (if not done on pump)
- CGM sensor insert
- Pump battery change
- View the current sensor, insulin, canula and pump battery ages
- History browser
- TDD (Total daily dose = bolus + basal per day)
Some doctors use - especially for new pumpers - a basal-bolus-ratio of 50:50. Therefore ratio is calculated as TDD / 2 * TBB (Total base basal = sum of basal rate within 24 hours). Others prefer range of 32% to 37% of TDD for TBB. Like most of these rules-of-thumb it is of limited real validity. Note: Your diabetes may vary!
Allows remote caregivers to control some AndroidAPS features via SMS, see SMS Commands for more setup information.
Displays the food presets defined in the Nightscout food database, see Nightscout Readme for more setup information.
Note: Entries cannot be used in the AndroidAPS calculator. (View only)
Monitor and control AAPS using your Android Wear watch (see page Watchfaces). Use settings (cog wheel) to define which variables should be considered when calculating bolus given though your watch (i.e. 15min trend, COB...).
If you want to bolus etc. from the watch then within “Wear settings” you need to enable “Controls from Watch”.
Through Wear tab or hamburger menu (top left of screen, if tab is not displayed) you can
- Resend all data. Might be helpful if watch was not connected for some time and you want to push the information to the watch.
- Open settings on your watch directly from your phone.
xDrip Statusline (watch)¶
Display loop information on your xDrip+ watchface (if you are not using AAPS/AAPSv2 watchface
- Setup sync of your AndroidAPS data with Nightscout.
- Settings in preferences can be opened by clicking the cog wheel.
Email and number of logs to be send. Normally no change necessary.
Use tab for config builder instead of hamburger menu.