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键盘体验。接下来,你可以按照项目文档的指示,进行硬件组装、固件编译和烧录。祝你好运!