Monome Arc Clone 项目使用与配置指南

1. 项目目录结构及介绍

Monome Arc Clone 项目是一个开源的克隆项目，旨在创建一个与原版 monome arc 兼容的设备。以下是项目的目录结构及其介绍：

MonomeArcClone/
├── case/              # 外壳设计文件
├── eagle/             # PCB 设计文件
├── firmware/          # 设备固件
├── .gitignore         # Git 忽略文件
├── BOM.csv            # 零件清单
├── BOM.xlsx           # 零件清单（Excel 格式）
├── README.md          # 项目说明文件
├── license.txt        # 项目许可证文件
└── ...

• case/：包含用于 3D 打印或 CNC 加工的外壳设计文件。
• eagle/：包含 PCB 设计的文件，用于制造电路板。
• firmware/：包含设备的固件代码，用于编程微控制器。
• .gitignore：指定 Git 应该忽略的文件和目录。
• BOM.csv 和 BOM.xlsx：包含制造设备所需的零件清单。
• README.md：提供项目的基本信息和说明。
• license.txt：项目的开源许可证。

2. 项目的启动文件介绍

项目的启动文件主要是 firmware/ 目录下的固件代码。这个目录包含了微控制器编程所需的源代码文件。以下是几个关键的启动文件：

• main.c：固件的入口点，包含主要的初始化代码和主循环。
• config.h：包含项目的配置定义，如引脚分配和功能设置。
• serialosc.c：实现与 monome arc 协议兼容的串行通信。
• arcloop.c：实现设备主循环的核心逻辑。

要编译固件，通常需要使用适合的编译器和工具链，如 AVR-GCC。

3. 项目的配置文件介绍

项目的配置文件主要是 config.h。这个文件定义了设备的工作参数和引脚分配。以下是一些重要的配置选项：

• ArcResolution：定义弧度分辨率，即 LED 的数量。
• RotaryEncoderResolution：定义旋转编码器的分辨率。
• ButtonPins：定义按钮连接的引脚。
• LEDPins：定义 LED 连接的引脚。
• RotaryEncoderPins：定义旋转编码器连接的引脚。

根据实际的硬件连接和需求，开发者可以修改这些配置以适应不同的硬件设置。

在使用项目之前，开发者需要确保已经安装了必要的软件和工具，并按照项目说明正确配置了开发环境。在编译和上传固件后，设备应该可以正常工作，实现 monome arc 的功能。