课程导入：了解Prusa 3D打印机与Klipper固件的背景、课程目标、学习路径和所需硬件软件准备

欢迎来到《从Prusa 3D打印机到Klipper固件：开源智能硬件复刻入门》的第一章。在正式开始动手之前，我们需要先建立对整个项目的宏观认知。Prusa i3系列打印机是开源3D打印领域最经典的参考设计之一，而Klipper固件则是近年来彻底改变3D打印机控制方式的一次技术革命。本章将帮助你理解为什么我们要将这两者结合，以及你将在这门课程中经历怎样的学习旅程。我们会从背景故事讲起，明确课程目标，规划学习路径，并详细列出你需要在桌面上准备的所有硬件与软件清单。这一章是整个课程的地基，请务必耐心阅读，确保你对后续所有章节的上下文有清晰的理解。

1.1 Prusa 3D打印机的历史地位与开源意义

Prusa i3 是由捷克工程师 Josef Průša 设计的开源3D打印机，它基于 RepRap 项目的 Darwin 和 Mendel 设计演化而来。自2012年发布以来，Prusa i3 凭借其简单的龙门架结构、相对低廉的制造成本和极高的可复制性，成为全球最受欢迎的桌面级3D打印机参考设计。其 MK3S/MK4 型号更是将打印质量、可靠性和用户体验提升到了新的高度。理解 Prusa 的设计哲学——即"开放、模块化、可维修"——是复刻它的前提。Prusa 的机械结构采用铝型材框架、直线轴承和螺纹杆传动，这些标准件在全球范围内都容易采购，这为复刻提供了极大的便利。

从控制系统的角度看，Prusa 打印机传统上运行 Marlin 固件。Marlin 是一个运行在8位或32位微控制器（MCU）上的固件，它直接解析 G-Code 并实时计算步进电机的运动轨迹。这种架构在低速打印时表现良好，但当打印速度超过 100mm/s 时，8位 MCU 的运算能力就会成为瓶颈，导致打印质量下降。此外，Marlin 的配置参数分散在多个头文件中，修改和调试相对繁琐。这正是我们引入 Klipper 固件的核心原因。

1.2 Klipper固件的技术革新与核心原理

Klipper 固件由 Kevin O'Connor 于2016年发起，它采用了一种截然不同的架构：将运动规划与实时控制分离。Klipper 将复杂的运动学计算（如直线插补、加速度规划、压力提前补偿）全部交给一个运行 Linux 的宿主设备（通常是树莓派）完成，而打印机主板上的 MCU 只负责执行由宿主设备预先计算好的、极其精确的步进脉冲指令。这种"主机-从机"架构带来了三个显著优势：

• 更高的计算性能：树莓派的 CPU 性能远超传统 MCU，可以轻松处理 200mm/s 以上的高速打印运动规划，甚至支持 300mm/s 的极限速度。
• 更灵活的控制：Klipper 使用基于文本的配置文件（printer.cfg），所有参数（如电机电流、加速度、PID 值）都可以在运行时修改并立即生效，无需重新编译固件。
• 高级功能支持：Klipper 原生支持压力提前（Pressure Advance）、输入整形（Input Shaper）、多 MCU 协同（如同时控制挤出机和热床）等高级功能，这些功能在 Marlin 上实现起来非常困难。

Klipper 的通信链路是 USB 串口，宿主设备通过串口向 MCU 发送打包好的运动指令。MCU 固件（Klipper 的 MCU 端）负责将这些指令转换为精确的定时脉冲，驱动步进电机驱动器（如 TMC2209）。这种架构使得 MCU 的负载极低，因此可以使用非常廉价的 MCU 板（如 STM32F103 蓝板）来驱动打印机，而将性能瓶颈转移到树莓派上。

1.3 课程目标与学习成果

完成本课程后，你将具备以下能力：

课程的核心目标是让你不仅会"照着做"，更理解"为什么这样做"。例如，当你调整 input shaper 的频率时，你需要明白这是为了抑制打印机框架的共振，而不是盲目地套用某个数值。

1.4 学习路径规划与阶段划分

本课程共30章，分为五个递进阶段。每个阶段都有明确的交付物和验证标准，确保你每一步都走得扎实。

1. 阶段一（第1-4章）：硬件认知与准备。 你将深入了解 Prusa i3 的机械结构、电子控制板（如 Einsy RAMBo）、步进电机驱动器和热端组件。同时，我们会列出完整的采购清单，并指导你如何检查二手打印机或套件的状态。
2. 阶段二（第5-10章）：Klipper 系统搭建。 从树莓派系统烧录开始，到安装 Klipper、Moonraker、Fluidd/Mainsail 前端界面，再到为 MCU 编译和刷写固件。这一阶段结束时，你的打印机应该能通过 Klipper 响应基本移动指令。
3. 阶段三（第11-15章）：核心校准与运动学。 这是课程最核心的部分。你将学习如何校准挤出机步数、热床 PID、压力提前和输入整形。我们会提供详细的校准流程和判断标准，例如通过打印测试塔来微调压力提前值。
4. 阶段四（第16-20章）：切片与打印实践。 你将学习如何配置 SuperSlicer 以生成 Klipper 友好的 G-Code，并利用 Klipper 的宏（Macro）功能实现自动调平、换料等复杂操作。我们会对比不同切片参数对打印速度和表面质量的影响。
5. 阶段五（第21-30章）：优化、故障排除与复刻实战。 最后阶段，我们将深入探讨如何解决打印中的常见问题（如拉丝、层纹、翘边），并指导你如何将一台普通的 Prusa 克隆机升级为高速静音的 Klipper 机器。课程以一个小型复刻项目收尾，要求你独立完成从硬件组装到最终打印的全流程。

1.5 硬件与软件准备清单

在开始之前，请确保你拥有以下硬件和软件环境。我们建议不要跳过任何一项，因为后续章节的练习都依赖于这些基础。

硬件清单

软件环境

• 树莓派系统： Raspberry Pi OS Lite（64位，基于 Debian Bullseye 或更新版本）。
• Klipper 主机端： 通过 KIAUH 脚本安装，包含 Klipper、Moonraker、Fluidd（或 Mainsail）。
• 上位机软件： SuperSlicer 或 PrusaSlicer（用于切片），以及一个串口终端工具（如 MobaXterm 或 PuTTY）。
• 文本编辑器： VS Code 或 Notepad++，用于编辑 printer.cfg 文件。

1.6 案例拆解：从 Marlin 到 Klipper 的迁移决策

为了帮助你更直观地理解 Klipper 的优势，我们来看一个真实的迁移案例。假设你有一台运行 Marlin 2.0 的 Prusa MK3S 克隆机，打印速度限制在 80mm/s，加速度 1000mm/s²。当你尝试将速度提升到 120mm/s 时，打印件表面出现明显的振纹（ringing），且挤出不足。

初始现象与目标： 用户希望在不更换机械结构的前提下，将打印速度提升至 150mm/s，并消除振纹。

分析判断过程： 在 Marlin 架构下，8位 MCU 的 CPU 占用率在 120mm/s 时已接近 90%，无法进行更复杂的运动规划。振纹源于打印机框架的共振频率被激发，而 Marlin 的 S 曲线加速功能有限，无法有效抑制。此时，迁移到 Klipper 是合理的解决方案。

实际操作步骤：

1. 在树莓派上安装 Klipper，并刷写 MCU 固件。
2. 在 printer.cfg 中设置 max_velocity: 150 和 max_accel: 3000。
3. 运行 TESTZ 命令进行 PID 校准，然后执行 INPUT SHAPER CALIBRATE 命令自动测量共振频率。
4. 根据测量结果，Klipper 自动配置输入整形参数（如 EI 或 2HUMP_EI 滤波器）。

结果对比： 迁移后，打印速度稳定在 150mm/s，振纹几乎消失，表面质量甚至优于原 80mm/s 时的效果。代价是需要额外维护一台树莓派设备，且初次配置耗时约 2-3 小时。

复盘经验： Klipper 并非银弹，它需要用户具备一定的 Linux 操作能力和排错思维。但一旦配置完成，其性能和灵活性远超 Marlin。对于追求高速打印的复刻爱好者来说，Klipper 是值得投入的方向。

1.7 常见误区与总结复盘

在课程开始之际，我们总结几个初学者常见的误区，帮助你避开这些坑：

• 误区一：认为 Klipper 只是 Marlin 的替代品。 实际上，Klipper 改变了整个控制架构，你需要重新学习配置方式，而不是简单地将 Marlin 参数翻译过来。
• 误区二：忽视机械结构的重要性。 即使 Klipper 能通过输入整形补偿共振，但松散的皮带、磨损的轴承仍然会限制打印质量。请确保你的 Prusa 机械结构处于良好状态。
• 误区三：盲目追求超高速度。 300mm/s 的打印速度需要配合高强度框架、轻量化的打印头和高速挤出机。对于普通 Prusa 结构，150mm/s 是一个合理的上限。
• 误区四：忽略电源和散热。 树莓派和 MCU 都需要稳定的 5V 电源，劣质电源会导致 USB 通信中断，造成打印失败。