FAST系统使用指南与注意事项
系统特性与设计说明
1. 系统用户说明
- FAST系统为追求极致的轻量化与安全性,采用单用户模式。
- 唯一用户:
root - 限制:系统不支持创建或切换至其他用户账户。
2. 软件包管理
FAST系统为保持精简与快速启动,未集成apt等传统包管理器,因此无法执行apt update等指令。- 预置软件:系统已内置Klipper生态及日常维护所需的常用工具。
- 软件需求:如果您有额外的软件包需求,欢迎向我们反馈。我们将评估其通用性,并考虑在后续版本中预置。
3. 文件系统与持久化
- 可修改路径:为确保系统核心的完整性,FAST系统仅允许修改
/etc和/data目录下的文件。 - 限制说明:系统其他目录均为只读状态,任何修改都不会被保存。请将您的自定义配置和数据存储在上述两个指定目录内。
4. 系统更新策略
FAST系统支持两种更新方式:
OTA在线更新(推荐)
- 从
V1.3.0开始FAST系统支持OTA升级 - 更新入口:您可以通过访问上位机的
IP地址:9998端口来进入系统OTA升级页面。 - 重要提醒:
- 在发起系统更新前,请确保已暂停所有打印任务。
- 更新过程中系统服务将会重启,请勿进行任何打印操作,否则可能导致打印失败或硬件失控。
刷机更新
- 适用场景:当系统无法正常启动时
- 重要警告:
- 刷机前必须备份配置:刷机过程会清除所有用户数据,请务必提前备份打印机系统配置
- 刷机完成后需要手动恢复备份的配置文件
- 刷机方法:请参考官方提供的刷机教程和工具
路径与环境差异
固件生成位置
- 在FAST系统中,成功编译Klipper固件后,生成的固件文件位于:
/data/klipper/out/
配置文件位置
- 在FAST系统中
| 固件版本 | Klipper配置路径 | RRF配置路径 |
|---|---|---|
| 固件配置路径 | Loading... | Loading... |
Python环境差异
FAST系统未使用Klipper官方推荐的Python venv虚拟环境,而是采用了全局Python环境。这导致所有需要调用Klipper环境下的Python脚本命令都需要进行调整。
核心修改: 将命令中的 ~/klippy-env/bin/python 替换为 python。
| 场景描述 | 标准系统命令 | FAST系统命令 |
|---|---|---|
| 查询CANBUS UUID | Loading... | Loading... |
常见问题:当执行命令时,可能会遇到如下错误:
-bash: ~/klippy-env/bin/python: No such file or directory
解决方案: 按照上表所示,替换命令中的Python解释器路径即可。
组件安装指南
本文档介绍在FAST系统中安装Klipper插件的通用方法。
通用安装步骤
大部分Klipper插件都可以通过以下简单步骤安装:
-
下载组件到
/data目录cd /data
git clone [插件仓库地址] -
复制必要的Python文件到Klipper扩展目录
cp /data/[插件目录]/[插件主文件].py /data/klipper/klippy/extras/ -
重启Klipper服务生效
systemctl restart klipper
重要提示
- 文件选择: 请根据插件文档确认需要复制的具体Python文件,不要盲目复制所有.py文件
- 依赖检查: 安装前请确认插件是否有特殊依赖要求
- 版本兼容: 确保插件版本与您的Klipper版本兼容
依赖说明
注意: 如果您使用的是 FlyOS_FAST-V1.3.0 或更新版本,系统已内置常用依赖,通常无需额外安装。
常用组件安装示例
Beacon 3D 探头
cd /data && git clone https://github.com/beacon3d/beacon_klipper.git
cp /data/beacon_klipper/beacon.py /data/klipper/klippy/extras/
IDM 或 Scanner
cd /data && git clone https://gitee.com/NBTP/IDM.git
cp /data/IDM/idm.py /data/klipper/klippy/extras/
cp /data/IDM/scanner.py /data/klipper/klippy/extras/
Cartographer 3D
cd /data && git clone https://github.com/Cartographer3D/cartographer-klipper.git
cp /data/cartographer-klipper/idm.py /data/klipper/klippy/extras/
cp /data/cartographer-klipper/scanner.py /data/klipper/klippy/extras/
cp /data/cartographer-klipper/cartographer.py /data/klipper/klippy/extras/
注意事项
- 安装位置: 所有自定义组件请统一安装在
/data目录下 - 文件确认: 复制前请确认文件用途,避免覆盖重要文件
- 服务重启: 安装完成后需要重启Klipper服务才能生效
- 问题排查: 如安装后出现异常,请检查复制的文件是否正确
常见问题解答
1. 无法通过浏览器访问 fly-tools (端口 9999) 怎么办？
- FAST 系统是高度集成化的核心运行环境,默认并未预装
fly-tools网页工具,因此 9999 端口无服务响应。此为正常设计。
2. ⚠️ 重要:关于系统组件更新的说明
FAST 系统内的 Klipper、Moonraker 等均为定制化版本,与社区官方版本存在差异。
- 【核心原则】请勿通过命令行或其他非官方渠道手动更新,否则会破坏系统优化,导致兼容性问题和功能异常。
- 【正确方法】所有组件更新必须通过以下官方途径进行:
- 使用系统内置的 OTA 在线更新 功能。
- 或重新烧录完整的最新版系统镜像。
3. 进行 OTA 更新时需要注意什么？
- 您的配置是安全的:OTA 更新流程经过特殊设计,不会覆盖或修改您的个人配置文件。
- 确保更新不中断:请在更新期间保持设备供电,意外断电会造成更新失败,可能需要重新烧录系统。
- 关于自定义代码:若您修改过 Klipper 配置文件或自定义插件,OTA 更新 Klipper 时将跳过这些文件,您的修改会被保留。
Loading...