Demon Klipper Essentials Unified 项目安装与配置全指南

前言

Demon Klipper Essentials Unified 是一套功能强大的 Klipper 宏集合，旨在为3D打印爱好者提供更智能、更高效的打印体验。本文将详细介绍如何从零开始安装和配置这套系统，包括前期准备、安装步骤、常见问题解决等关键内容。

系统准备

备份当前配置

在进行任何操作前，强烈建议完整备份当前系统配置：

1. 备份整个 /config 文件夹
2. 记录当前使用的关键参数（如步进电机配置、热床PID等）
3. 禁用现有宏（特别是START_PRINT和END_PRINT）

软件环境要求

确保满足以下条件：

• 最新版Orca Slicer（2.2.0 beta2或更高版本）
• 已安装Python 3环境
• 具备SSH访问权限

安装流程

基础安装（适用于大多数打印机）

执行以下SSH命令开始安装：

wget -O - [安装脚本地址] | bash

安装完成后运行预置条件安装脚本：

sh ~/printer_data/config/Demon_Klipper_Essentials_Unified/Other_Files/Demon_Install_Script/Demon_Prerequisites_Installer.sh

Sovol SV08专用安装

仅适用于Sovol SV08打印机：

wget -O - [SV08专用安装脚本地址] | bash

然后运行专用预置条件安装脚本：

sh ~/printer_data/config/Demon_Klipper_Essentials_Unified/Other_Files/Demon_Install_Script/Demon_Sovol_SV08_Prerequisites_Installer.sh

关键配置步骤

1. 变量保存设置

在printer.cfg中添加以下内容（建议放在文件顶部）：

[save_variables]
filename = ~/demon_vars.cfg

注意：确保系统中没有其他重复的[save_variables]段。

2. Mainsail配置

配置Mainsail.cfg中的_CLIENT_VARIABLE宏，或手动添加以下内容到printer.cfg：

[respond]

3. 用户文件管理

系统引入了新的用户文件管理机制：

1. 自动创建Demon_User_Files目录
2. 包含三个关键配置文件：
   • demon_user_settings.cfg
   • demon_printer_settings.cfg
   • demon_macro_settings.cfg

可通过以下方式之一启用自动更新功能（根据硬件平台选择）：

# 树莓派系统
[include ./Demon_Klipper_Essentials_Unified/Other_Files/Demon_User_Files_Updater/Extract_Demon_User_Files_Rpi.cfg]

# Biqu系统
[include ./Demon_Klipper_Essentials_Unified/Other_Files/Demon_User_Files_Updater/Extract_Demon_User_Files_Biqu.cfg]

# Sovol系统
[include ./Demon_Klipper_Essentials_Unified/Other_Files/Demon_User_Files_Updater/Extract_Demon_User_Files_Sovol.cfg]

# MKS系统
[include ./Demon_Klipper_Essentials_Unified/Other_Files/Demon_User_Files_Updater/Extract_Demon_User_Files_MKS.cfg]

诊断工具使用

系统提供了强大的诊断工具，可通过以下命令运行：

sh ~/printer_data/config/Demon_Klipper_Essentials_Unified/Other_Files/Demon_Diagnostics/Demon_Diagnostics.sh

该工具会：

• 扫描当前系统状态
• 显示安装进度
• 指出配置问题
• 提供修复建议

理想情况下，所有检查项应显示为绿色。

文件包含

完成上述步骤后，在printer.cfg顶部添加以下包含指令：

[include ./Demon_Klipper_Essentials_Unified/*.cfg]
[include ./Demon_User_Files/*.cfg]

保存并重启Klipper服务。

常见问题解决

EOF错误处理

如果出现EOF错误，通常是因为：

1. demon_vars.cfg文件存在但为空
2. 系统尚未创建必要的变量

解决方法：

1. 确保已正确配置[save_variables]段
2. 执行一次打印机归位操作
3. 对于Klicky Probe用户，需先编辑相关宏

启动循环问题

如果遇到启动循环：

1. 检查是否有重复的[save_variables]段
2. 尝试重新安装变量文件：

cp -f ~/printer_data/config/Demon_Klipper_Essentials_Unified/Other_Files/Demon_Vars/demon_vars.cfg ~/

3. 尝试修改文件名配置：

[save_variables]
filename = ~/demon_vars.cfg

版本升级注意事项

从旧版本升级时需注意：

1. 更新切片软件的起始G代码
2. 更新所有宏文件
3. 使用新的用户设置更新工具：

python3 ~/printer_data/config/Demon_Klipper_Essentials_Unified/Other_Files/Demon_Install_Script/Demon_config_update.py

需要先安装必要的Python库：

python3 -m pip install rich
python3 -m pip install ConfigUpdater

结语

Demon Klipper Essentials Unified 通过其丰富的功能和智能化的配置工具，大大简化了Klipper系统的配置过程。遵循本指南完成安装后，您将获得一个功能完善、易于维护的3D打印控制系统。如在安装过程中遇到任何问题，建议首先运行诊断工具获取详细的问题分析。