The instructions below apply to the AAPS Wear apk that you need to build. If you haven’t built it yet, see the linked guide here. When building, make sure to use the same keystore file that you used for the phone AAPS apk.
You can also use some of the information for the AAPSClient and PumpControl Wear apk. Each Wear app will communicate with it's matching phone app. Par exemple : l'application AAPSClient Wear ne peut être utilisée que pour afficher les données de AAPSClient et pas celles d'AAPS.
Installez l'apk AAPS Wear en utilisant Wear Installer 2, Easy Fire Tools (décrit ci-dessous) ou ADB.
Aucune limitation dans les opérations AAPS Wear.
(BuildingAapsWearOs-WearOS5)=
Par example: GW4, GW5, GW6
Installez l'apk AAPS Wear en utilisant Wear Installer 2, Easy Fire Tools (décrit ci-dessous) ou ADB.
Aucune limitation dans les opérations AAPS Wear.
:class: warning
**LES MISES A JOUR FUTURES DE FIRMWARE RISQUENT PROBABLEMENT DE SUPPRIMER LA COMPATIBILITE DES CADRANS AAPS : DESACTIVEZ LES MISES A JOUR DE LA MONTRE**.
Par example: GW7, GW Ultra
:class: warning
L'installation des cadrans AAPS doit être effectué avec [Wear Installer 2](https://www.youtube.com/watch?v=yef_qGvcCnk) après avoir installé l'application sur la montre.<br>
Un changement accidentel du cadran AAPS vers un autres cadran nécessitera de refaire la procédure d'installation ci-dessous.<br>
Le changement des paramètres spécifiques des cadrans comme : SombreDark, Séparateur Invisible, etc. n'est possible que via l'application AAPS montre.<br><br>
**LA MISE A JOUR DES FIRMWARE SUPPRIMERA LA COMPATIBILITE AVEC LES CADRANS AAPS : DESACTIVEZ LES MISES A JOUR DE LA MONTRE**.
Envisagez alternativement GlucoDataHandler avec une complication.
Non compatible avec les cadrans AAPS.
Considérez GlucoDataHandler avec une complication.
Cette section suppose que vous êtes totalement nouveau dans les Smartwatches, et vous donne l'orientation de base d'une montre classique, la Galaxy Watch 4, suivi d'un guide étape par étape pour configurer AAPS sur la montre.
This guide assumes the Samsung Galaxy watch you are setting up is running Wear OS version 3 or lower. If you are setting up a watch running Wear OS 4/OneUI 5 or later, you will need to use a new ADB pairing process, this is explained in the Samsung software on your phone and will be updated here in due course.
Here are basic setup guides for the Galaxy Watch 5 and Galaxy Watch 6
After basic setup of your watch according to the video above, go to the playstore on the phone and download the following apps: "Galaxy Wearable" “Samsung” and either “Easy Fire tools” or "Wear Installer 2".
There are plenty of 3rd party YouTube videos which will help you with getting familiar with your new smartwatch, for example:
https://www.youtube.com/watch?v=tSVkqWNmO2c
The app “Galaxy Wearable” also has an instruction manual section in it. Open galaxy wearable on the phone, search for the watch, attempt to pair the watch with the phone. Depending on your version, this may prompt you to install a further 3rd app “galaxy watch 4 plugin” from the playstore (takes a while to download). Install this on the phone, and then attempt to pair the watch and phone again in the wearable app. Go through a series of menus and tick various preferences.
You need to make sure that the email account you use to set up the Samsung account has a date-of-birth such that the user is age 13+, as otherwise the Samsung permissions are really difficult to approve. If you have given your child under 13 a Gmail account and are using that email address, you cannot simply change it to an adult account. One way around this is to modify the current date-of-birth to make the current age 12 years and 363 days old. The following day, the account will be converted to an adult account, and you can progress with the setup of the Samsung account.
(remote-control-transferring-the-aaps-wear-app-onto-your-aaps-phone)=
Loading the Wear.apk from Android Studio to your phone can be done either by:
a) using a USB cable to put the AAPS wear apk file onto the phone, and then “side-load” it to the watch. Transfer Wear.apk to the phone via USB into the downloads folder; or
b) cut and paste Wear.apk from Android Studio onto your Gdrive.
To side-load AAPS onto the watch You can use either: 1) Wear Installer 2 2) Easy Fire tools 3) Android Debug Bridge (ADB) Here we recommend Wear Installer 2, because the instructions and process in the video are so clear and well-explained. If Wear Installer 2 does not work for you try via
Wear Installer 2, developed by Malcolm Bryant can be downloaded from Google Play onto your phone and can be used to side-load the AAPS wear app onto the watch. The app includes a handy ‘how to sideload’ video.
For Wear OS 5 watches follow [this video](https://www.youtube.com/watch?v=yef_qGvcCnk).
See troubleshooting tips [below](#BuildingAapsWearOs-WearOS5-TShoot).
This provides all the necessary detail (best to open the video on a separate device so you can watch it whilst setting up the phone).
As mentioned in the video, once complete, switch ADB debugging off on the watch, to avoid draining the smartwatch battery.
Alternatively, but not for Wear OS 5, you can:
- Download Easy Fire Tools from the Play Store onto phone
- Make yourself a developer in the watch (once set up and connected to phone):
Go to settings >about watch (bottom option) -> software info -> software version.
Rapidly tap on “ software version” until a notification appears that the watch is now in "developer mode".
Return to the top of settings menu, scroll to the bottom and see “developer options” below “about watch”.
In “developer options”, turn on “ADB debugging” and “wireless debugging”. The latter option then reveals the IP address of the watch, the final two digits of which changes each time the watch is paired with a new phone. It will be something like: 192.168.1.214.5555 (ignore the last 4 digits). Note that the last two digits (here, “20”) of this address will change every time you change to a new phone handset for AAPS.
STEP 3) Enter IP address e.g. 192.168.1.214 into Easy Fire tools on the phone (go into the left hamburger, settings and enter the IP address).
Then click the plug socket icon on the top right. It will turn green when connected.
STEP 4) Follow the instructions here to side-load (i.e. transfer) aaps-wear.apk onto the smartwatch using Easy Fire tools
(BuildingAapsWearOs-WearOS5-TShoot)=
Connect your smartwatch and computer to the same Wi-Fi network.
- To install ADB download it from: https://developer.android.com/tools/releases/platform-tools
- Open a terminal.
- For Windows, create a new folder named
adbunder your diskC:. Open theplatform-tools-latest-windows.zipfile you downloaded above. Copy all files insideplatform-toolstoC:\adband open this folder with a command prompt (right click and Open in Terminal). Type the command below to set the path to the folder where ADB is located:setx PATH "%PATH%;C:\adb" - For Mac instead of installing manually you can use homebrew:
brew install android-platform-tools
On the watch:
- Go to Settings → About watch → Software Information
- Tap Software version 7 times until you see Developer mode enabled.
- Go to Settings → Developer options. Enable ADB debugging
- Go to Settings → Developer options → Wireless debugging → Pair new device
You will see a Wi-Fi paring code and IP address and port appearing: 
-
In the terminal:
adb pair ipaddress:portE.g.adb pair 10.10.1.125:36299 -
You will be asked for the pairing code. Enter it.
-
You will see a response:
Successfully paired to 10.10.1.125:36299 [guid=adb-RXXXW20LMKJY-eh5zBj] -
In the terminal type:
adb devices.
You should see something like:
List of devices attached
10.10.1.125:36299 offline
adb-RFAW20LMKJY-eh5zBj._adb-tls-connect._tcp device -
Now go to the folder on your computer where the Wear apk is and type
adb install wear-full.apk
with wear.apk replaced by the name of your apk file. -
You will see:
Performing Streamed Install
Success
- Do not use Wi-Fi Tethering. That won't work.
- You do not need to enable adb debugging on the phone (only on the watch). Disable adb debugging on the Phone.
- Make sure you are connecting to your local network where phone and watch can see each other (do not use your Wi-Fi guest network to connect).
- For GW7 you need to install using Wear Installer 2 as it gives you the option to select the AAPS (Custom) watchface on installation.
- Make sure both watch and phone are on the same network and Wi-Fi device. Especially Wi-Fi repeaters or access points may create problems.
- Make sure to be near your main router, then restart both phone and watch.
Pairing :
- Watch: Wireless Debugging: note the IP address.
- Wear Installer: Enter the IP on the in Wear Installer app.
- Select Pair new, note the pairing code and port number displayed.
- Wear Installer: enter the paring code + space + port number.
- Wear installer should report pairing was successful. If it does not, exit the Wear Installer, then try again.
Once paired you should be able to install the AAPS wear apk:
- Exit/close, then restart Wear Installer.
- On wireless debug, note the IP and Port number and make sure you check/enter the IP and port number in Wear Installer.
- Note: the port number is different from the one used for pairing!
The final step is to configure AAPS on the phone to interact with Wear.apk on the watch. To do this, enable the Wear plugin in Config Builder:
-
Go to the AAPS app on the phone
-
Select > Config Builder in the left-hand Hamburger tab
-
Tick for Wear selection under Synchronization
To change to a different AAPS watchface, press on the home screen of the watch and it will come to “customise”. Then swipe right until you get to all the AAPS faces.
If the AAPS Wear.apk has been successfully side-loaded onto the smartwatch, it will look like this:
For certain smart watches, like the Samsung Galaxy, 'Remote Connection' under Samsung Galaxy's Advanced Features must be switched on to use Wear.apk & AAPS remotely via wifi.
- If EasyFire tools does not connect or if you are receiving ‘authorisation failed’ > check IP address has been correctly entered.
- Check that the smartwatch is connected to the internet (and not just connected to the phone via Bluetooth).
- Check that the AAPS Phone and smartwatch are paired or linked in Samsung app.
- It may also help to do a hard restart of Phone and smartwatch (meaning turning phone on and off)
- Assuming you have managed to download the Wear.apk onto your phone but you are not receiving any BG data, check that you have side-loaded the correct AAPS apk version onto the watch. If your AAPS wear.apk version is listed as any of the following: a) “wear-AAPSClient-release’; b) ‘wear-full-release.aab’; or c) the word ‘debug’ appears in the title, you have not selected the correct Wear OS apk version during the build.
- Check that your router is not isolating the devices from one another.
More troubleshooting tips can be found here
(WearOS_changing-to-AAPS-watchface)=
Il existe plusieurs cadrans de montre disponibles dans la version standard de l'APK AAPS pour Wear OS. Une fois que vous avez installé l'APK AAPS Wear sur votre montre, ils seront disponibles. Voici les étapes pour en sélectionner un :
- Sur votre montre (WearOS uniquement), appuyez longuement sur votre cadran actuel pour faire apparaître l'écran de sélection du cadran et faites défiler complètement vers la droite jusqu'à ce que vous voyiez le bouton "Ajouter un cadran de montre" et sélectionnez-le
- Faites défiler vers le bas de la liste jusqu'à ce que vous voyez la section "Téléchargées" et trouvez "AAPS (Perso)" et cliquez sur le milieu de l'image pour l'ajouter à votre shortlist de cadrans. Ne vous inquiétez pas de l'apparence actuelle de la montre "AAPS (Perso)", nous sélectionnerons votre skin préféré à l'étape suivante.
- Maintenant, ouvrez AAPS sur votre téléphone et allez au plugin Wear (activez-le dans la Configuration (dans le bloc Synchronisation) si vous ne le voyez pas dans vos plugins actuels en haut).
- Cliquez sur le bouton « Charger le Cadran » et sélectionnez le cadran que vous voulez
- Vérifiez sur votre montre, le cadran de "AAPS (Perso)" devrait maintenant afficher l'apparence que vous avez sélectionnée. Attendre quelques secondes si nécessaire. You may now customize the complications, etc. by long pressing the watchface and then pressing the "Customize" button on the watchface image.
A - temps écoulé depuis le dernier calcul de la boucle
B - lecture du capteur MGC
C - nombre de minutes depuis la dernière lecture MGC
D - changement par rapport à la dernière lecture MGC (en mmol ou mg/dl)
E - variation moyenne des lectures MGC depuis 15 minutes
F - niveau de batterie du téléphone
G - débits de basal (en U/h ou en % pendant un DBT)
H - BGI (blood glucose interaction) -> the degree to which BG “should” be rising or falling based on insulin activity alone.
I - glucides (glucides actifs | e-glucides à venir)
J - Insuline Active (bolus | basal)