开源项目Djinn键盘设计指南
djinn Djinn Split Keyboard 项目地址: https://gitcode.com/gh_mirrors/dj/djinn
1. 项目目录结构及介绍
Djinn 是一个自定义键盘设计项目,其在GitHub上的仓库呈现出以下主要的目录结构:
djinn/
├── Djinn # 分裂式键盘Djinn的具体设计文件夹
│ ├── ... # 包含PCB设计、固件等子文件
├── Ghoul # 类Planck开发板Ghoul的设计文件夹
│ ├── ... # 同样包括相关设计和代码文件
├── .gitignore # 忽略的文件列表
├── LICENSE # 许可证文件,采用CERN-OHL-S-2.0
├── README.md # 主要的项目说明文档,介绍了项目概述
└── ... # 可能还有其他辅助或文档相关的文件
介绍:
- Djinn: 此文件夹包含了一个64键的分裂式键盘设计,由双4x7矩阵构成,配备一个4键拇指区和一个位于拇指下的5向触感开关。
- Ghoul: 类似于Planck布局的开发板设计,支持QMK固件,具有SparkFun MicroMod特性,允许热插拔MCU,拥有40键布局(2x4x5),集成编码器和RGB OLED屏幕,以及每键RGB照明。
2. 项目的启动文件介绍
该项目不直接涉及“启动文件”一说,因为它主要是硬件设计和固件定制。不过,在固件开发中,通常会有个入口点。对于类似QMK固件的项目,启动逻辑通常嵌入在固件的核心部分,如qmk_firmware/keyboards/你的键盘名称/
路径下的rules.mk
和.c
文件,但具体到本项目,由于没有提供详细的固件开发说明,这部分需参考QMK固件的官方文档来理解如何编译和上传固件以“启动”键盘功能。
3. 项目的配置文件介绍
主要配置文件:config.h
和keymaps
文件夹
虽然在提供的链接中没有直接展示这些文件,但在QMK固件框架下,每个键盘项目通常会有以下几个关键配置文件:
-
config.h: 这是键盘的主要配置文件,用户可以在这里配置键盘的基本参数,比如LED设置、层定义以及其他特定于键盘的选项。
-
keymaps 文件夹:包含了不同的键位映射文件,每个
.c
文件代表一种键位布局。通过编辑这些文件,用户能够自定义按键的功能,从而满足个性化需求。
请注意,上述文件路径和命名是在遵循QMK固件通用结构的基础上推测的,实际配置文件的细节和位置应参照项目内部具体的文档指示或QMK的官方文档进行操作。由于原始GitHub仓库未直接展示这些配置文件内容,具体实现细节需从项目的README.md
或QMK固件库获取进一步指导。
djinn Djinn Split Keyboard 项目地址: https://gitcode.com/gh_mirrors/dj/djinn