1. Marlin 概述：从开源固件到运动控制核心
大家好，欢迎来到《手把手教你Marlin运动控制逻辑》的第一章。
我是你们的讲师，一个在嵌入式圈子里摸爬滚打了十几年的老工程师。今天咱们不聊虚的，直接切入正题——Marlin 固件。
说实话，我第一次接触 Marlin 是在 2013 年，那时候它还是个刚起步的开源项目，代码量远没现在这么庞大。但它的设计思路，尤其是运动控制那一块，让我眼前一亮。嗯，咱们今天就把它掰开揉碎了看看。
1.1 Marlin 固件的历史：从 RepRap 到行业标准
Marlin 的故事，得从 RepRap 项目说起。RepRap 是“自我复制快速原型机”的缩写，它想造一台能打印自己零件的 3D 打印机。这个理念很酷，但早期的固件（比如 Sprinter、Grbl 的变体）要么功能单一，要么代码结构混乱。
2011 年，Erik van der Zalm 站了出来。他把 Sprinter 固件重写了一遍，加入了梯形加减速算法和更流畅的 G-code 解析器。这就是 Marlin 1.0 的雏形。
我个人觉得，Marlin 能活下来并成为主流，靠的是三点：
- 社区驱动：全球的创客、工程师都在给它提 PR，Bug 修复速度极快。
- 硬件兼容性：从 8 位的 Arduino Mega 到 32 位的 STM32，它都能跑。
- 功能迭代：从简单的 FDM 打印，扩展到支持激光雕刻、CNC 铣削，甚至双 Z 轴、自动调平这些高级功能。
我记得在 2015 年，我帮一个客户调试一台大尺寸打印机，用的就是 Marlin 1.1.x。当时为了搞定“打印平台倾斜补偿”，我熬了好几个通宵。后来 Marlin 2.0 直接内置了 BILINEAR 调平，省了我不少事。
核心里程碑：
- 2011年：Marlin 1.0 发布，基于 Arduino Mega 2560。
- 2016年：Marlin 1.1 引入高级配置器（Configuration.h 重构）。
- 2019年：Marlin 2.0 全面支持 32 位架构，引入 HAL（硬件抽象层）。
- 至今：Marlin 2.1.x 成为主流，Bugfix 分支持续更新。
1.2 应用场景：不止是 3D 打印
很多人以为 Marlin 只能做 3D 打印。其实不然。它的运动控制核心是通用的，说白了就是“让电机按指定轨迹走”。
三大主流场景：
| 场景 | 核心需求 | Marlin 的适配方式 |
|---|---|---|
| 3D 打印 | 精确的层高控制、挤出量同步、热床温度管理 | 支持 G-code 中的 G1/G2/G3 运动指令，配合 M104/M109 温度控制 |
| CNC 铣削 | 高速主轴启停、恒定材料去除率、急停保护 | 启用 CNC_WORKSPACE_PLANES 和 SPINDLE_LASER_ENABLE 功能 |
| 激光雕刻 | 激光功率随速度动态调整、光斑补偿 | 通过 LASER_POWER_INLINE 和 LASER_MOVE_POWER 实现 |
你想想看，一台机器，换个固件配置就能从“打印塑料”变成“切割木板”，这多有意思。我曾经用一台改装过的 Ender 3，刷上 Marlin 2.0 的 CNC 配置，硬是切出了 3mm 厚的亚克力板。虽然速度慢了点，但精度完全够用。
避坑指南：
我曾经在切换场景时忘记修改 DEFAULT_AXIS_STEPS_PER_UNIT，结果激光雕刻出来的图案被拉伸了 20%。记住：每次切换应用场景，一定要重新校准步进电机脉冲当量。
1.3 源码结构概览：别被文件夹吓到
Marlin 的源码目录，第一次打开可能会觉得眼花缭乱。但别怕，它的结构其实很有逻辑。我习惯把它分成三层：
- 顶层配置层：
Marlin/Configuration.h和Configuration_adv.h。这是你改得最多的文件，所有硬件参数、功能开关都在这里。 - 核心运动层：
Marlin/src/module/目录下的planner.cpp、stepper.cpp、motion.cpp。这是 Marlin 的灵魂，负责梯形加减速、插补计算、脉冲输出。 - 硬件抽象层 (HAL)：
Marlin/src/HAL/目录。它把不同 MCU（AVR、STM32、LPC1768）的差异封装起来，让你写应用代码时不用关心底层寄存器。
下面这张图，是我自己整理的 Marlin 源码核心模块关系。你看一眼，心里就有谱了。
你看，数据流其实很清晰：G-code 进来 → 解析器拆解 → 规划器算轨迹 → 步进器执行。每一层各司其职，耦合度很低。这也是 Marlin 能跨平台的原因之一。
注意：
初学者最容易犯的错误，是直接修改 stepper.cpp 里的中断服务函数。千万别这么干！除非你完全理解定时器抢占和脉冲时序。我建议先从 Configuration.h 改起，那里有 90% 的调参需求。
1.4 为什么选择 Marlin？
市面上还有 Grbl、Klipper、RepRapFirmware 等固件。为什么我推荐 Marlin 作为入门首选？
- 生态成熟：遇到问题，99% 能在论坛或 GitHub Issue 里找到答案。
- 文档齐全：虽然官方文档有点散，但社区教程多如牛毛。
- 硬件门槛低：一块几十块的 Arduino Mega 2560 就能跑起来。
当然，Klipper 在高速打印上有优势，Grbl 在 CNC 领域更轻量。但如果你想系统学习运动控制算法，Marlin 的代码是最值得读的——它把“梯形加减速”和“前瞻规划”的实现写得明明白白。
好，第一章就到这里。记住：Marlin 不只是一个固件，它是一套完整的运动控制教学案例。后面几章，我会带你把它的核心算法一个个拆开来看。