无线版固件刷写

固件类型

首次烧录 / 救砖恢复：刷 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 模式

拔掉 USB-C
长按 BOOT 按钮
按住不放的同时插入 USB-C
松开按钮

TIP

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

Windows

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

macOS / Linux

在仓库根目录运行：

bash

python tools/scripts/console.py

进入 Home
先点 Install or update wchisp
再点 Probe ISP devices
五键款保持 Layout = 5KEY
旋钮款先点 Toggle layout 切到 KNOB
点 Flash selected preset
等待刷写完成

说明

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 完成：

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

TIP

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

蓝牙配对测试

TODO