BinaryKeyboard 🐱

主题

无线版固件刷写 ​

固件类型 ​

  • 首次烧录 / 救砖恢复：刷 CH592F-<MODEL>-<version>-full.hex
  • Studio 在线更新：用 CH592F-<MODEL>-<version>-app.bin
  • OTA bin 不用于第一次 ISP 首刷

准备 ​

  • 首次烧录使用 CH592F-<MODEL>-<version>-full.hex
  • 后续通过 Studio 热更新使用 CH592F-<MODEL>-<version>-app.bin
  • Windows：使用 WCHISPStudio
  • macOS / Linux：使用 python tools/scripts/console.py

进入 Bootloader 模式 ​

  1. 拔掉 USB-C
  2. 长按 BOOT 按钮
  3. 按住不放的同时插入 USB-C
  4. 松开按钮

这里进入的是芯片 ROM 下载模式，不是 Studio 的应用层更新流程。

Windows ​

  1. 打开 WCHISPStudio
  2. 顶部工具栏选择 低功耗蓝牙系列 → CH57x-CH59x
  3. 芯片系列选择 CH59x，芯片型号选择 CH592
  4. 目标程序文件选择对应型号的 -full.hex
  5. 点击 下载
  6. 等待刷写完成
  7. 重新拔插 USB，测试蓝牙配对

macOS / Linux ​

  1. 在仓库根目录运行：
bash
python tools/scripts/console.py
  1. 进入 Home
  2. 先点 Install or update wchisp
  3. 再点 Probe ISP devices
  4. 五键款保持 Layout = 5KEY
  5. 旋钮款先点 Toggle layout 切到 KNOB
  6. 点 Flash selected preset
  7. 等待刷写完成

说明 ​

  • Flash selected preset 当前刷的是 build-full 产物，也就是 -full.hex
  • -full.hex 里面已经包含 JumpIAP + app + 高地址 IAP
  • 普通 .bin 是给 Studio 热更新走的，不是给 ISP 首刷的
  • Home -> Toggle layout 用来切换 5KEY / KNOB
  • Home -> Toggle build type 一般保持 release
  • Home -> Flash selected preset 会先构建，再刷写
  • 如果只是想检查设备在不在，可以用 Home -> Probe ISP devices

Studio 热更新 ​

设备进入系统后，后续更新通过 Studio 完成：

  1. 用 USB 连接键盘
  2. 打开 BinaryKeyboard Studio
  3. 在设备信息卡片里点固件更新
  4. Studio 会下载当前协议对应的最新 bin
  5. 固件先写到 Image B，重启后由高地址 IAP 完成搬运

TIP

如果 Release 已经更新、但 Studio 仍提示下载文件不存在，通常表示 GitHub Pages 上的固件镜像仍在同步。

蓝牙配对测试 ​

刷写完成后做一次 BLE 验证：

  1. 重新拔插 USB，让设备正常启动。
  2. 短按 FN1 切换到 BLE 模式，设备会保存模式并重启。
  3. 在系统蓝牙设置中搜索 BinaryKeyboard5KEY 或 BinaryKeyboardKNOB。
  4. 连接成功后，打开文本编辑器按 K1~K5 或 K1~K4 测试输入。
  5. 旋钮款额外测试旋钮左转、右转和按下。
  6. 如果需要回到 Studio 改键，直接插入 USB-C 数据线即可；最新版固件在 BLE 工作模式下也保留 USB 配置通道。

如果系统显示已配对但无法连接，在 BLE 模式长按 FN2 清除键盘端配对信息；同时在电脑或手机蓝牙列表中删除旧设备，再重新搜索。

首刷后模式

无线版会记住上一次 USB / BLE 模式。若设备看起来没有进入蓝牙广播，先短按 FN1 切换模式，再重新观察指示灯状态。