BinaryKeyboard 🐱

主题

经典版快速开始 ​

基于 CH552G 芯片的 USB 直连版本，即插即用。

先看使用方式

如果你已经有成品键盘，优先阅读 使用指南：经典版 BASIC / 5KEY / KNOB。这页主要覆盖复刻、刷写和首次配置流程。

支持型号 ​

型号按键默认动作层数说明
BASIC4 键0 / 1 / Enter / Space4最基础的 USB 小键盘
5KEY5 键1 / 2 / 3 / 4 / 55多一个实体键，适合快捷键
KNOB4 键 + 旋钮A~D，旋钮为鼠标左键 / 音量4适合媒体控制、滚轮、宏

经典版通用操作：

  • 短按 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. 点击"写入"

详细步骤见 改键软件使用

完成 🎉 ​

插上 USB，享受你的可爱二进制键盘吧！

下一步可以继续看：

遇到问题？

查看 常见问题 或在 GitHub 提交 Issue。