跳到主要内容

FLYOS-FAST 系统配置指南

本指南用于设置 FLYOS-FAST 的设备平台、网络、打印环境、屏幕、摄像头和 CAN 通信。H3、H5、H618 的系统服务使用方式相近，但硬件相关选项不能跨平台复制。

配置前确认​

开始前先确认以下信息：

项目需要确认的内容
系统镜像镜像平台与设备芯片一致：H3、H5 或 H618
设备型号用于选择正确的 board
打印环境使用 Klipper 还是 RRF
本地显示无屏幕、HDMI、FLY-TFT、KlipperScreen、FLY Screen 或串口屏
摄像头不启用、Crowsnest，或 FLYOS-FAST v1.4.0 测试版的 GoCam
CAN 速率主板、工具板和系统统一使用 1000000、500000 或 250000
优先设置 board

board 会影响串口、SPI、屏幕和板载 MCU 等硬件配置。选择错误可能造成接口不可用、屏幕异常或首次启动固件处理错误。不要先复制完整配置再修改设备名，应从当前镜像的原始 config.txt 开始逐项设置。

推荐配置顺序​

  1. 选择与设备匹配的系统镜像和 board。
  2. 设置 Wi-Fi、时区和打印机名称。
  3. 选择 printer=klipper 或 printer=rrf。
  4. 选择实际屏幕类型和屏幕 UI。
  5. 按需启用摄像头或 Moon2UART，一项一项测试。
  6. 使用 CAN 时统一设置全部设备的速率。
  7. 保存后重新启动，并逐项确认服务和硬件接口。

选择配置方式​

使用 Config Myprint 配置系统卡​

Config Myprint 适合在首次启动前图形化设置系统卡。将烧录完成的系统卡接入电脑，打开软件并等待软件识别 FlyOS-Conf 分区。

软件界面与镜像版本

软件可用选项可能晚于测试镜像更新。完成写入后，应打开 FlyOS-Conf/config.txt，检查 board、屏幕、摄像头和 CAN 速率是否与实际设备一致。软件没有显示的新配置项需要手动添加，不要使用相近名称代替。

第一步：启用系统配置​

打开 启用系统配置 开关。

Loading...

第二步：完成基础设置​

配置文件管理​
  • 只选择保存打印机配置文件的文件夹，不要选择单个文件。
  • 软件会将选定文件夹中的配置复制到系统卡，并在首次启动时加载。
  • 写入前确认文件夹内没有其他打印机遗留的 printer.cfg 或重复配置。
Loading...
Wi-Fi 网络​

填写可用的 Wi-Fi 名称和密码。使用有线网络或准备稍后配置 Wi-Fi 时可以留空。

Loading...
Klipper 网页界面​

选择 Fluidd 或 Mainsail。该选项仅影响 Klipper 模式下默认使用的网页界面。

Loading...
本地显示​

选择实际连接的显示接口，再决定是否启用 KlipperScreen 或 FLY Screen。如果两项同时开启，系统优先启动 KlipperScreen；使用 FLY Screen 时应关闭 KlipperScreen。

Loading...

第三步：完成高级设置​

打印机名称​

设置便于识别的打印机名称。建议只使用英文字母、数字、短横线和下划线。

Loading...
摄像头服务​

按需启用 Crowsnest。v1.4.0 测试版镜像如需使用 GoCam，应在写入完成后确认 config.txt 中为 crowsnest=0、gocam=1；两个服务不要同时启用。

Loading...
语言和时区​

选择系统初始语言和实际时区。系统联网后会根据该时区显示时间。

Loading...
CAN 通信速率​

选择与主板及全部 CAN 工具板固件一致的速率。常用值为 1000000、500000 或 250000，同一条 CAN 总线不能混用不同速率。

Loading...

第四步：写入并检查​

完成全部设置后，点击 手动写入配置。只在界面中选择选项但没有点击写入，配置不会保存到系统卡。

Loading...

写入完成后执行以下检查：

  1. 打开 FlyOS-Conf/config.txt。
  2. 确认 board 与实际设备完全一致。
  3. 确认只启用了需要的屏幕 UI 和摄像头服务。
  4. 确认 canbus_bitrate 与全部 CAN 设备固件一致。
  5. 保存后安全弹出系统卡，再插入目标设备启动。

按平台查看配置项​

H618 配置项​

以下默认值和可选值已按 H618 v1.3.10 正式镜像中的 FlyOS-Conf/config.txt 核对；v1.4.0 测试镜像新增的配置会单独标注。

无线网络​

WIFI_SSID 和 WIFI_PASS 在每次启动时读取。使用开放网络时密码可以留空；使用加密网络时，两项都要填写。

配置项默认值可选值说明
WIFI_SSID空Wi-Fi 名称填写后，系统启动时自动连接该网络
WIFI_PASS空Wi-Fi 密码开放网络可以留空

首次启动设置​

language、printer_name 和 firmware 只在完整镜像烧录后的首次启动流程中使用。系统已完成首次启动后，再修改这些项目不会重新执行初始化。

配置项默认值可选值说明
languagezh-CNzh-CN、en、ja、ko 等镜像列出的语言代码设置 Fluidd 和 Mainsail 的初始语言
printer_name空任意不含特殊字符的名称设置初始打印机名称
firmware/usr/lib/firmware/klipper/stm32h723-128k-usb.bin镜像内固件路径，或 /config/klipper.binC5、C5 V1.1、C8P 首次启动时可按 board 自动烧录板载 MCU；Pi V3 不会用该项烧录外接主板
自动烧录条件

自动烧录只在首次启动标记存在、board 和 firmware 均有效且固件文件存在时执行。不要为了重复烧录而手动创建首次启动标记；后续固件维护请使用对应主板的固件烧录教程。

系统与主板​

以下设置会在每次启动时读取。

配置项默认值可选值说明
boardnonefly-c5、fly-c5-v1.1、fly-c8p、fly-pi-v3选择实际设备型号；该值会影响 H618 的串口和 SPI 外设配置
localtimeAsia/Shanghai世界时区名称联网校时后使用的系统时区
printerklipperklipper、rrf选择要启动的打印控制环境
consoleserialserial、both设置系统控制台；无明确需求时保持默认
canbus_bitrate10000001000000、500000、250000设置系统 CAN 接口速率，必须与总线上的所有 CAN 设备一致
正确选择 board

镜像原始配置为 board=none，设备会优先尝试读取硬件识别结果；仍无法识别时，H618 v1.3.10 会回退为 fly-c5。因此 C8P、C5 V1.1 和 Pi V3 用户应在首次启动前明确选择自己的设备型号，不要依赖回退值。

不同 board 值启用的 H618 外设如下。此表只用于说明选择错误的影响，不代表这些串口或 SPI 接口可以随意改作其他用途。

board 配置值系统启用的板载外设
fly-c5UART1
fly-c5-v1.1UART1、SPI1.2
fly-c8pUART1、UART3、UART4、SPI1.2
fly-pi-v3UART1、UART3、UART4、SPI1.2

屏幕与界面​

配置项默认值可选值说明
screenhdminone、hdmi、fly-tft-v2-r、fly-tft-v2-c选择显示接口；none 关闭本地显示输出
rotateautoauto、0、90、180、270auto 时 HDMI 默认为 0 度，FLY-TFT 默认为 90 度；HDMI 显示和触摸方向也会应用手动角度
klipper_screen00、1Klipper 模式下启用 KlipperScreen
fly_screen00、1Klipper 模式下启用 FLY Screen
moon2uart00、1启用 Moon2UART 串口屏服务
m2u_port/dev/ttyS1实际串口设备路径Moon2UART 使用的串口
m2u_baud115200屏幕要求的波特率Moon2UART 串口通信速率

当 klipper_screen=1 与 fly_screen=1 同时设置时，系统优先启动 KlipperScreen。使用 FLY Screen 时，应设置 klipper_screen=0、fly_screen=1。

OTA 升级保留旧配置

从旧版本 OTA 升级后，config.txt 可能缺少 fly_screen、m2u_port 或 m2u_baud。需要相应功能时，可参照上表补充配置项。

Klipper 网页与摄像头​

配置项默认值可选值说明
klipper_webuifluiddfluidd、mainsailKlipper 模式下使用的网页界面
crowsnest00、1启用或关闭摄像头服务
v1.4.0 测试版配置
配置项默认值可选值说明
gocam00、1启用 GoCam UVC 摄像头服务

v1.3.10 正式版没有 gocam。v1.4.0 测试版中如果 crowsnest=1 与 gocam=1 同时设置，系统会优先启动 Crowsnest。使用 GoCam 时应明确设置 crowsnest=0、gocam=1。

GoCam 使用方法：查看 GoCam 摄像头服务

断电关机​

H618 v1.3.10 的原始配置中，shutdown_pin_state 与 shutdown_pin 默认被注释，即不启用断电关机检测。不同产品和硬件版本的触发电平可能不同，请按对应产品的“断电关机与断电续打”文档填写，不要直接复制其他设备的值。

功能互斥

断电关机与断电续打不能同时启用。需要断电续打时，请保持断电关机检测关闭。

高级配置​

配置项默认值可选值说明
spidevspidev0.0产品文档明确给出的 SPI 设备组合控制提供给 Linux 用户空间的 SPI 设备

spidev、overlays 等项目用于底层硬件启用。没有产品教程明确要求时，请保持镜像默认值，并且不要修改 ######### PLEASE DO NOT EDIT THE FOLLOWING ######### 之后的内容。

常用功能组合​

目标关键配置注意事项
仅使用网页，无本地屏幕screen=none、klipper_screen=0、fly_screen=0Moon2UART 串口屏可按需独立启用
HDMI + KlipperScreenscreen=hdmi、klipper_screen=1、fly_screen=0rotate 设置显示和触摸方向
使用 FLY Screenklipper_screen=0、fly_screen=1screen 仍需选择实际显示接口
使用 Crowsnestcrowsnest=1v1.4.0 测试版同时应保持 gocam=0
使用 GoCamcrowsnest=0、gocam=1仅适用于 v1.4.0 测试版镜像；查看教程
使用 Moon2UARTmoon2uart=1同时核对 m2u_port 与 m2u_baud
使用 CAN设置统一的 canbus_bitrate系统、主板和全部 CAN 节点必须一致

重启后的完成检查​

检查项正常结果
网络可以通过设备 IP、local.klipper.cn 或直连地址打开网页
设备平台串口、SPI 和板载功能与实际产品一致
打印服务Klipper 或 RRF 只启动所选环境
屏幕显示、触摸和旋转方向正常
摄像头只运行 Crowsnest 或 GoCam 中选择的一项
CAN所有节点能够被查询且无速率不一致报错

一次只修改一组相关选项。出现异常时先恢复该组配置，不要同时改动 board、屏幕、CAN 和高级硬件参数，以免无法判断问题来源。

Loading...