系统配置指南
- 本指南将引导您完成FlyOS-Fast系统的基本配置,帮助您快速上手并优化使用体验。
配置方式
- 通过Config Myprint软件进行系统配置
- 通过浏览器进行系统配置
使用 Config Myprint 配置系统卡
Config Myprint 适合在首次启动前图形化设置系统卡。将烧录完成的系统卡接入电脑，打开软件并等待软件识别 FlyOS-Conf 分区。
软件可用选项可能晚于测试镜像更新。完成写入后，应打开 FlyOS-Conf/config.txt，检查 board、屏幕、摄像头和 CAN 速率是否与实际设备一致。软件没有显示的新配置项需要手动添加，不要使用相近名称代替。
第一步：启用系统配置
打开 启用系统配置 开关。
第二步：完成基础设置
配置文件管理
- 只选择保存打印机配置文件的文件夹，不要选择单个文件。
- 软件会将选定文件夹中的配置复制到系统卡，并在首次启动时加载。
- 写入前确认文件夹内没有其他打印机遗留的
printer.cfg或重复配置。
Wi-Fi 网络
填写可用的 Wi-Fi 名称和密码。使用有线网络或准备稍后配置 Wi-Fi 时可以留空。
Klipper 网页界面
选择 Fluidd 或 Mainsail。该选项仅影响 Klipper 模式下默认使用的网页界面。
本地显示
选择实际连接的显示接口，再决定是否启用 KlipperScreen 或 FLY Screen。如果两项同时开启，系统优先启动 KlipperScreen；使用 FLY Screen 时应关闭 KlipperScreen。
第三步：完成高级设置
打印机名称
设置便于识别的打印机名称。建议只使用英文字母、数字、短横线和下划线。
摄像头服务
按需启用 Crowsnest。v1.4.0 测试版镜像如需使用 GoCam，应在写入完成后确认 config.txt 中为 crowsnest=0、gocam=1；两个服务不要同时启用。
语言和时区
选择系统初始语言和实际时区。系统联网后会根据该时区显示时间。
CAN 通信速率
选择与主板及全部 CAN 工具板固件一致的速率。常用值为 1000000、500000 或 250000，同一条 CAN 总线不能混用不同速率。
第四步：写入并检查
完成全部设置后，点击 手动写入配置。只在界面中选择选项但没有点击写入，配置不会保存到系统卡。
写入完成后执行以下检查：
- 打开
FlyOS-Conf/config.txt。 - 确认
board与实际设备完全一致。 - 确认只启用了需要的屏幕 UI 和摄像头服务。
- 确认
canbus_bitrate与全部 CAN 设备固件一致。 - 保存后安全弹出系统卡，再插入目标设备启动。
- 使用浏览器进行系统配置时,请确保您的设备已连接到同一网络,以便顺利访问配置界面。
- 需要根据SSH连接上位机教程安装好系统卡并启动系统,然后通过浏览器访问系统IP地址进行配置。
修改配置文件
FLYOS-FAST 的系统配置文件在不同位置显示为不同名称，但实际指向同一份配置：
| 使用场景 | 文件位置 | 适用情况 |
|---|---|---|
| 系统卡接入电脑 | FlyOS-Conf/config.txt | 首次启动前设置网络、设备型号和初始化选项 |
| Linux 系统内部 | /config/config.txt | 通过 SSH 检查配置 |
| Fluidd / Mainsail | .flyos-config/sys-config.conf | 系统启动后在线修改每次启动都会读取的选项 |
- 先备份原配置文件。
- 保持
key=value格式，不要改成key: value。 - 不要重复添加同名配置项；需要修改时直接编辑原值。
- 不要使用浏览器网页翻译功能编辑配置，避免配置内容被改写。
- 名称和路径尽量只使用英文字母、数字、短横线及下划线。
- 不要修改
######### PLEASE DO NOT EDIT THE FOLLOWING #########后面的内容。
- 首次启动前修改系统卡
- 系统启动后通过网页修改
- 完成镜像烧录后，将系统卡重新接入电脑。
- 打开名为
FlyOS-Conf的可移动磁盘。 - 使用纯文本编辑器打开
config.txt。 - 按实际设备修改
board，再设置 Wi-Fi、打印模式、屏幕和 CAN 速率。 - 保存文件并安全弹出系统卡，然后插入设备启动。
language、printer_name 和 firmware 等初始化项目应在这里修改。系统已经完成首次启动后，再编辑这些值不会重新执行初始化流程。
- 确保电脑与上位机连接到同一网络。
- 在浏览器打开设备 IP 地址，例如
http://192.168.1.2/。 - 在 Fluidd 中取消勾选“筛选隐藏的文件和文件夹”，或在 Mainsail 中勾选“显示隐藏文件”。
Loading... | Loading... |
- 打开
.flyos-config文件夹中的sys-config.conf。
- 修改需要的配置项并保存。
- 完全重新启动上位机，使系统服务和硬件配置重新加载。
网页方式适合修改每次启动都会读取的配置。已经错过首次启动的初始化项目不能仅靠重启重新执行；请使用相应功能自己的修改方法。
保存后检查
重新启动后至少确认以下项目：
- 网页可以正常打开，并且打印模式与网页界面选择正确。
- 本地屏幕、触摸方向和屏幕 UI 正常。
- 摄像头、Moon2UART 等可选服务只启动了需要的一项。
- 使用 CAN 时，系统速率与主板、工具板固件速率完全一致。
- Klipper 或 RRF 可以正常连接对应控制板。
如果修改后系统不能正常启动，将系统卡接入电脑，恢复修改前的 config.txt，再逐项修改和验证。
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 只在完整镜像烧录后的首次启动流程中使用。系统已完成首次启动后，再修改这些项目不会重新执行初始化。
| 配置项 | 默认值 | 可选值 | 说明 |
|---|---|---|---|
language | zh-CN | zh-CN、en、ja、ko 等镜像列出的语言代码 | 设置 Fluidd 和 Mainsail 的初始语言 |
printer_name | 空 | 任意不含特殊字符的名称 | 设置初始打印机名称 |
firmware | /usr/lib/firmware/klipper/stm32h723-128k-usb.bin | 镜像内固件路径，或 /config/klipper.bin | C5、C5 V1.1、C8P 首次启动时可按 board 自动烧录板载 MCU；Pi V3 不会用该项烧录外接主板 |
自动烧录只在首次启动标记存在、board 和 firmware 均有效且固件文件存在时执行。不要为了重复烧录而手动创建首次启动标记；后续固件维护请使用对应主板的固件烧录教程。
系统与主板
以下设置会在每次启动时读取。
| 配置项 | 默认值 | 可选值 | 说明 |
|---|---|---|---|
board | none | fly-c5、fly-c5-v1.1、fly-c8p、fly-pi-v3 | 选择实际设备型号；该值会影响 H618 的串口和 SPI 外设配置 |
localtime | Asia/Shanghai | 世界时区名称 | 联网校时后使用的系统时区 |
printer | klipper | klipper、rrf | 选择要启动的打印控制环境 |
console | serial | serial、both | 设置系统控制台；无明确需求时保持默认 |
canbus_bitrate | 1000000 | 1000000、500000、250000 | 设置系统 CAN 接口速率，必须与总线上的所有 CAN 设备一致 |
board镜像原始配置为 board=none，设备会优先尝试读取硬件识别结果；仍无法识别时，H618 v1.3.10 会回退为 fly-c5。因此 C8P、C5 V1.1 和 Pi V3 用户应在首次启动前明确选择自己的设备型号，不要依赖回退值。
不同 board 值启用的 H618 外设如下。此表只用于说明选择错误的影响，不代表这些串口或 SPI 接口可以随意改作其他用途。
board 配置值 | 系统启用的板载外设 |
|---|---|
fly-c5 | UART1 |
fly-c5-v1.1 | UART1、SPI1.2 |
fly-c8p | UART1、UART3、UART4、SPI1.2 |
fly-pi-v3 | UART1、UART3、UART4、SPI1.2 |
屏幕与界面
| 配置项 | 默认值 | 可选值 | 说明 |
|---|---|---|---|
screen | hdmi | none、hdmi、fly-tft-v2-r、fly-tft-v2-c | 选择显示接口；none 关闭本地显示输出 |
rotate | auto | auto、0、90、180、270 | auto 时 HDMI 默认为 0 度，FLY-TFT 默认为 90 度；HDMI 显示和触摸方向也会应用手动角度 |
klipper_screen | 0 | 0、1 | Klipper 模式下启用 KlipperScreen |
fly_screen | 0 | 0、1 | Klipper 模式下启用 FLY Screen |
moon2uart | 0 | 0、1 | 启用 Moon2UART 串口屏服务 |
m2u_port | /dev/ttyS1 | 实际串口设备路径 | Moon2UART 使用的串口 |
m2u_baud | 115200 | 屏幕要求的波特率 | Moon2UART 串口通信速率 |
当 klipper_screen=1 与 fly_screen=1 同时设置时，系统优先启动 KlipperScreen。使用 FLY Screen 时，应设置 klipper_screen=0、fly_screen=1。
从旧版本 OTA 升级后，config.txt 可能缺少 fly_screen、m2u_port 或 m2u_baud。需要相应功能时，可参照上表补充配置项。
Klipper 网页与摄像头
| 配置项 | 默认值 | 可选值 | 说明 |
|---|---|---|---|
klipper_webui | fluidd | fluidd、mainsail | Klipper 模式下使用的网页界面 |
crowsnest | 0 | 0、1 | 启用或关闭摄像头服务 |
| 配置项 | 默认值 | 可选值 | 说明 |
|---|---|---|---|
gocam | 0 | 0、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 默认被注释，即不启用断电关机检测。不同产品和硬件版本的触发电平可能不同，请按对应产品的“断电关机与断电续打”文档填写，不要直接复制其他设备的值。
断电关机与断电续打不能同时启用。需要断电续打时，请保持断电关机检测关闭。
高级配置
| 配置项 | 默认值 | 可选值 | 说明 |
|---|---|---|---|
spidev | spidev0.0 | 产品文档明确给出的 SPI 设备组合 | 控制提供给 Linux 用户空间的 SPI 设备 |
spidev、overlays 等项目用于底层硬件启用。没有产品教程明确要求时，请保持镜像默认值，并且不要修改 ######### PLEASE DO NOT EDIT THE FOLLOWING ######### 之后的内容。