Дистанционное управление AAPS
Существует 4 наиболее эффективных инструмента для удаленного управления AAPS:
SMS команды (телефон фолловера может быть как Android, так и iOS), 2) Клиент AAPS (телефон фолловера только Android), 3) Nightscout (Android, iOS или любой компьютер/устройство с доступом к браузеру)
Умные часы (Android)
Первые три варианта вполне подходят родителям или опекунам, однако умные часы весьма удобны не только им, но и взрослым с диабетом.
Некоторые соображения по поводу настройки удаленного управления AAPS для детей
Подумайте о том, каким образом вы обеспечите нахождение телефона ребенка в зоне доступа его помпы и НМГ. Это еще то испытание с маленькими детьми, которые пока не несут ответственность за свой телефон. Убедитесь, что выбрали для AAPS телефон с хорошим качеством и дальностью связи Bluetooth и подобрали удобный для ребенка способ ношения помпы и телефона (_например, _ можно использовать поясные сумочки).
Найдите время, чтобы спокойно настроить и отладить все удаленные команды, находясь рядом с ребенком, прежде чем начать удаленно подавать команды и следить за сахарами. Многие родители для этого выбирают школьные каникулы или выходные.
Убедитесь, что учителя или другие ответственные взрослые, в курсе терапии вашего ребенка и выясните, как удаленное управление может повлиять на имеющуюся терапию.
Многие родители находят полезным иметь отдельное устройство для мониторинга состояния ребенка другими, например недорогой телефон-«фолловер» для учителя.
Examples for school care plans for children of different ages can be found in the “files section” of the AAPS Facebook page.
Какие ваши действия на случай, когда удаленное управление не работает (например, возникли проблемы с интернетом или потерялся сигнал bluetooth)? Всегда учитывайте, что может произойти с AAPS, если вы внезапно потеряете возможность отправить новую команду. AAPS перезапишет значения базы, ФЧИ и УК, указанные в помпе, значениями из текущего профиля. Если вы устанавливаете более агрессивный профиль - всегда делайте его временным (т.е. указывайте длительность действия профиля) на случай, если удаленное управление станет недоступным. Помпа вернется к стандартному профилю по истечении указанного времени.
1) SMS команды
Существует возможность удаленно управлять AAPS с помощью текстового (SMS) сообщения на основе SMS-команд. Команды SMS можно отправлять на AAPS с любого типа телефона (iPhone|Android).
SMS-команды очень полезны:
Для обычного дистанционного управления
Для дистанционного введения инсулина
На территориях с плохо работающим интернетом, где могут проходить текстовые сообщения, а прием данных/интернет ограничен. Полезно при путешествиях в отдаленные районы ( в походах, на лыжных базах и т.п.).
Если другие методы дистанционного управления (Nightscout/AAPSClient) временно не работают
Безопасность SMS-команд
При включении SMS коммуникатора в AAPS, учитывайте, что телефон, который настроен для подачи удаленных команд, может быть украден и/или использован кем-то еще. Всегда блокируйте телефон PIN-кодом. Рекомендуются надежные пароли и/или биометрические замки, отличные от мастер-пароля (пароль, который требуется для изменения настроек AAPS). Для корректной работы SMS команд в настройках должен быть активирован второй номер телефона, даже если у вас только один основной опекун/фоллоуэр. Второй номер может понадобиться чтобы временно отключить SMS-коммуникатор (командой «SMS stop»), если главный телефон попал в чужие руки. Версии AAPS 2.7 и новее также используют приложение Authenticator).
Различные типы SMS команд
В нижеприведенной таблице команд SMS представлены все возможные SMS-команды. Для облегчения понимания приводятся Примерные значения. Команды имеют такой же диапазон возможных значений (цели, процентный профиль и т. д.), который разрешен в самом приложении AAPS. Команды в таблицах перечислены в том порядке, в котором обычно используются; первые две таблицы содержат большую часть команд SMS для AAPS.
Таблицы SMS команд
Нужна ли аутентификация?
Из приведенной таблицы видно, что некоторые команды SMS дают немедленный ответ, а другие требуют аутентификации по коду безопасности из дополнительного приложения и PIN-коду (см. подробнее ниже). Простой запрос, например «bg» (запрашивает обновление ГК) быстро вводится, не требует аутентификации и возвращает информацию о статусе AAPS - см. ниже:
Команды, которым требуется больше безопасности, требуют ввести код, например:
Как настроить SMS-команды
The overall process is as follows:
1) Скачиваем аутентификатор (на телефон родителя/опекуна)
2) Проверяем настройки телефона (телефон с AAPS)
3) Синхронизируем дату и время (телефон родителя и телефон AAPS)
4) AAPS settings (APPS phone)
5) Проверяем работу команд SMS (телефон родителя и AAPS)
Приступим!
Скачиваем аутентификатор: На смартфоне родителя скачиваем (из App store или Google play) и установливаем один из аутентификаторов на выбор из списка ниже:
Аутентификатор Google - Android / iOS
Эти приложения содержат ограниченный по времени одноразовый 6-значный пароль. Можно использовать любое приложение Authenticator, которое поддерживает маркеры TOTP RFC 6238. Microsoft Authenticator не работает.
Проверьте настройки телефона: В настройках телефона AAPS перейдите к приложениям > AAPS > Разрешения > SMS > Разрешить SMS
Синхронизация дат и времени: В телефоне с AAPS и телефоне опекуна, проверьте синхронизацию даты и времени. Как именно вы это делаете, зависит от конкретных моделей телефонов, возможно придется попробовать различные настройки.
Пример (для смартфона Samsung S23): Настройки – общее управление дата и время - автоматическая дата и время
Некоторые опции могут быть недоступны (затенены) из-за настроек семейной учетной записи ребенка. Эта настройка даты и времени называется «автоматически» на iPhone опекуна/родителя. Если вы не уверены, синхронизированы ли телефоны, не волнуйтесь, это можно настроить в дальнейшем.
Настройки AAPS:
i) После проверки настроек телефона, в самом приложении AAPS, через левое верхнее меню перейдите в Конфигуратор:
ii) Включите «SMS-сообщение», установив флажок, затем нажмите «шестеренку» и получите доступ к экрану настройки SMS-сообщения:
Примечание. В качестве альтернативного пути к Конфигуратору можно также использовать новую вкладку «SMS Communicator» в верхней части окна AAPS, затем щелкните правой кнопкой мыши по контекстному меню справа для этой страницы, чтобы перейти к настройкам SMS коммуникатора.
iii) На экране настроек включите «разрешить удаленные команды с помощью SMS»:
iv) Enter the caregiver phone number(s). Include the country code and exclude the first “0” of the phone number, as shown in these examples:
Номер телефона великобритании: +447976304596
Номер телефона сша: +11234567890
Номер телефона франции: +33612344567
etc.
Обратите внимание, что «+» перед номером может быть обязательным или не потребуется в зависимости от вашего местоположения. Для определения этого отправьте тестовое сообщение, которое будет отображать полученный формат на вкладке SMS Communicator.
Если у вас более одного номера телефона, разделите их точкой с запятой БЕЗ пробела между цифрами (это критично!). Select “OK”:
v) Выберите PIN-код, который вы (и другие опекуны) будут использовать в конце кода аутентификатора при отправке SMS-команды.
Требования к PIN-коду:
•от 3 до 6 цифр
•не одинаковые цифры (напр. 1111 или 1224)
•не последовательные цифры (напр. 1234)
vi) На экране настроек выберите «Настройка Аутентификации»
● Следуйте пошаговым инструкциям на экране.
● Откройте установленное приложение-аутентификатор на телефоне опекуна создайте новое соединение и
● Use the caregiver phone to scan the QR code provided by AAPS, when prompted.
● Проверьте одноразовый код доступа от аутентификатора на телефоне опекуна, за которым следует ваш PIN:
Пример:
Маркер из приложения идентификации-457051
Ваш обязательный PIN-код 2401
Код для проверки: 4570512401
If the entry is correct, the red text “WRONG PIN” will change automatically to a green “OK”. Процесс завершен, нет кнопки «OK», которую нужно нажать после ввода кода:
Теперь все готово для работы с помощью SMS-команд.
First steps using SMS commands
Чтобы проверить правильность настройки, отправьте «bg» в качестве SMS-сообщения с телефона опекуна на телефон AAPS. Вы должны получить ответ, похожий на этот:
Now try an SMS command that requires the authenticator. To do this, send a text from the caregiver’s phone with the required command to theAAPS phone (e.g. “target hypo”). Телефон опекуна получит смс с предложением ввести пароль аутентификации с шестизначными цифрами из приложения-аутентификатора, с последующим секретным PIN-кодом известным только родителям/опекунам (строка из десяти цифр в общей сложности, при условии, что ваш PIN-код состоит из 4х цифр).
Ниже показан пример с командой SMS «target hypo», чтобы установить временную цель гипо:
● В этом примере ваш PIN-код 1289
Маркер из приложения идентификации-274127
● При появлении запроса отправьте текст 2741271289
Команды отправляются на английском языке. Ответ на локальном языке. Когда будете отправлть команду в первый раз, держите оба телефона при себе, чтобы убедиться, что все работает:
Телефон опекуна получит SMS от AAPS в подтверждение успешного выполнения удаленной команды SMS. Существует несколько возможных причин, по которым команда не проходит:
● Настройка SMS-команд не завершена/не корректна
● Отправлена команда в некорректном формате (например, “disconnect pump 45” вместо “pump disconnect 45”)
● Использован неправильный или просроченный код аутентификации (обычно лучше подождать несколько секунд чтобы получить свежий код, если истекает срок действующего)
● Код подтверждения+PIN-код в порядке, но возникла задержка в отправке/прибытии SMS, что заставило AAPS вычислить истекший код аутентификации
● The AAPS phone is out of range/contact with the pump
● Система уже занята вводом болюса
Если ваша команда успешна, вы получите ответ-подтверждение. Если возникла проблема, вы получите сообщение об ошибке.
Распространенные ошибки приведены в примерах ниже:
Дополнительные примечания о безопасности в SMS-командах
Минимальная задержка между командами на болюс по умолчанию составляет 15 минут. Из соображений безопасности следует добавить хотя бы два авторизованных номера телефона для уменьшения этого значения. Если вы дистанционно пытаетесь повторно ввестиь болюс в течение 15 минут после предыдущего, вы получите ответ “Дистанционный болюс невозможен. Повторите позже”
Если вы хотите прекратить возможность отправлять SMS команды с телефона опекуна, используйте экстренную кнопку “RESET AUTHENTICATORS” в AAPS (см. настройки выше, ссылка) или отправьте SMS-команду “SMS stop”. Сбросив аутентификаторы, вы делаете ВСЕ телефоны опекунов недействительными. Вам придется их снова настроить.
Передача SMS-команд о болюсах на еду
Дистанционное введение болюсов может быть сделано только с помощью SMS команд, оно не может осуществляться через NightScout или AAPSClient. Однако углеводы могут быть внесены любым из трех методов. В одном SMS-сообщении невозможно отправить углеводы и инсулин. Эти команды должны отправляться отдельно следующим образом:
Отправьте команду на болюс (например»bolus2»,которая инициирует введение 2 единиц) при помощи SMS, что эквивалентно нажатию на иконку «шприца» в AAPS. 2) Отправьте SMS об углеводах (напр. “carbs 20” внесет 20 г углеводов). Это эквивалентно использованию иконки “углеводы” в AAPS.
Порядок отправки этих команд важен.. Если любым методом внести запись о значительном количестве углеводов при активированнной функции SMB, AAPS может моментально отреагировать, введя часть болюса. Поэтому если после этого отправить команду на болюс, может возникнуть задержка с выполнением и появится сообщение «вводится болюс», после которого придется проверять количество инсулина, введенного в виде микроболюса. Или, если вы не обнаружили SMB, а ваш собственный болюс также введен успешно, может оказаться, что на еду отправлено слишком много инсулина. Поэтому, если дистанционно отправлять команду на болюсы, следует всегда вводить болюс перед внесением записи об углеводах. Если предпочитаете, можно использовать сочетание Nightscout или AAPSClient с командами SMS. Запись об углеводах вносится в Nightscout без проверки подлинности (см. раздел инструкций ниже), и поэтому происходит быстрее чем SMS-команды.
Ответы на часто задаваемые вопросы по SMS-командам и устранение неполадок
В: Что не может быть выполнено при помощи команд SMS?
You cannot set a temporary profile switch (so for example, setting “profile exercise“ for 60 minutes), although you can permanently switch to “profile exercise”. Временные профили можно устанавливать через Nightscout или AAPSClient.
Нельзя отменить автоматизацию или задать определенные пользователем цели, но есть другие решения: представьте себе обычную цель профиля 5.5. В AAPS установлена автоматизация всегда устанавливать высокую цель 7.0 между 14.30 и 15.00 из-за урока физкультуры в школе, а условием срабатывания автоматизации является «отсутствие врем. целей». На этой неделе незадолго до занятий вам сообщили о замене урока физкультуры на ланч с пиццей, но ваш ребенок уже в школе с телефоном AAPS. Если высокая временная цель 7.0 запускается автоматизацией, а вы ее отменили (на телефоне AAPS или удаленно), то условия для автоматизации все равно соблюдены, и AAPS просто установит высокую цель еще раз, минутой позже.
Если у вас есть доступ к телефону AAPS, вы можете отключить/изменить автоматизацию, или, если вы не хотите этого делать, вы можете просто установить новую временную цель 5.6 на 60 минут на вкладке Действия или нажав на кнопку Цель. Это помешало бы автоматизации устанавить высокую цель 7.0.
Если же у вас нет доступа телефону с AAPS SMS команда может приблизительно исправить ситуацию: например, с помощью команды «target meal (ожидаемый прием пищи) установить цель 5.0 на 45 минут (другие цели по умолчанию 8.0 для нагрузки или гипо, см. таблицу). Но командами SMS нельзя указать точную величину (например, 5.6 на 60 мин.), для этого понадобится AAPSClient или Nightscout.
В: Что произойдет, если я передумаю отдавать команду, которую только что отправил?
AAPS выполняет только самую свежую команду. Поэтому, если вы отправили «bolus 1.5», а затем, не аутентифицируясь, новую команду «bolus 1», то она проигнорирует предыдущую команду 1.5. AAPS всегда отправляет на телефон опекуна подтверждение SMS команды, до ввода кода аутентификации, а также ответ после действий.
Если не получен ответ на команду SMS, то это может быть по одной из следующих причин:
Сообщение не попало на телефон (проблемы с сетью). 2) AAPS все еще обрабатывает запрос (напр. болюс, который отнимает некоторое время в зависимости от скорости обмена). 3) Телефон AAPS не имеет хорошего соединения Bluetooth с помпой при получении команды, и ему не удается выполнить команду (обычно это вызывает оповещение на телефоне AAPS). Невозможно остановить команду, которая уже подтверждена (аутентифицирована). Многие команды (кроме болюсов и записей об углеводах) могут быть легко отменены или их последствия смягчены. По поводу ошибок в болюсах и записях об углеводах, также можно принять меры. Например, внесена запись о 20 г углеводов, но ваш ребенок съел только 10 г, и нет возможности удалить ее непосредственно в телефоне AAPS, вы можете установить высокую временную цель или понизить % профиля, чтобы снизить агрессивность AAPS.
Q. Почему я получаю несколько SMS одного сообщения?
Если же вы неоднократно получаете одно и то же сообщение (напр. переключатель профиля) возможно случайно возникло закольцовывание с другими приложениями. Например, с xDrip+. Если это так, убедитесь, что xDrip+ (или любое другое приложение) не загружает данные терапии в NS.
Q. Я только что настроил команды SMS, и теперь получаю слишком много текстовых сообщений. Можно уменьшить их частоту или остановить?
Использование SMS команд может генерировать много автоматических сообщений на телефон опекуна. Также могут приходить сообщения типа “basal profile in pump updated” (базальный профиль на помпе обновлен), если в AAPS настроена автоматизация. Полезно иметь тарифный план с неограниченным количеством SMS на телефоне AAPS (и на телефонах опекунов), а также отключить уведомления, оповещения или вибрации на SMS. Невозможно пользоваться SMS-командами и не получать эти сообщения. В связи с этим, альтернативный способ общения с ребенком (если он достаточно взрослый) может оказаться более предпочтительным. Альтернативные приложения для коммуникаций с опекунами AAPS включают Whatsapp, Lime, Telegram, и Facebook Messenger.
Q. Почему команды SMS не работают на моем телефоне Samsung?
Были сообщения об остановке работы SMS команд после обновления на телефоне Galaxy S10. Решается путем отключения опции «отправлять SMS как сообщения чата».
Q. Как исправить проблемы с приложением Android Messages?
Если у вас возникают проблемы с отправкой или получением SMS-команд в приложении Android Messages, отключите сквозное шифрование как на телефоне опекуна, так и на детском телефоне:
● Откройте конкретный SMS-диалог в приложении Messages
● Select the options ellipsis in the top right corner
● select “Details”
● Активируйте опцию «Отправлять только SMS и MMS”
2) Клиент AAPS
Обратите внимание, что NSClient теперь заменен на AAPSClient для AAPS версии 3. и выше, подробности см. в примечаниях к версиям.
Для версий AAPS старше AAPS 3.2, если у вас родительский Android-телефон, вы можете напрямую скачать и установить приложение AAPSClien. AAPSClient похож внешне на сам AAPS, но позволяет опекунам отправлять команды в AAPS дистанционно:
There are 2 versions of the app you can download, AAPSClient & AAPSClient2. Единственное различие между двумя версиями - наименование приложения. Что позволяет дважды устанавливать приложение AAPSClient на один и тот же телефон и следить за двумя разными пользователями или аккаунтами Nightscout одновременно.
Для загрузки AAPSClient, нажмите на app-AAPSClient-release-3.1.0.3.apk
Затем перейдите в загрузки на своем компьютере. В Windows, -downloads_ покажется лента справа:
После загрузки нажмите на показать в папке
Теперь приложение (apk) может быть либо:
Перенесено при помощи кабеля USB на телефон опекуна; или перетащено в папку диска G, а затем добавлено на телефон опекуна после нажатия на app-AAPSClient-release-3.0.3.apk
Возможности AAPSClient включают:
AAPSClient allows the caregiver to make many of the adjustments that are allowed directly in AAPS (excluding insulin boluses) remotely, via the mobile or internet network. The main benefits of AAPSClient are the speed and ease with which caregivers/parents can use it to remotely control APPS. AAPSClient can be much faster than entering SMS Commands, if delivering a command which would require authentication. Commands entered on AAPSClient are uploaded onto Nightscout.
Remote control through AAPSClient is only recommended if your synchronization is working well (i.e. you don’t see unwanted data changes like self-modification of TT, TBR etc) see release notes for Version 2.8.1.1 for further details.
NS Client with smartwatch options
A smartwatch can be a very useful tool for helping to manage AAPS with kids. A couple of different configurations are possible. If AAPSClient is installed on the parents phone, the AAPSClient WearOS app can be downloaded and installed on a compatible smartwatch which is connected to the parent’s phone. На них будет отображаться текущая ГК, статус замкнутого цикла, возможность вписать углеводы, временные цели и изменения профиля. Возможности ввести болюс с приложения на WearOS не будет. You can read more about Smartwatches here.
3) Nightscout
As well as Nightscout being a server in “the Cloud”, there is also a dedicated Nightscout app which can be downloaded directly from the App Store on your iPhone. If you have an Android follower phone, there is not a dedicated Nightscout app and it is better to use AAPSClient, or, if you only want to follow, and not send treatments you can download and install the Nightwatch app from the Playstore.
Once you have installed the Nightscout app on your iPhone, open the app and follow the set-up prompts, entering your Nightscout address (see below, left). The form of this may vary depending on how your Nightscout is hosted. (e.g. http://youraddresshere.herokuapp.com). Then enter your Nightscout API secret (see below, right). If not prompted for your API password, then you need to enter this by clicking on the padlock at the top of the app:
More info on setup is available directly from Nightscout
When you first log in, you will have a very simple display (below, left). Customise the display options, by selecting the “hamburger” in the top right and scrolling down:
Scroll down through to “Settings”. You may wish to change the “scale” to “linear” as the default for the BG display is logarithmic, and under “render basal” select “default” so that the pump basal shows up. Continue to scroll down until you get to “show plugins”. You need to make sure “careportal” is checked, and can also select various other metrics (most useful are: IOB, care portal, pump, cannula age, insulin age, basal profile and OpenAPS).
Importantly, you now need to click “save” at the bottom for these changes to take effect.
After pressing “save” the app will return to your main Nightscout screen which will look a little like this:
Looking in more detail at the top left menu of the Nightscout app:
There is a huge amount of information on the status of the AAPS system in the grey tabs (and even more information is revealed if you tap the tab) on this screen:
Sending treatments through the Nightscout app to AAPS
To set-up sending treatments from the Nightscout app to AAPS, on the main AAPS phone, go into the AAPSClient tab in the AAPS app. Open the right-hand dot menu, and open AAPSClientpreferences – synchronisation and select the relevant options in this menu. Set it to receive the different commands (temporary targets, etc) and also to synchronise profiles. If things don’t seem to be synchronised, go back to the AAPSClient tab and select “full synchronisation” and wait a few minutes.
Nightscout on your iPhone has all the same functions as Nightscout on your PC. It allows you to send many commands to AAPS, but it does not allow you to send insulin boluses.
Cancelling negative insulin to avoid repeat hypos
Although you cannot actually bolus insulin, you can however “announce” insulin through Nightscout as a “correction bolus”, although it is not delivered. Because AAPS now takes that fake insulin bolus into account, announcing insulin actually works to make AAPS less aggressive, and can be useful for cancelling negative insulin and preventing lows in the event that your profile has been too strong (for example due to prior exercise). You will want to check this for yourself in the presence of the AAPS phone, in case your Nightscout setup differs.
Some of the most useful Nightscout commands are described in the table below.
Nightscout command table
Read more about Nightscout options here
Tips for getting the most out of the Nightscout app
1). If you get “stuck” on a page and want to be able to see the main screen again, just click “refresh” (bottom middle) and this will take you back to the Nightscout homepage with the BG graph.
To see the current profile which is running on the phone, press the various icons on the screen above the graph. More info (current carb ratio, sensitivity and timezone etc.) can be seen by pressing “basal” and “OpenAPS” gives info about the profile and current target etc. Both the phone battery% and the pump battery % can also be monitored. BWP gives information on what the algorithm thinks will happen in the future, given the IOB and COB.
4) Smartwatches
Smartwatches are becoming increasingly used with AAPS both for adults with diabetes and carers/parents of children with diabetes.
General advantages of using smartwatches with AAPS
Smartwatches - depending on the model - can be used in many different ways with AAPS. They can be used to fully or partly control AAPS, or simply to remotely check glucose levels, insulin-on-board, and other parameters.
Integrating a smartwatch with AAPS can be useful in many situations, including driving a car or (motor) bike and during exercise. Some people feel that looking at a watch (in a meeting, party, dinner table etc.) is more discreet than looking on a phone. From a security perspective, a smartwatch can also be beneficial while on the move, enabling user to have their AAPS phone stored out of sight (like inside a bag), but with the aid of the smartwatch for remote control use.
Specific advantages for parents/carers using AAPS
For a child - if their AAPS phone is nearby - a caregiver can use a smartwatch to monitor or make modifications without needing to use the AAPS phone. This can be useful, for example, if the AAPS phone is hidden away in a pump belt.
A smartwatch can be used either in addition to, or as an alternative to the PHONE-based options for remote control or following only.
Additionally, unlike parent/carer follower phones (which rely on the mobile network or wifi connection), bluetooth connected smartwatches can be useful in remote locations, like a cave, in a boat, or half-way up a mountain. If both devices (AAPS phone and smartwatch) are on the same wifi network, they can also use wifi.
Different types of Smartwatch-AAPS interactions
Many of the possible smartwatch options available to AAPS users are detailed at Nightscout on your watch, so you are strongly advised to read those pages first to get a good idea of all the possibilities.
There are currently five main ways in which smartwatches are used in conjunction with AAPS. These are shown in the table below:
Please note this table was prepared in 2023, it is not exhaustive, and additional options are being added all the time.
Before you buy a smartwatch…
The exact model of smartwatch you buy depends on the desired function(s). Существует две таблицы, в которых приводятся модели совместимых: смартфонов и смартфонов и часов.
There are a huge number of options for smartwatch setups for use with AAPS, and this is a quickly moving field as new watches are released. Popular watch brands include Samsung Galaxy, Garmin, Fossil, Mi band and Fitbit. The different options summarised in the Table above are explained in more detail below, to help you decide which smartwatch is right for your situation.
If you are integrating a smartwatch with AAPS on a phone with the intention to remotely interact with AAPS, you also need to consider if the two devices are compatible with each other, particularly if you have an older, or an unusual phone. We intend to add a specific page to one of the spreadsheets concerning watch-phone compatibility.
In general, if you only want to follow glucose numbers and not interact with AAPS, there are a wider range of affordable and simpler watches you can use.
For Smartwatch Options 1 - 3: What is Wear OS?
The first three smartwatch options require the smartwatch to have Wear OS installed.
Wear OS is the operating system which runs on some modern Android smartwatches. In 2018, Google rebranded Android Wear 1.x to Wear OS from version 2.x. So, if a device is labelled “Android Wear” rather than Wear OS it may indicate an older version. If the description of the smartwatch indicates only compatibility with Android and iOS - it does not mean it is running Wear OS. It may be some other sort of Vendor specific operating system which is not compatible with AAPS. To support installation and use of any version of AAPS or AAPSClient, a smartwatch will need to be running Wear OS, and ideally be Android 10 or newer. As a guide, as of October 2023, the latest release of Wear OS is version 4.0 (based on Android 13).
If you install AAPS wear.apk on a Wear OS watch, there are a range of different custom AAPS watchfaces which can be selected. Alternatively, you can use a standard smartphone watchface, with your AAPS information included in small tiles known as “complications” on the face. A complication is any feature that is displayed on a watch face in addition to the time. Features like complications require Wear OS version 2.0 or newer to work.
What could my smartwatch look like with remote control of AAPS?
Examples of complications (where AAPS is embedded in an existing watchface) are shown here:
These are the currently available AAPS-dedicated watchfaces:
More information about the possible smartwatch faces and their functions can be found in Smartwatches
Watchfaces for Wear OS
Further details about the watchfaces and configurations for complications, including how to make your own, can be found here
Option 1) Standalone Watch running AAPS
It sounds like an attractive option, right? However, at present, only a few enthusiasts are experimenting with AAPS on a stand-alone watch. There are a limited number of smartwatches with a reasonable interface which also which work well with standalone use of AAPS and your CGM app. Popular models include the LEMFO LEM 14, 15 and 16. You will need to load the watch with the AAPS «full» apk (the apk which is usually installed on a smartphone) rather than the AAPS «wear» apk.
While there is no clear specification which helps you to know if a watch will work well for standalone AAPS use, the following parameters will help:
Android 10 or newer. 2) Being able to take the watchface off “square” mode to make text larger and easier to read. 3) Very good battery life. 4) Good bluetooth range.
Most of the frustrations of standalone AAPS watches come from interacting with a tiny screen, and the fact that the current AAPS full app interface has not been designed for a watch. You may prefer to use a stylus to edit AAPS settings on the watch, due to the restricted screen size, and some AAPS buttons may not be visible on the watch screen.
Additional challenges are that it is hard to get sufficient battery life, and watches with sufficient battery are often bulky and thick. Users report fighting with the OS and power-saving settings, difficulty in starting sensors on the watch, poor bluetooth range (for maintaining connection with both the sensor and pump) and questionable water resistance. Examples are shown in the photos below (photo credit: Janvier Doyon).
If you are interested in setting up a standalone watch, read the posts and comments on the AAPS Facebook group (good search options are “standalone” and “Lemfo”) and Discord for more information.
Option 2) AAPS on watch, for remote control of AAPS on a phone
Similarly to using a follower phone with either AAPSClient, Nightscout or SMS commands (link to sections) a smartwatch can be used to remotely control AAPS and provide full profile data. A key difference to using a follower phone is that the smartwatch to AAPS phone link is via bluetooth and does not require an authenticator code. As a side-note, users have reported that if both smartwatch and phone linked by bluetooth are also on the same wifi network, the watch may also interact with the smartphone over the wifi, giving a longer range of communication.
A remote control smartwatch is therefore often useful in any situation where:
a) AAPSClient/Nightscout/SMS commands cannot work; or
b) the user wishes to avoid the need for authenticator code (as required for the follower phone with inputting data, selecting TT or entering carbs).
A smartwatch needs to have Android wear software (ideally 10 or higher) to be able to control AAPS. Please check the technical specifications of the watch, and check the spreadsheet of compatible watches. Search, or ask in the AAPS Facebook/Discord groups if unsure.
Specific How-to guides for setting up AAPS on the Samsung Galaxy Watch 4 (40mm) is given below. The Garmin watch is also a popular choice. If you have experience of setting up a different smartwatch which you think would be useful to others, please add it into these pages edit the documentation to share your findings with the wider AAPS community.
The AAPS Wear apk
The Wear OS App of AAPS (“Wear OS apk”) required for the smartwatch has been separated from the «full» AAPS build for the Android phone. Therefore you have to generate a second installation file, or apk, to install AAPS wear onto the watch (which is done by side-loading it from the phone). It is strongly recommended that the AAPS Wear apk file is built immediately after first building the full AAPS apk for the phone. Not only is this very quick to do if you are [building AAPS for the first time](link to building AAPS for the first time), but it will avoid any potential compatibility issues when you try to set up the watch-phone communication. The AAPS Wear apk on the watch is unlikely to be compatible with the AAPS phone apk if they have been built in different versions of Android Studio, or if months have past since the initial AAPS build.
If you are already using AAPS on a phone and you did not build both the phone and watch (wear) AAPS apks at the same time, to ensure success it is therefore best to do a fresh build of both apk files at the same time. If you have already installed Android studio, then you may wish to uninstall and then reinstall Android studio as outlined below, and build the AAPS phone and watch apks at the same time, using the same keystore file.
How to uninstall Android Studio
Make sure your keystore file is safely stored elsewhere on your computer, outside of the Android Studio folders.
There are several steps required to completely remove Android Studio from a computer. This is a good guide if you are using a Windows machine. In the final step of these instructions, you also need to manually remove the folder “StudioProjects”.
Now reinstall the latest version of Android Studio.
Building the AAPS Wear apk
As a summary, the build process for the Wear apk is very similar to that for the «full» phone apk, the difference is that in Android Studio you need to select “AndroidAPS.wear” in the drop-down menu, and as build variant choose “fullRelease”. This will generate the AAPS Wear apk file. If you prefer, you can build “pumpcontrolRelease” instead, from the drop-down menu, which will allow you to just remotely control the pump but without looping.
The following guide assumes you have reinstalled the latest version of Android studio (scenario below has used Giraffe 2022.3.1)).
To get back here:
continue to follow the instructions.
Follow the prompts through the different screens until you are given an option with a dropdown menu offering to build the AAPS full apk. At this point, select “Wear” from the dropdown instead of “AndroidAPS.apk” because you are building the apk for the smartwatch.
Next Step go to «Build» in the ribbon
Go to Build > Generate Signed Bundle / APK
Select > Android APK Bundle:
Select in Module: AndroidAPSwear
Enter keystore file at the default location. Your keystore path will depend where you have stored your Keystore. For this scenario the keystore path was located: C:\Program Files\Android\Android Studio\jbr\bin
The next screen should show this:
And select “fullRelease”.
Be patient - the AAPS Wear apk should be built in around 10-20 minutes, depending on the speed of your internet connection.
Troubleshooting - if you get an error about «uncommitted changes», see the troubleshooting guide
In the process of building the 3.2 full AAPS app (and in fact any signed app), Android Studio generates a .json file. This then causes errors with «uncommitted changes» when you try to build the next signed app, like the AAPS wear app. The quickest way to resolve this is to navigate to the folder where the full AAPS app has been built, your folder is probably something like:
C:\Users\Your Name\StudioProjects\AndroidAPS\app\aapsclient\release.
Either delete, or move the unneeded .json file out of the folder. Then try to build the AAPS wear app again. If that doesn’t work, the more detailed troubleshooting guide will help you to identify the specific file causing the issue, which could also be your keystore file.
How to set up a Samsung Galaxy 4 smartwatch with AAPS
This section assumes you are totally new to Smartwatches, and gives you basic orientation of a popular watch, the Galaxy Watch 4, followed by a step-by-step guide to setup AAPS on the watch.
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
Basic smartwatch familiarity
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.
Setting up a Samsung account
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.
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.
You can use either Wear Installer 2 or Easy Fire tools to side-load AAPS onto the watch. Here we recommend Wear Installer 2, because the instructions and process in the video are so clear and well-explained.
Using Wear Installer 2 to side-load AAPS Wear from the phone onto the watch
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.
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, you can:
Use Easy Fire tools to side-load the AAPS wear on the watch
Download Easy Fire Tools from playstore 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: 167.177.0.20. 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. 167.177.0.20 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.
STEP 4) Follow the instructions here to side-load (i.e. transfer) Wear.apk onto the smartwatch using Easy Fire tools
Click side «plug-in» socket in the app, in order to upload Wear OS.apk onto the smartwatch:
Next step > accept the authorisation request on the smartwatch
Setting up the connection between the watch and the phone from AAPS
The final step is to configure AAPS on the phone to interact with AAPS Wear” 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 General
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:
Troubleshooting the AAPS watch- AAPS phone communication
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
Troubleshooting Sony smartwatch setup
Although it was discontinued a few years ago, if you are using a Sony Smartwatch SW 3 please see here for a troubleshooting guide: Troubleshooting Sony Smartwatch SW 3
Controlling AAPS from the Wear Watch
The following functions can be triggered from the smartwatch:
● set a temporary target
● use the bolus calculator (calculation variables can be defined in settings on the phone)
● administer eCarbs
● administer a bolus (insulin + carbs)
● watch settings
● status
● check pump status
● check loop status
● check and change profile, CPP (Circadian Percentage Profile = time shift + percentage)
● show TDD (Total daily dose = bolus + basal per day)
Communication from caregivers to the watch using other apps (like Whatsapp)
It is possible to add additional apps to the watch, like Whatsapp, for messaging (for example) between caregivers and kids. It is important only to have ONE Google account associated with the phone, or the watch will not bring this data across. You need to be 13 or older to have a Samsung account, and this needs to be set up in the same email address which is used on the Android phone.
A video explaining getting Whatsapp setup for messaging on the Galaxy 4 watch (you can’t get full functionality of Whatsapp) is shown here
Making adjustments in both the Galaxy wearable app on the AAPS phone and the watch makes it possible for Whatsapp messages to announce with a slight vibration, and also for the Whatsapp message to display over the existing watchface.
Option 3) AAPSClient on a watch for remote control of AAPS on a phone
The software for the watch, AAPSClient Wear apk, can be downloaded directly from Github.
To download the software, click on the required app (in this screenshot, either wear-aapsclient-release_3.2.0.1 or wear-aapsclient2-release_3.2.0.1 would work, there are two versions in case you need a copy for a second caregiver watch):
Then «save as» and save the file to a convenient location on your computer:
The AAPSClient wear apk can be transferred to your phone and side-loaded onto the watch in the same way as the AAPS Wear app, as detailed in Transferring the Wear app onto your AAPS phone
Option 4) Limited Nightscout (and other options) on a watch - Fitbit watches
«Sentinel» is a clockface developed by Ryan Chen for his family and shared for free for the Fitbit smart watches: Sense1/2, Versa 2/3/4. it is not compatible with the FitBit Luxe since this is only a fitness tracker. Sentinel can be downloaded from the FitBit mobile app.
It allows the monitoring of 1, 2, or 3 individual’s blood glucose numbers using either Dexcom Share, Nightscout, or a combination of the two as data sources.
You can also use xDrip+ or SpikeApp if used with local web server mode. Users can set custom alarms and submit events using Nightscout’s careportal functionality directly from the watch to help track insulin-on-board (IOB), carbs-on-board (COB), enter meal information (carb count and bolus amount), and BG check values.
All will appear on the Nightscout timeline-graph, and as updated values in the IOB and COB fields. Community support can be found at the dedicated Facebook group, Sentinel.
There are additional options for FitBit watches which appear to be for monitoring only. This includes Glance. These additional options are described in the Nightscout webpages.
Option 5) Monitoring of AAPS (full profile data, or glucose-only) where AAPS is running on a phone.
These options are described in more detail in the «following only» section of the documentation.
In general, there are a wide range of affordable smartwatches which can provide glucose display only. If you are using Nightscout, then a good overview of all the options are described in the Nightscout pages.