系统配置指南
- 本指南将引导您完成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，再逐项修改和验证。
H3 / H5 配置项
以下配置已按 H3、H5 v1.3.10 正式镜像中的 FlyOS-Conf/config.txt 核对。两个平台的服务配置基本一致，但 board、屏幕型号和底层硬件选项不能混用。
无线网络
| 配置项 | 默认值 | 可选值 | 说明 |
|---|---|---|---|
WIFI_SSID | 空 | Wi-Fi 名称 | 填写后，系统启动时尝试连接该网络 |
WIFI_PASS | 空 | Wi-Fi 密码 | 开放网络可以留空 |
这两项会在每次启动时读取。名称或密码包含空格及特殊字符时，应保留镜像中的双引号格式。
首次启动设置
| 配置项 | 默认值 | 可选值 | 说明 |
|---|---|---|---|
language | zh-CN | 镜像列出的语言代码 | 设置 Fluidd 和 Mainsail 的初始语言 |
printer_name | 空 | 不含特殊字符的名称 | 设置初始打印机名称 |
firmware | 默认不启用 | 产品文档指定的固件路径 | 仅在对应产品明确支持首次启动烧录时使用 |
language、printer_name 和 firmware 只在完整镜像烧录后的首次启动流程中使用。不要自行取消 firmware 的注释或复制其他产品的固件路径。
设备平台与 board
| 镜像平台 | 设备 | board 配置值 |
|---|---|---|
| H5 | FLY-Pi | fly-pi |
| H5 | FLY-Pi V2 | fly-pi-v2 |
| H5 | FLY-Gemini V1 | fly-gemini-v1 |
| H5 | FLY-Gemini V2 | fly-gemini-v2 |
| H5 | FLY-Gemini V3 | fly-gemini-v3 |
| H5 | FLY-C8 | fly-c8 |
| H3 | FLY-Lite2 | fly-lite2 |
| H3 | FLY-Lite2.1 | fly-lite2.1 |
| H3 | FLY-MiniPad | fly-minipad |
H5 镜像不能使用 H3 的 board，H3 镜像也不能使用 H5 的 board。启动脚本会拒绝不属于当前平台的设备值。首次启动前应明确填写实际设备，不要依赖镜像默认值。
H5 v1.3.10 镜像原始默认值为 board=fly-pi-v2，H3 v1.3.10 镜像原始默认值为 board=fly-lite2.1。只有实际设备正好对应这些型号时才能保留默认值。
系统与通信
| 配置项 | 默认值 | 可选值 | 说明 |
|---|---|---|---|
localtime | Asia/Shanghai | 世界时区名称 | 联网校时后使用的系统时区 |
console | serial | serial、both | 系统控制台模式；无明确需求时保持默认 |
printer | klipper | klipper、rrf | 选择启动 Klipper 或 RRF 打印环境 |
canbus_bitrate | 1000000 | 1000000、500000、250000 | 系统 CAN 速率，必须与总线上的全部设备一致 |
屏幕类型
| 镜像平台 | screen 可选值 |
|---|---|
| H5 | none、hdmi、fly-tft-v1、fly-tft-v2-r、fly-tft-v2-c |
| H3 | none、hdmi、fly-tft-v1、fly-minipad-r、fly-minipad-c、fly-tft-v2-r、fly-tft-v2-c |
| 配置项 | 默认值 | 可选值 | 说明 |
|---|---|---|---|
screen | hdmi | 上表中当前平台支持的值 | 选择显示接口；none 关闭本地显示输出 |
rotate | auto | auto、0、90、180、270 | auto 时 HDMI 默认使用 0 度，TFT 默认使用 90 度 |
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。屏幕型号、接口方向和串口路径应以对应产品文档为准。
网页与摄像头
| 配置项 | 默认值 | 可选值 | 说明 |
|---|---|---|---|
klipper_webui | fluidd | fluidd、mainsail | Klipper 模式下默认使用的网页界面 |
crowsnest | 0 | 0、1 | 启用或关闭 Crowsnest 摄像头服务 |
H3、H5 v1.3.10 正式镜像没有 gocam 配置项，请不要照搬 v1.4.0 测试版镜像的设置。
断电关机和高级配置
shutdown_pin_state、shutdown_pin、spidev 和 overlays 与具体设备硬件有关。只有对应产品文档给出明确值时才可修改，不要复制其他主板、其他硬件版本或其他芯片平台的配置。
断电关机与断电续打不能同时启用。需要断电续打时，应按对应产品教程关闭断电关机检测。