跳到主要内容

OTA 系统更新指南

本文档详细介绍 FlyOS-Fast 系统的 OTA(Over-The-Air)更新功能，帮助您安全、便捷地升级系统。

版本支持说明​

  • V1.3.0 及以上:支持 OTA 在线更新功能
  • V1.3.3 及以上:新增 U 盘系统更新方式
  • V1.3.10 及以上:升级包需要同步 MCU 固件时，可在 OTA 后首次启动阶段自动更新受支持主板的 USB 固件

预置服务版本说明​

FlyOS-Fast 系统内置了 Klipper、RRF、Mainsail、Fluidd、Moonraker、KlipperScreen 等主流服务，这些服务在系统打包时遵循以下版本管理策略：

针对性优化​

我们对 Klipper、Mainsail、Fluidd、Moonraker、KlipperScreen 等核心服务进行了专门的针对性优化，以提升系统稳定性和打印性能。

重要警告

请勿手动升级或替换这些服务。手动切换将导致针对性优化失效，可能影响系统稳定性和功能兼容性。如需更新，请通过官方 OTA 方式获取最新版本。

更新策略​

系统 OTA 包会同时提供经过适配和测试的系统组件。发布版本不承诺与每个上游项目的最新提交完全一致，请以 FlyOS-Fast 更新日志列出的内容为准。

注意事项​

由于系统组件之间存在配套关系，不要在 OTA 之外单独替换 Klipper、Moonraker、网页界面或屏幕服务。如有特定版本需求，请联系技术支持。

更新方式选择​

网络更新条件​

  • 设备已连接到互联网
  • 系统版本为 V1.3.0 或更高

操作步骤​

  1. 在浏览器中访问: http://[设备IP地址]:9998
  2. 系统将自动检查可用更新
  3. 如有新版本，点击 "更新" 按钮开始升级
  4. 等待系统自动下载并安装更新

提示: 更新过程中请勿断电或进行打印操作

更新注意事项​

通用安全提示​

  • 更新前请暂停所有打印任务
  • 确保设备供电稳定，避免意外断电
  • 重要配置文件建议提前备份

更新后操作​

  • 按页面提示等待系统完成更新和重启；如果升级包要求更新 MCU，系统只会自动处理受支持主板的 USB 固件
  • 更新期间保持供电稳定，不要关闭设备、开始打印或手动重启
  • 重新进入网页后检查系统版本以及 Klipper、Moonraker 连接状态
  • 不在自动更新支持范围内的主板和固件，需要按对应产品教程手动更新

OTA 后自动更新 MCU 固件​

仅支持以下主板

OTA 的 MCU 固件自动更新功能只支持以下主板：

  • FLY-C8
  • FLY-C5
  • FLY-C8P
  • FLY-GEMINI V3

以上主板必须使用 USB 通信固件。其他主板、CAN 固件、USB 转 CAN 固件、CAN 工具板及其他外接 MCU 均不支持 OTA 自动更新固件。

不在支持范围内的设备，请按对应产品文档手动编译和烧录固件。

如果升级包需要更新受支持主板的 MCU 固件，系统会在 OTA 后首次启动阶段自动处理。开始 OTA 前应确认主板的 USB 连接正常，并在更新完成后检查 Klipper 是否能够正常连接。

更新期间不要操作设备

自动更新 MCU 时不要断电、重启、开始打印或插拔 USB 线束。中断烧录可能导致 MCU 无法连接，需要按对应主板的固件烧录教程手动恢复。

通过以上步骤，您可以轻松完成 FlyOS-Fast 系统的 OTA 更新。

Loading...