PrintCFG Klipper 套件使用教程

PrintCFG Klipper 套件使用教程

1. 项目目录结构及介绍

PrintCFG 是一套为 Klipper 3D 打印机设计的宏指令集，旨在提供一系列增强功能。以下是项目的目录结构及各部分的简要介绍：

• /.github: 存放 GitHub 专用的配置文件，如 FUNDING.yml 等。
• /docs: 包含项目文档链接，通常指向项目的 Wiki 页面。
• /profiles: 存储用户配置文件，如 user_profile.cfg，用户可以通过编辑这个文件来自定义宏指令的行为。
• /scripts: 包含一些脚本文件，用于项目的辅助操作。
• /src: 项目的主要源代码目录，包含宏指令的实现代码。
• /.gitignore: 指定 Git 忽略的文件和目录。
• /LICENSE: 项目的开源许可证文件，本项目采用 GPL-3.0 许可。
• /README.md: 项目说明文件，包含项目的基本信息和使用说明。
• /logging.cfg: 日志配置文件。
• /print_debug.cfg: 调试配置文件。
• /print_extras.cfg: 额外功能配置文件。
• /print_macros.cfg: 宏指令配置文件，包含宏指令的定义。

2. 项目的启动文件介绍

在 PrintCFG 套件中，并没有一个特定的“启动文件”。项目的功能主要是通过在 Klipper 的配置文件中引用宏指令来实现的。通常情况下，用户需要编辑 Klipper 的配置文件（通常名为 printer.cfg 或类似名称），在其中包含 PrintCFG 提供的宏指令。

例如：

[include printcfg/print_macros.cfg]

这条指令告诉 Klipper 包含 print_macros.cfg 文件中的宏定义。

3. 项目的配置文件介绍

项目的配置主要通过 user_profile.cfg 文件进行。以下是配置文件的一些基本介绍：

• user_profile.cfg: 这是用户自定义设置的主要文件。用户可以通过编辑此文件来改变宏指令的行为，如启动和结束 Gcode 宏指令、风扇控制、自定义归位行为、加热器控制等。
• 在 user_profile.cfg 文件中，用户可以设置各种参数，例如：

[bed_mesh]
enable = True
mesh_x = 5
mesh_y = 5
mesh_min = 0.0,0.0
mesh_max = 220.0,220.0

[start_gcode]
gcode = G28 ; Home all axes

用户可以根据自己的打印机型号和偏好来调整这些参数。通过修改 user_profile.cfg 中的设置，用户可以实现无需编写宏指令代码即可定制化打印体验。