跳到主要内容

Fly 上位机安装与使用指南

一、准备工作​

1. 电源要求​

  • 供电标准: 需使用 5V / 2A 或以上 的独立电源适配器
  • 禁止事项:除以下特定型号外，严禁通过3D打印机主板接口供电
    • ✅ 支持主板供电型号:C8, GEMINI, C5, C5V1.1, C8P
  • 风险提示:供电不足将导致设备运行不稳定、频繁重启，长期可能造成硬件损坏

2. 存储介质选择​

存储类型适用设备关键说明
TF 卡全系列兼容通用方案，需配合标准读卡器使用
M2WE 固态卡非Lite/MINI-PAD系列专用方案，必须搭配M2SD烧录器

TF 卡规格建议:

  • 容量: 16GB-128GB(推荐32GB/64GB)
  • 速度等级: Class10 或 U1/U3
  • 品牌推荐：闪迪、三星等知名品牌

3. 烧录工具准备​

  • TF 卡:标准TF卡读卡器
  • M2WE 卡:专用M2SD烧录器(必需)

4. 系统镜像匹配​

根据设备主控芯片选择对应系统镜像：

主控芯片适用设备型号
H618C8P、C5、C5-V1.1、PI-V3
H5PI、PI-V2、GEMINI系列、C8
H3Lite2系列、MINI-PAD系列

镜像下载:FlyOS 系统镜像下载站

5. 配套资源​

  • 硬件:支持数据传输的Type-C线缆
  • 软件工具包:包含终端工具、驱动、格式化工具等
    Loading...

二、系统安装流程​

  • 因教程过长请参考下方链接
  • 系统烧录

三、设备启动与连接​

  • SSH连接教程

1. 硬件连接​

  • 插入已烧录系统的存储卡
  • 连接独立电源适配器
  • 使用Type-C数据线连接电脑
供电注意事项

首次启动系统时，请勿连接屏幕（TFT 或 HDMI）。屏幕会增加功耗，可能导致供电不足而使系统扩容失败。

扩容失败后无法通过其他方式修复，只能重新烧录系统。

2. 串口终端配置​

  • 启动MobaXterm软件
  • 新建Serial会话
  • 选择CH340串口，波特率115200

3. 系统启动验证​

  • 通电后观察终端日志输出
  • 正常启动将显示系统运行信息
  • 无输出时尝试回车键唤醒

4. 网络配置​

系统启动完成后，通过命令行配置Wi-Fi连接

  • 网络连接教程

四、常见问题与维护指南​

启动优先级​

  • 问题:同时插入TF卡和M2WE卡时的启动顺序
  • 说明:系统始终优先从TF卡启动，但启动后不影响M2WE卡的WiFi功能使用
  • 解决方案:建议日常使用仅插入单张系统卡以避免混淆

存储卡选择​

  • 问题:新手如何选择存储卡类型
  • 解决方案:
    • 推荐方案:TF 卡（通用性强、成本低、适合入门）
    • 替代方案:M2WE 卡（自带 WiFi 功能，需专用烧录器）
    • 说明:系统已预装主流 WiFi 模块驱动，TF 卡和 M2WE 卡均可直接使用

M2SD接触问题​

  • 问题:使用M2SD烧录器时，M2WE卡识别不稳定或无法启动
  • 解决方案:
    • 临时方案：使用橡皮筋加固卡体与插槽的连接
    • 长期方案：安装专用固定件
    • 固定件下载地址:
      Loading...

设备维护指南​

1. 关机流程

  • 务必通过系统命令执行正常关机
  • 严禁直接断开电源，以防系统损坏

2. 系统更新

  • 系统支持两种更新方式：
    1. 在线更新:在系统后台自动完成。
    2. 手动更新:本地下载更新包后，通过系统界面上传安装。
  • 请注意，传统的FAST系统全盘烧录升级方式依然适用。

3. 配置备份

  • 请定期将打印机配置文件备份至本地存储设备
  • 避免因系统问题造成配置丢失

4. 电源管理

  • 必须使用独立电源进行供电
  • 避免因电源干扰影响设备稳定运行

5. 存储卡保护

  • 系统烧录完成后请勿再次格式化存储卡
  • 防止系统文件损坏导致设备无法启动

OTA 更新说明​

1. 如何执行OTA更新

  • 请在浏览器中访问您的上位机IP地址,并在其后加上端口号 :9998 以访问OTA更新界面。
    • 示例：如果您的上位机IP是 192.168.1.100,则访问 http://192.168.1.100:9998

2. 配置文件安全

  • OTA 更新经过特殊设计，不会覆盖或修改您的个人配置文件

3. 更新过程注意事项

  • 更新期间请确保设备供电稳定
  • 意外断电将导致更新失败，严重时需重新烧录系统

4. 自定义代码处理

  • 如您曾修改 Klipper 配置文件或安装自定义插件
  • OTA 更新时将自动跳过相关文件，确保您的修改得以保留

5. 重要提醒：固件更新

  • 每次完成 OTA 更新后，请务必手动编译klipper固件，然后重新刷写下位机固件

Klipper 版本说明​

版本对应关系
  • FlyOS 系统内置的 Klipper 会自动获取系统版本号作为自身版本（如 FlyOS 1.3.0 则 Klipper 显示为 1.3.0）
  • 系统基于 Klipper 上游版本进行了针对性优化和功能增强：
    • 稳定性优化: 针对 FLY 硬件平台进行适配和稳定性调优
    • 断电续打: 支持意外断电后恢复打印任务
    • USB 打印: 支持通过 USB 直接发送 G-code 进行打印
    • 其他增强: 堵料检测、断电关机等 FLY 特色功能
版本时效性
  • 系统镜像打包时会锁定当时的 Klipper 版本
  • 例如：2026年5月13日发布的系统，其 Klipper 包含至少 2026年5月10日 的上游功能（测试验证需要时间）
  • 如需获取最新 Klipper 功能，可通过 OTA 更新或手动编译
Loading...