Marlin 2.1.x 开源项目启动与配置教程

1. 项目目录结构及介绍

Marlin 2.1.x 是一个开源的3D打印机固件项目。以下是项目的目录结构及其简要介绍：

Marlin_2.1.x/
├── .github/                # GitHub相关文件
├── Arduino/                # Arduino IDE项目文件
├── src/                    # 源代码目录
│   ├── cartesiano/         # 卡迪辛诺坐标系相关代码
│   ├── configurationStore/ # 配置存储相关代码
│   ├── core/               # 核心代码
│   ├── fonts/              # 字体文件
│   ├── gcode/              # G代码解析相关代码
│   ├── lcd/                # 液晶显示屏相关代码
│   ├── Marriott/           # Marlin UI界面相关代码
│   ├── motion/             # 运动控制相关代码
│   ├── planner/            # 打印任务规划器
│   ├── serial/             # 串行通信相关代码
│   ├── temperature/        # 温度控制相关代码
│   ├── ulikanos/           # Marlin主循环和事件处理
│   └── utilities/          # 实用工具代码
├── tests/                  # 测试代码
└── tools/                  # 开发工具和脚本

2. 项目的启动文件介绍

项目的启动文件主要是位于 Arduino/ 目录下的 Marlin.ino 文件。这个文件是Arduino IDE的主入口文件，包含了以下内容：

• 初始化硬件和变量
• 设置串口通信
• 主循环（loop() 函数）

在 Marlin.ino 文件中，你会看到以下几个关键部分：

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

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

这些代码负责初始化3D打印机的硬件，以及处理持续的运动控制、温度控制、串行通信等任务。

3. 项目的配置文件介绍

项目的配置文件位于 src/ 目录下，主要包括以下几个文件：

• Configuration.h：这是主要的配置头文件，其中包含了打印机硬件的配置选项，如步进电机驱动类型、热床类型、传感器类型等。
• Configuration_adv.h：高级配置文件，包含了更多高级功能选项，如加速度、 Jerk、bed补偿等。
• ConfigurationStore.h：配置存储相关，用于存储和恢复用户的打印配置。

以下是配置文件的一些基本配置选项示例：

// 定义机器类型
#define MACHINE_NAME "My 3D Printer"

// 选择主板类型
#define BOARD_NAME BOARD_RAMPS_13_2

// 定义步进电机驱动
#define X_DRIVER_TYPE  A4988
#define Y_DRIVER_TYPE  A4988
#define Z_DRIVER_TYPE  A4988
#define E0_DRIVER_TYPE  A4988
#define E1_DRIVER_TYPE  A4988

// 配置温度传感器
#define TEMP_SENSOR_0 1 // thermistor
#define TEMP_SENSOR_1 1 // thermistor
#define TEMP_SENSOR_2 1 // thermistor

// 配置热床
#define HEATER_BED_PIN 8
#define HEATER_BED WheatstoneBridge1

通过修改这些配置文件，可以适应不同型号的3D打印机硬件，实现自定义的配置。在更改配置后，通常需要重新编译并上传固件到3D打印机上。