Marlin 3D打印机固件下载及安装教程

1. 项目介绍

Marlin是一款基于Arduino平台的优化固件，专为RepRap 3D打印机设计。许多商用3D打印机都预装了Marlin固件。Marlin固件支持多种硬件平台，包括8位AVR和32位ARM处理器。它提供了丰富的功能和灵活的配置选项，适用于各种3D打印机。

2. 项目下载位置

Marlin固件的源代码托管在GitHub上，可以通过以下步骤进行下载：

1. 打开终端或命令提示符。
2. 使用git clone命令下载项目：

   git clone https://github.com/MarlinFirmware/Marlin.git
   

3. 下载完成后，项目文件将保存在当前目录下的Marlin文件夹中。

3. 项目安装环境配置

3.1 安装Arduino IDE

1. 下载并安装Arduino IDE：

   • 访问Arduino官方网站，下载适用于您操作系统的Arduino IDE安装包。
   • 安装完成后，打开Arduino IDE。

2. 配置Arduino IDE：

   • 在Arduino IDE中，点击文件 -> 首选项，确保附加开发板管理器网址中包含以下内容：

     https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
     

   • 点击工具 -> 开发板 -> 开发板管理器，搜索并安装所需的开发板（如Arduino AVR Boards）。

3.2 安装PlatformIO

1. 下载并安装Visual Studio Code（VSCode）：

   • 访问VSCode官方网站，下载适用于您操作系统的安装包并安装。

2. 在VSCode中安装PlatformIO插件：

   • 打开VSCode，点击左侧扩展图标，搜索PlatformIO并安装。
   • 安装完成后，重启VSCode。

3.3 配置示例图片

图1：Arduino IDE配置示例

图2：PlatformIO配置示例

4. 项目安装方式

4.1 使用Arduino IDE安装

1. 打开Arduino IDE，点击文件 -> 打开，选择下载的Marlin项目文件夹中的Marlin.ino文件。
2. 选择正确的开发板和端口（工具 -> 开发板和工具 -> 端口）。
3. 点击上传按钮，等待编译和上传完成。

4.2 使用PlatformIO安装

1. 打开VSCode，点击PlatformIO图标，选择打开项目，导航到下载的Marlin项目文件夹。
2. 在PlatformIO中，选择正确的开发板配置。
3. 点击构建按钮进行编译，然后点击上传按钮将固件上传到打印机。

5. 项目处理脚本

Marlin项目包含一些处理脚本，用于自动化构建和测试。以下是一些常用的脚本命令：

5.1 本地构建测试

# 运行所有本地构建测试
make tests-config-all-local

# 运行单个本地构建测试
make tests-config-single-local TEST_TARGET=

5.2 使用Docker进行构建测试

# 运行所有本地构建测试（使用Docker）
make tests-config-all-local-docker

# 运行单个本地构建测试（使用Docker）
make tests-config-single-local-docker TEST_TARGET=

5.3 运行单元测试

# 使用PIO运行所有单元测试
platformio run -t test-marlin

# 使用Make运行所有单元测试
make unit-test-all-local

# 使用Docker + Make运行所有单元测试
maker unit-test-all-local-docker

# 运行单个单元测试
platformio run -t marlin_<test-suite-name>
make unit-test-single-local TEST_TARGET=<test-suite-name>
maker unit-test-single-local-docker TEST_TARGET=<test-suite-name>

通过以上步骤，您可以成功下载、配置并安装Marlin 3D打印机固件。