无线版快速开始

基于 CH592F 芯片的蓝牙低功耗版本，无线自由。

先看使用方式

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

支持型号

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

无线版通用操作：

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

准备工作

你需要

工具/材料	说明
🔧 热风枪/加热台 + 锡膏	焊接 PCB
🖨️ 3D 打印机	或找人代打印
💻 电脑	用于连接键盘和刷写固件
🔋 锂电池	3.7V，根据外壳大小选择容量
🔌 USB-C 数据线	充电和刷固件

下载文件

固件 - 从 GitHub Releases 下载
- 首次烧录使用 CH592F-<MODEL>-<version>-full.hex
- 后续通过 Studio 热更新使用 CH592F-<MODEL>-<version>-app.bin
外壳 STL - 从 Releases 或 OSHWHub 下载（无线版专用，带电池仓）
初次下载
- Windows 推荐使用 WCHISPStudio
- macOS / Linux 推荐使用喵喵的终端工具：python tools/scripts/console.py

复刻流程

Step 1：3D 打印外壳

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

Step 2：焊接 PCB

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

注意

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

Step 3：刷写固件

Windows

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

macOS / Linux

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

硬件操作

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

开始烧录

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

详细步骤见刷写固件

Step 4：组装

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

Step 5：蓝牙配对

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

重新配对

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

Step 6：配置键位（可选）

用 USB-C 连接键盘到电脑。
如果键盘当前在 BLE 模式，短按 FN1 切回 USB 模式。
用 Chrome / Edge 打开 BinaryKeyboard Studio。
点击"连接设备"，选择你的键盘。
配置键位、层、FN、RGB 或宏。
点击保存 / 写入，等待提示成功。

详细步骤见改键软件使用

完成 🎉

打开蓝牙并完成连接。

下一步可以继续看：

省电

不用时可以关闭键盘电源开关
键盘会在闲置后自动进入低功耗模式

遇到问题？

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