Table of Contents

Обновление OpenAPS (Open Artificial Pancreas System) до последних версий аппаратного и программного обеспечения может значительно улучшить производительность цикла, улучшить функции безопасности и разблокировать новые возможности. Поскольку OpenAPS является системой с замкнутым циклом, DIY, каждое обновление приносит уточнения из реального опыта и клинических исследований. Однако процесс обновления требует тщательного планирования, чтобы избежать простоев или ошибок конфигурации. Это руководство предоставляет практические, пошаговые советы, которые помогут вам выполнить плавное обновление при сохранении надежности системы.

Подготовка к обновлению

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

Изобретите свою текущую систему

Документируйте каждый компонент вашей текущей настройки OpenAPS. Обратите внимание на модель Raspberry Pi (например, Pi 3, Pi Zero W, Pi 4 или Pi 5), радиоустройство (например, плата Explorer, RileyLink или mmtlm stick), модель насоса (например, Medtronic 722, 723, 754 или более новый), и передатчик непрерывного монитора глюкозы (CGM) (Dexcom G6, G7, Medtronic Guardian, Libre через мост). Также записывайте номера версий программного обеспечения операционной системы (версия Raspbian, ядро), алгоритмы цикла (oref0 версия и тег выпуска) и Nightscout (cgm-remote-monitor commit). Этот инвентарь помогает вам проверить совместимость с целевым обновлением. Например, более старые версии oref0 (например, 0.6.x) несовместимы с Pi 4 без дополнительных патчей, а некоторые радиоустройства требуют определенных ветвей прошивки.

Совместимость исследований и выпуск заметок

OpenAPS быстро развивается. Посетите официальный oref0 репозиторий GitHub и OpenAPS веб-сайт, чтобы прочитать примечания к выпуску для версии, которую вы планируете установить. Обратите пристальное внимание на любые уведомления об амортизации, новые требования к оборудованию или изменения конфигурации. Например, новые версии рифов (начиная с 0.7.x) ввели расширенную помощь в еде, которая требует включения в предпочтения. Аналогично, переход от Node.js 10 к Node.js 14 может нарушить старые сценарии. Проверить форумы сообщества на Discourse для взаимодействия пользователей с вашей точной комбинацией оборудования. Также просмотрите проблемы GitHub для известных ошибок в целевом выпуске — иногда последняя помеченная версия имеет нерешенные проблемы, которых избегает предыдущий стабильный выпуск.

Резервное копирование Everything

Создайте полную резервную копию вашей текущей системы.

  • Конфигурационные файлы: Копии настроек.json, autosens.json, настроек насоса и любых пользовательских профилей. Сохраните их в безопасном месте за пределами устройства, например, в папке облачного хранилища или USB-накопителе.
  • Изображение карты SD: Используйте такие инструменты, как Win32 Disk Imager (Windows), dd (Linux/Mac) или функцию резервного копирования Raspberry Pi Imager, чтобы создать точное изображение SD-карты Raspberry Pi. Сжимайте изображение, чтобы сэкономить место. Это позволяет восстановить всю систему, если обновление не удается — полное восстановление часто быстрее, чем устранение проблем после обновления.
  • Данные Nightscout: Убедитесь, что ваш сайт Nightscout полностью синхронизирован и резервно копирован. Записи базы данных экспорта, если это возможно, с помощью команды MongoDB . Как минимум, подтвердите, что последние несколько дней данных о глюкозе и лечении видны на вашей странице Nightscout.
  • Настройки насоса и CGM: Обратите внимание на текущие базальные показатели, соотношение инсулина к углеводам, факторы чувствительности и продолжительность активного инсулина. Хотя они остаются неизменными благодаря обновлениям программного обеспечения, наличие письменной ссылки позволяет избежать случайной неправильной конфигурации при повторном входе в профили.

Соберите инструменты и ресурсы

Для аппаратных обновлений соберите необходимые инструменты: небольшую отвертку Phillips, антистатический ремень запястья, пинцет для прыгунов и надежный источник питания, который может обеспечить адекватный усилитель (например, 5V/3A для Pi 4, 5V/2.5A для Pi 3). Для обновлений программного обеспечения убедитесь, что у вас есть учетные данные доступа SSH, стабильное интернет-соединение и вторичное устройство (ноутбук или телефон) с эмулятором терминала (например, PuTTY или встроенный терминал на macOS / Linux). Загрузите любые файлы прошивки или скрипты обновления, чтобы избежать прерываний - общедоступные соединения Wi-Fi не надежны для больших загрузок. Также подготовьте пишущий файл карты microSD и запасную карту, если вы планируете протестировать новую установку перед подключением к вашей производственной системе.

Обновление Hardware Upgrade

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

Обновление Raspberry Pi

Переход от более старой модели Pi (Pi Zero, Pi 3) к Pi 4 или Pi Zero 2 W предлагает лучшую скорость процессора и память, что снижает задержку вычисления петли. Однако, требования к вычисленности и мощности значительно различаются. Если вы переключаетесь на Pi 4, вам может понадобиться новый корпус, адаптер питания USB-C и, возможно, другое радиоустройство, если ваше текущее устройство полагается на заголовки GPIO Pi 3 (например, Explorer HAT использует GPIO0 и GPIO1 на Pi 3, но требует переназначения на Pi 4 из-за смещенного выбивания). Используйте официальную документацию Raspberry Pi для схем проводки. Убедитесь, что все периферийные соединения (радио, приемник CGM, дисплей) правильно размещены перед включением. Если вы используете дисплей (например, PiTFT), убедитесь, что драйверы совместимы с новой версией ядра Pi. Многие пользователи считают, что Pi Zero 2 W предлагает хороший баланс низкого энергопотребления и адекватной скорости для OpenAPS, в то время как Pi 4 предлагает хороший

Обновление радиоустройств

Популярные варианты включают в себя плату Explorer, RileyLink и палку mmtlm. При обновлении до более новой модели убедитесь, что она поддерживает частоту вашего насоса (например, 916 МГц для насосов US Medtronic, 868 МГц для ЕС). Проверьте совместимость прошивки устройства - некоторые требуют конкретных версий прошивки Subg Rfspy. Следуйте инструкциям производителя по миганию. Например, плата Explorer ожидает обновления прошивки через скрипт . После установки запустите команду для проверки связи. Если вы обновляете от RileyLink до более нового RileyLink 433, обратите внимание, что радиодиапазон может отличаться - оригинальная RileyLink поддерживает только 916 МГц, в то время как версия 433 охватывает полосу 433 МГц для европейских насосов. Также рассмотрите обновление антенны, если ваш насос часто находится более чем в 2 метрах от системы; небольшая внешняя антенна SMA может улучшить запас связи.

CGM и сенсорные обновления

Если вы модернизируете свой передатчик CGM (например, от Dexcom G6 до G7 или от Medtronic Enlite до Guardian 4), проверьте, что цикл OpenAPS может интерпретировать новый формат данных. Некоторые более новые CGM могут потребовать обновленного программного обеспечения моста или пользовательских плагинов. Dexcom G7, например, использует Bluetooth Low Energy (BLE) и другой протокол передачи данных, чем G6, который использовал фирменное радио 916 МГц. Сообщество OpenAPS часто обеспечивает поддержку нового оборудования в течение нескольких недель после выпуска. Но вам может потребоваться запустить отдельный скрипт моста (например, FLT: 3) и настроить конфигурацию загрузчика Nightscout. Всегда тестируйте поток данных CGM в Nightscout перед возобновлением автоматического режима - проверяйте, что значения глюкозы появляются каждые 5 минут и что предсказанные стрелки генерируют правильно. Если вы используете датчик Libre с мостом, проверяйте, что прошивка передатчика MiaoMiao или Bubble обновлена.

Периферийные улучшения

Рассмотрите возможность обновления источника питания (например, аккумулятора большей емкости, такого как Anker PowerCore емкостью 10 000 мАч), добавления тактового модуля реального времени (например, DS3231) для надежного хронометража или замены стареющей SD-карты на более быстрый, более долговечный (например, SanDisk Extreme Pro A2). Эти несущественные обновления могут предотвратить повреждение данных и сократить время перезагрузки. Часы реального времени особенно важны, если ваш Pi иногда теряет подключение к Интернету - без NTP, дрейф часов, вызванный перебоями в питании, может вызвать неправильные вычисления петли. Аналогично, SD-карта с более высокими IOPS (операции ввода / вывода в секунду) снижает вероятность повреждения во время частых записей в файлы журналов. Если вы используете Pi Zero 2 W, рассмотрите источник питания USB-C с конденсатором сглаживания напряжения для предотвращения выключения во время радиопередачи.

Обновления программного обеспечения и прошивки

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

Обновление алгоритма петли (Oref0)

Ядро OpenAPS — это программное обеспечение oref (открытая ссылка). Для обновления SSH в ваш Raspberry Pi и перехода в каталог oref0. Запустите , чтобы получить последний код, затем выполните для обновления зависимостей. После обновления вам может потребоваться снова запустить , чтобы применить любые новые параметры конфигурации. Сценарий задаст вопросы о вашем оборудовании и предпочтениях. Сценарий будет задавать вопросы о вашем резервном файле конфигурации, чтобы ответить последовательно. Обратите внимание на подсказки о новых функциях — например, для включения требуется совместимая версия oref0 и соответствующие настройки чувствительности к инсулину. После повторной настройки, перезагрузки устройства и проверки журнала циклов на ошибки. Если вы сталкиваетесь с конфликтами зависимостей, попробуйте очистить кэш npm с перед повторным использованием. Для основных скачков версии (например, 0.6.x до 0.7.x), часто безопаснее выполнить новую установку на новой SD-карте, а затем скопировать

Обновление Nightscout Integration

Если ваш сайт Nightscout размещен самостоятельно, обновите его компоненты (MongoDB, Node.js и код cgm-remote-monitor) до последних стабильных версий. Используйте команду на вашем сервере Nightscout и запустите . Проверьте, что токены API остаются действительными и что скрипт загрузчика (часто на Pi) отправляет данные правильно. Тест временно включив функцию «Карьерный портал» для просмотра, появляются ли процедуры в реальном времени. Также проверьте, что переменная среды на Pi указывает на правильный URL (включая секрет API, если это необходимо). Если вы используете файл , убедитесь, что путь конечной точки соответствует обновленной версии Nightscout — некоторые обновления изменили конечную точку API с на . Используйте для тестирования соединения: . Если вы размещаете стек Heroku, также обновите стек Heroku, если платформа требует этого

Flashing Radio Firmware (Радио)

Прошивка вашего радиоустройства должна соответствовать версии OpenAPS. Для платы Explorer стандартная прошивка - Subg Rfspy. Загрузите последнюю из официального репозитория . Используйте инструмент для мигания, такой как (на Pi) или скрипт . Убедитесь, что устройство включено и сделаны правильные соединения контактов. Если вы используете инструмент RileyLink, вы можете мигать через инструмент на macOS или Windows. После мигания запустите , чтобы подтвердить, что радиомодуль отвечает. Если вы видите ошибки о неправильной скорости бод или устройство не найдено, проверьте, что последовательный путь устройства (например, для Explorer, для mmtlm) соответствует тому, который в вашем файле. Некоторые новые модели Pi могут назначать разные узлы устройства из-за системы наложения - вам может потребоваться включить UART вручную в

Пользовательская конфигурация Transfer

При обновлении программного обеспечения ваши пользовательские предпочтения (целевой диапазон, ISF, базальные скорости) обычно выживают, потому что они хранятся в отдельных файлах JSON. Однако иногда изменяется схема файла. Сравните свои старые с шаблоном по умолчанию, предоставленным в новом выпуске. Добавьте любые новые настройки, которые контролируют расширенные функции (например, . Используйте валидатор JSON, такой как или онлайн-инструмент, чтобы избежать ошибок синтаксиса. Будьте особенно осторожны с запятыми и кавычками. Отсутствующая запятая может привести к тому, что вся служба OpenAPS не запускается. Перезагрузите службу OpenAPS после редактирования, запустив . Если вы используете пользовательский , проверьте, что значения кривой действия инсулина (например, DIA) все еще находятся в ожидаемом диапазоне — некоторые обновления алгоритма изменили максимально допустимое значение DIA.

После обновления валидации

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

Системная диагностика и логи

Проверьте журнал циклов OpenAPS, запустив . Ищите сообщения об ошибках, предупреждения или необычные записи, такие как «насосов не удалось» или «недействительное чтение CGM». Проверьте системный журнал с для статуса обслуживания. Если вы видите тайм-ауты или повторные записи, исследуйте диапазон радиосигналов или уровень батареи насоса. Также отслеживайте температуру ЦП с использованием — если она превышает 80°C, рассмотрите возможность добавления радиаторов или улучшения вентиляции. Для использования памяти запустите ; если Pi начинает заменять, вам может потребоваться отключить ненужные службы или сократить период хранения файлов журнала. Проверьте дисковое пространство с ; почти полная SD-карта может вызвать повреждение базы данных в локальном кэше Nightscout.

Функциональное тестирование

Проверить каждую подсистему вручную:

  • Управление насосом: Используйте команду с очень маленькой дозой (0,05 U) для подтверждения точной доставки и ответа. Проверьте, что экран насоса обновляется правильно и что болюс появляется в Nightscout в течение одной минуты. Также испытательный насос приостанавливается через (приостанавливается на 30 минут) и затем .
  • Читания CGM: Проверьте, чтобы новые значения CGM появились в Nightscout в течение 5 минут после передачи датчика. Перекрестите проверку с родным дисплеем приемника CGM. Если вы используете Dexcom, проверьте мост, поместив манекен для обработки палкой, чтобы увидеть, загружается ли он.
  • Состояние цикла: Наблюдайте за принятием решения циклом. Система должна генерировать временный базальный сигнал в течение 4-5 минут после получения нового показания глюкозы. Используйте , чтобы увидеть текущую рекомендуемую дозу. Подтвердите, что предлагаемая базальная скорость соответствует вашим ожиданиям, учитывая текущую тенденцию глюкозы.
  • Сигналы тревоги и предупреждения: Моделируйте низкое предсказанное событие глюкозы, временно повышая текущее значение глюкозы (через лечение Nightscout) или корректируя настройки чувствительности. Убедитесь, что насос приостанавливается и уведомления пользователей работают (например, через pushover Nightscout или SMS).

Проверка безопасности

Проверьте, что ваши аварийные меры предосторожности работают. Проверьте таймер сторожевого пса (если настроен) сбрасывает систему после аварии, вручную повесив процесс с (будьте осторожны). Подтвердите, что ограничения «максимальный базальный» и «максимальный болюс» в предпочтениях все еще установлены правильно - обновление иногда сбрасывает их по умолчанию (например, макс базальный может перейти от 2,0 U / ч обратно до 0,5 U / ч. Просмотрите настройку «отключить петлю», если вы хотите вручную контролировать инсулин в течение некоторого времени после обновлений. Держите ручной план резервного копирования (шприцы, инсулиновая ручка) доступный во время первоначального тестирования. Также убедитесь, что ваши пороги тревоги с низким содержанием глюкозы CGM все еще активны в Nightscout - обновления иногда могут перезаписывать профили оповещения.

Устранение общих проблем

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

Неудачи загрузки или тайм-аут SSH

Если Raspberry Pi не загружается после изменений оборудования, проверьте источник питания (5V/3A, рекомендованный для Pi 4, 5V/2.5A для Pi 3). Убедитесь, что SD-карта полностью вставлена. Если SSH выходит из строя, подключите монитор и клавиатуру для проверки сообщений об ошибках. Общие причины: поврежденная SD-карта (повторная съемка требуется через резервное изображение), неправильная проводка GPIO (короткая схема) или несовместимая аппаратная ревизия (например, Pi 4 rev 1.1 vs 1.2 может потребовать разных резисторов подтягивания GPIO). Загрузка с вашего резервного изображения для восстановления функциональности. Если зеленый светодиод мигает беспорядочно, ядро может отсутствовать - перефлешируйте карту свежим изображением Raspbian, а затем восстановите конфигурацию.

Ошибки радиосвязи

Если в журнале цикла отображается постоянная «mmeowlink: timeout waiting for response», радиопрограмма может быть устаревшей или устройство не настроено должным образом. Перезагрузите прошивку и подтвердите правильное последовательное устройство (например, для платы Explorer, для ммтлм. Первоначально уменьшите расстояние до менее 1 метра. Помехи от маршрутизаторов Wi-Fi или микроволновых печей также могут ухудшить связь - переместите систему. Если вы используете плату Explorer, попробуйте увеличить мощность радио, изменив параметр (диапазон 0-4). Для пользователей RileyLink проверьте уровень батареи самого устройства - низкая батарея может вызвать прерывистые тайм-ауты.

Несоответствия данных в Nightscout

Дублирующие записи или отсутствующие данные часто происходят из дрейфа часов. После обновления оборудования пересинхронизируйте время Pi с помощью и включите NTP в . Убедитесь, что загрузчик Nightscout использует тот же токен API и URL сайта, что и раньше. Если вы самостоятельно размещаете, проверьте, что индексы базы данных вашего сервера Nightscout не повреждены (. Также проверьте на Pi для ошибок HTTP 409 (конфликт), которые указывают на дублирование процедур — это может произойти, если вы перезагрузите службу цикла без очистки кэша. Очистите локальный кэш, удалив и перезагрузите.

Возвращение к предыдущей версии

Если обновление вводит критические проблемы, вернитесь к резервному копированию. Восстановите изображение карты SD с помощью того же инструмента, который используется для резервного копирования (например, Win32 Disk Imager или . Альтернативно, если существуют проблемы только с программным обеспечением, вы можете откатить oref0 через git: , затем повторно запустить . Всегда проверяйте восстановленную систему в течение не менее 24 часов, прежде чем считать ее стабильной. Если вы не можете вернуться чисто, выполните новую установку предыдущей версии на новой SD-карте, перенесите свои предпочтения и снова проверьте.

Поддержка и ресурсы сообщества

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

Официальная документация и GitHub

Репозиторий документации OpenAPS содержит руководства по настройке, советы по устранению неполадок и подробные объяснения каждого алгоритма. Прочитайте страницу «как обновить» и примечания по миграции, относящиеся к релизу. Трекер проблем GitHub также является хорошим местом для поиска аналогичных проблем обновления. Например, многие пользователи столкнулись с ошибкой «oref0-setup: no pump found» после обновления до 0.7.1, и исправление было задокументировано в выпуске No 2345. Закладка хранилища и проверка новых проблем перед началом обновления.

Форумы и платформы чата

Присоединяйтесь к форуму OpenAPS Discourse, чтобы задавать вопросы и делиться опытом. Сообщество активно и отзывчиво. Для помощи в режиме реального времени канал #openaps на сервере Looped Discord предоставляет немедленные советы по устранению неполадок. При публикации включайте свою аппаратную модель, версию программного обеспечения и соответствующие фрагменты журнала. Многие пользователи также ведут личные блоги с подробными прогулками по обновлению - ищите «Обновление OpenAPS Pi 4», чтобы найти пошаговые учетные записи, которые включают конкретные назначения GPIO и версии прошивки.

Оставаться в курсе обновлений

Подписывайтесь на рассылку OpenAPS или следите за блогом на официальном сайте. Смотрите репозитории GitHub для «выпуска» уведомлений, нажав кнопку «Смотри» для oref0 и связанных с ними репозиториев. Быть активным в отношении объявлений помогает вам планировать обновления в периоды, когда вы можете позволить себе несколько часов практического внимания. Сообщество часто публикует ранние предупреждения о крупных изменениях, таких как переход с Python 2 на Python 3 или обесценивание определенного радиооборудования. Планирование вокруг этих объявлений может спасти вас от принуждения к обновлению в неудобное время.

Заключительные мысли

Модернизация вашей системы OpenAPS - это полезный процесс, который держит вашу DIY-систему на переднем крае технологии управления диабетом. Следуя структурированному подходу - тщательная подготовка, тщательные обновления оборудования и программного обеспечения, систематическая проверка и использование знаний сообщества - вы минимизируете риски и максимизируете преимущества. Помните, что безопасность на первом месте: всегда тестируйте обновления в течение времени, когда вы можете внимательно следить за своей глюкозой, и никогда не стесняйтесь возвращаться, если что-то не так. С каждым обновлением ваша система становится более надежной, точной и адаптированной к вашим уникальным потребностям. Сообщество OpenAPS понимает, что совершенство не является целью; устойчивость и безопасность. Не торопитесь, документируйте каждый шаг, и вы создадите систему, которая растет вместе с вами.