Руководство по 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.