BinaryKeyboard 🐱

主题

经典版快速开始 ​

基于 CH552G 的 USB 键盘。本页说明复刻、刷写和首次配置；成品使用方式见 使用指南。

支持型号 ​

型号按键默认动作层数说明
BASIC4 键0 / 1 / Enter / Space4USB 小键盘
5KEY5 键1 / 2 / 3 / 4 / 55五个普通键
KNOB4 键 + 旋钮A~D，旋钮为鼠标左键 / 音量4带旋钮的 USB 小键盘

经典版通用操作：

  • 短按 FUNC：切换 RGB 灯效。
  • 按住 FUNC 再按普通键：切换到对应层。
  • 按住 FUNC 时普通键和旋钮不会向电脑发送输入。

准备工作 ​

你需要 ​

工具/材料说明
电烙铁和焊锡焊接 PCB
3D 打印机或 3D 打印服务
电脑刷写和配置
USB-C 数据线连接键盘

下载文件 ​

  1. 固件 - 从 GitHub Releases 下载

    • CH552G-BASIC-<version>.hex - 基础款
    • CH552G-5KEY-<version>.hex - 五键款
    • CH552G-KNOB-<version>.hex - 旋钮款

  2. 外壳 STL - 从 Releases 或 OSHWHub 下载。

  3. 下载程序 - WCHISPStudio

复刻流程 ​

Step 1：3D 打印外壳 ​

  • 普通 FDM 打印即可。
  • 层高 0.2mm

Step 2：焊接 PCB ​

  1. 焊接 USB-C 接口
  2. 按照原理图焊接元器件
  3. 焊接按键

注意

USB-C 接口焊接需要重点检查焊点完整性与引脚连通性。

Step 3：刷写固件 ​

软件配置 ​

  1. 打开 WCHISPStudio
  2. 顶部工具栏选择 MCU系列视图 → E8051USB系列
  3. 芯片选择：芯片系列 CH55x，芯片型号 CH552，下载接口 USB
  4. 下载文件：目标程序文件1 选择对应的 .hex 固件文件

硬件操作 ​

  1. 按住 PCB 上的 BOOT 按钮不松开
  2. 保持按住的同时，将 USB-C 插入电脑
  3. 松开 BOOT 按钮（此时软件应识别到设备）

开始烧录 ​

  1. 点击"下载"按钮
  2. 等待进度条完成，提示成功

详细步骤见 刷写固件

Step 4：组装 ​

  1. 将 PCB 装入外壳
  2. 盖上盖板，拧紧螺丝
  3. 安装轴体

Step 5：配置键位 ​

  1. 用 Chrome / Edge 打开改键工具
  2. 点击"连接设备"
  3. 选择你的键盘
  4. 配置想要的键位映射
  5. 点击"写入"

详细步骤见 改键软件使用

后续文档 ​

问题排查见 常见问题，可复现的软件问题请附日志提交 Issue。