diff --git a/docs/EN/CompatibleCgms/Libre1.md b/docs/EN/CompatibleCgms/Libre1.md
index ba4bc52eef64..89ac2fb850e1 100644
--- a/docs/EN/CompatibleCgms/Libre1.md
+++ b/docs/EN/CompatibleCgms/Libre1.md
@@ -36,8 +36,9 @@ details.
- You can safely download the [latest APK (stable)](https://xdrip-plus-updates.appspot.com/stable/xdrip-plus-latest.apk) unless you need recent features, in which case you should use the latest [Nightly Snapshot](https://github.com/NightscoutFoundation/xDrip/releases).
- Follow setup instructions on [xDrip+ settings page](../CompatibleCgms/xDrip.md).
- You also need [OOP2](https://drive.google.com/file/d/1f1VHW2I8w7Xe3kSQqdaY3kihPLs47ILS/view) for Libre 1 US (and Libre 2 EU).
-- Select xDrip+ in in [ConfigBuilder, BG Source](#Config-Builder-bg-source).
+- Select xDrip+ in [ConfigBuilder, BG Source](#Config-Builder-bg-source).
+(libre1-using-glimp)=
## 2. Using Glimp
- Glimp supports Miaomiao, Blucon and Bubble for Libre 1 and Libre 2 EU.
@@ -45,11 +46,12 @@ details.
- Install [Glimp](https://play.google.com/store/apps/details?id=it.ct.glicemia).
- Select Glimp in in [ConfigBuilder, BG Source.](#Config-Builder-bg-source)
+(libre1-using-tomato)=
## 3. Using Tomato
- Tomato is the vendor app for Miaomiao.
- Install [Tomato](http://tomato.cool/#download_page) and follow the vendor [instructions](http://tomato.cool/how-to-broadcast-data-to-android-aps/tips/).
-- Select Tomato in in [ConfigBuilder, BG Source](#Config-Builder-bg-source).
+- Select Tomato in [ConfigBuilder, BG Source](#Config-Builder-bg-source).
## 4. Using Diabox
@@ -58,4 +60,4 @@ details.
-- Select xDrip+ in in [ConfigBuilder, BG Source](#Config-Builder-bg-source).
+- Select xDrip+ in [ConfigBuilder, BG Source](#Config-Builder-bg-source).
diff --git a/docs/EN/CompatibleCgms/PocTech.md b/docs/EN/CompatibleCgms/PocTech.md
index 5043dc1d0dfe..9d614f98e144 100644
--- a/docs/EN/CompatibleCgms/PocTech.md
+++ b/docs/EN/CompatibleCgms/PocTech.md
@@ -1,4 +1,4 @@
# For users of PocTech CT-100
-- Install PocTech App
+- Install [PocTech App](https://play.google.com/store/apps/details?id=com.poctechcorp.pocct)
- Select PocTech App in [ConfigBuilder, BG Source](#Config-Builder-bg-source).
diff --git a/docs/EN/CompatibleCgms/SmoothingBloodGlucoseData.md b/docs/EN/CompatibleCgms/SmoothingBloodGlucoseData.md
index 6fe0232590e5..8ff70f36173a 100644
--- a/docs/EN/CompatibleCgms/SmoothingBloodGlucoseData.md
+++ b/docs/EN/CompatibleCgms/SmoothingBloodGlucoseData.md
@@ -36,6 +36,7 @@ Use this option only if your CGM data is being properly smoothed by your collect
#### Build Your Own Dexcom App
When using [BYODA](#DexcomG6-if-using-g6-with-build-your-own-dexcom-app), your BG data is smooth and consistent. Furthermore, you can take advantage of Dexcom back-smoothing. There are no restrictions in using SMBs, because the noise-level data is shared with AAPS.
+(smoothing-xdrip-dexcom-g6)=
#### xDrip+ with Dexcom G6 or Dexcom ONE
Noise-level data and smooth BG readings are only shared with AAPS if you use xDrip+ [native mode](https://navid200.github.io/xDrip/docs/Native-Algorithm). Using native mode, there are no restrictions in using SMBs.
diff --git a/docs/EN/DailyLifeWithAaps/AapsScreens.md b/docs/EN/DailyLifeWithAaps/AapsScreens.md
index dbbd75a9441a..3fa745dc0892 100644
--- a/docs/EN/DailyLifeWithAaps/AapsScreens.md
+++ b/docs/EN/DailyLifeWithAaps/AapsScreens.md
@@ -5,6 +5,7 @@
:depth: 2
```
+(AapsScreens-the-homescreen)=
## The Homescreen
@@ -298,6 +299,8 @@ Shows the sensitivity that [Autosens](#Open-APS-features-autosens) has detected.
Sensitivity is a calculation of sensitivity to insulin as a result of exercise, hormones etc.
+Note, you need to be in [Objective 8](#objectives-objective8) in order to let Sensitivity Detection/[Autosens](#Open-APS-features-autosens) automatically adjust the amount of insulin delivered. Before reaching that objective, the line in your graph is displayed for information only.
+
#### Heart rate
This data may be available when using a [Garmin smartwatch](#Watchfaces-garmin).
@@ -505,9 +508,9 @@ Like most of these rules-of-thumb it is of limited real validity. Note: Your dia
-This shows the activity profile of the insulin you have chosen in [config builder](#Config-Builder-insulin).
+This shows the activity profile of the insulin you have chosen in [config builder](#Config-Builder-insulin). The curves will vary based on the [DIA](#your-aaps-profile-duration-of-insulin-action) and the time to peak.
-The **purple** line shows how much insulin remains after it has been injected as it decays with time and the **blue** line shows how active it is. The important thing to note is that the decay has a **long tail**. If you have been used to manual pumping, you have probably been used to assuming that insulin decays over about 3.5 hours. However, when you are looping, the long tail matters as the calculations are far more precise and these small amounts add up when they are subjected to the recursive calculations in the **AAPS** algorithm.
+The **purple** line shows how much insulin remains after it has been injected as it decays with time and the **blue** line shows how active it is. The important thing to note is that the decay has a **long tail**. If you have been used to manual pumping, you have probably been used to assuming that insulin decays over about 3.5 hours. However, when you are looping, the long tail matters as the calculations are far more precise and these small amounts add up when they are subjected to the recursive calculations in the **AAPS** algorithm. Therefore, **AAPS** uses minimum 5h as DIA.
For a more detailed discussion of the different types of insulin, their activity profiles and why all this matters you can read an article here on [Understanding the New IOB Curves Based on Exponential Activity Curves](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/understanding-insulin-on-board-calculations.html#understanding-the-new-iob-curves-based-on-exponential-activity-curves)
@@ -529,18 +532,18 @@ Calculations are run each time the system gets a fresh reading from the CGM.
For more details see [APS section on config builder page](#Config-Builder-aps).
+(aaps-screens-profile)=
## Profile
-Profile contains information on your individual diabetes settings:
+Profile contains information on your individual diabetes settings, see the detailed **[Profile](../SettingUpAaps/YourAapsProfile.md)** page for more information.
- * DIA (Duration of Insulin Action)
- * IC or I:C: Insulin to Carb ratio
- * ISF: Insulin Sensitivity Factor
- * Basal rate
- * Target: Blood glucose level that you want **AAPS** to be aiming for
+The buttons on this page allow you to manage your profiles :
+* **Green plus**: create new profile from scratch
+* **Red X**: delete the profile currently on screen
+* **Blue arrow**: duplicate the profile currently on screen
-See the detailed **[Profile](../SettingUpAaps/YourAapsProfile.md)** page for more information.
+When you want to make any changes to a profile, make sure you are editing the correct profile. When you reach the profile tab, it may not show the current profile in use, but the first one in the list.
## Automation
@@ -562,6 +565,7 @@ Depending on your BG source settings, this tab is named differently.
Shows history of CGM readings and offers option to remove reading in case of failure (i.e. compression low) or duplicate readings.
+(aaps-screens-treatments)=
## Treatments
This view can be accessed by pressing the 3 dots on the right of the menu, then Treatments. It is not possible to show it in the main menu through the Config Builder.
@@ -633,6 +637,12 @@ The history of profile switches can be seen here. You may see multiple entries e
Deleting the entries only affects your reports in Nightscout and will never actually change the current profile.
+(aaps-screens-clone-profile-switch)=
+#### 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. Use the **Clone** button shown on line **1**.
+
+You can now go to the [Profile tab](#profile) to edit the newly created Profile.
+
### Care portal
diff --git a/docs/EN/DailyLifeWithAaps/KeyAapsFeatures.md b/docs/EN/DailyLifeWithAaps/KeyAapsFeatures.md
index 08b79286d2be..0cdefc80acb0 100644
--- a/docs/EN/DailyLifeWithAaps/KeyAapsFeatures.md
+++ b/docs/EN/DailyLifeWithAaps/KeyAapsFeatures.md
@@ -2,49 +2,63 @@
(Open-APS-features-autosens)=
## Autosens
-* Autosens is a algorithm which looks at blood glucose deviations (positive/negative/neutral).
+* Autosens is an algorithm which looks at blood glucose deviations (positive/negative/neutral).
* It will try and figure out how sensitive/resistant you are based on these deviations.
* The oref implementation in **OpenAPS** runs off a combination of 24 and 8 hours worth of data. It uses either one which is more sensitive.
-* In versions prior to AAPS 2.7 user had to choose between 8 or 24 hours manually.
-* From AAPS 2.7 on Autosens in AAPS will switch between a 24 and 8 hours window for calculating sensitivity. It will pick which ever one is more sensitive.
+* In versions prior to **AAPS 2.7**, the user had to choose between 8 or 24 hours manually.
+* From **AAPS 2.7** on Autosens in **AAPS** will switch between a 24 and 8 hours window for calculating sensitivity. It will pick whichever one is more sensitive.
* If users have come from oref1 they will probably notice the system may be less dynamic to changes, due to the varying of either 24 or 8 hours of sensitivity.
* Changing a cannula or changing a profile will reset Autosens ratio back to 100% (a percentual profile switch with duration won't reset autosens).
* Autosens adjusts your basal and ISF (i.e.: mimicking what a Profile shift does).
-* If continuously eating carbs over an extended period, autosens will be less effective during that period as carbs are excluded from BG delta calculations.
+* If continuously eating carbs over an extended period, Autosens will be less effective during that period as carbs are excluded from **BG** delta calculations.
(Open-APS-features-super-micro-bolus-smb)=
## Super Micro Bolus (SMB)
-SMB, the shortform of 'super micro bolus', is the latest OpenAPS feature (from 2018) within the Oref1 algorithm. In contrast to AMA, SMB does not use temporary basal rates to control glucose levels, but mainly **small super microboluses**. In situations where AMA would add 1.0 IU insulin using a temporary basal rate, SMB delivers several super microboluses in small steps at **5 minute intervals**, e.g. 0.4 IU, 0.3 IU, 0.2 IU and 0.1 IU. At the same time (for safety reasons) the actual basal rate is set to 0 IU/h for a certain period to prevent overdose (**'zero-temping'**). This allows the system adjust the blood glucose faster than with the temporary basal rate increase in AMA.
+**SMB**, the shortform of **Super micro bolus**, is an OpenAPS feature introduced from 2018 onwards, within the Oref1 algorithm. In contrast to **AMA**, **SMB** does not use temporary basal rates to control glucose levels, but mainly **small super micro boluses**. In situations where **AMA** would add 1.0 IU insulin using a temporary basal rate, **SMB** delivers several super micro boluses in small steps at **5 minute intervals**, e.g. 0.4 IU, 0.3 IU, 0.2 IU and 0.1 IU. At the same time (for safety reasons) the actual basal rate is set to 0 IU/h for a certain period to prevent overdose (**'zero-temping'**). This allows the system to adjust the blood glucose faster than with the temporary basal rate increase in **AMA**.
-Thanks to SMB, it may be sufficient for meals containing only "slow" carbs to inform the system of the planned amount of carbohydrate and leave the rest to AAPS. However, this may lead to higher postprandial (post-meal) peaks because pre-bolusing isn’t possible. Or you can give, if necessary with pre-bolusing, a **start bolus**, which **only partly** covers the carbohydrates (e.g. 2/3 of the estimated amount) and let SMB provide the rest.
+Thanks to SMB, it may be sufficient for meals containing only "slow" carbs to inform the system of the planned amount of carbohydrate and leave the rest to **AAPS**. However, this may lead to higher postprandial (post-meal) peaks because pre-bolusing isn’t possible. Or you can give, if necessary with pre-bolusing, a **start bolus**, which **only partly** covers the carbohydrates (e.g. 2/3 of the estimated amount) and let **SMB** deliver the rest of the insulin.
-The SMB feature contains some safety mechanisms:
+
-1. The largest single SMB dose can only be the smallest value off:
+SMBs are shown on the main graph with blue triangles. Tap on the triangle to see how much insulin was delivered, or use the [Treatments tab](#aaps-screens-treatments).
+
+**SMB's** features contain some safety mechanisms:
+
+1. **Largest single SMB dose**
+The largest single SMB dose can only be the smallest value of:
* value corresponding to the current basal rate (as adjusted by autosens) for the duration set in "Max minutes of basal to limit SMB to", e.g. basal quantity for the next 30 minutes, or
* half the amount of insulin currently required, or
* the remaining portion of your maxIOB value in the settings.
-2. Probably you will often notice low temporary basal rates (called 'low temps') or temporary basal rates at 0 U/h (called 'zero-temps'). This is by design for safety reasons and has no negative effects if the profile is set correctly. The IOB curve is more meaningful than the course of the temporary basal rates.
+2. **Low temp basal rates**
+Low temporary basal rates (called 'low temps') or temporary basal rates at 0 U/h (called 'zero-temps') are activated more in **SMB**. This is by design for safety reasons and has no negative effects if the **Profile** is set correctly. On the main graph, the IOB curve (yellow thin line) is more meaningful than the course of the temporary basal rates.
-3. Additional calculations to predict the course of glucose, e.g. by UAM (un-announced meals). Even without manual carbohydrate input from the user, UAM can automatically detect a significant increase in glucose levels due to meals, adrenaline or other influences and try to adjust this with SMB. To be on the safe side this also works the other way round and can stop the SMB earlier if an unexpectedly rapid drop in glucose occurs. That's why UAM should always be active at SMB.
+3. **Un-Announced Meals**
+Additional calculations to predict the course of glucose, e.g. by **UAM** (un-announced meals). Even without manual carbohydrate input from the user, **UAM** can automatically detect a significant increase in glucose levels due to meals, adrenaline or other influences and try to adjust this with **SMB**. To be on the safe side this also works the other way round and can stop the SMB earlier if an unexpectedly rapid drop in glucose occurs. That's why UAM should always be active at SMB.
**You must have started [objective 9](#objectives-objective9) to use SMB.**
-See also: [OpenAPS documentation for oref1 SMB](https://openaps.readthedocs.io/en/latest/docs/Customize-Iterate/oref1.html) and [Tim's info on SMB](https://www.diabettech.com/artificial-pancreas/understanding-smb-and-oref1/).
+See also :
+* [OpenAPS documentation for SMB](https://openaps.readthedocs.io/en/latest/docs/Customize-Iterate/oref1.html#understanding-super-micro-bolus-smb).
+* [OpenAPS documentation for oref1 SMB](https://openaps.readthedocs.io/en/latest/docs/Customize-Iterate/oref1.html)
+* [Tim's info on SMB](https://www.diabettech.com/artificial-pancreas/understanding-smb-and-oref1/).
+
+The settings for OpenAPS SMB are described below.
(Open-APS-features-max-u-h-a-temp-basal-can-be-set-to)=
-### Max U/h a temp basal can be set to (OpenAPS “max-basal”)
-This safety setting determines the maximum temporary basal rate the insulin pump may deliver. The value should be the same in the pump and in AAPS and should be at least 3 times the highest single basal rate set.
+### Max U/h a temp basal can be set to
-Example:
+This safety setting determines the maximum temporary basal rate the insulin pump may deliver. It is also known as **max-basal**.
-Your basal profile’s highest basal rate during the day is 1.00 U/h. Then a max-basal value of at least 3 U/h is recommended.
+The value is measured in units per hour (U/h). It is advised to set this to something sensible.
+A good recommendation for setting this parameter is:
-AAPS limits the value as a 'hard limit' according to the patients age you have selected under settings.
+ max-basal = highest basal rate x 4
-AAPS limits the value as follows:
+For example, if the highest basal rate in your profile was 0.5 U/h you could multiply that by 4 to get a value of 2 U/h.
+
+**AAPS** limits this value as a 'hard limit' according to [Preferences > Treatments safety > Patient Type](#preferences-patient-type). The hard limits are as follows:
* Child: 2
* Teenager: 5
@@ -55,14 +69,19 @@ AAPS limits the value as follows:
*See also [overview of hard-coded limits](#overview-of-hard-coded-limits).*
(Open-APS-features-maximum-total-iob-openaps-cant-go-over)=
-### Maximum total IOB OpenAPS can’t go over (OpenAPS "max-iob")
-This value determines the maxIOB that AAPS will remain under while running in closed loop mode. If the current IOB (e.g. after a meal bolus) is above the defined value, the loop stops dosing insulin until the IOB limit is below the given value.
+### Maximum total IOB OpenAPS can’t go over
+
+This value determines the maximum **Insulin on Board** (basal and bolus IOB) that **AAPS** will remain under while running in closed loop mode. It is also known as **maxIOB**.
+
+If the current IOB (e.g. after a meal bolus) is above the defined value, the loop stops dosing insulin until the IOB limit is below the given value.
-Using the OpenAPS SMB, max-IOB is calculated differently than in OpenAPS AMA. In AMA, maxIOB was just a safety-parameter for basal IOB, while in SMB-mode, it also includes bolus IOB. A good start is
+A good start for setting this parameter is:
maxIOB = average mealbolus + 3x max daily basal
-Be careful and patient and only change the settings step by step. It is different for everyone and can also depend on the average total daily dose (TDD). For safety reason, there is a limit, which depends on the patient age. The 'hard limit' for maxIOB is higher than in [AMA](#max-uh-a-temp-basal-can-be-set-to-openaps-max-basal).
+Be careful and patient when adjusting your **max-IOB**. It is different for everyone and can also depend on the average total daily dose (TDD).
+
+**AAPS** limits this value as a 'hard limit' according to [Preferences > Treatments safety > Patient Type](#preferences-patient-type). The hard limits are as follows:
* Child: 3
* Teenager: 7
@@ -72,42 +91,50 @@ Be careful and patient and only change the settings step by step. It is differen
*See also [overview of hard-coded limits](#overview-of-hard-coded-limits).*
+Note : When using **SMB**, the **max-IOB** is calculated differently than in AMA. In **AMA**, maxIOB is a safety-parameter for basal **IOB**, while in SMB-mode, it also includes bolus IOB.
+
See also [OpenAPS documentation for SMB](https://openaps.readthedocs.io/en/latest/docs/Customize-Iterate/oref1.html#understanding-super-micro-bolus-smb).
-### Enable AMA Autosens
-Here, you can choose if you want to use the [sensitivity detection](../DailyLifeWithAaps/SensitivityDetectionAndCob.md) 'autosens' or not.
+### Enable Autosens
+
+[Autosens](#autosens) looks at blood glucose deviations (positive/negative/neutral). It will try and figure out how sensitive/resistant you are based on these deviations and adjust basal rate and ISF based on these deviations.
-(Open-APS-features-enable-smb)=
### Enable SMB
-Enable this to use SMB functionality. If disabled, no SMBs will be given.
+Enable this to use SMB functionality. If disabled, no **SMBs** will be given.
(Open-APS-features-enable-smb-with-high-temp-targets)=
### Enable SMB with high temp targets
-If this setting is enabled, SMB will be allowed, but not necessarily enabled, when there is a high temporary target active (defined as anything above 100mg/dl regardless of profile target). This option is intended to be used to disable SMBs when the setting is disabled. For example, if this option is disabled, SMBs can be disabled by setting a temp target above 100mg/dl. This option will also disable SMB regardless of what other condition is trying to enable SMB.
-If this setting is enabled, SMB will only be enabled with a high temp target if Enable SMB with temp targets is also enabled.
+If this setting is enabled, **SMBs** will still be delivered even if the user has selected a high **Temp Target** (defined as anything above 100mg/dL or 5.6mmol/l, regardless of **Profile** target). This option is intended to be used to disable SMBs when the setting is disabled. For example, if this option is disabled, **SMBs** can be disabled by setting a **Temp Target** above 100mg/dL or 5.6mmol/l. This option will also disable **SMBs** regardless of what other condition is trying to enable SMB.
+
+If this setting is enabled, **SMB** will only be enabled with a high temp target if **Enable SMB with temp targets** is also enabled.
(Open-APS-features-enable-smb-always)=
### Enable SMB always
-If this setting is enabled, SMB is enabled always (independent of COB, temp targets or boluses). If this setting is enabled, the rest of the enable settings below will have no effect. However, if “Enable SMB with high temp targets” is disabled and a high temp target is set SMBs will be disabled.
-For safety reasons, this option is only available for BG sources with a good filtering system for noisy data. Currently it is only an available option with a Dexcom G5 or G6, if using the ['Build your own Dexcom App'](#DexcomG6-if-using-g6-with-build-your-own-dexcom-app) or “native mode” in xDrip+. If a BG value has too large of a deviation, the G5/G6 doesn’t send it and waits for the next value in 5 minutes.
+If this setting is enabled, SMB is enabled always enabled(independent of COB, temp targets or boluses). If this setting is enabled, the rest of the enable settings below will have no effect. However, if **Enable SMB with high temp targets** is disabled and a high temp target is set, SMBs will be disabled.
-For other CGM/FGM like Freestyle Libre, ‘SMB always’ is deactivated until xDrip+ has a better noise smoothing plugin. You can find more [here](../CompatibleCgms/SmoothingBloodGlucoseData.md).
+For safety reasons, this option is only available for BG sources with a good filtering system for noisy data.
+* Currently, it is only available with a Dexcom G5 or G6, if using the [Build your own Dexcom App](#DexcomG6-if-using-g6-with-build-your-own-dexcom-app) or “[native mode](#smoothing-xdrip-dexcom-g6)” in xDrip+. If a BG value has too large of a deviation, the G5/G6 doesn’t send it and waits for the next value 5 minutes later.
+* For other CGM/FGM like Freestyle Libre, **SMB always** is deactivated until there is a better noise smoothing plugin.
+* You can find more [here](../CompatibleCgms/SmoothingBloodGlucoseData.md).
### Enable SMB with COB
If this setting is enabled, SMB is enabled when the COB is greater than 0.
### Enable SMB with temp targets
-If this setting is enabled, SMB is enabled when there is any temp target set (eating soon, activity, hypo, custom). If this setting is enabled but "Enable SMB with high temp targets" is disabled, SMB will be enabled when a low temp target is set (below 100mg/dl) but disabled when a high temp target is set.
+If this setting is enabled, SMB is enabled when there is any temp target set (eating soon, activity, hypo, custom). If this setting is enabled but **Enable SMB with high temp targets** is disabled, SMB will be enabled when a low temp target is set (below 100mg/dL or 5.6mmol/l) but disabled when a high temp target is set.
### Enable SMB after carbs
-If enabled, SMB is enabled for 6h after carbohydrates are announced, even if COB has reached 0. For safety reasons, this option is only available for BG sources with a nice filtering system for noisy data. Currently it is only an available option with a Dexcom G5 or G6 if using the ['Build your own Dexcom App'](#DexcomG6-if-using-g6-with-build-your-own-dexcom-app) or “native mode” in xDrip+. If a BG value has too large of a deviation, the G5/G6 doesn’t send it and waits for the next value in 5 minutes.
+If enabled, SMB is enabled for 6h after carbohydrates are announced, even if COB has reached 0.
-For other CGM/FGM like Freestyle Libre, 'Enable SMB after carbs' is deactivated until xDrip+ has a better noise smoothing plugin. You can find [more information here](../CompatibleCgms/SmoothingBloodGlucoseData.md).
+For safety reasons, this option is only available for BG sources with a good filtering system for noisy data.
+* Currently, it is only available with a Dexcom G5 or G6, if using the [Build your own Dexcom App](#DexcomG6-if-using-g6-with-build-your-own-dexcom-app) or “[native mode](#smoothing-xdrip-dexcom-g6)” in xDrip+. If a BG value has too large of a deviation, the G5/G6 doesn’t send it and waits for the next value 5 minutes later.
+* For other CGM/FGM like Freestyle Libre, **SMB always** is deactivated until there is a better noise smoothing plugin.
+* You can find more [here](../CompatibleCgms/SmoothingBloodGlucoseData.md).
### How frequently SMBs will be given in min
This feature limits the frequency of SMBs. This value determines the minimum time between SMBs.
-Note that the loop runs every time a glucose value comes in (generally 5 minutes). Subtract 2 minute to give loop additional time to complete. E.g if you want SMB to be given every loop run, set this to 3 minutes.
+Note that the loop runs every time a glucose value comes in (generally 5 minutes). Subtract 2 minute to give loop additional time to complete. E.g. if you want SMB to be given every loop run, set this to 3 minutes.
Default value: 3 min.
@@ -122,31 +149,49 @@ It is recommended not to set the value higher than 90 minutes, as this would lea
Default value: 30 min.
### Enable UAM
-With this option enabled, the SMB algorithm can recognize unannounced meals. This is helpful if you forget to tell AAPS about your carbs or estimate your carbs wrong and the amount of entered carbs is wrong or if a meal with lots of fat and protein has a longer duration than expected. Without any carb entry, UAM can recognize fast glucose increasements caused by carbs, adrenaline, etc., and tries to adjust it with SMBs. This also works the opposite way: if there is a fast glucose decrease, it can stop SMBs earlier.
+With this option enabled, the SMB algorithm can recognize unannounced meals. This is helpful if you forget to tell **AAPS** about your carbs or estimate your carbs wrong and the amount of entered carbs is wrong or if a meal with lots of fat and protein has a longer duration than expected. Without any carb entry, UAM can recognize fast glucose increase caused by carbs, adrenaline, etc., and tries to adjust it with SMBs. This also works the opposite way: if there is a fast glucose decrease, it can stop SMBs earlier.
**Therefore, UAM should always be activated when using SMB.**
### Sensitivity raises target
If this option is enabled, the sensitivity detection (autosens) can raise the target when sensitivity is detected (below 100%). In this case your target will be raised by the percentage of the detected sensitivity.
+If the target is modified due to sensitivity detection, it will be displayed with a green background on your home screen.
+
+
+
### Resistance lowers target
If this option is enabled, the sensitivity detection (autosens) can lower the target when resistance is detected (above 100%). In this case your target will be lowered by the percentage of the detected resistance.
### High temp-target raises sensitivity
-If you have this option enabled, the insulin sensitivity will be increased while having a temporary target above 100 mg/dl or 5.6 mmol/l. This means, the ISF will rise while IC and basal will decrease. This will effectively make AAPS less aggressive when you set a high temp target.
+If you have this option enabled, the insulin sensitivity will be increased while having a temporary target above 100 mg/dl or 5.6 mmol/l. This means, the ISF will rise while IC and basal will decrease. This will effectively make **AAPS** less aggressive when you set a high temp target.
### Low temp-target lowers sensitivity
-If you have this option enabled, the insulin sensitivity will be decreased while having a temporary target lower than 100 mg/dl or 5.6 mmol/l. This means, the ISF will decrease while IC and basal will rise. This will effectively make AAPS more aggressive when you set a low temp target.
+If you have this option enabled, the insulin sensitivity will be decreased while having a temporary target lower than 100 mg/dl or 5.6 mmol/l. This means, the ISF will decrease while IC and basal will rise. This will effectively make **AAPS** more aggressive when you set a low temp target.
+
+(key-aaps-features-minimal-carbs-required-for-suggestion)=
+### Minimal carbs required for suggestion
+
+Minimum grams of carbs to display a carbs suggestion alert.
+Eating of additional carbs will be suggested when the reference design detects that it requires carbs. In this case you will receive a notification which can be snoozed for 5, 15 or 30 minutes.
+
+Carb required notifications can be pushed to Nightscout if wished, in which case an announcement will be shown and broadcast.
+
+In any case, the required carbs will be displayed in the COB section on your home screen.
+
+
### Advanced Settings
-**Always use short average delta instead of simple data** If you enable this feature, AAPS uses the short average delta/blood glucose from the last 15 minutes, which is usually the average of the last three values. This helps AAPS to be steadier with noisy data sources like xDrip+ and Libre.
+You can read more here : [OpenAPS docs](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/preferences-and-safety-settings.html).
-**Max daily safety multiplier** This is an important safety limit. The default setting (which is unlikely to need adjusting) is 3. This means that AAPS will never be allowed to set a temporary basal rate that is more than 3x the highest hourly basal rate programmed in a user’s pump and/or profile. Example: if your highest basal rate is 1.0 U/h and max daily safety multiplier is 3, then AAPS can set a maximum temporary basal rate of 3.0 U/h (= 3 x 1.0 U/h).
+**Always use short average delta instead of simple data** If you enable this feature, **AAPS** uses the short average delta/blood glucose from the last 15 minutes, which is usually the average of the last three values. This helps **AAPS** to be steadier with noisy data sources like xDrip+ and Libre.
+
+**Max daily safety multiplier** This is an important safety limit. The default setting (which is unlikely to need adjusting) is 3. This means that **AAPS** will never be allowed to set a temporary basal rate that is more than 3x the highest hourly basal rate programmed in a user’s pump and/or profile. Example: if your highest basal rate is 1.0 U/h and max daily safety multiplier is 3, then **AAPS** can set a maximum temporary basal rate of 3.0 U/h (= 3 x 1.0 U/h).
Default value: 3 (shouldn’t be changed unless you really need to and know what you are doing)
-**Current Basal safety multiplier** This is another important safety limit. The default setting (which is also unlikely to need adjusting) is 4. This means that AAPS will never be allowed to set a temporary basal rate that is more than 4x the current hourly basal rate programmed in a user’s pump and/or profile.
+**Current Basal safety multiplier** This is another important safety limit. The default setting (which is also unlikely to need adjusting) is 4. This means that **AAPS** will never be allowed to set a temporary basal rate that is more than 4x the current hourly basal rate programmed in a user’s pump and/or profile.
Default value: 4 (shouldn’t be changed unless you really need to and know what you are doing)
@@ -158,13 +203,12 @@ AMA, the short form of "advanced meal assist" is an OpenAPS feature from 2017 (o
You can find more information in the [OpenAPS documentation](https://newer-docs.readthedocs.io/en/latest/docs/walkthrough/phase-4/advanced-features.html#advanced-meal-assist-or-ama).
-(Open-APS-features-max-u-hr-a-temp-basal-can-be-set-to-openaps-max-basal)=
### Max U/hr a Temp Basal can be set to (OpenAPS "max-basal")
-This safety setting helps AAPS from ever being capable of giving a dangerously high basal rate and limits the temp basal rate to x U/h. It is advised to set this to something sensible. A good recommendation is to take the highest basal rate in your profile and multiply it by 4 and at least 3. For example, if the highest basal rate in your profile is 1.0 U/h you could multiply that by 4 to get a value of 4 U/h and set the 4 as your safety parameter.
+This safety setting helps **AAPS** from ever being capable of giving a dangerously high basal rate and limits the temp basal rate to x U/h. It is advised to set this to something sensible. A good recommendation is to take the highest basal rate in your profile and multiply it by 4 and at least 3. For example, if the highest basal rate in your profile is 1.0 U/h you could multiply that by 4 to get a value of 4 U/h and set the 4 as your safety parameter.
-You cannot chose any value: For safety reason, there is a 'hard limit', which depends on the patient age. The 'hard limit' for maxIOB is lower in AMA than in SMB. For children, the value is the lowest while for insulin resistant adults, it is the biggest.
+You cannot choose any value: For safety reason, there is a 'hard limit', which depends on the patient age. The 'hard limit' for maxIOB is lower in AMA than in SMB. For children, the value is the lowest while for insulin resistant adults, it is the biggest.
-The hardcoded parameters in AAPS are:
+The hardcoded parameters in **AAPS** are:
* Child: 2
* Teenager: 5
@@ -175,9 +219,9 @@ The hardcoded parameters in AAPS are:
*See also [overview of hard-coded limits](#overview-of-hard-coded-limits).*
### Maximum basal IOB OpenAPS can deliver [U] (OpenAPS "max-iob")
-This parameter limits the maximum of basal IOB where AAPS still works. If the IOB is higher, it stops giving additional basal insulin until the basal IOB is under the limit.
+This parameter limits the maximum of basal IOB where **AAPS** still works. If the IOB is higher, it stops giving additional basal insulin until the basal IOB is under the limit.
-The default value is 2, but you should be rise this parameter slowly to see how much it affects you and which value fits best. It is different for anyone and also depends on the average total daily dose (TDD). For safety reason, there is a limit, which depends on the patient age . The 'hard limit' for maxIOB is lower in AMA than in SMB.
+The default value is 2, but you should rise this parameter slowly to see how much it affects you and which value fits best. It is different for anyone and also depends on the average total daily dose (TDD). For safety reason, there is a limit, which depends on the patient age . The 'hard limit' for maxIOB is lower in AMA than in SMB.
* Child: 3
* Teenager: 5
@@ -188,109 +232,43 @@ The default value is 2, but you should be rise this parameter slowly to see how
*See also [overview of hard-coded limits](#overview-of-hard-coded-limits).*
### Enable AMA Autosens
-Here, you can chose, if you want to use the [sensitivity detection](../DailyLifeWithAaps/SensitivityDetectionAndCob.md) autosens or not.
+Here, you can choose, if you want to use the [sensitivity detection](../DailyLifeWithAaps/SensitivityDetectionAndCob.md) autosens or not.
### Autosens adjust temp targets too
-If you have this option enabled, autosens can adjust targets (next to basal and ISF), too. This lets AAPS work more 'aggressive' or not. The actual target might be reached faster with this.
+If you have this option enabled, autosens can adjust targets (next to basal and ISF), too. This lets **AAPS** work more 'aggressive' or not. The actual target might be reached faster with this.
### Advanced Settings
-**Always use short average delta instead of simple data** If you enable this feature, AAPS uses the short average delta/blood glucose from the last 15 minutes, which is usually the average of the last three values. This helps AAPS to work more steady with noisy data sources like xDrip+ and Libre.
+- Normally you do not have to change the settings in this dialogue!
+- If you want to change them anyway make sure to read about details in [OpenAPS docs](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/preferences-and-safety-settings.html#) and to understand what you are doing.
-**Max daily safety multiplier** This is an important safety limit. The default setting (which is unlikely to need adjusting) is 3. This means that AAPS will never be allowed to set a temporary basal rate that is more than 3x the highest hourly basal rate programmed in a user’s pump. Example: if your highest basal rate is 1.0 U/h and max daily safety multiplier is 3, then AAPS can set a maximum temporary basal rate of 3.0 U/h (= 3 x 1.0 U/h).
+**Always use short average delta instead of simple data** If you enable this feature, **AAPS** uses the short average delta/blood glucose from the last 15 minutes, which is usually the average of the last three values. This helps **AAPS** to work more steady with noisy data sources like xDrip+ and Libre.
-Default value: 3 (shouldn’t be changed unless you really need to and know, what you are doing)
+**Max daily safety multiplier** This is an important safety limit. The default setting (which is unlikely to need adjusting) is 3. This means that **AAPS** will never be allowed to set a temporary basal rate that is more than 3x the highest hourly basal rate programmed in a user’s pump. Example: if your highest basal rate is 1.0 U/h and max daily safety multiplier is 3, then **AAPS** can set a maximum temporary basal rate of 3.0 U/h (= 3 x 1.0 U/h).
-**Current Basal safety multiplier** This is another important safety limit. The default setting (which is also unlikely to need adjusting) is 4. This means that AAPS will never be allowed to set a temporary basal rate that is more than 4x the current hourly basal rate programmed in a user’s pump.
+Default value: 3 (shouldn’t be changed unless you really need to and know what you are doing)
-Default value: 4 (shouldn’t be changed unless you really need to and know, what you are doing)
+**Current Basal safety multiplier** This is another important safety limit. The default setting (which is also unlikely to need adjusting) is 4. This means that **AAPS** will never be allowed to set a temporary basal rate that is more than 4x the current hourly basal rate programmed in a user’s pump.
+
+Default value: 4 (shouldn’t be changed unless you really need to and know what you are doing)
**Bolus snooze dia divisor**
-The feature “bolus snooze” works after a meal bolus. AAPS doesn’t set low temporary basal rates after a meal in the period of the DIA divided by the “bolus snooze”-parameter. The default value is 2. That means with a DIA of 5h, the “bolus snooze” would be 5h : 2 = 2.5h long.
+The feature “bolus snooze” works after a meal bolus. **AAPS** doesn’t set low temporary basal rates after a meal in the period of the DIA divided by the “bolus snooze”-parameter. The default value is 2. That means with a DIA of 5h, the “bolus snooze” would be 5h : 2 = 2.5h long.
Default value: 2
***
-
(Open-APS-features-overview-of-hard-coded-limits)=
## Overview of hard-coded limits
-
-
-
- |
- Child |
- Teenager |
- Adult |
- Insulin resistant adult |
- Pregnant |
-
-
-
-
- | MAXBOLUS |
- 5,0 |
- 10,0 |
- 17,0 |
- 25,0 |
- 60,0 |
-
-
- | MINDIA |
- 5,0 |
- 5,0 |
- 5,0 |
- 5,0 |
- 5,0 |
-
-
- | MAXDIA |
- 9,0 |
- 9,0 |
- 9,0 |
- 9,0 |
- 10,0 |
-
-
- | MINIC |
- 2,0 |
- 2,0 |
- 2,0 |
- 2,0 |
- 0,3 |
-
-
- | MAXIC |
- 100,0 |
- 100,0 |
- 100,0 |
- 100,0 |
- 100,0 |
-
-
- | MAXIOB_AMA |
- 3,0 |
- 5,0 |
- 7,0 |
- 12,0 |
- 25,0 |
-
-
- | MAXIOB_SMB |
- 7,0 |
- 13,0 |
- 22,0 |
- 30,0 |
- 70,0 |
-
-
- | MAXBASAL |
- 2,0 |
- 5,0 |
- 10,0 |
- 12,0 |
- 25,0 |
-
-
-
+| | Child | Teenager | Adult | Insulin resistant adult | Pregnant |
+|------------|-------|----------|-------|-------------------------|----------|
+| MAXBOLUS | 5,0 | 10,0 | 17,0 | 25,0 | 60,0 |
+| MINDIA | 5,0 | 5,0 | 5,0 | 5,0 | 5,0 |
+| MAXDIA | 9,0 | 9,0 | 9,0 | 9,0 | 10,0 |
+| MINIC | 2,0 | 2,0 | 2,0 | 2,0 | 0,3 |
+| MAXIC | 100,0 | 100,0 | 100,0 | 100,0 | 100,0 |
+| MAXIOB_AMA | 3,0 | 5,0 | 7,0 | 12,0 | 25,0 |
+| MAXIOB_SMB | 7,0 | 13,0 | 22,0 | 30,0 | 70,0 |
+| MAXBASAL | 2,0 | 5,0 | 10,0 | 12,0 | 25,0 |
\ No newline at end of file
diff --git a/docs/EN/DailyLifeWithAaps/ProfileSwitch-ProfilePercentage.md b/docs/EN/DailyLifeWithAaps/ProfileSwitch-ProfilePercentage.md
index 6b931031341c..7e3d62cbc04c 100644
--- a/docs/EN/DailyLifeWithAaps/ProfileSwitch-ProfilePercentage.md
+++ b/docs/EN/DailyLifeWithAaps/ProfileSwitch-ProfilePercentage.md
@@ -97,3 +97,8 @@ It is always a question of which hour’s **Profile’s** settings should replac
This mechanism of taking snapshots of the **Profile** allows a much more precise calculation of the past and the possibility to track **Profile** changes.
+## Keep a profile switch for later use
+
+Once you have performed a profile switch with percentage and/or timeshift, you can make a copy of this temporary profile into a new profile.
+
+To do this, go to the tab [Treatments > Profile Switch](#aaps-screens-clone-profile-switch).
\ No newline at end of file
diff --git a/docs/EN/DailyLifeWithAaps/TempTargets.md b/docs/EN/DailyLifeWithAaps/TempTargets.md
index c17a0d7485ea..2ce09cab5cef 100644
--- a/docs/EN/DailyLifeWithAaps/TempTargets.md
+++ b/docs/EN/DailyLifeWithAaps/TempTargets.md
@@ -74,7 +74,7 @@ In closed loop mode, **SMB**:
- *may be* deactivated (discussed further below); and/or
- basal may be activated if **AAPS** is in negative **IOB** or <0.
-
+(TempTargets-where-can-i-select-a-temp-target)=
## Where can I select a Temp-Target?
In the **Actions** tab in **AAPS**.
@@ -87,6 +87,10 @@ Or clicking on the "**BG Target**" located in the top right corner of **AAPS**.
+- Press long on your target in the top right corner on the home screen or use the shortcuts in the orange “Carbs” button at the bottom.
+
+
+
## Where can I change the default Temp-Target and override with my own preferences?
To reconfigure the ‘BG target range’ and ‘duration’ allocated to the user’s default **Temp-Target** settings, go to the menu in **AAPS** on the top right hand corner and
diff --git a/docs/EN/Getting-Started/CompatiblesCgms.md b/docs/EN/Getting-Started/CompatiblesCgms.md
index 6d86bd3ff95b..5e7da660a493 100644
--- a/docs/EN/Getting-Started/CompatiblesCgms.md
+++ b/docs/EN/Getting-Started/CompatiblesCgms.md
@@ -1,18 +1,22 @@
-# CGMS/FGMS Configuration
+# CGMs/FGMs Configuration
-This is just a short overview of all compatible CGMs/FGMs with **AAPS**.
-Just a short hint: if you can display your glucose data in xDrip+ app or Nightscout website, you can choose xDrip+ (or Nightscout with web connection) as BG source in **AAPS**.
+This section provides a brief overview of all compatible **CGMs/FGMs** with **AAPS**.
-* [General](../CompatibleCgms/GeneralCGMRecommendation.md)
+*Tip*: If you can display your glucose data in xDrip+ app, you can choose xDrip+ as **BG** source in **AAPS**.
+
+* [General recommendations](../CompatibleCgms/GeneralCGMRecommendation.md)
* [Data Smoothing](../CompatibleCgms/SmoothingBloodGlucoseData.md)
* [xDrip+Settings](../CompatibleCgms/xDrip.md)
-* [Dexcom G7 and ONE+](../CompatibleCgms/DexcomG7.md): Works with xDrip+ or patched Dexcom app
-* [Dexcom G6 and ONE](../CompatibleCgms/DexcomG6.md): Works with BYODA or xDrip+
-* [Dexcom G5](../CompatibleCgms/DexcomG5.md): Works with xDrip+ or patched Dexcom app
-* [Libre 3](../CompatibleCgms/Libre3.md): Works with xDrip+ (no transmitter needed)
-* [Libre 2](../CompatibleCgms/Libre2.md): Works with xDrip+ (no transmitter needed)
-* [Libre 1](../CompatibleCgms/Libre1.md): You need a transmitter like Bluecon or MiaoMiao for it (build or buy) and xDrip+ app
-* [Eversense](../CompatibleCgms/Eversense.md): It works so far only in combination with ESEL app and a patched Eversense-App (works not with Dana RS and LineageOS, but DanaRS and Android or Combo and Lineage OS work fine)
-* [Enlite (MM640G/MM630G)](../CompatibleCgms/MM640g.md): quite complicated with a lot of extra stuff
-* [PocTech](../CompatibleCgms/PocTech.md)
-* [Nightscout as BG Source](../CompatibleCgms/CgmNightscoutUpload.md)
\ No newline at end of file
+* [Nightscout as BG Source](../CompatibleCgms/CgmNightscoutUpload.md): While it's possible to use Nightscout as a BG source for closed-loop insulin delivery, **this method is not recommended** due to its reliance on stable mobile data or Wi-Fi connectivity. This means your **CGM** data would only be received by **AAPS** when you have an online connection to your Nightscout site. For a more reliable set up, using a CGM with local broadcast from the receiver (as listed below) to **AAPS**, is a much better option.
+
+| CGM | Available [BG Sources](../SettingUpAaps/ConfigBuilder.md#bg-source) |
+|-------------------------------------------------------|------------------------------------------------------------------------------|
+| [Dexcom G7 and ONE+](../CompatibleCgms/DexcomG7.md) | xDrip+ or DiaKEM app (select BYODA) |
+| [Dexcom G6 and ONE](../CompatibleCgms/DexcomG6.md) | xDrip+ or BYODA |
+| [Dexcom G5](../CompatibleCgms/DexcomG5.md) | xDrip+ |
+| [Libre 3](../CompatibleCgms/Libre3.md) | xDrip+ (no transmitter needed) |
+| [Libre 2](../CompatibleCgms/Libre2.md) | xDrip+ (no transmitter needed) |
+| [Libre 1](../CompatibleCgms/Libre1.md) | xDrip+, Glimp, Tomato or Diabox. Need a transmitter like Bluecon or MiaoMiao |
+| [Eversense](../CompatibleCgms/Eversense.md) | xDrip+ or ESEL/Eversense patched App + MM640g |
+| [Enlite (MM640G/MM630G)](../CompatibleCgms/MM640g.md) | xDrip+ or MM640g + 600SeriesAndroidUploader App |
+| [PocTech](../CompatibleCgms/PocTech.md) | PocTech |
\ No newline at end of file
diff --git a/docs/EN/Maintenance/DocumentationUpdate.md b/docs/EN/Maintenance/DocumentationUpdate.md
index 03b2010ecefd..1558dcd73809 100644
--- a/docs/EN/Maintenance/DocumentationUpdate.md
+++ b/docs/EN/Maintenance/DocumentationUpdate.md
@@ -2,11 +2,10 @@
## October 2024
-- [COB Calculation](../DailyLifeWithAaps/CobCalculation.md) @UnderCliffe10
+- Update of several pages:
+ - [How long will it take](#preparing-how-long-will-it-take), [Component Overview](../DailyLifeWithAaps/CobCalculation.md), [Completing the objectives](../SettingUpAaps/CompletingTheObjectives.md), [Your AAPS Profile](../SettingUpAaps/YourAapsProfile.md), [Config Builder](../SettingUpAaps/ConfigBuilder.md) & [Preferences](../SettingUpAaps/Preferences.md), [AAPS screens](../DailyLifeWithAaps/AapsScreens.md) @emilise
+ - [COB Calculation](../DailyLifeWithAaps/CobCalculation.md), [Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md) @UnderCliffe10
- [Building instructions for Android Studio Ladybug](../SettingUpAaps/BuildingAaps.md) @tanja
-- [How long will it take](#preparing-how-long-will-it-take) @emilise
-- [Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md) @UnderCliffe10
-- [Completing the objectives](../SettingUpAaps/CompletingTheObjectives.md) @emilise
- Technical work (deployment process for the documentation, files organisation...) @psonnerat & @emilise
***
@@ -20,7 +19,7 @@ Missing history from March 2022 to September 2024
- [BG quality warning sign](#aaps-screens-bg-warning-sign) @tanja
- [Medtronic pump update](../CompatiblePumps/MedtronicPump.md) @dottedfingertips
- [Necessary checks after update to AAPS 3.0](Update3_0.md) @tanja
-- [Omnipod Dash](../CompatiblePumps/OmnipodDASH.md) @Freloner @ robertrub @vanelsberg
+- [Omnipod Dash](../CompatiblePumps/OmnipodDASH.md) @Freloner @robertrub @vanelsberg
- Update docs for AAPS 3.0 (partly) @xJoe
- [Wear OS for AAPS 3.0](../UsefulLinks/WearOsSmartwatch.md) @peterleimbach
@@ -37,7 +36,7 @@ Missing history from March 2022 to September 2024
- Best practices for calibrating a [libre 2 sensor](#Libre2-best-practices-for-calibrating-a-libre-2-sensor)
- [ISF](../UsefulLinks/FAQ.md) reformulation of impact
-- Update [troubleshooting Android stduio](../GettingHelp/TroubleshootingAndroidStudio)
+- Update [troubleshooting Android studio](../GettingHelp/TroubleshootingAndroidStudio)
- Removed patched [Dexcom](../CompatibleCgms/DexcomG6.md) app as it is obsolete
## October 2021
diff --git a/docs/EN/Maintenance/ReleaseNotes.md b/docs/EN/Maintenance/ReleaseNotes.md
index 5bee5c22de41..51f196539430 100644
--- a/docs/EN/Maintenance/ReleaseNotes.md
+++ b/docs/EN/Maintenance/ReleaseNotes.md
@@ -376,7 +376,7 @@ You need at least start [objective 11 (in later versions objective 10!)](#object
- new [preferences layout](../SettingUpAaps/Preferences.md) @MilosKozak
- SMB algorithm update @Tornado-Tim
- [Low glucose suspend mode](#Preferences-aps-mode) @Tornado-Tim
-- [carbs required notifications](#Preferences-carb-required-notification) @twain47 @Tornado-Tim
+- [carbs required notifications](#key-aaps-features-minimal-carbs-required-for-suggestion) @twain47 @Tornado-Tim
- removed Careportal (moved to Actions) @MilosKozak
- [new encrypted backup format](ExportImportSettings.md) @dlvoy
- [new SMS TOTP authentication](../RemoteFeatures/SMSCommands.md) @dlvoy
diff --git a/docs/EN/Sandbox/sandbox1.md b/docs/EN/Sandbox/sandbox1.md
index 3456f9a30d5d..f2f0fc26b76b 100644
--- a/docs/EN/Sandbox/sandbox1.md
+++ b/docs/EN/Sandbox/sandbox1.md
@@ -63,4 +63,4 @@ Links with anchor :
- [Screenshot main graph](#aaps-screens-main-graph) to header level 3
- [OpenAPS-features](#Open-APS-features-max-u-h-a-temp-basal-can-be-set-to)
- [max IOB](#Open-APS-features-maximum-total-iob-openaps-cant-go-over)
-- [SMB section in this documentation](#Open-APS-features-super-micro-bolus-smb)
+- [SMB section in this documentation](#Open-APS-features-super-micro-bolus-smb)
\ No newline at end of file
diff --git a/docs/EN/SettingUpAaps/ChangeAapsConfiguration.md b/docs/EN/SettingUpAaps/ChangeAapsConfiguration.md
index da95e14b84dd..2df89eb7a5a6 100644
--- a/docs/EN/SettingUpAaps/ChangeAapsConfiguration.md
+++ b/docs/EN/SettingUpAaps/ChangeAapsConfiguration.md
@@ -1,40 +1,43 @@
-# Making changes to your AAPS configuration
+# Making changes to your AAPS' configuration
-After you have completed the **Setup Wizard** you don't need to run the entire Wizard again if you want to only change parts of the configuration.
+After you have completed the **[Setup Wizard](../SettingUpAaps/SetupWizard.md)**, you don't need to run the entire Wizard again if you want to only change parts of your **AAPS**' configuration.
-There are three routes to change the different configuration settings, which route you take is simply a matter of convenience, each route leads to the same configuration settings.
+There are three routes to change AAPS’ configuration. As to which route you take, it is simply a matter of convenience or personal preference as each route leads to the same configuration settings.
These are as follows:
1. Config builder,
-1. Three dot menu on the right and select "preferences" or
-1. Three dot menu on the right and select "plugin preferences".
+1. Three dot menu on the right and select "Preferences" or
+1. Three dot menu on the right and select "Plugin preferences".
Here we explain which option is most convenient for each situation:
## Config builder
-The **config builder** is used if you want to **enable plugins** and their **visibility** in the top level menu. If they are enabled, they will still run, you can decide if you want to be able to see them in the top menu or not.
+
-Plugins which you have not enabled (_i.e._ disabled) plugins can not be made visible. For example, when you first start with **AAPS** on **objective 1**, you cannot yet use **automations**, so the **automations** plugin cannot be enabled and made visible in the top menu.
+The **config builder** is used if you want to **enable plugins** and their **visibility** in the top level menu. Once enabled, the **plugins** will always run, and you can decide if you want to be able to see them in the top menu or not. Disabled plugins can not be made visible.
-**Config builder** is the easiest way to further modify your configuration after you have used the **Setup Wizard**.
+You can use the cogwheel next to each activated plugin to access its settings.
The documentation relating to the config builder is available [here](../SettingUpAaps/ConfigBuilder.md).
## Preferences
-The preferences dialogue can be reached via the top right three dot menu on the **home screen** of AAPS. It gives you the possibility to change the configuration of **all enabled plugins at once**.
+
-This is a good route if you are not really sure where to look for an configuration option, but it can be a bit tedious if you know you want to change the configuration for just one specific plugin.
+The **preferences** dialogue can be reached via the top right _three dots_ menu on any tab of **AAPS**. This allows to change the configuration of **all enabled plugins in a single place**.
-The documentation of the preferences is available [here](../SettingUpAaps/Preferences.md).
+This is a good route if you are not really sure where to look for a configuration option, but it can be a bit tedious if you know you want to change the configuration for just one specific plugin.
+The documentation of the preferences is available [here](../SettingUpAaps/Preferences.md).
## Plugin preferences
-The **plugin preferences** dialogue can be reached via the top right three dot menu on the home screen of AAPS. It provides the possibility to change the configuration of the plugin currently on screen.
+
+
+The **plugin preferences** dialogue can be reached via the top right _three dots_ menu on the home screen of **AAPS**. It allows to change the configuration of the **plugin currently on screen**.
-This is a good route if you know that _e.g._ you _just_ want to change the configuration for BYODA. Then, you would select the tab "BYODA" on the top menu of **AAPS**, and then once you are on the BYODA page, in the top right, select the three dot menu and then the "plugin preferences" entry. You are taken directly to the preferences dialogue specifically for the BYODA plugin.
+For example, this is a good route if you know that you want to change the configuration for BYODA. Then, you would select the tab "BYODA" on the top menu of **AAPS**, and then once you are on the BYODA page, in the top right, select the _three dots_ menu and then the "plugin preferences" entry. You are taken directly to the preferences dialogue specifically for the BYODA plugin.
-This is a "short cut" to the general preferences dialogue, the documentation of the preferences is available [here](../SettingUpAaps/Preferences.md).
+This is a "shortcut" to the general preferences dialogue, the documentation of the preferences is available [here](../SettingUpAaps/Preferences.md).
diff --git a/docs/EN/SettingUpAaps/CompletingTheObjectives.md b/docs/EN/SettingUpAaps/CompletingTheObjectives.md
index eaba66857bc2..c7d5c77b6f9b 100644
--- a/docs/EN/SettingUpAaps/CompletingTheObjectives.md
+++ b/docs/EN/SettingUpAaps/CompletingTheObjectives.md
@@ -105,14 +105,14 @@ Additionally, you can change the minimum percentage for recommended basal rate c
You don't need to action each and every system recommendation!
```
-
+(objectives-objective5)=
## Objective 5: Understanding your open loop, including its temp basal recommendations
As part of **Objective 5** you will start to understand how temporary basal recommendations are derived. This includes the [determination of basal logic](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/Understand-determine-basal.html), analyzing the impact by observing [prediction lines in **AAPS Overview**](#aaps-screens-prediction-lines) (or Nightscout) and looking at detailed calculations shown on your **OpenAPS** tab.
Estimated time to complete this objective: **7 days**.
-This **Objective** requires you to determine and set your “Max U/h a temp basal can be set to” (max-basal) value as described in [OpenAPS-features](#Open-APS-features-max-u-h-a-temp-basal-can-be-set-to). This value can be set in [Preferences > OpenAPS](#Preferences-max-u-h-a-temp-basal-can-be-set-to).
+This **Objective** requires you to determine and set your “Max U/h a temp basal can be set to” (max-basal) value as described in [OpenAPS-features](#Open-APS-features-max-u-h-a-temp-basal-can-be-set-to). This value can be set in **Preferences > OpenAPS**.
If you are still using a virtual pump, make sure this safety setting is set in both **AAPS** and your insulin pump.
You might wish to set your [**Profile** BG target](#profile-glucose-targets) higher than usual until you are comfortable with **AAPS**' calculations and settings. You may wish to experiment with adjusting your **BG target** in your **Profile** being in a tighter range (say, 1 or less mmol/l [20 mg/dl or less] wide) and observe the resulting behavior.
@@ -192,6 +192,8 @@ Minimal time to complete this objective: **7 days**. This is a mandatory wait ti
Enable [Autosens](../DailyLifeWithAaps/KeyAapsFeatures.md) over a period of 7 days and watch [**Overview**'s graph white line](#AapsScreens-section-g-additional-graphs) showing your insulin sensitivity rising or falling due to exercise or hormones etc. Keep an eye on the OpenAPS report tab which shows **AAPS** adjusting the sensitivity, basals and targets accordingly.
+This is a good time to review your settings for [Sensitivity Detection](../SettingUpAaps/ConfigBuilder.md#sensitivity-detection). You can view your sensitivity on the homescreen in an [additional graph](../DailyLifeWithAaps/AapsScreens.md#section-g---additional-graphs).
+
Additionally, you can use [Autotune](https://openaps.readthedocs.io/en/latest/docs/Customize-Iterate/autotune.html) as a one off to check your basals remain accurate or do a traditional basal test.
(objectives-objective9)=
diff --git a/docs/EN/SettingUpAaps/ConfigBuilder.md b/docs/EN/SettingUpAaps/ConfigBuilder.md
index 8843078c25f9..ad4659e10f6b 100644
--- a/docs/EN/SettingUpAaps/ConfigBuilder.md
+++ b/docs/EN/SettingUpAaps/ConfigBuilder.md
@@ -1,14 +1,12 @@
# Config Builder
-Depending on your settings you can open Config Builder through a tab at the top of the screen or through hamburger menu.
+Depending on your settings you can open Config Builder through a tab at the top of **AAPS**' screen or through the 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 AAPS. 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.
+The **Config Builder** is the tab where you turn the modular features on and off. In the picture below, the boxes on the left-hand side (A) allow you to select which modules you want activated, the boxes on the right-hand side (C) allow you to view these as a tab (E) in **AAPS**. 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. See [Tab or hamburger menu](#tab-or-hamburger-menu) below.
-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 AAPS. Push 3-dots-menu on the upper right-hand side of the screen (F) and select 'Setup Wizard' to use it.
+When 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.
@@ -19,85 +17,33 @@ With the checkbox under the eye symbol you can decide how to open the correspond
-(Config-Builder-profile)=
-## Profile
-* Select the basal profile you wish to use. See [Profiles](../DailyLifeWithAaps/ProfileSwitch-ProfilePercentage.md) page for more setup information.
-* As of AAPS 3.0, only the local profile is available.
-
-However, it is possible to synchronise a Nightscout profile into a local profile. To do this, however, it is important to clone the whole database record consisting of several profiles in the Nightscout editor. Please see the instructions below. This can be helpful if major changes to a more extensive profile can be entered more easily via the web interface, e.g. to manually copy data from a spreadsheet.
-
-(Config-Builder-local-profile)=
-### Local profile
-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](../Maintenance/ExportImportSettings.md). So make sure to have a backup in a safe place.
-
-
-
-Buttons:
-* 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 being 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.
-
-1. Click 3-dots-menu in upper right corner.
-2. Select 'Treatments'.
-3. Press star symbol to access profile switch page.
-4. Select the desired profile switch and press "Clone".
-5. You can edit the new local profile in Local Profile (LP) tab or via the hamburger menu.
-
-
-
-(Config-Builder-upload-local-profiles-to-nightscout)=
-#### Upload local profiles to Nightscout
-Local profiles can also be uploaded to Nightscout. The settings can be found in [NSClient preferences](#Preferences-nsclient).
+```{contents}
+:backlinks: entry
+:depth: 2
+```
-
-
-#### Change profile in Nightscout profile editor
-You can synchronize changes to the profile in the Nightscout profile editor to local profiles. The settings can be found in [NSClient preferences](#Preferences-nsclient).
-
-It is necessary to clone the actual active entire Nightscout database records for the profiles and not just a profile with the blue arrow! The new database records then carries the current date and can be activated via the tab "local profile".
-
-
-
-### Profile helper
-
-Profile helper offers two functions:
+## Profile
- 1. Find a profile for kids
- 2. Compare two profiles or profile switches in order to clone a new profile
+This module can not be disabled as it is a core part of **AAPS**.
-Details are explained on the separate [profile helper page](../SettingUpAaps/ProfileHelper.md).
+* See [Your AAPS Profile](../SettingUpAaps/YourAapsProfile.md) for a basic understanding of what goes inside your **Profile**.
+* See [AAPS Screens > Profile](#aaps-screens-profile) for more information about managing your **Profiles**.
(Config-Builder-insulin)=
## Insulin
-* Select the type of insulin curve you are using.
-* The options 'Rapid-Acting Oref', Ultra-Rapid Oref', 'Lyumjev' and 'Free-Peak Oref' all have an exponential shape. More information is listed in the [OpenAPS docs](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/understanding-insulin-on-board-calculations.html#understanding-the-new-iob-curves-based-on-exponential-activity-curves).
-* The curves will vary based on the DIA and the time to peak.
+Select the type of insulin you are using.
- * PURPLE line shows how much **insulin remains** after it has been injected as it decays with time.
- * BLUE line shows **how active** insulin is.
-
-### DIA
-
-* 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.
-* For a lot of people using ultra-rapid insulins like Fiasp there is practically no noticeable effect 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, AAPS uses minimum 5h as DIA.
-* You can read more about that in the Insulin Profile section of [this](#AapsScreens-insulin-profile) page.
+More information to understand the Insulin Profile as shown in **AAPS** [here](#AapsScreens-insulin-profile).
### Insulin type differences
+
+* The options 'Rapid-Acting Oref', Ultra-Rapid Oref', 'Lyumjev' and 'Free-Peak Oref' all have an exponential shape.
* For 'Rapid-Acting', 'Ultra-Rapid' and 'Lyumjev' 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](#AapsScreens-insulin-profile) 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.
#### Rapid-Acting Oref
@@ -134,139 +80,126 @@ Details are explained on the separate [profile helper page](../SettingUpAaps/Pro
(Config-Builder-bg-source)=
## BG Source
-Select the blood glucose source you are using - see [BG Source](../Getting-Started/CompatiblesCgms.md) page for more setup information.
+Select the blood glucose source you are using. See [BG Source](../Getting-Started/CompatiblesCgms.md) page for more setup information.
-* [Build Your Own Dexcom App (BYODA)](https://docs.google.com/forms/d/e/1FAIpQLScD76G0Y-BlL4tZljaFkjlwuqhT83QlFM5v6ZEfO7gCU98iJQ/viewform?fbzx=2196386787609383750&fbclid=IwAR2aL8Cps1s6W8apUVK-gOqgGpA-McMPJj9Y8emf_P0-_gAsmJs6QwAY-o0).
-* [xDrip+](https://xdrip-plus-updates.appspot.com/stable/xdrip-plus-latest.apk)
-* [MM640g](https://github.com/pazaan/600SeriesAndroidUploader/releases)
-* [Glimp](https://play.google.com/store/apps/details?id=it.ct.glicemia&hl=de) - only version 4.15.57 and newer are supported
-* [Poctech](https://www.poctechcorp.com/en/contents/268/5682.html)
-* [Tomato App](http://tomato.cool/) for MiaoMiao device
+* [xDrip+](../CompatibleCgms/xDrip.md)
+* [NSClient BG](../CompatibleCgms/CgmNightscoutUpload.md) - only if you know what you are doing, see [BG Source](../Getting-Started/CompatiblesCgms.md).
+* [MM640g](../CompatibleCgms/MM640g.md)
+* [Glimp](#libre1-using-glimp) - only version 4.15.57 and newer are supported
+* [Build Your Own Dexcom App (BYODA)](#DexcomG6-if-using-g6-with-build-your-own-dexcom-app).
+* [Poctech](../CompatibleCgms/PocTech.md)
+* [Tomato App](#libre1-using-tomato) for MiaoMiao device
* [Glunovo App](https://infinovo.com/) for Glunovo CGM system
-* NSClient BG - not recommended as closed loop relies on mobile data / wifi coverage in this case. CGM data will only be received if there is an online connection to your NS site. Better use local broadcast from one of the other CGM data sources.
* Random BG: Generates random BG data (Demo mode only)
+## Smoothing
+
+
+
+See [Smoothing blood glucose data](../CompatibleCgms/SmoothingBloodGlucoseData.md).
+
(Config-Builder-pump)=
## Pump
-Select the pump you are using.
+Select the pump you are using. See [Compatible pumps](../Getting-Started/CompatiblePumps.md) page for more setup information.
-
+
* [Dana R](../CompatiblePumps/DanaR-Insulin-Pump.md)
* Dana R Korean (for domestic DanaR pump)
* Dana Rv2 (DanaR pump with unofficial firmware upgrade)
* [Dana-i/RS](../CompatiblePumps/DanaRS-Insulin-Pump.md)
-
- * 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](../CompatiblePumps/DanaRS-Insulin-Pump.md) must be entered correctly. Password was not checked in previous versions.
-
* [Accu Chek Insight](../CompatiblePumps/Accu-Chek-Insight-Pump.md)
-* [Accu Chek Combo](../CompatiblePumps/Accu-Chek-Combo-Pump.md) (requires ruffy installation)
-* [Omnipod Eros](../CompatiblePumps/OmnipodEros.md)
-* [Omnipod DASH](../CompatiblePumps/OmnipodDASH.md)
+* Accu Chek Combo
+ * [Driver using Ruffy](../CompatiblePumps/Accu-Chek-Combo-Pump.md) (requires ruffy installation)
+ * [Driver with no additional requirement](../CompatiblePumps/Accu-Chek-Combo-Pump-v2.md), added in [AAPS v.3.2](#version3200)
+* Omnipod for [Omnipod Eros](../CompatiblePumps/OmnipodEros.md)
+* Dash for [Omnipod DASH](../CompatiblePumps/OmnipodDASH.md)
* [Medtronic](../CompatiblePumps/MedtronicPump.md)
* [Diaconn G8](../CompatiblePumps/DiaconnG8.md)
-- 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)
+* [EOPatch2](../CompatiblePumps/EOPatch2.md)
+* [Medtrum](../CompatiblePumps/MedtrumNano.md)
+* Virtual pump: open loop - **AAPS** suggestions only
+ * as you make you first steps with **AAPS**, during the first [objectives](../SettingUpAaps/CompletingTheObjectives.md)
+ * for pump which doesn't have any driver yet
## Sensitivity Detection
Select the type of sensitivity detection. For more details of different designs please [read on here](../DailyLifeWithAaps/SensitivityDetectionAndCob.md). 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](https://openaps.readthedocs.io/en/latest/docs/Customize-Iterate/autosens.html).
+You can view your sensitivity on the homescreen in an [additional graph](#AapsScreens-section-g-additional-graphs).
You can view your sensitivity on the homescreen by selecting SEN and watching the white line. Note, you need to be in [Objective 8](#objectives-objective8) in order to let Sensitivity Detection/[Autosens](#Open-APS-features-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.
-(Config-Builder-absorption-settings)=
### Absorption settings
-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](../DailyLifeWithAaps/CobCalculation.md) can't be dynamically worked out based on your bloods reactions it inserts a default decay to your carbs. Basically, it is a failsafe.
+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](../DailyLifeWithAaps/CobCalculation.md) can't be dynamically worked out based on your blood's reactions it inserts a default decay to your carbs. Basically, it is a failsafe.
(Config-Builder-aps)=
## APS
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) 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](../DailyLifeWithAaps/KeyAapsFeatures.md) (super micro bolus, most recent algorithm for advanced users)
-Note you need to be in [Objective 9](#objectives-objective9) in order to use OpenAPS SMB and min_5m_carbimpact must be set to 8 in Config builder > Sensitivity detection > Sensitivity Oref1 settings.
+* OpenAPS AMA
+ * Advanced Meal Assist: older algorithm not recommended anymore.
+ * 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](#Open-APS-features-super-micro-bolus-smb)
+ * Super Micro Bolus: most recent algorithm recommended for all users.
+ * In contrast to AMA, SMB does not use temporary basal rates to control glucose levels, but mainly small **Super Micro Boluses**.
+ * Note : It is recommended to use this algorithm from the beginning, even though you will not actually get SMBs delivered until [Objective 9](#objectives-objective9).
+
+If switching from AMA to SMB algorithm, _min_5m_carbimpact_ must be changed manually to **8** (default value for SMB) in [Preferences > Sensitivity detection > Sensitivity Oref1 settings](../SettingUpAaps/Preferences.md).
## Loop
-* Switch between Open Loop, Closed Loop and Low Glucose Suspend (LGS).
+This module should not be disabled as it is a core part of **AAPS**.
-
+## Constraints
-(Config-Builder-open-loop)=
-### Open Loop
-* 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 AAPS works or if you are using an unsupported pump.
+### Objectives
-(Config-Builder-closed-loop)=
-### Closed Loop
-* 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](#objectives-objective6) 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.
+**AAPS** has a learning program (a series of 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.
-### 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.
+See [Objectives](../SettingUpAaps/CompletingTheObjectives.md) page for more information.
-### 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.
+## Synchronization
-## Objectives (learning program)
-AAPS has a learning 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.
+In this section, you can choose if/where you want **AAPS** to send your data to.
-You should [export your settings](../Maintenance/ExportImportSettings.md) (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.
+### NSClient or NSClientV3
-See [Objectives](../SettingUpAaps/CompletingTheObjectives.md) page for more information.
+Can be used as a [reporting server](../SettingUpAaps/SettingUpTheReportingServer.md) and/or for [remote monitoring](../RemoteFeatures/RemoteMonitoring.md), [remote control](../RemoteFeatures/RemoteControl.md).
-## Treatments
-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](#screens-bolus-carbs).
+See [Synchronization with the reporting server](#SetupWizard-synchronization-with-the-reporting-server-and-more) to help you choose between NSClient (v1) and NSClientV3.
-## General
-### Overview
-Displays the current state of your loop and buttons for most common actions (see [section The Homescreen](../DailyLifeWithAaps/AapsScreens.md) for details). Settings can be accessed by clicking the cog wheel.
+### Tidepool
-#### 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.
+Can be used as a [reporting server](../SettingUpAaps/SettingUpTheReportingServer.md).
-#### Buttons
-Define which Buttons are shown on the home screen.
-* Treatments
-* Calculator
-* Insulin
-* Carbs
-* CGM (opens xDrip+)
-* Calibration
+See [Tidepool](../SettingUpAaps/Tidepool.md).
-Furthermore, you can set shortcuts for insulin and carb increments and decide whether the notes field should be shown in treatment dialogues.
+### xDrip
-#### QuickWizard settings
-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.
+Used to **send** data such as treatments to xDrip+.
-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.
+### Open Humans
-
+See [Open Humans](../SupportingAaps/OpenHumans.md).
-#### Default Temp-Targets
-Choose default temp-targets (duration and target). Preset values are:
+### Wear
+Monitor and control **AAPS** using your Android WearOS watch (see [page Watchfaces](../UsefulLinks/WearOsSmartwatch.md)).
-* 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
+### Samsung Tizen
-#### Fill/Prime standard insulin amounts
-Choose the default amounts of the three buttons in fill/prime dialogue, depending on the length of your catheter.
+Broadcast data to Samsung's G-Watch Wear App (Tizen OS).
-#### Range of visualization
-Choose the high and low marks for the BG-graph on AAPS 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
+### Garmin
-#### Shorten tab titles
-Choose whether the tab titles in AAPS are long (e.g. ACTIONS, LOCAL PROFILE, AUTOMATION) or short (e.g. ACT, LP, AUTO)
+Connection to Garmin device (Fenix, Edge...)
+## Treatments
+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](#screens-bolus-carbs).
+
+## General
+
+### Overview
+
+This is the [main screen](#AapsScreens-the-homescreen) of **AAPS** and can not be disabled.
#### Show notes field in treatment dialogs
Choose if you want to have a notes field when entering treatments or not.
@@ -281,20 +214,21 @@ Choose if you want to have [status lights](#Preferences-status-lights) on overvi
(Config-Builder-actions)=
### Actions
-* Some buttons to quickly access common features.
-* See [AAPS screenshots](#screens-action-tab) for details.
+
+A tab offering multiple buttons to take [actions](#screens-action-tab) in **AAPS**.
### Automation
-User defined automation tasks ('if-then-else'). Please [read on here](../DailyLifeWithAaps/Automations.md).
+
+A tab for managing your [Automations](../DailyLifeWithAaps/Automations.md), starting at [Objective 10](#objectives-objective10).
(Config-Builder-sms-communicator)=
### SMS Communicator
-Allows remote caregivers to control some AAPS features via SMS, see [SMS Commands](../RemoteFeatures/SMSCommands.md) for more setup information.
+Allows remote caregivers to control some **AAPS** features via SMS, see [SMS Commands](../RemoteFeatures/SMSCommands.md) for more setup information.
### Food
Displays the food presets defined in the Nightscout food database, see [Nightscout Readme](https://github.com/nightscout/cgm-remote-monitor#food-custom-foods) for more setup information.
-Note: Entries cannot be used in the AAPS calculator. (View only)
+Note: Entries cannot be used in the **AAPS** calculator. (View only)
(Config-Builder-wear)=
### Wear
@@ -309,15 +243,10 @@ Through Wear tab or hamburger menu (top left of screen, if tab is not displayed)
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](../UsefulLinks/WearOsSmartwatch.md)
-
-### NSClient
-* Setup sync of your AAPS data with Nightscout.
-* Settings in [preferences](#Preferences-nsclient) can be opened by clicking the cog wheel.
-
### Maintenance
-Email and number of logs to be send. Normally no change necessary.
+
+Access this tab to export / import settings.
### Config Builder
-Use tab for config builder instead of hamburger menu.
+
+This current tab.
\ No newline at end of file
diff --git a/docs/EN/SettingUpAaps/Preferences.md b/docs/EN/SettingUpAaps/Preferences.md
index 38f908b79280..7a70d8b0aa83 100644
--- a/docs/EN/SettingUpAaps/Preferences.md
+++ b/docs/EN/SettingUpAaps/Preferences.md
@@ -2,19 +2,19 @@
- **Open preferences** by clicking the three-dot menu on the top right side of the home screen.
- 
+
- You can jump directly to preferences for a certain tab (i.e. pump tab) by opening this tab and clicking Plugin preferences.
- 
+
- **Sub-menus** can be opened by clicking the triangle below the sub-menu title.
- 
+
- With the **filter** on top of the preferences screen you can quickly access certain preferences. Just start typing part of the text you are looking for.
- 
+
```{contents}
:backlinks: entry
@@ -34,10 +34,9 @@
- New option to use phone's default language (recommended).
-- In case you want AAPS in a different language than your standard phone language you can choose from a broad variety.
-
-- If you use different languages you might sometimes see a language mix. This is due to an android issue that overriding the default android language sometimes doesn't work.
+- In case you want **AAPS** in a different language than your standard phone language, you can choose from a broad variety.
+- If you use different languages, you might sometimes see a language mix. This is due to an android issue where overriding the default android language sometimes doesn't work.
**Patient name**
@@ -46,217 +45,224 @@
(Preferences-protection)=
### Protection
-(Preferences-master-password)=
-
+(Preferences-master-password)=
#### Master password
-- Necessary to be able to [export settings](../Maintenance/ExportImportSettings.md) as they are encrypted from version 2.7.
- **Biometric protection may not work on OnePlus phones. This is a known issue of OnePlus on some phones.**
+Mandatory to be able to [export settings](../Maintenance/ExportImportSettings.md) as they are encrypted from version 2.7.
-- Open Preferences (three-dot menu on top right of home screen)
+**Biometric protection may not work on OnePlus phones. This is a known issue of OnePlus on some phones.**
-- Click triangle below "General"
-
-- Click "Master-Password"
-
-- Enter password, confirm password and click ok.
-
- 
+
#### Settings protection
-- Protect your settings with a password or phone's biometric authentication (i.e. [child is using AAPS](../RemoteFeatures/RemoteMonitoring.md)).
+- Protect your settings with a password or phone's biometric authentication (i.e. [child is using **AAPS**](../RemoteFeatures/RemoteMonitoring.md)). If you enable this feature, you will be prompted for authentication each time you want to access any Preferences related view.
-- Custom password should be used if you want to use master password just for securing [exported settings](../Maintenance/ExportImportSettings.md).
+- Custom password should be used if you want to use master password just for securing [exported settings](../Maintenance/ExportImportSettings.md), and use a different one for editing the preferences.
- If you are using a custom password click on line "Settings password" to set password as described [above](#Preferences-master-password).
- 
+
#### Application protection
-- If app is protected you must enter password or use phone's biometric authentication to open AAPS.
-- App will shut down immediately if wrong password is entered - but still run in the background if it was previously opened successfully.
+If the app is protected, you must enter the password or use the phone's biometric authentication to open **AAPS**.
+
+**AAPS** will shut down immediately if a wrong password is entered - but will still run in background if it was previously opened successfully.
#### Bolus protection
-- Bolus protection might be useful if AAPS is used by a small child and you [bolus via SMS](../RemoteFeatures/SMSCommands.md).
+- Bolus protection might be useful if **AAPS** is used by a small child and you [bolus via SMS](../RemoteFeatures/SMSCommands.md).
-- In the example below you see the prompt for biometric protection. If biometric authentication does not work, click in the space above the white prompt and enter master password.
+- In the example below you see the prompt for biometric protection. If biometric authentication does not work, click in the space above the white prompt and enter thr master password.
- 
+
+
+#### Password and PIN retention
+
+Define how long (in seconds), the preferences or bolus functionalities remain unlocked after you successfully enter the password.
(Preferences-skin)=
#### Skin
+You can choose from four types of skins:
-- You can choose from four types of skins:
+
- 
+'Low resolution skin' comes with shorter labels and age/level removed to have more available space on a very low resolution screen.
-- 'Low resolution skin' comes with shorter label and age/level removed to have more available space on very low resolution screen.
-
-- Difference of other skins depend of phone's display orientation.
+Difference between the other skins depends on the phone's display orientation:
##### Portrait orientation
- **Original Skin** and **Buttons are always displayed on bottom of screen** are identical
-- **Large Display** has an increased size of all graphs compared to other skins
+- **Large Display** has an increased height for all graphs compared to other skins
##### Landscape orientation
- Using **Original Skin** and **Large Display**, you have to scroll down to see buttons at the bottom of the screen
-- **Large Display** has an increased size of all graphs compared to other skins
+- **Large Display** has an increased height for all graphs compared to other skins
- 
+
-(Preferences-overview)=
## Overview
-- In overview section you can define preferences for home screen.
+In the **Overview** section, you can define the preferences for the home screen.
- 
+
### Keep screen on
-- Useful while giving a presentation.
-- It will consume a lot of energy, so it is wise to have your phone plugged into a charger.
+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.
(Preferences-buttons)=
### Buttons
- Define which buttons are visible on the bottom of your home screen.
- 
+
-- With the increment figure you can define amount for the three buttons in carb and insulin dialogue for easy entry.
+- The **Increment** options allow you to define the amount for the three buttons in the carb and insulin dialogues, for easy entry.
- 
+
- 
+
(Preferences-quick-wizard)=
### Quick Wizard
-- If you have a frequent snack or meal, you can use the quick wizard button to easily enter amount of carbs and set calculation basics.
+Create customized buttons for certain standard meals or snacks which will be displayed on the home screen. Useful for standard meals frequently eaten.
-- In setup you define during which time period the button will be visible on your home screen - just one button per period.
+For each button, you define the carbs and calculation method for the bolus.
+Then, you define during which time period the button will be visible on your home screen - just one button per period. The 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. 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.
- 
+
-- If you click the quick wizard button AAPS will calculate and propose a bolus for those carbs based on your current ratios (considering blood glucose value or insulin on board if set up).
+If you click the quick wizard button **AAPS** will calculate and propose a bolus for those carbs based on your current ratios (considering blood glucose value or insulin on board if set up).
-- The proposal has to be confirmed before insulin is delivered.
+The proposal has to be confirmed before insulin is delivered.
- 
+
(Preferences-default-temp-targets)=
### Default temp targets
-- [Temp targets (TT)](../DailyLifeWithAaps/TempTargets.md) allow you to define change your blood glucose target for a certain time period.
-
-- With setting of default TT you can easily change your target for activity, eating soon etc.
+[Temporary targets (TT)](../DailyLifeWithAaps/TempTargets.md) allow you to change your blood glucose target for a certain time period. When setting a default TT, you can easily change your target for activity, eating soon etc.
- 
+Here you can change the target and the duration for each predefined TT. Preset values are:
-- Press long on your target in the top right corner on the home screen or use the shortcuts in the orange “Carbs” button at the bottom.
+* 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
- 
+
-###
+Learn how to [activate Temp Targets here](#TempTargets-where-can-i-select-a-temp-target).
### Fill/Prime standard insulin amounts
-- If you want to fill tube or prime cannula through AAPS you can do this through [actions tab](#screens-action-tab).
-- Pre-set values can be defined in this dialogue.
+If you want to fill the tube or prime cannula through **AAPS** you can do this through the [**Actions** tab](#screens-action-tab).
+
+Pre-set values can be defined in this dialogue. Choose the default amounts of the three buttons in fill/prime dialogue, depending on the length of your catheter.
(Preferences-range-for-visualization)=
### Range for visualization
-- Define which part of the graph on the home screen shall be you target range and be filled with green background.
+Choose the high and low marks for the BG-graph on **AAPS** overview and smartwatch. 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
-- See more tab titles on screen.
+Useful to see more tab titles on screen.
-- For example the 'OpenAPS AMA' tab becomes 'OAPS', 'OBJECTIVES' becomes 'OBJ' etc.
+For example the 'OpenAPS AMA' tab becomes 'OAPS', 'OBJECTIVES' becomes 'OBJ' etc.
- 
+
(Preferences-show-notes-field-in-treatments-dialogs)=
### Show notes field in treatments dialogs
-- Gives you the option to add short text notes to your treatments (bolus wizard, carbs, insulin...)
+Gives you the option to add short text notes to your treatments (bolus wizard, carbs, insulin...)
- 
+
(Preferences-status-lights)=
### Status lights
-- Status lights give a visual warning for
-
- - Sensor age
- - Sensor battery level for certain smart readers (see [screenshots page](#screens-sensor-level-battery) for details).
- - Insulin age (days reservoir is used)
- - Reservoir level (units)
- - Cannula age
- - Pump battery age
- - Pump battery level (%)
+Status lights give a visual warning for:
-- If threshold warning is exceeded, values will be shown in yellow.
+- Sensor age
+- Sensor battery level for certain smart readers (see [screenshots page](#screens-sensor-level-battery) for details).
+- Insulin age (days reservoir is used)
+- Reservoir level (units)
+- Cannula age
+- Pump battery age
+- Pump battery level (%)
-- If threshold critical is exceeded, values will be shown in red.
+If the warning threshold is exceeded, values will be shown in yellow. If the critical threshold is exceeded, values will be shown in red.
-- In versions prior to AAPS 2.7 settings for status lights had to be made in Nightscout settings.
+The last option allows you to import those settings from Nightscout if defined there. See [Nightscout documentation](https://nightscout.github.io/nightscout/setup_variables/#age-pills) for more information.
- 
+
(Preferences-deliver-this-part-of-bolus-wizard-result)=
### Deliver this part of bolus wizard result
Set the [default percentage](#AapsScreens-section-j) of the bolus calculated when using the bolus wizard.
-Default is 100%: no correction. Even when setting a different value here, you can still change each time you use the bolus wizard.
+Default is 100%: no correction. Even when setting a different value here, you can still change each time you use the bolus wizard. If this setting is 75 % and you had to bolus 10U, the bolus wizard will propose a meal bolus of only 7.5 units.
-When using [SMB](#objectives-objective9), using a value lower than 100% here can be useful:
+When using [SMB](#objectives-objective9), 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. Using a value lower than 100% here can be useful:
* for people with slow digestion: sending all the bolus upfront can cause hypo because the insulin action is faster than the digestion.
-* to leave more room to *AAPS** to deal by itself with **BG rise**.
-In both cases, **AAPS** will compensate the missing part of the bolus with SMBs, if/when deemed adequate.
+* to leave more room to **AAPS** to deal by itself with **BG rise**.
+In both cases, **AAPS** will compensate for the missing part of the bolus with SMBs, if/when deemed adequate.
+
+### Enabled bolus advisor
+
+
+
+When enabled, when you use the bolus wizard as you are in hyperglycemia, you will get a warning, prompting you if you wish to pe-bolus and eat later, when your **BG** gets back in range.
+
+### Enabled bolus reminder
+
+% todo
(Preferences-advanced-settings-overview)=
### Advanced Settings (Overview)
-(Preferences-superbolus)=
#### Superbolus
-- Option to enable superbolus in bolus wizard.
-- [Superbolus](https://www.diabetesnet.com/diabetes-technology/blue-skying/super-bolus/) is a concept to "borrow" some insulin from basal rate in the next two hours to prevent spikes.
+Option to enable superbolus in bolus wizard.
+
+[Superbolus](https://www.diabetesnet.com/diabetes-technology/blue-skying/super-bolus/) is a concept to "borrow" some insulin from basal rate in the next two hours to prevent spikes. It is different from *super micro bolus*!
+
+Use with caution and do not enable it 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"](#Open-APS-features-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](https://www.diabetesnet.com/diabetes-technology/blue-skying/super-bolus).
## Treatment safety
+(preferences-patient-type)=
### Patient type
- Safety limits are set based on the age you select in this setting.
- If you start hitting these hard limits (like max bolus) it's time to move one step up.
-- It's a bad idea to select higher than real age because it can lead to overdosing by entering the wrong value in insulin dialog (by skipping the decimal dot, for example).
+- It's a bad idea to select higher than real age because it can lead to overdosing by entering the wrong value in the insulin dialog (by skipping the decimal dot, for example).
- If you want to know the actual numbers for these hard-coded safety limits, scroll to the algorithm feature you are using on [this page](../DailyLifeWithAaps/KeyAapsFeatures.md).
-### Max allowed bolus \[U\]
+### Max allowed bolus
-- Defines maximum amount of bolus insulin that AAPS is allowed to deliver at once.
+- Defines the maximum amount of bolus insulin, in insulin units, that **AAPS** is allowed to deliver at once.
- This setting exists as a safety limit to prevent the delivery of a massive bolus due to accidental input or user error.
- It is recommended to set this to a sensible amount that corresponds roughly to the maximum amount of bolus insulin that you are ever likely to need for a meal or correction dose.
- This restriction is also applied to the results of the bolus calculator.
-### Max allowed carbs \[g\]
+### Max allowed carbs
-- Defines the maximum amount of carbs that AAPS bolus calculator is allowed to dose for.
+- Defines the maximum amount of carbs, in grams, that **AAPS** bolus calculator is allowed to dose for.
- This setting exists as a safety limit to prevent the delivery of a massive bolus due to accidental input or user error.
- It is recommended to set this to a sensible amount that corresponds roughly to the maximum amount of carbs that you are ever likely to need for a meal.
@@ -264,158 +270,104 @@ In both cases, **AAPS** will compensate the missing part of the bolus with SMBs,
(Preferences-aps-mode)=
### APS mode
+Switch between Open Loop, Closed Loop and Low Glucose Suspend (LGS).
-- Toggle between open and closed looping as well as low glucose suspend (LGS)
-- **Open looping** means TBR suggestions are made based on your data and appear as a notification. After manual confirmation, the command to dose insulin will be transferred to pump. Only if you use virtual pump you have to enter it manually.
-- **Closed looping** means TBR suggestions are automatically sent to your pump without confirmation or input from you.
-- **Low glucose suspend** is similar to closed looping, but overrides the maxIOB setting to zero. This means that if blood glucose is dropping it can reduce the basal rate, but if blood glucose is rising then it will only increase the basal rate if the basal IOB is negative (e.g. from a previous Low Glucose Suspend).
-
-(Preferences-minimal-request-change)=
-### 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.
+(Preferences-pen-loop)=
+#### Open Loop
+**AAPS** continuously evaluates all available data (IOB, COB, BG...) and makes treatment suggestions (temporary basal rates) on how to adjust your therapy if necessary.
-(Preferences-advanced-meal-assist-ama-or-super-micro-bolus-smb)=
-## Advanced Meal Assist (AMA) or Super Micro Bolus (SMB)
+The suggestions will not be executed automatically (as in closed loop). The suggestions have to be enacted by the user manually into the pump (if using virtual pump) or by using a button if **AAPS** is connected to a real pump.
-Depending on your settings in [config builder](../SettingUpAaps/ConfigBuilder.md) you can choose between two algorithms:
+This option is for getting to know how **AAPS** works or if you are using an unsupported pump. You will be in Open Loop, no matter what choice you make here, until the end of **[Objective 5](#objectives-objective5)**.
-- [Advanced meal assist (OpenAPS AMA)](#Open-APS-features-advanced-meal-assist-ama) - state of the algorithm in 2017
-- [Super Micro Bolus (OpenAPS SMB)](#Open-APS-features-super-micro-bolus-smb) - most recent algorithm recommended for beginners
+(preferences-closed-loop)=
+#### Closed Loop
-### OpenAPS AMA settings
+**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](#profile-glucose-targets) (bolus delivery, temporary basal rate, insulin switch-off to avoid hypo etc.).
-- Allows the system to high-temp more quickly after a meal bolus IF you enter carbs reliably.
-- More details about the settings and Autosens can be found in the [OpenAPS docs](https://openaps.readthedocs.io/en/latest/docs/Customize-Iterate/autosens.html).
+The Closed Loop works within numerous safety limits, which can be set individually.
-(Preferences-max-u-h-a-temp-basal-can-be-set-to)=
-#### Max U/h a Temp Basal can be set to
+Closed Loop is only possible if you are in **[Objective 6](#objectives-objective6)** or higher and use a supported pump.
-- Exists as a safety limit to prevent AAPS from ever being capable of giving a dangerously high basal rate.
-- The value is measured in units per hour (U/h).
-- It is advised to set this to something sensible. A good recommendation is to take the **highest basal rate** in your profile and **multiply it by 4**.
-- For example, if the highest basal rate in your profile was 0.5 U/h you could multiply that by 4 to get a value of 2 U/h.
-- See also [detailed feature description](#Open-APS-features-max-u-h-a-temp-basal-can-be-set-to).
+#### Low Glucose Suspend (LGS)
-#### Maximum basal IOB OpenAPS can deliver \[U\]
+In this mode, [maxIOB](#Open-APS-features-maximum-total-iob-openaps-cant-go-over) is set to zero.
-- Amount of additional basal insulin (in units) allowed to accumulate in your body, on top of your normal basal profile.
-- Once this value is reached, AAPS will stop giving additional basal insulin until your basal Insulin on Board (IOB) has decayed to within this range again.
-- This value **does not consider bolus IOB**, only basal.
-- This value is calculated and monitored independently of your normal basal rate. It is only the additional basal insulin on top of that normal rate that is considered.
+This means that if blood glucose is dropping, **AAPS** can reduce the basal for you. But if blood glucose is rising, no automatic correction will be made. Your basal rates will remain the same as defined in your current **Profile**. Only if basal IOB is negative (from a previous Low Glucose Suspend) additional insulin will be given to lower **BG**.
-When you begin looping, **it is advised to set Max Basal IOB to 0** for a period of time, while you are getting used to the system. This prevents AAPS from giving any additional basal insulin at all. During this time AAPS will still be able to limit or turn off your basal insulin to help prevent hypoglycaemia. This is an important step in order to:
-
-- Have a period of time to safely get used to the AAPS system and monitor how it works.
-- Take the opportunity to perfect your basal profile and Insulin Sensitivity Factor (ISF).
-- See how AAPS limits your basal insulin to prevent hypoglycaemia.
-
-When you feel comfortable, you can allow the system to start giving you additional basal insulin, by raising the Max Basal IOB value. The recommended guideline for this is to take the **highest basal rate** in your profile and **multiply it by 3**. For example, if the highest basal rate in your profile was 0.5 U/h you could multiply that by 3 to get a value of 1.5 U/h.
+(Preferences-minimal-request-change)=
+### Minimal request change
-- You can start conservatively with this value and increase it slowly over time.
-- These are guidelines only; everyone's body is different. You may find you need more or less than what is recommended here, but always start conservatively and adjust slowly.
+When using **Open loop**, you will receive notifications every time **AAPS** recommends adjusting the basal rate.
+To reduce the number of notifications you can either use a [wider bg target range](#profile-glucose-targets) or increase the percentage of the minimal request rate.
+This defines the relative change required to trigger a notification.
-**Note: As a safety feature, Max Basal IOB is hard-limited to 7u.**
+## Advanced Meal Assist (AMA) or Super Micro Bolus (SMB)
-#### Autosens
+Depending on your settings in [config builder](../SettingUpAaps/ConfigBuilder.md) you can choose between three algorithms:
-- [Autosens](#Open-APS-features-autosens) looks at blood glucose deviations (positive/negative/neutral).
-- It will try and figure out how sensitive/resistant you are based on these deviations and adjust basal rate and ISF based on these deviations.
-- If you select "Autosens adjust target, too" the algorithm will also modify your glucose target.
+- [Advanced meal assist (OpenAPS AMA)](#Open-APS-features-advanced-meal-assist-ama) - state of the algorithm in 2017
+- [Super Micro Bolus (OpenAPS SMB)](#Open-APS-features-super-micro-bolus-smb) - most recent algorithm recommended for beginners
+- [Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md) - released in 2024, available starting at **[Objective 11](#objectives-objective11)**
-#### Advanced settings (OpenAPS AMA)
+### OpenAPS AMA
-- Normally you do not have to change the settings in this dialogue!
-- If you want to change them anyway make sure to read about details in [OpenAPS docs](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/preferences-and-safety-settings.html#) and to understand what you are doing.
+All the settings for OpenAPS AMA are described in the dedicated section in [Key AAPS Features > Advanced Meal Assist (AMA)](#Open-APS-features-advanced-meal-assist-ama).
(Preferences-openaps-smb-settings)=
-### OpenAPS SMB settings
-
-- In contrast to AMA, [SMB](#Open-APS-features-super-micro-bolus-smb) does not use temporary basal rates to control glucose levels, but mainly small super micro boluses.
-
-- You must have started [objective 9](#objectives-objective9) to use SMB.
-
-- The first three settings are explained [above](#Preferences-max-u-h-a-temp-basal-can-be-set-to).
-
-- Details on the different enable options are described in [OpenAPS feature section](#Open-APS-features-enable-smb).
-
-- *How frequently SMBs will be given in min* is a restriction for SMB to be delivered only every 4 min by default. This value prevents the system from issuing SMB too often (for example in case of a temp target being set). You should not change this setting unless you know exactly about consequences.
-
-- If 'Sensitivity raises target' or 'Resistance lowers target' is enabled [Autosens](#Open-APS-features-autosens) will modify your glucose target according to your blood glucose deviations.
-
-- If target is modified it will be displayed with a green background on your home screen.
-
- 
-
-(Preferences-carb-required-notification)=
-#### Carb required notification
-
-- This feature is only available if SMB algorithm is selected.
-
-- Eating of additional carbs will be suggested when the reference design detects that it requires carbs.
+### OpenAPS SMB
-- In this case you will receive a notification which can be snoozed for 5, 15 or 30 minutes.
+All the settings for OpenAPS SMB are described in the dedicated section in [Key AAPS Features > Super Micro Bolus (SMB)](#Open-APS-features-super-micro-bolus-smb).
-- Additionally the required carbs will be displayed in the COB section on your home screen.
+### Dynamic ISF
-- A threshold can be defined - minimum amount of carbs needed to trigger a notification.
-
-- Carb required notifications can be pushed to Nightscout if wished, in which case an announcement will be shown and broadcast.
-
- 
-
-#### Advanced settings (OpenAPS SMB)
-
-- Normally you do not have to change the settings in this dialogue!
-- If you want to change them anyway make sure to read about details in [OpenAPS docs](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/preferences-and-safety-settings.html#) and to understand what you are doing.
+All the settings for Dynamic ISF are described in the dedicated section in [Dynamic ISF](../DailyLifeWithAaps/DynamicISF.md).
## Absorption settings
-
-
(Preferences-min_5m_carbimpact)=
### min_5m_carbimpact
-- The algorithm uses BGI (blood glucose impact) to determine when carbs are absorbed.
-
-- 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.
+The algorithm uses BGI (blood glucose impact) to determine when [carbs are absorbed](../DailyLifeWithAaps/CobCalculation.md).
-- At times when carb absorption can’t be dynamically worked out based on your blood's reactions it inserts a default decay to your carbs. Basically, it is a failsafe.
+At times when carb absorption can’t be dynamically worked out based on your blood's reactions, **AAPS** inserts a default decay to your carbs. Basically, it is a failsafe. This 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.
-- To put it simply: The algorithm "knows" how your BGs *should* behave when affected by the current dose of insulin etc.
+To put it simply: The algorithm "knows" how your BGs *should* behave when affected by the current dose of insulin etc. Whenever there is a positive deviation from the expected behaviour, some carbs are absorbed/decayed. Big change=many carbs etc.
-- Whenever there is a positive deviation from the expected behaviour, some carbs are absorbed/decayed. Big change=many carbs etc.
+The min_5m_carbimpact does define the default carb absorption impact per 5 minutes. For more details see [OpenAPS docs](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/preferences-and-safety-settings.html?highlight=carbimpact#min-5m-carbimpact).
-- The min_5m_carbimpact does define the default carb absorption impact per 5 minutes. For more details see [OpenAPS docs](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/preferences-and-safety-settings.html?highlight=carbimpact#min-5m-carbimpact).
+Standard value for AMA is 5, for SMB it's 8.
-- Standard value for AMA is 5, for SMB it's 8.
+The COB graph on the home screen indicates when min_5m_impact is being used by putting an orange circle at the top.
-- The COB graph on the home screen indicates when min_5m_impact is being used by putting an orange circle at the top.
+
- 
+### Meal max absorption time
-### Maximum meal absorption time
-
-- If you often eat high fat or protein meals you will need to increase your meal absorption time.
+If you often eat high fat or protein meals you will need to increase your meal absorption time.
### Advanced settings - autosens ratio
+
+
- Define min. and max. [autosens](#Open-APS-features-autosens) ratio.
- Normally standard values (max. 1.2 and min. 0.7) should not be changed.
+## Pump
+
+### BT Watchdog
+
+Activate BT watchdog if necessary (e.g. for Dana pumps). 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.
+
## Pump settings
-The options here will vary depending on which pump driver you have selected in [Config Builder](#Config-Builder-pump). Pair and set your pump up according to the pump related instructions:
+The options here will vary depending on which pump driver you have selected in [Config Builder](#Config-Builder-pump). Pair and set your pump up according to the [pump related instructions](../Getting-Started/CompatiblePumps.md).
-- [DanaR Insulin Pump](../CompatiblePumps/DanaR-Insulin-Pump.md)
-- [DanaRS Insulin Pump](../CompatiblePumps/DanaRS-Insulin-Pump.md)
-- [Accu Chek Combo Pump](../CompatiblePumps/Accu-Chek-Combo-Pump.md)
-- [Accu Chek Insight Pump](../CompatiblePumps/Accu-Chek-Insight-Pump.md)
-- [Medtronic Pump](../CompatiblePumps/MedtronicPump.md)
+## Tidepool
-If using AAPS to open loop then make sure you have selected Virtual Pump in config builder.
+More information on the dedicated [Tidepool](../SettingUpAaps/Tidepool.md) page.
(Preferences-nsclient)=
## NSClient
@@ -425,9 +377,9 @@ If using AAPS to open loop then make sure you have selected Virtual Pump in conf
Original communication protocol, can be used with older Nightscout versions.
- Set your *Nightscout URL* (i.e. ).
- - **Make sure that the URL is WITHOUT /api/v1/ at the end.**
+- **Make sure that the URL is WITHOUT /api/v1/ at the end.**
- The *[API secret](https://nightscout.github.io/nightscout/setup_variables/#api-secret-nightscout-password)* (a 12 character password recorded in your Nightscout variables).
-- This enables data to be read and written between both the Nightscout website and AAPS.
+- This enables data to be read and written between both the Nightscout website and **AAPS**.
- Double check for typos here if you are stuck in Objective 1.
## NSClientV3
@@ -439,19 +391,19 @@ Original communication protocol, can be used with older Nightscout versions.
```{admonition} V3 data uploaders
:class: warning
-When using NSClientV3, all uploaders must be using the API V3. Since most are not compatible yet, this means **you must let AAPS upload all data** (BG, treatments, ...) to Nightscout and disable all other uploaders if they're not V3 compliant.
+When using NSClientV3, all uploaders must be using the API V3. Since most are not compatible yet, this means **you must let **AAPS** upload all data** (BG, treatments, ...) to Nightscout and disable all other uploaders if they're not V3 compliant.
```
- Set your *Nightscout URL* (i.e. ).
- - **Make sure that the URL is WITHOUT /api/v1/ at the end.**
-- In Nightscout, create an *[Admin token](https://nightscout.github.io/nightscout/security/#create-a-token)* (requires [Nightscout 15](https://nightscout.github.io/update/update/) to use the V3 API) and enter it in **NS access token** (not your API Secret!).
-- This enables data to be read and written between both the Nightscout website and AAPS.
+- **Make sure that the URL is WITHOUT /api/v1/ at the end.**
+- In Nightscout, create an *[Admin token](https://nightscout.github.io/nightscout/security/#create-a-token)* (requires [Nightscout 15](https://nightscout.github.io/update/update/) to use the V3 API) and enter it in the **NS access token** (not your API Secret!).
+- This enables data to be read and written between both the Nightscout website and **AAPS**.
- Double check for typos here if you are stuck in Objective 1.
- Leave Connect to websockets enabled (recommended).
### Synchronization
-Synchronization choices will depend on the way you will want to use AAPS.
+Synchronization choices will depend on the way you will want to use **AAPS**.
You can select which data you want to [upload and download to or from Nightscout](#Nightscout-aaps-settings).
@@ -459,11 +411,11 @@ You can select which data you want to [upload and download to or from Nightscout
-- Alarm options allows you to select which Nightscout alarms to use through the app. AAPS will alarm when a Nightscout alarms trigger.
- - For the alarms to sound you need to set the Urgent High, High, Low and Urgent Low alarm values in your [Nightscout variables](https://nightscout.github.io/nightscout/setup_variables/#alarms).
- - They will only work whilst you have a connection to Nightscout and are intended for parent/caregivers.
- - If you have the CGM source on your phone (i.e. xDrip+ or BYODA) then use those alarms instead of Nightscout Alarms.
-- Create notifications from Nightscout [announcements](https://nightscout.github.io/nightscout/discover/#announcement) will echo Nightscout announcements in the AAPS notifications bar.
+- Alarm options allows you to select which Nightscout alarms to use through the app. **AAPS** will alarm when a Nightscout alarm triggers.
+- For the alarms to sound you need to set the Urgent High, High, Low and Urgent Low alarm values in your [Nightscout variables](https://nightscout.github.io/nightscout/setup_variables/#alarms).
+- They will only work whilst you have a connection to Nightscout and are intended for parent/caregivers.
+- If you have the **CGM** source on your phone (i.e. xDrip+ or BYODA) then use those alarms instead of Nightscout Alarms.
+- Create notifications from Nightscout [announcements](https://nightscout.github.io/nightscout/discover/#announcement) will echo Nightscout announcements in the **AAPS** notifications bar.
- You can change stale data and urgent stale data alarms threshold when no data is received from Nightscout after a certain time.
### Connection settings
@@ -472,7 +424,7 @@ You can select which data you want to [upload and download to or from Nightscout
- Connection settings define when Nightscout connection will be enabled.
- Restrict Nightscout upload to Wi-Fi only or even to certain Wi-Fi SSIDs.
-- If you want to use only a specific WiFi network you can enter its WiFi SSID.
+- If you want to use only a specific Wi-Fi network you can enter its Wi-Fi SSID.
- Multiple SSIDs can be separated by semicolon.
- To delete all SSIDs enter a blank space in the field.
@@ -485,16 +437,13 @@ Options in advanced settings are self-explanatory.
## SMS Communicator
-- Options will only be displayed if SMS communicator is selected in [Config Builder](#Config-Builder-sms-communicator).
-- This setting allows remote control of the app by texting instructions to the patient's phone which the app will follow such as suspending loop, or bolusing.
-- Further information is described in [SMS Commands](../RemoteFeatures/SMSCommands.md).
-- Additional safety is obtained through use of an authenticator app and additional PIN at token end.
+More information on the dedicated [SMS Commands](../RemoteFeatures/SMSCommands.md) page.
## Automation
Select which location service shall be used:
-- Use passive location: AAPS only takes locations if other apps are requesting it
+- Use passive location: **AAPS** only takes locations if other apps are requesting it
- Use network location: Location of your Wi-Fi
- Use GPS location (Attention! May cause excessive battery drain!)
@@ -502,25 +451,24 @@ Select which location service shall be used:
-- Settings should be self-explanatory.
+Settings should be self-explanatory.
## Data choices
-- You can help develop AAPS further by sending crash reports to the developers.
+You can help develop **AAPS** further by sending crash reports to the developers.
## Maintenance settings
-- Standard recipient of logs is .
+Standard recipient of logs is .
## Open Humans
-- You can help the community by donating your data to research projects! Details are described on the [Open Humans page](../SupportingAaps/OpenHumans.md).
-
-- In Preferences you can define when data shall be uploaded
+You can help the community by donating your data to research projects! Details are described on the [Open Humans page](../SupportingAaps/OpenHumans.md).
- - only if connected to WiFi
- - only if charging
+In Preferences, you can define when data shall be uploaded
+- only if connected to Wi-Fi
+- only if charging
\ No newline at end of file
diff --git a/docs/EN/SettingUpAaps/SetupWizard.md b/docs/EN/SettingUpAaps/SetupWizard.md
index fa7600515cd2..55fc9c1e6ed5 100644
--- a/docs/EN/SettingUpAaps/SetupWizard.md
+++ b/docs/EN/SettingUpAaps/SetupWizard.md
@@ -184,6 +184,7 @@ Please press the "NEXT" button:
+(SetupWizard-synchronization-with-the-reporting-server-and-more)=
### Synchronization with the reporting server and more
Here you are configuring the data upload to your reporting server.
@@ -198,7 +199,8 @@ In this example we select Nightscout as reporting server, and will configure it.
```{admonition} Make sure to choose the correct **NSClient** version for your needs!
:class: Note
-Click [here](../Maintenance/ReleaseNotes.md) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**.
+
+Click [here](#version3200) for the release notes of **AAPS** 3.2.0.0 which explain the differences between the top option **NSClient** (this is "v1", although it is not explicitly labelled) and the second option, **NSClient v3**.
Nightscout users should choose **NSClient v3**, unless you want to monitor or send remote treatments (_e.g._ as a parent or caregiver using **AAPS** for a child) through Nightscout, in which case, choose the first option "**NSClient**" until further notice.
```
diff --git a/docs/EN/SettingUpAaps/YourAapsProfile.md b/docs/EN/SettingUpAaps/YourAapsProfile.md
index ac085811e5c3..e348202a9570 100644
--- a/docs/EN/SettingUpAaps/YourAapsProfile.md
+++ b/docs/EN/SettingUpAaps/YourAapsProfile.md
@@ -19,6 +19,7 @@ For the final three parameters, basal rates (BR), insulin sensitivity factors (I
Screenshots from **AAPS** of an _example_ profile are shown in below.
+(your-aaps-profile-duration-of-insulin-action)=
## Duration of insulin action (DIA)
The duration of insulin action is set to a single value in **AAPS**, because your pump will continually infuse the same type of insulin.
@@ -35,8 +36,8 @@ The **figure below** shows an example of how the DIA and glucose targets could b
Your **BG target** is a core value and all of **AAPS** calculations are based on it. It is different from the target range which you usually aim to keep your blood glucose values in:
* A glucose target, particularly if it is only short-term (less than 4 hours in duration), does not need to be the *actual value* you expect or want your glucose level to get to, rather, it is a good way to tell **AAPS** to be more or less aggressive, while still keeping your glucose levels in range.
* If your target is very wide (say, 3 or more mmol/l [50 mg/dl or more] wide), you will often find little **AAPS** action. This is because **BG** level is predicted to be somewhere in that wide range, and thus temporary basal rate changes are rarely suggested.
-* When beginning with **AAPS**, especially when progressing through [the first objectives](../SettingUpAaps/CompletingTheObjectives.md), using a wide range target can be a good option while you are learning how **AAPS** behaves and ajusting your **Profile**.
-* Later on, you will probably find more appropriate to reduce the range until you have a single target for each time of the day (_Low_ target = _High_ target), to make sure that **AAPS** reacts promptly to **BG** fluctuations.
+* When In [Open Loop](#Preferences-pen-loop), especially when progressing through [the first objectives](../SettingUpAaps/CompletingTheObjectives.md), using a wide range target can be a good option while you are learning how **AAPS** behaves and ajusting your **Profile**.
+* When In [Closed Loop](#preferences-closed-loop) (starting at **[Objective 6](#objectives-objective6)**), you will probably find more appropriate to reduce the range until you have a single target for each time of the day (_Low_ target = _High_ target), to make sure that **AAPS** reacts promptly to **BG** fluctuations.
The targets can be defined within those boundaries :
@@ -107,6 +108,23 @@ A hybrid closed loop _can_ attempt to make insulin delivery adjustments to minim
If you are starting with **AAPS** after using a different open or closed-loop pumping system, you will already have a reasonable idea of what values to use for basal rates (BR), insulin sensitivity factors (ISF) and insulin-to-carb ratios (IC or ICR).
If you are moving from injections (MDI) to **AAPS**, then it is a good idea to read up on how to make the transfer from MDI to pump first, and plan and make the move carefully in consultation with your diabetes team. ["Pumping insulin"](https://amzn.eu/d/iaCsFa2) by John Walsh & Ruth Roberts and [“Think like a Pancreas”](https://amzn.eu/d/iVU0RGe) by Gary Scheiner are very useful.
+## Profile backup
+
+Being a core setting of your looping system, your profiles are highly sensitive and something you really don't want to lose.
+
+* Your Profiles are stored in the **AAPS** database.
+* If enabled, Profiles are also uploaded to Nightscout. The settings can be found in [NSClient Preferences > NSClient > Synchronization > Upload data to NS](#Preferences-nsclient).
+* They are also part of [exported settings](../Maintenance/ExportImportSettings.md). So make sure to have a backup in a safe place.
+
+## Editing Profiles from Nightscout
+
+If enabled, profile changes made directly in Nightscout can be received in **AAPS**. The settings can be found in [NSClient Preferences > NSClient > Synchronization > Receive profile store](#Preferences-nsclient).
+
+This can be helpful when about to make major changes to a more extensive profile. They can be entered more easily via the web interface, _e.g._ to manually copy data from a spreadsheet.
+
+To do this, however, it is important to clone the whole **database record** consisting of several profiles in the Nightscout editor (blue arrow on the screenhost below). The new database records then carries the current date. After saving, the changed/new profile can be activated in **AAPS** with a regular [Profile switch](../DailyLifeWithAaps/ProfileSwitch-ProfilePercentage.md).
+
+
## Profile Helper
diff --git a/docs/EN/UsefulLinks/WearOsSmartwatch.md b/docs/EN/UsefulLinks/WearOsSmartwatch.md
index 814ad04d08fb..c608bd908b1a 100644
--- a/docs/EN/UsefulLinks/WearOsSmartwatch.md
+++ b/docs/EN/UsefulLinks/WearOsSmartwatch.md
@@ -5,12 +5,27 @@
There are several watchfaces to choose from that are included in the base build of the AAPS Wear APK. These watchfaces include average delta, IOB, currently active temp basal rate and basal profiles and a CGM readings graph.
-Ensure notifications from AAPS are not blocked on the watch. Confirmation of an action (e.g. bolus, tempt target) comes via a notification which you will need to swipe and tick.
-
Some available actions on the watchfaces are:
* Double tap on the BG to get to the AAPS menu
* Double tap on the BG graph to change the graph's time scale
+## Configuration
+
+Enable the Wear module in the [Config Builder](../SettingUpAaps/ConfigBuilder.md).
+
+Use the Wear Preferences 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.
+
+Ensure notifications from AAPS are not blocked on the watch. Confirmation of an action (e.g. bolus, tempt target) comes via a notification which you will need to swipe and tick.
+
## Changing to an AAPS Watchface on your WearOS watch
There are a number of watchfaces available in the standard build of the AAPS Wear OS APK build. Once you have installed the AAPS Wear APK on your watch, they will be available. Here are the steps for selecting one:
diff --git a/docs/EN/images/BolusAdvisor.png b/docs/EN/images/BolusAdvisor.png
new file mode 100644
index 000000000000..b50cbbf47eb8
Binary files /dev/null and b/docs/EN/images/BolusAdvisor.png differ
diff --git a/docs/EN/images/ConfBuild_Pump_AAPS32.png b/docs/EN/images/ConfBuild_Pump_AAPS32.png
new file mode 100644
index 000000000000..57570016fa47
Binary files /dev/null and b/docs/EN/images/ConfBuild_Pump_AAPS32.png differ
diff --git a/docs/EN/images/SMBs.png b/docs/EN/images/SMBs.png
new file mode 100644
index 000000000000..b9b0c699274d
Binary files /dev/null and b/docs/EN/images/SMBs.png differ