Dumbpad 开源项目使用教程
1. 项目介绍
Dumbpad 是一个简单的 4x4 数字小键盘,支持最多两个旋转编码器,设计用于 QMK 固件。该项目由 imchipwood 创建,旨在为机械键盘爱好者提供一个易于组装和定制的宏键盘解决方案。Dumbpad 支持多种配置,包括 OLED 显示屏、RGB 灯效和热插拔功能,适用于不同的硬件平台,如 Arduino Pro Micro 和 Teensy。
2. 项目快速启动
2.1 准备工作
在开始组装 Dumbpad 之前,您需要准备以下材料:
- 1 块 PCB
- 16 个 MX 风格的机械开关
- 17 个 1n4148 二极管(直插式)
- 1 个 Arduino Pro Micro 或兼容的 ATmega32u4 微控制器(可选)
- 1 个 EC11 旋转编码器(7 针,可选)
- 1 个 6mm 轻触开关(用于重置微控制器)
- LED 和 OLED 显示屏(根据配置需求)
2.2 组装步骤
- 选择版本:根据您的需求选择合适的 Dumbpad 版本(如
combo
、combo_oled
、combo_teensy
、reversible
、hotswap_rgb
)。 - 订购零件:根据所选版本的零件列表订购所需零件。
- 组装 Dumbpad:
- 使用焊锡将二极管、开关和 Arduino Pro Micro(或 Teensy)焊接到 PCB 上。
- 根据需要焊接 LED 和 OLED 显示屏。
- 刷写固件:
- 使用 QMK 配置器配置您的 Dumbpad。
- 编译并下载固件。
- 使用 QMK 工具箱刷写固件到 Dumbpad。
2.3 代码示例
以下是使用 QMK 配置器生成并刷写固件的示例代码:
# 克隆 QMK 固件仓库
git clone https://github.com/qmk/qmk_firmware.git
# 进入 QMK 固件目录
cd qmk_firmware
# 编译 Dumbpad 固件
make dumbpad/combo:default
# 刷写固件到 Dumbpad
qmk flash -kb dumbpad/combo -km default
3. 应用案例和最佳实践
3.1 应用案例
Dumbpad 可以用于多种场景,例如:
- 办公自动化:通过自定义按键映射,简化日常办公任务。
- 游戏控制:为游戏玩家提供额外的按键控制,提升游戏体验。
- 编程辅助:通过宏按键快速输入常用代码片段。
3.2 最佳实践
- 自定义按键映射:使用 QMK 配置器轻松自定义每个按键的功能。
- 添加 RGB 灯效:通过
hotswap_rgb
版本为 Dumbpad 添加炫酷的 RGB 灯效。 - 集成 OLED 显示屏:在
combo_oled
版本中集成 OLED 显示屏,显示当前层级和状态信息。
4. 典型生态项目
Dumbpad 作为 QMK 固件生态系统的一部分,可以与其他 QMK 支持的键盘项目结合使用,例如:
- Planck:一个 4x12 的紧凑型键盘,适合需要更多按键的用户。
- Ergodox EZ:一个可定制的人体工程学键盘,适合长时间打字的用户。
- Clueboard:一个模块化的机械键盘,支持多种配置和布局。
通过结合这些项目,用户可以构建一个高度定制化的键盘系统,满足各种使用需求。