Руководство по OTA-обновлению системы
В этом документе подробно описывается функция OTA-обновления (Over-The-Air) системы FlyOS-Fast, которая поможет вам безопасно и удобно обновить систему.
Информация о поддержке версий
- V1.3.0 и выше: Поддерживается функция онлайн-обновления OTA
- V1.3.3 и выше: Добавлен способ обновления системы через USB-накопитель
- V1.3.10 и выше: Если пакет обновления требует синхронизации прошивки MCU, на этапе первого запуска после OTA автоматически обновляется USB-прошивка поддерживаемых материнских плат
Информация о предустановленных версиях сервисов
Система FlyOS-Fast включает встроенные основные сервисы, такие как Klipper, RRF, Mainsail, Fluidd, Moonraker, KlipperScreen и другие. При упаковке системы эти сервисы следуют следующей стратегии управления версиями:
Целевая оптимизация
Мы провели специальную целевую оптимизацию основных сервисов, таких как Klipper, Mainsail, Fluidd, Moonraker, KlipperScreen, чтобы повысить стабильность системы и производительность печати.
Не обновляйте и не заменяйте эти сервисы вручную. Ручное переключение приведет к потере целевой оптимизации, что может повлиять на стабильность системы и совместимость функций. При необходимости обновления получайте последнюю версию только через официальный OTA-канал.
Стратегия обновления
OTA-пакеты системы одновременно предоставляют адаптированные и протестированные системные компоненты. Релизные версии не гарантируют полного соответствия последним коммитам каждого вышестоящего проекта. Ориентируйтесь на содержимое, указанное в журнале обновлений FlyOS-Fast.
Примечания
Поскольку между системными компонентами существуют взаимосвязи, не заменяйте отдельно Klipper, Moonraker, веб-интерфейс или экранные сервисы вне OTA. При наличии особых требований к версиям обращайтесь в службу технической поддержки.
Выбор способа обновления
- Сетевое онлайн-обновление
- Ручное обновление
- Автономное обновление с USB-накопителя
Условия сетевого обновления
- Устройство подключено к интернету
- Версия системы
V1.3.0или выше
Порядок действий
- Откройте в браузере:
http://[IP-адрес устройства]:9998 - Система автоматически проверит наличие доступных обновлений
- При наличии новой версии нажмите кнопку "Обновить" для начала обновления
- Дождитесь автоматической загрузки и установки обновления
Подсказка: Во время обновления не отключайте питание и не выполняйте печать
Загрузка локального пакета обновления
Если устройство не может получить версию из источника онлайн-обновлений, вы также можете загрузить локальный пакет обновления на странице управления OTA:
- Откройте в браузере
http://[IP-адрес устройства]:9998. - Найдите область Ручная загрузка пакета обновления, перетащите пакет обновления в поле загрузки или нажмите Обзор файлов для выбора файла.
- Выберите пакет обновления с расширением
.full.fupили.diff.fup. Страница отклонит другие расширения. - Дождитесь завершения проверки и загрузки файла на странице, убедитесь в правильности имени файла, модели устройства и информации о версии.
- Нажмите Загрузить и обновить, подтвердите запрос и начните обновление.
- Дождитесь полного завершения загрузки, проверки, записи и перезагрузки, затем снова откройте веб-страницу.
.full.fup— это полный системный пакет, обычно используемый для обновления между версиями или восстановления системы..diff.fup— это дифференциальный пакет обновления, который можно использовать только для явно поддерживаемых им исходных версий.- Пакет обновления должен соответствовать модели устройства и системному разделу; не загружайте файлы от других устройств.
- Во время загрузки и записи поддерживайте стабильное питание, не закрывайте страницу, не отключайте сеть, не извлекайте USB-накопитель и не перезагружайте устройство вручную.
Подготовка
Условия обновления с USB-накопителя
- Версия системы
V1.3.3или выше
Требования к USB-накопителю
- Тип интерфейса: необходимо использовать USB 2.0-накопитель или кардридер
- Объём хранилища: не менее 8 ГБ свободного пространства
- Примечание о совместимости: устройства USB 3.0 (синие разъёмы) могут привести к медленному обновлению
Загрузка системного пакета
Загрузите соответствующий полный пакет обновления системы в зависимости от модели устройства:
Перейти на страницу загрузкиПроцесс обновления
Шаг первый: подготовка файла обновления
- Перейдите на страницу загрузки системы и получите пакет обновления для соответствующего устройства
- Скопируйте загруженный файл
.full.fupв корневой каталог USB-накопителя
- Убедитесь, что пакет обновления полностью соответствует модели устройства
- Если файл не соответствует, система не покажет никаких уведомлений после подключения USB-накопителя
Шаг второй: запуск обновления
- Вставьте подготовленный USB-накопитель в USB-порт устройства
- После обнаружения файла обновления система автоматически покажет уведомление об обновлении
Места отображения уведомления:
- Веб-интерфейс управления: интерфейс Mainsail / Fluidd
- WiScreen 7-дюймовый экран: специализированный последовательный экран
- KlipperScreen: уведомление об обновлении не отображается, используйте веб-интерфейс
Шаг третий: выполнение обновления
В интерфейсе с появившимся уведомлением об обновлении нажмите кнопку "Начать обновление", и система автоматически выполнит весь процесс обновления.
Примечания к обновлению
Общие предупреждения безопасности
- Перед обновлением приостановите все задачи печати
- Убедитесь в стабильности питания устройства, чтобы избежать непредвиденного отключения электроэнергии
- Рекомендуется заранее создать резервную копию важных файлов конфигурации
Действия после обновления
- Следуйте подсказкам на странице и дождитесь завершения обновления и перезагрузки системы; если пакет обновления требует обновления MCU, система автоматически обработает только USB-прошивку поддерживаемых материнских плат
- Во время обновления поддерживайте стабильное питание, не выключайте устройство, не начинайте печать и не выполняйте ручную перезагрузку
- После повторного входа в веб-интерфейс проверьте версию системы, а также статус подключения Klipper и Moonraker
- Для материнских плат и прошивок, не входящих в область автоматического обновления, необходимо выполнить ручное обновление в соответствии с руководством по соответствующему продукту
Автоматическое обновление прошивки MCU после OTA
Функция автоматического обновления прошивки MCU через OTA поддерживает только следующие материнские платы:
- FLY-C8
- FLY-C5
- FLY-C8P
- FLY-GEMINI V3
Указанные выше материнские платы должны использовать USB-прошивку связи. Другие материнские платы, CAN-прошивки, прошивки USB-to-CAN, CAN-инструментальные платы и другие внешние MCU не поддерживают автоматическое обновление прошивки через OTA.
Для устройств, не входящих в поддерживаемый диапазон, пожалуйста, вручную скомпилируйте и прошейте прошивку в соответствии с документацией соответствующего продукта.
Если пакет обновления требует обновления прошивки MCU поддерживаемых материнских плат, система автоматически обработает это на этапе первого запуска после OTA. Перед началом OTA убедитесь, что USB-подключение материнской платы в норме, и после завершения обновления проверьте, может ли Klipper подключиться нормально.
Во время автоматического обновления MCU не отключайте питание, не перезагружайте устройство, не начинайте печать и не подключайте/отключайте USB-кабели. Прерывание прошивки может привести к невозможности подключения MCU, и потребуется ручное восстановление в соответствии с руководством по прошивке соответствующей материнской платы.
Следуя приведенным выше шагам, вы сможете легко выполнить OTA-обновление системы FlyOS-Fast.