QMK Firmware 安装与配置指南

2025-04-17 01:24:37作者：庞眉杨Will

1. 项目基础介绍

QMK Firmware 是一款基于 Atmel AVR 和 ARM 控制器的开源键盘固件，它基于 tmk_keyboard 固件进行了功能扩展，特别为 OLKB 产品线、ErgoDox EZ 键盘以及 Clueboard 产品线提供了有用的特性。QMK 固件支持多种键盘布局，并拥有一个活跃的社区，不断进行功能的开发和优化。

主要编程语言：C

2. 项目使用的关键技术和框架

C 语言：用于编写固件的主要语言。
Makefile：用于自动化构建过程。
tmk_core：QMK Firmware 的核心库，包含了键盘处理逻辑。
Docsify：用于生成和展示项目文档的框架。

3. 项目安装和配置的准备工作

在开始安装 QMK Firmware 之前，请确保您已经安装了以下必要的工具：

Git：用于克隆和更新代码仓库。
AVRDUDE：用于与 Atmel AVR 控制器进行通信。
dfu-programmer：用于与 ARM 控制器进行通信。
C 编译器：例如 GCC，用于编译代码。
Make：用于运行 Makefile 脚本。

详细安装步骤

克隆项目仓库：

git clone https://github.com/callum-oakley/qmk_firmware.git
cd qmk_firmware

选择您的键盘型号和布局。在 qmk_firmware/keyboards 目录中，找到与您的键盘型号对应的文件夹。
配置您的键盘。在键盘型号文件夹中，通常会有一个 config.h 文件和一个 keymap.h 文件。您可以根据自己的需求修改这些文件。
编译固件。在项目根目录下运行以下命令：
```
make
```
如果您的键盘使用的是 ARM 控制器，可能需要指定不同的编译器标志或工具链。
刷新固件到您的键盘。确保键盘处于引导模式，然后运行以下命令：
- 对于 AVR 控制器：
```
avrdude -v -patmega32u4 -cstk500v2 -Pusb -Uflash:w:qmk_firmware.hex:i
```
- 对于 ARM 控制器：
```
dfu-util -D qmk_firmware.hex
```
注意：以上命令可能需要根据您的键盘型号和控制器进行调整。