QMK Firmware 安装与配置指南

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 脚本。

详细安装步骤

1. 克隆项目仓库：

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

2. 选择您的键盘型号和布局。在 qmk_firmware/keyboards 目录中，找到与您的键盘型号对应的文件夹。

3. 配置您的键盘。在键盘型号文件夹中，通常会有一个 config.h 文件和一个 keymap.h 文件。您可以根据自己的需求修改这些文件。

4. 编译固件。在项目根目录下运行以下命令：

   make
   

   如果您的键盘使用的是 ARM 控制器，可能需要指定不同的编译器标志或工具链。

5. 刷新固件到您的键盘。确保键盘处于引导模式，然后运行以下命令：

   • 对于 AVR 控制器：

     avrdude -v -patmega32u4 -cstk500v2 -Pusb -Uflash:w:qmk_firmware.hex:i
     

   • 对于 ARM 控制器：

     dfu-util -D qmk_firmware.hex
     

   注意：以上命令可能需要根据您的键盘型号和控制器进行调整。

完成以上步骤后，您应该已经成功安装了 QMK Firmware，并可以开始使用您的定制键盘了。