pteron36-split-keyboard 的安装和配置教程

2025-05-19 14:24:52作者：钟日瑜

1. 项目基础介绍和主要编程语言

pteron36-split-keyboard 是一个开源项目，它是一个基于 pteron-pcb 的 36 键键盘设计，适用于 Miryoku 布局。这个项目旨在为用户提供一个高效的分体键盘使用体验。主要编程语言是 C，因为它使用 QMK（Quantum Mechanical Keyboard）固件，这是一个专门为定制机械键盘编写固件的平台。

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

该项目使用的关键技术主要包括：

PCB 设计：键盘的电路板设计，涉及到电子元件的布局和电路连接。
QMK 固件：这是该项目使用的开源键盘固件框架，它允许用户自定义键盘的按键布局、功能和其他特性。
Miryoku 布局：这是一种旨在提高分体键盘效率的键盘布局。

3. 项目安装和配置的准备工作及详细安装步骤

准备工作

在开始安装之前，请确保您已经具备以下条件：

一台装有 Windows、macOS 或 Linux 操作系统的计算机。
安装有 Git 版本控制系统的计算机。
安装有 C 编译器和必要的开发工具（如 GCC 或者 Clang）。
熟悉基本的命令行操作。

安装步骤

克隆项目

打开命令行工具，使用以下命令克隆仓库：

git clone https://github.com/harshitgoel96/pteron36-split-keyboard.git
cd pteron36-split-keyboard

安装依赖

根据您的操作系统，安装 QMK 固件构建所需的依赖。以下是以 Ubuntu 为例的安装命令：
```
sudo apt-get install build-essential libusb-1.0-0-dev libncurses5-dev
```
对于其他操作系统，您可以参考 QMK 官方文档来安装依赖。
获取 QMK 固件源码

pteron36-split-keyboard 项目依赖于 QMK 固件，因此您需要获取 QMK 的源码：
```
git submodule update --init --recursive
```
选择键盘配置

在 QMK 源码目录中，选择与您的键盘对应的配置文件（例如 config.h 和 keymap.h）。
编译固件

返回到 pteron36-split-keyboard 项目目录，编译固件：
```
make pteron36_split_keyboard:default
```
如果编译成功，您会在 build 目录下找到编译好的固件文件。
上传固件

使用合适的软件（如 QMK Toolbox 或其他兼容的软件）将编译好的固件上传到您的键盘。
完成安装

上传完成后，您的键盘应该已经运行了新的固件，您可以开始配置和使用您的 pteron36-split-keyboard。