CR6Community Marlin 项目启动与配置教程

1. 项目目录结构及介绍

CR6Community Marlin 项目的目录结构如下：

Marlin
├── .github             # GitHub 工作流和配置文件
├── .gitattributes      # Git 属性配置文件
├── .gitignore          # Git 忽略文件
├── buildroot           # 构建系统相关文件
├── config              # 配置文件目录
├── docker              # Docker 相关文件
├── docs                # 文档目录
├── ini                 # INI 配置文件
├── scripts             # 脚本目录
├── extui               # 扩展用户界面目录
├── LICENSE             # 许可证文件
├── Makefile            # Makefile 文件
├── README.md           # 项目说明文件
├── docker-compose.yml  # Docker Compose 配置文件
├── get_test_targets.py # 测试目标生成脚本
├── platformio.ini      # PlatformIO 配置文件
└── process-palette.json # 处理调色板配置文件

• .github：包含 GitHub Actions 工作流文件，用于自动化项目管理任务。
• .gitattributes：定义 Git 的一些文件属性，如二进制文件和文本文件的区分。
• .gitignore：指定 Git 忽略跟踪的文件和目录。
• buildroot：包含用于构建固件的构建系统文件。
• config：存放不同硬件配置的配置文件。
• docker：包含用于 Docker 容器化开发的文件。
• docs：存放项目文档。
• ini：包含 INI 格式的配置文件。
• scripts：存放项目相关的脚本。
• extui：扩展用户界面相关的代码和资源。
• LICENSE：项目的许可证文件，本项目采用 GPL-3.0 许可。
• Makefile：用于构建项目的 Makefile 文件。
• README.md：提供项目的基本信息和说明。
• docker-compose.yml：定义 Docker 服务和网络的配置文件。
• get_test_targets.py：用于生成测试目标的 Python 脚本。
• platformio.ini：PlatformIO 的配置文件，用于项目构建和开发。
• process-palette.json：处理调色板配置文件。

2. 项目的启动文件介绍

项目的启动主要是通过 Makefile 和 platformio.ini 文件来完成的。

• Makefile：这是一个用于构建项目的文件，Make 工具会读取它来确定编译过程中需要执行哪些命令。它通常包含构建目标、依赖关系和命令。

• platformio.ini：这是 PlatformIO 的配置文件，用于指定项目的构建环境、依赖和构建选项。通过 PlatformIO，用户可以轻松地配置和管理项目的开发环境。

3. 项目的配置文件介绍

项目的配置文件主要集中在 config 目录下，以下是几个重要的配置文件：

• Configuration.h：这是 Marlin 主配置文件，用于定义打印机硬件和功能的配置选项。用户需要根据自己打印机的硬件配置进行相应的设置。

• Configuration_adv.h：高级配置文件，包含更详细的设置，通常用于更高级的用户。

• platformio-environment.txt：这个文件包含 PlatformIO 环境的配置信息，它会告诉 PlatformIO 使用哪个板型和编译器来编译项目。

在进行配置时，用户需要参考项目文档和官方教程，确保所有的设置都符合自己的硬件配置要求。通常，修改这些配置文件后，需要重新编译项目以应用更改。