Мастер установки AAPS

When you first start AAPS you are guided by the «Setup Wizard», to quickly setup all the basic configurations of your app in one go. Setup Wizard guides you, in order to avoid forgetting something crucial. For example, the permission settings are fundamental for setting up AAPS correctly.

However, it’s not mandatory to get everything completely configured in the first run of using the Setup Wizard and you can easily exit the Wizard and come back to it later. There are three routes available after the Setup Wizard to further optimise/change the configuration. О них расскажем в следующем разделе. Итак, если пропустить некоторые этапы в мастере установки, их можно легко выполнить позже.

During, and directly after using the Setup Wizard you may not notice any significant observable changes in AAPS. To enable your AAPS loop, you have to follow the Objectives to enable feature after feature. You will start Objective 1 at the end of the Setup Wizard. You are the master of AAPS, not the other way around.

Preview Objectives

If you are keen to know the structure of the objectives, please read Completing the objectives but then come back here to run the Setup Wizard first.

From previous experience, we are aware that new starters often put themselves under pressure to setup AAPS as fast as possible, which can lead to frustration as it is a big learning curve.

So, please take your time in configuring your loop, the benefits of a well-running AAPS loop are huge.

Ask for Help

If there is an error in the documentation or you have a better idea for how something can be explained, you can ask for help from the community as explained at Connect with other users.

Приветственное сообщение

Это просто приветственное сообщение, которое можно пропустить, нажав кнопку «ДАЛЕЕ»:

изображение

Лицензионное соглашение

In the end user license agreement there is important information about the legal aspects of using AAPS. Внимательно изучите его.

If you don’t understand, or can’t agree to the end user license agreement please don’t use AAPS at all!

Если вы понимаете и соглашаетесь, нажмите кнопку «I UNDERSTAND AND AGREE» (я принимаю и соглашаюсь) и следуйте подсказкам Мастера установки:

изображение

Необходимые разрешения

AAPS needs some requirements to operate correctly.

In the following screens you are asked several questions you have to agree to, to get AAPS working. Мастер сам объясняет, почему он запрашивает соответствующие разрешения или настройки.

На этом экране мы даем дополнительную справочную информацию, переводим с технического языка на общий или объясняем причину.

Нажмите кнопку «ДАЛЕЕ»:

изображение

Notification and battery optimization

Android требует специального разрешения для уведомлений от приложений.

While it is a good feature to disable notifications e.g. from social media apps, it is essential that you allow AAPS to send you notifications.

Please click the first «ASK FOR PERMISSION» button:

изображение

Выберите приложение «AAPS»:

изображение

Включите «Разрешить поверх других приложений», сдвинув переключатель вправо:

изображение

Так выглядит переключатель во включенном положении:

изображение

Расход батареи на смартфонах все еще является сложной задачей, поскольку производительность батарей по-прежнему весьма ограничена. Операционная система Android довольно неохотно разрешает приложениям запускатьсся и расходоавать время работы процессора, а, следовательно, и заряд батареи.

However, AAPS needs to run regularly, e.g. to receive the glucose readings every few minutes and then apply the algorithm to decide how to deal with your glucose levels, based on your specifications. Поэтому Android должен разрешить эти действия без препятствий.

Это делается при помощи подтверждения настроек.

Click the second «ASK FOR PERMISSION» button. Выберите «Разрешить:

изображение

Нажмите кнопку «ДАЛЕЕ»:

Screenshot_20241207-161454.png

Location

Android увязывает использование Bluetooth со службой определения местоположения. Возможно, вы замечали это у других приложений. Обычно, если нужен доступ к Bluetooth, требуется разрешение на определение местоположения.

AAPS uses bluetooth to communicate with your CGM and insulin pump if they are directly controlled by AAPS and not another app which is used by AAPS. Детали могут различаться в зависимости от настроек.

Click the first «ASK FOR PERMISSION» button:

изображение

Это важно. Otherwise AAPS can not work properly at all.

Выберите «При использовании приложения»:

изображение

Click the second «ASK FOR PERMISSION» button:

Screenshot_20241207-154117.png

Select «Allow all the time».

Нажмите кнопку «ДАЛЕЕ»:

изображение

Storage permission

AAPS needs to log information to the permanent storage of your smartphone. Постоянная память означает, что информация будет доступна даже после перезагрузки телефона. Остальная информация теряется, поскольку она не сохраняется в постоянной памяти.

Click the first «ASK FOR PERMISSION» button:

изображение

Нажмите «Разрешить»:

изображение

Click «AAPS Directory». This opens the filesystem on your phone and allows you to choose where you want AAPS to store its information. The default directory is AAPS, but you can use any dedicated directory of your liking. Create the directory if necessary, enter it, and choose «Use this folder»:

Screenshot_20241207-155358.png

Confirm that you wish to grant access to AAPS to the selected directory:

Screenshot_20241207-155833.png

Нажмите кнопку «ДАЛЕЕ»:

изображение

Главный пароль

As the configuration of AAPS contains some sensitive data (e.g. API_KEY for accessing your Nightscout server) it is encrypted by a password you can set here.

The second sentence is very important, please DO NOT LOSE YOUR MASTER PASSWORD. Please make a note of it e.g. on Google Drive. Google Drive - хорошее место, так как он создан специально для подобных целей. Телефон или ПК могут выйти из строя, оставив нас без актуальной копии. If you forget your Master Password, it can be difficult to recover your profile configuration and progress through the Objectives at a later date.

После двукратного ввода пароля нажмите кнопку «Далее»:

изображение

Загрузка отчета для разработчиков в Fabric

Здесь вы можете настроить автоматизированную службу отчетов о пользовании приложением и сбоях.

Это не обязательно, но рекомендуется.

Это помогает разработчикам лучше понимать как пользователи работают с приложением и информирует о происходящих сбоях.

Они получают:

  1. Информацию о сбоях в работе приложения, о которых им может быть неизвестно, если у них все работает должным образом

  2. В отправляемых данных (информация о сбоях) содержится информация о обстоятельствах, при которых произошел сбой, а также о конфигурации приложения.

Что помогает разработчикам улучшить приложение.

Поэтому включите отправку данных разработчикам, сдвинув переключатель вправо:

изображение

Кроме того, вы можете определить что разработчики могут связаться с вами только по неотложным проблемам:

изображение

Заполнив «контактную информацию» нажмите кнопку «ОК». Контактная информация может быть учетная запись в Facebook, на Discord, … Просто информация для связи с вами наилучшим способом:

изображение

Нажмите кнопку «ДАЛЕЕ»:

изображение

Units (mg/dL <-> mmol/L)

Выберите, в каких единицах хотите видеть значения гликемии – в мг/дл или ммоль/л, затем нажмите кнопку «ДАЛЕЕ»:

изображение

Параметры экрана

Здесь выбираем диапазон значений, в котором хотим видеть свою гликемию. Его можно оставить заданным по умолчанию и отредактировать в дальнейшем.

Эти значения влияют только на графическое отображение ГК и больше ни на что.

Your glucose target e.g. is configured separately in your profile.

Величины для анализа TIR (времени в целевом диапазоне) конфигурируются отдельно при создании отчетов на сервере отчетов.

Нажмите кнопку «ДАЛЕЕ»:

изображение

Синхронизация с сервером отчетов и другие вопросы

Здесь вы настраиваете загрузку данных на сервер отчетов.

Здесь также можно выполнить другие настройки, но для первого запуска мы сосредоточимся на сервере отчетов.

Если вам неудобно заниматься этим в данный момент, пропустите их. Их можно сделать потом.

If you select an item here on the left tick box, on the right you can then ticking the visibility (eye) box, which will place this plugin in the upper menu on the AAPS home screen. Если на этом этапе вы настраиваете сервер отчетов, для него тоже выбирайте видимость.

В этом примере мы выберем Nightscout в качестве сервера отчетов и настроим его.

Make sure to choose the correct NSClient version for your needs!

Click here 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 web interface, in which case, choose the first option «NSClient» until further notice.

Для Tidepool проще, так как требуются только персональные данные для входа.

After making your selection, please press the cogwheel button next to the item you selected :

изображение

Здесь вы настраиваете сервер отчетов Nightscout.

Нажмите на «URL-адрес Nightscout»:

изображение

Введите адрес вашего сайта URL Nightscout. Это просто URL-адрес, который вы настроили самостоятельно, или он был предоставлен поставщиком услуг Nightscout.

Нажмите кнопку «OK»:

изображение

Введите атрибут защиты доступа к Nightscout. Это код доступа для Nightscout, настроенный вами. Без него доступа не будет.

If you don’t have it at the moment please check the documentation for setting up the reporting server in the AAPS documentation.

After filling in the «NS access token» and clicking «OK», please click on the «Synchronization» button:

изображение

Выберите «Передать данные в NS», если вы уже настроили Nightscout на предыдущих шагах мастера установки.

If you have stored profiles on Nightscout and want to download them to AAPS, enable «Receive profile store»:

изображение

Вернитесь на предыдущий экран и выберите «Опции оповещения»:

изображение

Пока что оставьте переключатели неактивными. Мы зашли на этот экран только чтобы показать параметры, которые можно настроить в будущем. В настоящий момент такой необходимости нет.

Вернитесь на предыдущий экран и выберите «Параметры подключения».

Здесь вы можете настроить способ передачи данных на сервер отчетов.

Caregivers must enable «use cellular connection» as otherwise the smartphone which serves the dependant/child can not upload data outside of WiFi range e.g. on the way to school.

Other AAPS users can disable the tranfer via cellular connection if they want to save data or battery.

Если сомневаетесь, просто оставьте все включенным.

Вернитесь на предыдущий экран и выберите «Дополнительные настройки».

изображение

Включите «Передать в NS запись о начале работы приложения», если хотите получить эту информацию на сервере отчетов. Это может помочь вам удаленно узнать, было ли перезапущено приложение и когда именно, особенно если вы лицо, осуществляющее уход.

It might be interesting to see if AAPS is correctly configured now, but later it is usually not that important to be able to see AAPS stopping or starting in Nightscout.

Включите «Создавать оповещение на основе названия ошибки» и «Создавать оповещения из напоминаний о необходимых углеводах».

Оставьте «Замедлить выгрузку» невключенным. Эта функция может пригодиться только в необычных обстоятельствах, если, например, на сервер Nightscout необходимо передать много информации, а Nightscout медленно обрабатывает данные.

Go back twice, to the list of plugins and select «NEXT» to go to the next screen:

изображение

Patient name

Here you can setup your name in AAPS.

Можете выбрать любое. Это нужно, чтобы различать пользователей.

Для просты, введите имя и фамилию.

Нажмите «ДАЛЕЕ» и перейдите к следующему экрану.

изображение

Тип пациента

Here you select your «Patient type» which is important, as the AAPS software has different limits, depending on the age of the patient. Это важно по соображениям безопасности и как мера предосторожности.

Here is where you also configure the maximum allowed bolus for a meal. То есть, самый большой болюс, который можно ввести на свои обычные блюда. Это мера безопасности, которая помогает избежать случайной передозировки, когда вводится болюс на еду.

Второе ограничение аналогично по концепции, но относится к максимальному ожидаемому потреблению углеводов.

После установки этих значений нажмите «ДАЛЕЕ» и перейдите на следующий экран:

изображение

Применяемый инсулин

Выберите тип инсулина, используемого в помпе.

Названия инсулинов должны быть самоочевидными.

Don’t use the «Free-Peak Oref» unless you know what you are doing

For advanced users or medical studies there is the possibility to define with «Free-Peak Oref» a customised profile of how insulin acts. Please don’t use it unless you are an expert, usually the pre-defined values work well for each branded insulin.

Нажмите «ДАЛЕЕ» и перейдите к следующему экрану:

изображение

Источник ГК

Выберите используемый вами источник ГК Please read the documentation for your BG source.

Поскольку доступно несколько вариантов, мы не объясняем здесь конфигурацию каждого. В нашем примере мы приводим Dexcom G6 с самостоятельно собранным приложением BYODA:

изображение

Если вы используете Dexcom G6 с BYODA, активируйте видимость его меню, поставив галочку справа.

После установки этих значений нажмите «ДАЛЕЕ» и перейдите на следующий экран:

изображение

If you are using Dexcom G6 with BYODA, click on the cogwheel button to access the settings for BYODA.

Включите «Загружать данные ГК в NS» и «Вносить запись о замене сенсора в NS».

Go back and press «NEXT» to go to the next screen:

изображение

Profile

Теперь мы переходим к очень важной части мастера установки.

Please read the documentation about profiles before you try to enter your profile details on the following screen.

Working profile required - no exceptions here !

An accurate profile is necessary to control the safe action of AAPS

It’s required that you have determined and discussed your profile with your doctor, and that it has been proven to work by successful basal rate, ISF and IC testing!

If a robot has an incorrect input it will fail - consistently. AAPS can only work with the information it is given. If your profile is too strong, you risk hypoglycemia, and if it is too weak, you risk hyperglycemia.

Нажмите «ДАЛЕЕ» и перейдите к следующему экрану. Введите «название профиля»:

изображение

В дальнейшем при необходимости можно настроить несколько профилей. Мы здесь создадим только один.

Profile only for tutorial - not for your usage

The example profile here is only to show you how to enter data.

It is not intended to be an accurate profile or something very well optimised, because each person’s needs are so different.

Don’t use it for actually looping!

Enter your Duration of insulin Action (DIA) in hours. Затем нажмите «IC» (углеводный коэффициент):

изображение

Enter your IC values:

изображение

Нажмите «ISF» (фактор чувствительности к инсулину). Enter your ISF values:

изображение

Нажмите «БАЗАЛ». Enter your basal values:

изображение

Нажмите «ЦЕЛЬ». Введите целевые значения сахара в крови.

For open looping this target can be a wider range, as otherwise AAPS notifies you permanently to change the temporary basal rate or another setting, which can be exhausting.

Позднее для замкнутого цикла у вас обычно будет одно значение для верхней и нижней границы. That makes it easier for AAPS to hit the target and give you better overall diabetes control.

Введите/подтвердите целевые значения:

изображение

Сохраните профиль, нажав «СОХРАНИТЬ»:

изображение

После сохранения профиля появляется новая кнопка «Активировать профиль».

Several defined but only one active profile

Можно иметь несколько заданных профилей, но в каждый данный момент активен только один.

Нажмите «Активировать профиль»:

изображение

Появляется диалог переключения профиля. В этом случае он останется как предустановленный.

Several defined but only one active profile

В дальнейшем вы узнаете, как пользоваться этим диалогом в таких ситуациях, как болезнь или спорт, когда есть необходимость изменить профиль.

Нажмите «OK»:

изображение

Появляется диалог подтверждения переключения профиля.

Подтвердите нажав кнопку «OK». Нажмите «ДАЛЕЕ» и перейдите к следующему экрану:

изображение

Ваш профиль установлен:

изображение

Инсулиновая помпа

Теперь выберем инсулиновую помпу.

Появится важный диалог предупреждения. Прочитайте его и нажмите «OK».

Если ваш профиль уже установлен на предыдущих шагах и вы знаете, как подключить помпу, сделайте это сейчас.

Otherwise, leave the Setup Wizard, using the arrow in the top left corner and let AAPS first show you some blood glucose values. Вы можете вернуться к этому в любое время или использовать один из параметров прямой конфигурации (минуя мастер).

Please read the documentation for your insulin pump.

Нажмите «ДАЛЕЕ» и перейдите к следующему экрану.

изображение

В данном случае мы выберем «Виртуальную помпу».

Нажмите «ДАЛЕЕ» и перейдите к следующему экрану:

изображение

APS algorithm

Примените алгоритм OpenAPS SMB. Несмотря на название, функция алгоритма микроболюсов SMB отключена до полного знакомства с AAPS и прохождения первых целей. В любом случае алгоритм OpenAPS SMB новее и лучше по сравнению с OpenAPS AMA.

Причина, по которой SMB отключён в начале, заключается в том, что функция SMB позволяет быстрее реагировать на увеличение сахара в крови через супермикроболюсы, а не повышать базальную скорость. As in the beginning your profile is in general not as good as after some time of experience the feature is disabled in the beginning.

Only use the older algorithm OpenAPS AMA if you know what you are doing

OpenAPS AMA is the most basic algorithm which does not support micro boluses to correct high values. There might be circumstances where it is better to use this algorithm but it is not the recommendation.

Press the cogwheel to see the details:

изображение

Только прочтите текст и ничего не меняйте.

Due to the limitations which are imposed by the Objectives you can’t use either «closed loop» or «SMB features» at the moment anyway.

Go back and press «NEXT» to go to the next screen:

изображение

Режим APS

Оставьте выбранным «Открытый цикл».

Нажмите «ДАЛЕЕ» и перейдите к следующему экрану:

изображение

Определение чувствительности

Let «Sensitivity Oref1» the standard for the sensitivity plugins selected.

Нажмите «ДАЛЕЕ» и перейдите к следующему экрану:

изображение

Начните выполнение Цели 1

Здесь вы приступаете к Целям. The qualification for access to further AAPS features.

Здесь мы запускаем цель 1, даже если на данный момент наши настройки не полностью готовы к завершению этой цели.

Но это – начало.

Нажмите на зеленую надпись «СТАРТ» для запуска Цели 1:

изображение

Вы видите, что уже добились определенного прогресса, но другие области еще не завершены.

Нажмите «ГОТОВО» и перейдите к следующему экрану.

изображение

You are coming to the home screen of AAPS.

Here you find the information message in AAPS that you set your profile.

Это было сделано при переходе на наш новый профиль.

Нажмите «УБРАТЬ ОПОВЕЩЕНИЕ» и оно исчезнет.

изображение

If you accidentally leave the Setup Wizard at any point, you can either simply re-start the Wizard, or change the configuration of the AAPS loop manually.

If your AAPS loop is now fully setup, please move on to the next section «Completing the objectives».