Grabert Keyboard Hardware 项目安装与配置指南

Grabert Keyboard Hardware 项目安装与配置指南

grabert-hardware 项目地址: https://gitcode.com/gh_mirrors/gr/grabert-hardware

1. 项目基础介绍

Grabert Keyboard Hardware 是一个开源的机械键盘项目，它提供了一个60%布局的机械键盘设计方案。项目包括了键盘的电气设计（PCB）和机械设计（外壳等），并且支持自定义键帽布局和功能。该项目主要使用 C 语言进行编程，同时也涉及到一些硬件描述语言（如 KiCad 的脚本）和机械设计软件（如 FreeCAD）的使用。

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

• KiCad：用于电气设计的开源电子设计自动化（EDA）软件。
• FreeCAD：用于机械设计的开源参数化3D CAD模型软件。
• STM32：基于 ARM Cortex-M 的 32 位微控制器，用于键盘的主要处理单元。
• QMK：Quantum Mechanical Keyboard 的简称，是一个开源的键盘固件，可以用于自定义键盘的按键布局和功能。
• VIA：用于键盘配置和键映射的软件。

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

在开始安装和配置之前，请确保你的系统满足以下要求：

• 操作系统：本项目支持 Windows、macOS 和 Linux。
• 编程环境：安装 GCC ARM 编译器和 make 工具。
• KiCad：安装最新版本的 KiCad。
• FreeCAD：安装最新版本的 FreeCAD。
• QMK：从 QMK 的 GitHub 仓库克隆源代码。

详细安装步骤

步骤 1：克隆项目仓库

打开终端（或命令提示符），使用以下命令克隆项目仓库：

git clone https://github.com/KoBussLLC/grabert-hardware.git
cd grabert-hardware

步骤 2：安装 KiCad

前往 KiCad 官方网站下载并安装最新版本的 KiCad。

步骤 3：安装 FreeCAD

前往 FreeCAD 官方网站下载并安装最新版本的 FreeCAD。

步骤 4：安装 GCC ARM 编译器和 make

根据你的操作系统，安装 GCC ARM 编译器和 make 工具。

• 对于 Windows 用户，可以使用 MSYS2 或其他方法安装。
• 对于 macOS 用户，可以使用 Homebrew 安装。
• 对于 Linux 用户，可以使用包管理器安装。

步骤 5：安装 QMK

克隆 QMK 仓库并编译：

git clone https://github.com/qmk/qmk_firmware.git
cd qmk_firmware
make

步骤 6：配置键盘

使用 VIA 软件配置键盘的按键映射和功能。

步骤 7：编译项目

在项目目录下，使用以下命令编译项目：

make

编译完成后，你将得到一个可供刷入微控制器的固件文件。

步骤 8：刷入固件

使用适当的刷机工具（如 ST-Link、DFU 等）将编译好的固件刷入键盘的微控制器。

至此，你已经完成了 Grabert Keyboard Hardware 项目的安装和配置。现在你可以开始享受自定义机械键盘带来的乐趣了！

grabert-hardware 项目地址: https://gitcode.com/gh_mirrors/gr/grabert-hardware