diff --git a/docs/EN/GettingHelp/BluetoothTroubleshooting.md b/docs/EN/GettingHelp/BluetoothTroubleshooting.md index 0549504ba2de..2c671da5ecd0 100644 --- a/docs/EN/GettingHelp/BluetoothTroubleshooting.md +++ b/docs/EN/GettingHelp/BluetoothTroubleshooting.md @@ -15,6 +15,18 @@ Some of these issues likely apply to other Bluetooth Insulin pumps too, the Medt --- +(bluetoothtroubleshooting-bluetooth-battery-optimisation)= + +## Bluetooth Battery Optimisation + +Newer versions of Android have enable Battery optimisation for the system Bluetooth app. This is known to cause some issues for Bluetooth pumps and CGMs. + +If you followed the [Setup Wizard](../SettingUpAaps/SetupWizard) and followed the configuration settings in the [Bluetooth Battery Optimisation](setup-wizard-bluetooth-battery-optimisation) section then this setting should be correct, however if you followed an older version of this guide its possible you have not changed this setting. + +Verify this is correctly configured if you have pump an CGM disconnections. + +--- + (bluetoothtroubleshooting-apps-using-nearby-device-permission)= ## Apps that use the "Nearby devices" Android permission can cause connection drops and Pod activation problems diff --git a/docs/EN/SettingUpAaps/SetupWizard.md b/docs/EN/SettingUpAaps/SetupWizard.md index e3b0b64d66be..91276e8fb5c9 100644 --- a/docs/EN/SettingUpAaps/SetupWizard.md +++ b/docs/EN/SettingUpAaps/SetupWizard.md @@ -110,6 +110,47 @@ Click the "NEXT" button: ![image](../images/setup-wizard/Screenshot_20231202_130002.png) +(setup-wizard-bluetooth-battery-optimisation)= +### Bluetooth battery optimisation + +Newer versions of Android have added battery optimisation to the system Bluetooth application too. + +As well as Disabling battery optimisation for **AAPS**, you will likely need to also disable this for the Bluetooth system app. Failure to do this may lead to pump connection dropouts and issues. + +***NOTE: The xDrip documentation covers how to do this here: [xDrip documentation](https://navid200.github.io/xDrip/docs/BluetoothBatteryOpt.html)*** + +Follow these steps on Android 16, other versions will varies slightly from the provided screenshots: + +1. Open Android settings and search for **Apps**, and open the Apps settings. + + ![settings_apps](../images/setup-wizard/settings_apps.png) + +2. You will see the App settings, however we need to expand to see all apps, click on **See all apps** to expand. + + ![settings_apps](../images/setup-wizard/apps_not_expanded.png) + +3. As the Bluetooth app is a system app its hidden by default, we need to show system apps. Click on the **three dots (hamburger)** on the top left (1). Then click on **Show System** (2). + + ![settings_apps](../images/setup-wizard/show_system.png) + +4. Search for the `Bluetooth` app and click on `Bluetooth` and/or `Legacy Bluetooth` if both are present ensure the procedure is followed for both. + + ***NOTE: It's safe to ignore the `Bluetooth MIDI Service` this is not used by AAPS*** + + ![settings_apps_1](../images/setup-wizard/apps_search_blue_13-14.png) ![settings_apps_2](../images/setup-wizard/apps_search_blue_12.png) ![settings_apps_3](../images/setup-wizard/apps_search_blue_15.png) + + 1. On Android 12 Click on `Battery`, Android 13+ Click on `App battery usage`, + + ![settings_apps_16](../images/setup-wizard/app_bluetooth.png)) ![settings_apps_12](../images/setup-wizard/app_bluetooth_12.png) + +5. On Android 12+ select the `Unrestricted` option, on Android 15+ you need to expand the `Allow background usage` setting, click on the section highlighted in red to do this then follow step 6 to complete. + + ![bluetooth_settings_apps_12](../images/setup-wizard/app_bluetooth_unrestricted_12-14.png) ![bluetooth_settings_apps_15](../images/setup-wizard/app_bluetooth_allow_background.png) + +6. On Android 16 Select ``Unrestricted`` + + ![settings_apps](../images/setup-wizard/app_bluetooth_allow_background_unrestrict.png) + ### Storage permission **AAPS** needs to log information to the permanent storage of your smartphone. Permanent storage means that it will be available even after rebooting your smartphone. Other information is just lost, as it is not saved to permanent storage. diff --git a/docs/EN/images/setup-wizard/app_bluetooth.png b/docs/EN/images/setup-wizard/app_bluetooth.png new file mode 100644 index 000000000000..1a49b8c033e2 Binary files /dev/null and b/docs/EN/images/setup-wizard/app_bluetooth.png differ diff --git a/docs/EN/images/setup-wizard/app_bluetooth_12.png b/docs/EN/images/setup-wizard/app_bluetooth_12.png new file mode 100644 index 000000000000..872a1177ec22 Binary files /dev/null and b/docs/EN/images/setup-wizard/app_bluetooth_12.png differ diff --git a/docs/EN/images/setup-wizard/app_bluetooth_allow_background.png b/docs/EN/images/setup-wizard/app_bluetooth_allow_background.png new file mode 100644 index 000000000000..bdc3fea8892e Binary files /dev/null and b/docs/EN/images/setup-wizard/app_bluetooth_allow_background.png differ diff --git a/docs/EN/images/setup-wizard/app_bluetooth_allow_background_unrestrict.png b/docs/EN/images/setup-wizard/app_bluetooth_allow_background_unrestrict.png new file mode 100644 index 000000000000..6844f86f8a69 Binary files /dev/null and b/docs/EN/images/setup-wizard/app_bluetooth_allow_background_unrestrict.png differ diff --git a/docs/EN/images/setup-wizard/app_bluetooth_unrestricted_12-14.png b/docs/EN/images/setup-wizard/app_bluetooth_unrestricted_12-14.png new file mode 100644 index 000000000000..5c51a48d9452 Binary files /dev/null and b/docs/EN/images/setup-wizard/app_bluetooth_unrestricted_12-14.png differ diff --git a/docs/EN/images/setup-wizard/apps_not_expanded.png b/docs/EN/images/setup-wizard/apps_not_expanded.png new file mode 100644 index 000000000000..41f0a4a88c0a Binary files /dev/null and b/docs/EN/images/setup-wizard/apps_not_expanded.png differ diff --git a/docs/EN/images/setup-wizard/apps_search_blue_12.png b/docs/EN/images/setup-wizard/apps_search_blue_12.png new file mode 100644 index 000000000000..e07731cb3148 Binary files /dev/null and b/docs/EN/images/setup-wizard/apps_search_blue_12.png differ diff --git a/docs/EN/images/setup-wizard/apps_search_blue_13-14.png b/docs/EN/images/setup-wizard/apps_search_blue_13-14.png new file mode 100644 index 000000000000..527ee48c9641 Binary files /dev/null and b/docs/EN/images/setup-wizard/apps_search_blue_13-14.png differ diff --git a/docs/EN/images/setup-wizard/apps_search_blue_15.png b/docs/EN/images/setup-wizard/apps_search_blue_15.png new file mode 100644 index 000000000000..9a42868b4671 Binary files /dev/null and b/docs/EN/images/setup-wizard/apps_search_blue_15.png differ diff --git a/docs/EN/images/setup-wizard/settings_apps.png b/docs/EN/images/setup-wizard/settings_apps.png new file mode 100644 index 000000000000..8e0648776f30 Binary files /dev/null and b/docs/EN/images/setup-wizard/settings_apps.png differ diff --git a/docs/EN/images/setup-wizard/show_system.png b/docs/EN/images/setup-wizard/show_system.png new file mode 100644 index 000000000000..150df6ba1f9f Binary files /dev/null and b/docs/EN/images/setup-wizard/show_system.png differ