Pinci 项目使用教程

1. 项目目录结构及介绍

Pinci 项目的目录结构如下：

pinci/
├── cad/
├── doc/
├── firmware/
├── pcb/
├── .gitignore
├── .gitmodules
├── LICENSE
└── README.md

目录介绍：

• cad/：包含项目的 CAD 文件，可能是用于 PCB 设计的相关文件。
• doc/：存放项目的文档文件，可能包括设计文档、用户手册等。
• firmware/：包含项目的固件代码，使用 Rust 编写，运行在 RP2040 芯片上。
• pcb/：包含 PCB 设计的相关文件，可能是 KiCad 或其他 PCB 设计工具的文件。
• .gitignore：Git 忽略文件，指定哪些文件或目录不需要被 Git 跟踪。
• .gitmodules：Git 子模块配置文件，用于管理项目中的子模块。
• LICENSE：项目的许可证文件，Pinci 项目使用 MIT 许可证。
• README.md：项目的介绍文件，包含项目的概述、使用说明等信息。

2. 项目的启动文件介绍

Pinci 项目的启动文件位于 firmware/ 目录下。由于 Pinci 是一个硬件项目，启动文件主要是固件代码，用于初始化硬件并运行键盘功能。

主要启动文件：

• firmware/src/main.rs：这是固件的主入口文件，包含了键盘的初始化代码和主要逻辑。

启动流程：

1. 初始化硬件：在 main.rs 中，首先会初始化 RP2040 芯片的 GPIO 和其他硬件资源。
2. 配置键盘矩阵：设置键盘的按键矩阵，配置每个按键对应的 GPIO 引脚。
3. 启动键盘扫描：启动键盘扫描循环，检测按键状态并处理按键事件。

3. 项目的配置文件介绍

Pinci 项目的配置文件主要位于 firmware/ 目录下，用于配置键盘的硬件参数和固件行为。

主要配置文件：

• firmware/src/config.rs：这个文件包含了键盘的配置参数，如按键矩阵的布局、GPIO 引脚的映射等。

配置参数：

• 按键矩阵布局：定义了键盘的按键布局，包括按键的数量和位置。
• GPIO 引脚映射：配置每个按键对应的 GPIO 引脚，确保按键事件能够正确触发。
• 其他硬件配置：可能还包括其他硬件资源的配置，如 LED 灯、USB 接口等。

通过修改 config.rs 文件中的配置参数，可以自定义键盘的行为和功能。

---

以上是 Pinci 项目的使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用 Pinci 项目。