QMK_port_ch582 项目下载与安装教程

1. 项目介绍

QMK_port_ch582 是一个开源项目，旨在为 CH58x 系列芯片提供一个 QMK 键盘固件的端口。该项目通过桥接应用层（QMK）和底层硬件，支持有线、蓝牙以及 2.4G 三重模式，并具有低功耗特性，同时支持 QMK 的大多数功能。

2. 项目下载位置

项目托管在 GitHub 上，您可以访问以下位置下载项目：

https://github.com/O-H-M2/qmk_port_ch582.git

3. 项目安装环境配置

在安装前，您需要确保您的系统中已安装以下依赖环境：

• GCC 编译器
• NRF 命令行工具
• Git
• CMake
• CCache
• Python 3 及相关库（cbor2, click, cryptography, intelhex）

以下是在基于 Debian 的 Linux 发行版（如 Ubuntu）上配置环境的示例：

安装编译器和 NRF 命令行工具

首先，下载并配置 WCH 提供的编译器和 NRF 命令行工具：

wget http://file.mounriver.com/tools/MRS_Toolchain_Linux_X64_V170.tar.xz
wget https://nsscprodmedia.blob.core.windows.net/prod/software-and-other-downloads/desktop-software/nrf-command-line-tools/sw/versions-10-x-x/10-21-0/nrf-command-line-tools-10.21.0_linux-amd64.tar.gz

mkdir -p $HOME/local/opt
tar xvf MRS_Toolchain_Linux_X64_V170.tar.xz -C $HOME/local/opt
tar xvf nrf-command-line-tools-10.21.0_linux-amd64.tar.gz -C $HOME/local/opt

# 添加路径到 .bashrc
echo 'export PATH=$HOME/local/opt/MRS_Toolchain_Linux_x64_V170/RISC-V\ Embedded\ GCC/bin/:$HOME/local/opt/nrf-command-line-tools/bin/:$PATH' >> $HOME/.bashrc
source $HOME/.bashrc

安装其他依赖

然后，安装其他必要的依赖：

sudo apt update
sudo apt install git cmake ccache python3 python3-click python3-cbor2 python3-intelhex

4. 项目安装方式

克隆项目

使用 Git 克隆项目：

git clone https://github.com/O-H-M2/qmk_port_ch582.git
cd qmk_port_ch582
git -c submodule."qmk_porting/keyboards_private" update=none submodule update --recursive --init

创建构建目录

创建一个构建目录并运行 CMake：

mkdir build
cd build
cmake -Dkeyboard=m2wired -Dkeymap=default

编译

最后，编译项目：

make -j$(nproc)

编译成功后，会在项目顶级目录生成 uf2 和 hex 文件。

5. 项目处理脚本

在编译过程中，如果需要运行特定的处理脚本，请参考项目的 README.md 文件或相关文档，以获取更多信息。

以上就是 QMK_port_ch582 项目的下载与安装教程，祝您使用愉快！