BinaryKeyboard 🐱

主题

无线版快速开始 ​

基于 CH592F 的 USB / BLE 双模键盘。本页说明复刻、首刷和首次配对；成品操作见 无线款使用手册。

支持型号 ​

型号输入默认动作层数说明
5KEY5 个普通键1 / 2 / 3 / 4 / 55USB / BLE 双模五键键盘
KNOB4 键 + 旋钮1~4，旋钮为音量加 / 音量减 / 静音4USB / BLE 双模旋钮键盘

无线版通用操作：

  • FN1 短按或长按：切换 USB / BLE 模式，切换时设备会重启进入目标模式。
  • FN2 短按：切换到下一层。
  • FN2 长按：在 BLE 模式下清除配对信息并重启。
  • 按住 BOOT 再按普通键：切换到对应层。
  • 单击 BOOT 不再进入 IAP / Bootloader。

准备工作 ​

你需要 ​

工具/材料说明
热风枪或加热台、锡膏焊接 PCB
3D 打印机或 3D 打印服务
电脑刷写和配置
锂电池3.7V，按外壳尺寸选择
USB-C 数据线充电、刷写和配置

下载文件 ​

  1. 固件 - 从 GitHub Releases 下载

    • 首次烧录使用 CH592F-<MODEL>-<version>-full.hex
    • 后续通过 Studio 热更新使用 CH592F-<MODEL>-<version>-app.bin

  2. 外壳 STL - 从 Releases 或 OSHWHub 下载（无线版专用，带电池仓）

  3. 初次下载

    • Windows：使用 WCHISPStudio
    • macOS / Linux：使用 python tools/scripts/console.py

复刻流程 ​

Step 1：3D 打印外壳 ​

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

Step 2：焊接 PCB ​

  1. 按照原理图焊接元器件。
  2. 焊接按键/轴体

注意

  • CH592F 芯片方向不要焊反！
  • 电池正负极不要接反！ 可能导致芯片烧毁
  • 焊锡不要沾到天线区域
  • QFN封装的芯片焊接后仔细检查是否有虚焊或桥连

Step 3：刷写固件 ​

Windows ​

  1. 打开 WCHISPStudio
  2. 顶部工具栏选择 低功耗蓝牙系列 → CH57x-CH59x
  3. 芯片系列选择 CH59x，芯片型号选择 CH592
  4. 目标程序文件选择对应型号的 -full.hex

macOS / Linux ​

  1. 在仓库根目录运行 python tools/scripts/console.py
  2. 进入 Home
  3. 点 Install or update wchisp
  4. 点 Probe ISP devices
  5. 五键款保持 Layout = 5KEY，旋钮款先点 Toggle layout

硬件操作 ​

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

开始烧录 ​

  1. Windows 点击 下载
  2. macOS / Linux 回到终端工具，点 Flash selected preset
  3. 等待刷写完成

详细步骤见 刷写固件

Step 4：组装 ​

  1. 安装轴体/按键
  2. 连接锂电池
  3. 将 PCB 和电池装入外壳
  4. 盖上盖板

Step 5：蓝牙配对 ​

  1. 确认电池已连接且电量足够。
  2. 短按 FN1 切换到 BLE 模式，键盘会重启。
  3. 等待键盘进入广播状态。
  4. 打开电脑或手机蓝牙设置，搜索：
    • BinaryKeyboard5KEY
    • BinaryKeyboardKNOB
  5. 点击连接并等待系统完成配对。

如果之前配对过但现在无法连接，在 BLE 模式长按 FN2 清除配对；同时在电脑或手机蓝牙列表中删除旧设备，再重新搜索。

Step 6：配置键位（可选） ​

  1. 用 USB-C 连接键盘到电脑。
  2. 用 Chrome / Edge 打开 BinaryKeyboard Studio。最新版固件在 BLE 模式下也保留 USB 配置通道，无需先切回 USB 模式。
  3. 点击"连接设备"，选择你的键盘。
  4. 配置键位、层、FN、RGB、系统模式或宏。
  5. 点击保存 / 写入，等待提示成功。

详细步骤见 改键软件使用

后续文档 ​

不用时可关闭电源开关；设备闲置后会按当前休眠设置进入低功耗。问题排查见 常见问题。