Marlin 3D Printer Firmware 项目教程

1. 项目的目录结构及介绍

Marlin 是一款开源的 3D 打印机固件，支持多种硬件平台和打印机。以下是项目的目录结构及其介绍：

Marlin/
├── .aiderignore
├── .editorconfig
├── .gitattributes
├── .gitignore
├── .zed
├── devcontainer/
├── docker/
├── docs/
├── ini/
├── LICENSE
├── Makefile
├── README.md
├── platformio.ini
├── test/
├── Marlin/            # 核心代码目录
├── buildroot/         # 构建系统相关文件
├── config/            # 配置文件目录
└── ...

• .aiderignore：配置 Aider 工具忽略的文件和目录。
• .editorconfig：定义代码编辑器的配置，以保持代码风格的一致性。
• .gitattributes：配置 Git 的文件属性。
• .gitignore：配置 Git 忽略的文件和目录。
• .zed：与 Zed 编程语言相关的配置文件。
• devcontainer/：开发容器配置。
• docker/：Docker 配置文件。
• docs/：文档目录。
• ini/：初始配置文件目录。
• LICENSE：项目许可证文件，本项目采用 GPL-3.0 许可。
• Makefile：构建项目所需的 Makefile 文件。
• README.md：项目说明文件。
• platformio.ini：PlatformIO 集成开发环境配置文件。
• test/：测试文件目录。
• Marlin/：核心代码目录，包含固件的源代码。
• buildroot/：构建系统相关文件。
• config/：配置文件目录。

2. 项目的启动文件介绍

Marlin 项目的启动文件是位于 Marlin/ 目录下的 Marlin.cpp 文件。这个文件包含了项目的入口点 main() 函数，以及一些初始化代码。

#include "MarlinConfig.h"

void setup() {
  // 初始化代码
}

void loop() {
  // 主循环代码
}

int main() {
  setup();
  while (true) {
    loop();
  }
  return 0;
}

setup() 函数用于初始化硬件和变量，loop() 函数则是固件运行的主循环。main() 函数调用 setup() 和 loop() 函数，并进入一个无限循环。

3. 项目的配置文件介绍

Marlin 项目的配置文件位于 config/ 目录下。这些文件用于定义打印机的硬件配置、功能特性和行为。以下是一些重要的配置文件：

• Configuration.h：主配置文件，包含打印机硬件的配置选项，如轴数、步进电机驱动类型、传感器类型等。
• Configuration_adv.h：高级配置文件，包含一些更高级的设置，如加速度、加速度分解、PID 控制参数等。
• Configuration_<board>.h：针对特定控制板的配置文件，例如 Configuration_RAMPS.h 用于 RAMPS 控制板。
• Configuration_example.h：示例配置文件，可以作为创建自定义配置文件的参考。

配置文件通常以 .h 为后缀，它们被 Marlin.cpp 和其他源文件包含，以使用其中的配置选项。用户需要根据自己的打印机硬件和需求修改这些文件，以实现最佳的性能和功能。