4xMacropad 项目下载及安装教程

1. 项目介绍

4xMacropad 是一个使用 CH552G 微控制器的超低成本机械宏键盘项目。该项目提供了多种独特的布局设计，适合 DIY 爱好者制作自己的宏键盘。项目包括 PCB 设计文件、3D 打印模型、固件代码等，用户可以根据这些资源自行组装和编程。

2. 项目下载位置

要下载 4xMacropad 项目，请按照以下步骤操作：

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

git clone https://github.com/tobychui/4xMacropad.git

3. 下载完成后，项目文件将保存在当前目录下的 4xMacropad 文件夹中。

3. 项目安装环境配置

在开始安装之前，请确保您的开发环境已配置好以下工具和库：

• Arduino IDE: 用于编写和上传固件代码。
• CH552G 驱动程序: 确保您的操作系统能够识别 CH552G 微控制器。
• 3D 打印机: 用于打印键盘的底板。

环境配置示例

Arduino IDE 安装

1. 下载并安装 Arduino IDE。
2. 打开 Arduino IDE，进入 文件 -> 首选项，在 附加开发板管理器网址 中添加以下 URL：

https://github.com/DeqingSun/ch55xduino/releases/download/v1.0.0/package_ch55xduino_index.json

3. 进入 工具 -> 开发板 -> 开发板管理器，搜索并安装 CH55xDuino。

CH552G 驱动程序安装

1. 下载并安装 CH55xDuino 驱动程序。
2. 连接 CH552G 微控制器到电脑，确保设备管理器中显示为正常工作。

3D 打印机配置

1. 下载项目中的 3D 模型文件（位于 4xMacropad/3D Model 文件夹）。
2. 使用 3D 打印机打印底板。

4. 项目安装方式

1. PCB 制作: 将项目中的 Gerber 文件发送给 PCB 制造商进行制作。
2. 元件采购: 根据项目中的 BOM 列表采购所有所需元件。
3. 组装: 将元件焊接到 PCB 上，并安装 3D 打印的底板。
4. 固件上传: 使用 Arduino IDE 打开项目中的固件代码（位于 4xMacropad/firmware 文件夹），编译并上传到 CH552G 微控制器。

固件上传步骤

1. 打开 Arduino IDE，加载项目中的固件代码。
2. 选择 工具 -> 开发板 -> CH552G。
3. 选择正确的端口（通常为 USB-SERIAL CH340）。
4. 点击 上传 按钮，等待上传完成。

5. 项目处理脚本

项目中包含一些处理脚本，用于生成 PCB 文件、固件代码等。这些脚本通常使用 Python 编写，位于 tools 文件夹中。

示例脚本

# tools/zh-hk_conv_tool.py
import os

def convert_files(directory):
    for filename in os.listdir(directory):
        if filename.endswith(".txt"):
            with open(os.path.join(directory, filename), 'r', encoding='utf-8') as file:
                content = file.read()
            with open(os.path.join(directory, filename), 'w', encoding='utf-8') as file:
                file.write(content.replace('zh-hk', 'zh-cn'))

convert_files('docs')

此脚本用于将文档中的繁体中文转换为简体中文。

---

通过以上步骤，您可以成功下载、安装并运行 4xMacropad 项目。祝您 DIY 愉快！