什么是Marlin固件？
Marlin是2025年全球使用最广泛的开源 3D打印机 固件，运行在成千上万种不同型号的打印机主板上。它负责将切片软件生成的G-code指令转化为步进电机的精确运动、控制热端和热床的温度、处理限位开关信号以及管理各种传感器。
虽然大多数成品打印机出厂已预装Marlin并配置好，但以下场景需要你自行编译和刷写自定义固件：升级主板、更换热端或热床传感器、增加自动调平传感器、改装挤出机类型、调整步进电机驱动芯片设置等。本文将从编译环境搭建开始，带你掌握Marlin固件的配置方法。
编译环境搭建
在Windows上搭建
推荐使用PlatformIO（PIO）来编译Marlin，它是VS Code的一个扩展：
- 下载并安装Visual Studio Code
- 在VS Code中安装扩展"PlatformIO IDE"
- 从Marlin GitHub仓库下载最新的Marlin 2.x源码
- 在VS Code中打开Marlin文件夹，PlatformIO会自动检测并初始化
- 确认platformio.ini文件中已添加你的主板型号
核心文件结构
Marlin源码中两个最重要的配置文件位于Marlin/目录下：
- Configuration.h：主配置文件，包含所有可启用的功能宏定义和参数
- Configuration_adv.h：高级配置，包含更细粒度的功能和调试选项
注意：Marlin使用C++预处理器宏（#define/#undef）来控制功能的开启和关闭，不要手动删除代码行，只需注释掉不需要的功能或修改数值。
核心配置参数详解
基本参数
#define SERIAL_PORT -1：串口编号，-1表示使用USB虚拟串口
#define BAUDRATE 250000：串口通信速率，越高越流畅，建议250000
#define MOTHERBOARD BOARD_RAMPS_14_EFB：主板型号，在boards.h中找到对应定义
运动参数
#define DEFAULT_AXIS_STEPS_PER_UNIT { 80, 80, 400, 93 }：X/Y/Z/E各轴的每毫米步进数，这是校准后获得的关键参数。数值来自：
步进值 = 驱动器微步数 × 电机步进角 × 皮带轮齿距 / (360° × 传动比)
#define DEFAULT_MAX_FEEDRATE { 300, 300, 5, 25 }：各轴最大进给速度（mm/s）
#define DEFAULT_MAX_ACCELERATION { 3000, 3000, 100, 10000 }：各轴最大加速度（mm/s²）
温度参数
#define TEMP_SENSOR_0 1：热端温度传感器类型。1=EPCOS 100K NTC（最常用），5=PT100（高温）
#define HEATER_0_MAXTEMP 285：热端最高温度保护，防止热失控
#define PIDTEMP：开启PID温控，建议开启
PID参数可以自动校准：运行 M303 E0 S200 C8 命令，固件会自动计算P/I/D值并输出到串口。
自动调平传感器配置
自动调平是现代3D打印机的标配功能，以下是最常见的两种传感器配置：
BLTouch安装与配置
- 将BLTouch的5根线连接到主板对应的Servo接口和Z限位接口
- 在Configuration.h中：
#define BLTOUCH // 启用BLTouch
#define NOZZLE_TO_PROBE_OFFSET { -30, -10, 0 } // 传感器相对喷嘴的偏移量
#define AUTO_BED_LEVELING_BILINEAR // 使用双线性插值调平
G-code调平命令：G28（归零）→ G29（启动自动调平），完成后调平数据自动保存到EEPROM。
电感式/电容式传感器配置
- 确认传感器的工作电压与主板兼容（大多数为5V或24V）
- 将传感器信号线连接到Z限位端口
- 在Configuration.h中将Z限位从"物理限位"改为"探头限位"
固件刷写
通过USB刷写
- 连接打印机主板到电脑，在VS Code中点击PlatformIO的"Build"按钮
- 编译成功后点击"Upload"，PlatformIO会自动识别主板串口并刷写
- 刷写完成后，通过串口监视器发送Marlin启动信息查看固件版本和配置
通过SD卡刷写
如果主板不支持通过USB刷写（或USB驱动异常）：
- 将编译好的firmware.bin文件复制到FAT32格式的SD卡根目录
- 将SD卡插入主板
- 重启打印机，主板会自动刷写固件（屏幕可能短暂黑屏）
- 如果主板没有自动更新，尝试将文件名改为firmware.bin（某些主板检测文件名是否有变化）
常见配置问题与排查
- 编译报错"unknown board"：检查platformio.ini中的board名称是否与实际的MCU型号匹配
- 自动调平后一直报错"Probe failed"：检查BLTouch的接线和探针伸缩是否正常，增加Z_PROBE_SPEED的慢速探测速度
- 温度读数异常（显示-14°C或300°C+）：温度传感器类型配置错误或接线松动
- 电机不运动或抖动：步进驱动芯片的电流设置不正确或微步配置错误
- EEPROM保存失败：检查MCU是否有EEPROM空间，配置SD卡模拟EEPROM的选项
进阶：在Marlin中开启线性前进
线性前进（Linear Advance）是Marlin中改善挤出均匀性的关键技术：
- 在Configuration_adv.h中找到
#define LIN_ADVANCE并取消注释 - 编译刷写后，运行
M900 K0.0到M900 K0.5测试K值 - 打印线性前进校准模型，找到最佳K值后写入配置并重新编译
注意：线性前进会小幅增加打印计算负担，在8位主板上可能影响最高速度。
总结
Marlin固件的自定义配置是3D打印高级用户的必修课。从PlatformIO编译环境搭建开始，到核心参数配置、自动调平传感器设置再到最终刷写，每一步都有明确的原理支撑。建议修改配置时一次只改一个参数，刷写后立即验证效果。如果发生配置错误导致打印机异常（如热失控保护触发），按住主板的RESET按钮或断开电源重新检查配置——这是最安全的Marlin排错方式。
来源参考：Marlin固件官方文档、Marlin GitHub源码、3D打印社区Marlin配置经验贴