Pierce 键盘项目下载及安装教程

1. 项目介绍

Pierce 是一个分体式 5x3 列布局的无线/半无线键盘项目，设计灵感来源于 Corne 键盘，但增加了更多的无名指倾斜度，并且仅使用 1u 键帽。该项目支持无线版本和半无线版本，无线版本需要额外的接收器，而半无线版本则通过有线部分作为无线部分的接收器。两种版本都完全支持 QMK 固件。支持的开关类型包括 MX、Choc V1 和 Alps。

2. 项目下载位置

要下载 Pierce 键盘项目，请访问项目的 GitHub 仓库。你可以通过以下步骤下载项目：

1. 打开终端或命令提示符。
2. 使用 git clone 命令下载项目：

git clone https://github.com/durken1/pierce.git

3. 项目安装环境配置

在安装 Pierce 键盘项目之前，你需要配置一些必要的开发环境。以下是所需的软件和工具：

• Git: 用于克隆项目仓库。
• OpenOCD: 用于刷写无线模块的固件。
• ST-Link V2 克隆版: 用于连接到无线模块进行固件刷写。

环境配置步骤

1. 安装 Git:

   • 在终端或命令提示符中输入以下命令安装 Git：

     sudo apt-get install git
     

2. 安装 OpenOCD:

   • 下载并安装 OpenOCD：

     sudo apt-get install openocd
     

3. 安装 ST-Link V2 驱动:

   • 下载并安装 ST-Link V2 驱动程序。

环境配置示例图片

4. 项目安装方式

安装 Pierce 键盘项目主要包括以下几个步骤：

1. 克隆项目仓库:

   • 使用 git clone 命令下载项目。

2. 配置无线模块:

   • 使用 OpenOCD 刷写无线模块的固件。

3. 组装键盘:

   • 按照项目提供的 BOM（物料清单）购买所需的组件并进行组装。

安装步骤示例

1. 克隆项目仓库:

   git clone https://github.com/durken1/pierce.git
   cd pierce
   

2. 刷写无线模块:

   openocd -f openocd.cfg
   telnet localhost 4444
   halt
   nrf51 mass_erase
   program firmware.bin
   reset
   

5. 项目处理脚本

Pierce 键盘项目包含一些处理脚本，用于刷写无线模块的固件。以下是一些常用的脚本：

• openocd.cfg: OpenOCD 配置文件，用于配置刷写环境。
• flash_firmware.sh: 用于刷写固件的脚本。

脚本示例

#!/bin/bash

# 刷写固件脚本
openocd -f openocd.cfg &
telnet localhost 4444
halt
nrf51 mass_erase
program firmware.bin
reset

通过以上步骤，你可以成功下载、配置并安装 Pierce 键盘项目。