Dactyl 开源键盘搭建与使用教程

1. 项目目录结构及介绍

在你克隆或下载的https://github.com/tshort/dactyl-keyboard.git仓库中，你会看到以下主要目录结构：

dactyl-keyboard/
├── docs/           # 文档和说明
├── firmware/       # 键盘固件相关代码
├── keebs/          # 关键部件的设计文件
│   ├── svg/        # SVG设计文件
│   └── stl/        # STL 3D打印模型文件
├── kicad/          # KiCad电路板设计文件
├── pcb/            # 电路板Gerber文件和制造文件
└── src/             # C++源码文件
    ├── config.h    # 用户自定义配置头文件
    └── main.cpp     # 主程序文件

• docs/: 包含了项目的详细文档和组装指南。
• firmware/: 存放用于编程微控制器（如Pro Micro）的固件源码。
• keebs/: 提供键盘物理组件的设计，包括3D打印模型和SVG文件。
• kicad/: 使用KiCad软件创建的PCB设计文件。
• pcb/: 制造电路板所需的所有文件，包括Gerber和其他制造指令。
• src/: 固件的核心代码，config.h可以个性化你的键盘设置，而main.cpp是主程序。

2. 项目的启动文件介绍

项目中的两个关键启动文件是：

• src/config.h: 这个头文件允许你自定义你的Dactyl键盘的行为。你可以在这儿设定按键映射、背光亮度、布局等参数。
• src/main.cpp: 是整个固件的主要入口点。它包含了初始化代码、扫描矩阵、处理输入以及更新LED状态等功能。

在编译并烧录固件到微控制器之前，你需要先编辑config.h以满足个人需求。这通常涉及调整宏定义和按键配置。

3. 项目的配置文件介绍

3.1 src/config.h

src/config.h 文件提供了许多预定义的宏和变量，可以让你修改以下配置项：

• PROTOCOL_XXX: 选择通讯协议，例如PROTOCOL_KCFC或PROTOCOL_CHERRY.
• LAYOUT_XXX: 定义键盘布局，如LAYOUT_DACTYL或LAYOUT_MINI.
• BACKLIGHT_ENABLE: 启用/禁用键盘背光。
• KEYMAP: 定义按键的功能映射，可以通过重新排列keymap_matrix数组来完成。

3.2 src/keymaps/default.c/h

除了config.h之外，你还可以在src/keymaps目录下创建自定义的键图文件，比如your_config.c/h。这个文件将包含具体的按键功能定义，如宏、特殊组合键和层切换。

注意: 在创建新键图时，务必保持config.h中KEYMAP定义指向你的新键图文件。

通过这些配置文件的修改，你可以实现一个完全个性化的Dactyl键盘体验。接下来，你可以按照项目文档的指示，进行硬件组装、固件编译和烧录。祝你好运！