4.2 DC22 三模（开发中）
22 键三模数字小键盘 · USB / 蓝牙 / 2.4G
本页处于开发中
有线（USB）通道已在真机验证：枚举、打字、VIA 改键、落盘全部跑通。
以下尚未上机验证，参数与按键可能随固件调整：蓝牙（BLE）、2.4G、低功耗、音乐律动。
1. 基本参数
| 规格 | 参数 | 备注 |
|---|---|---|
| 按键数量 | 22 | 直连 GPIO，无矩阵、无二极管 |
| 按键层数 | 4 | 0 基础层 / 1 FN 层 / 2 灯效层（FN2）/ 3 用户层（出厂留空） |
| 连接模式 | 三模：USB 有线 / 蓝牙 BLE / 2.4G | 蓝牙、2.4G 开发中 |
| 主控 | CH582M（RISC-V4A，448K Flash / 32K RAM） | 自研固件（非 QMK / ZMK） |
| 接口 | Type-C | 走 USB2 通路 |
| C2C | 支持 | |
| 扫描周期 | 1ms | 去抖 5ms |
| 回报率 | 开发中，待定 | |
| 延迟 | 开发中，待定 | |
| 全键无冲 | 支持 | NKRO 位图报告；FN + 7 在 NKRO / 6KRO 之间切换 |
| 全键自定义 | 支持 | VIA 在线改键，仅 USB 通道下可用 |
| 灯光 | RGB 轴灯 22 颗，下灯位 | 49 种灯效；音乐律动需 PC 端工具推频谱 |
| 电池 | 内置锂电池，Type-C 充电 | 电量测量未实现，蓝牙上报固定 100% |
| 进入休眠 | 开发中，待定 | |
| 套件尺寸 / 重量 | 待补 | |
| 固件平台 | 自研 CH582 固件 | 非 QMK / ZMK |
| 源代码开源 | 开发中 | 固件仓库整理中，暂未公开 |
2. 快捷键
出厂默认值。全部可在 VIA 里改（见第 6 节），改完掉电记忆。
2.1 基础层
标准数字小键盘：0~9、.、/、*、-、+、Enter、NumLock、Home、End、PgUp、PgDn，外加一颗 FN。
2.2 FN 层（按住 FN）
| 快捷键 | 键值 (VIA) | 说明 | 备注 |
|---|---|---|---|
| FN + 1 | Mode BT1 | 切换到蓝牙 1 号通道 | 广播名 czm_dc22_ble1；灯闪蓝，连上后常亮 |
| FN + 2 | Mode BT2 | 切换到蓝牙 2 号通道 | 广播名 czm_dc22_ble2 |
| FN + 3 | Mode BT3 | 切换到蓝牙 3 号通道 | 广播名 czm_dc22_ble3 |
| FN + 4 | Mode USB | 切回 USB 有线 | P4 下的灯绿色常亮 3 秒 |
| FN + 5 | Mode 2G4 | 切到 2.4G | 开发中；P5 下的灯紫色常亮 3 秒 |
| FN + 8 | BT Next | 蓝牙切到下一个通道 | 与 FN + 1/2/3 等价，循环轮换 |
| FN + 6 | BT Pair | 蓝牙重新配对 | 广播 30 秒，期间任意主机都能配对 |
| FN + 7 | NKRO | 全键无冲 / 6 键无冲切换 | 切换后落盘记忆 |
| FN + 0 | Battery | 上报电量 | 蓝牙下有效；USB 下暂未实现 |
| FN + . | Bootldr | 进入 bootloader（刷固件） | |
| FN + PgUp | Reset | 恢复出厂键位 | |
| FN + / | 音量 - | 媒体键 | 蓝牙、2.4G 下不可用 |
| FN + * | 音量 + | 媒体键 | 蓝牙、2.4G 下不可用 |
| FN + - | 静音 | 媒体键 | 蓝牙、2.4G 下不可用 |
| FN + + | 播放 / 暂停 | 媒体键 | 蓝牙、2.4G 下不可用 |
| FN + Enter | 计算器 | 媒体键 | 蓝牙、2.4G 下不可用 |
| FN + Home | 上一曲 | 媒体键 | 蓝牙、2.4G 下不可用 |
| FN + End | 下一曲 | 媒体键 | 蓝牙、2.4G 下不可用 |
2.3 FN2 灯效层（长按 P/）
P/ 短按是除号，长按约 0.2 秒进入 FN2 层。灯效键刻意没有占用 FN 层最顺手的 P1-P4，那些位置留给了三模切换。
| 快捷键 | 键值 (VIA) | 说明 |
|---|---|---|
| 长按 P/ 再按 1 | LED + | 亮度 + |
| 长按 P/ 再按 2 | LED - | 亮度 - |
| 长按 P/ 再按 3 | LED Tog | 灯光开 / 关 |
| 长按 P/ 再按 4 | LED Next | 下一个灯效 |
| 长按 P/ 再按 0 | Battery | 上报电量 |
| 长按 P/ 再按 . | Bootldr | 进入 bootloader |
3. 三模切换
一句话：插着线就是 USB；拔了线自己回到上次用的那条蓝牙；手动切走之后不会被拽回去。
3.1 自动切换
固件按 USB 供电（VBUS）的跳变沿自动往返，正常使用不需要手按 FN + 4：
| 事件 | 固件动作 |
|---|---|
| 插上线 | 立刻切回 USB，并记住这个模式 |
| 拔掉线，且当前在 USB | 回到上次用过的那条蓝牙通道；从没用过蓝牙则回到 1 号通道 |
| 拔掉线，但当前不在 USB | 原地不动 |
- 插着线也能切蓝牙：手动按
FN + 1/2/3之后不会被拽回 USB。 - 插着线上电 = USB 优先：不会出现「开机停在蓝牙、还得手按 FN + 4」。
- VBUS 有 20ms 去抖，插头抖动不会误触发。
3.2 切换时会发生什么
- USB 和蓝牙不会同时连着。 插着线切到蓝牙时，电脑上的 USB 键盘会消失（键盘主动断开总线）；切回 USB 会重新枚举一次。
- 切换前键盘会先放掉所有按着的键，不会出现「切过去以后有键一直在重复」。
- VIA 只在 USB 通道下可用 —— 蓝牙 / 2.4G 下电脑上根本没有这个设备。要改键请先按
FN + 4切回 USB。
3.3 指示灯
本键盘没有独立状态灯，用对应按键下面那颗轴下灯做提示（亮度刻意压暗，只做指示）：
| 动作 | 灯位 | 样子 |
|---|---|---|
| 切到蓝牙 / 还没连上 | 对应通道的数字键下（FN+1 → 1 键） | 闪蓝，闪到连上为止（不超时） |
| 蓝牙连上 | 同上 | 常亮 1.5 秒，然后回归灯效 |
| 蓝牙掉线 | 同上 | 自动回到闪蓝 |
| 切回 USB | 4 键下 | 常绿 3 秒 |
| 切到 2.4G | 5 键下 | 常紫 3 秒 |
「连上」单独给一次常亮是刻意的：闪停掉和「指示灯放弃了」看起来一样，用户没法从「灯不闪了」判断到底连上没有。
4. 蓝牙
4.1 三个配对通道
键盘可以记住 3 台主机，每台各占一个通道。通道不是「第几台配对过的设备」，而是三个互相独立的槽位：
- 切到某个槽 = 用那个槽的名字广播：
czm_dc22_ble1/czm_dc22_ble2/czm_dc22_ble3； - 绑定信息记在键盘里（掉电不丢），再连同一台电脑不需要重新配对，切过去会自动连回；
- 切到哪个通道，键盘就出现在那台电脑的「已连接」里，另外两台那边会显示断开。
⚠ 开发中：切换到某个槽只改广播名，还做不到「按槽位定向连回指定那一台」，最终连上来的是任意一台已配对的主机。按槽位定向重连要等「槽位 ↔ 主机地址」对照表做完。
4.2 首次配对
- 按住
FN再按1/2/3，选一个通道 —— 对应数字键下的灯开始闪蓝； - 在电脑 / 手机的蓝牙设置里找到
czm_dc22_ble1（或2/3）并连接； - 灯变为常亮 1.5 秒后回归灯效，说明已连上，可以打字了。
4.3 重新配对
FN + 6：键盘进入「谁都能连」的广播状态 30 秒。适合换新电脑、或者绑定信息乱了的时候。30 秒内没有主机连上，广播自动停止（省电，也避免键盘一直挂在别人的蓝牙列表里）。
4.4 已知限制
- 媒体键不工作：音量 / 播放 / 计算器这些在蓝牙下无效，按键不会有反应。原因是协议栈的键盘服务里没有消费者报告，补它要改 HID 报告描述符，排在基本通道上机验证之后。
- 闲置自动断开：蓝牙闲置 60 秒会断开省电，按一下键或碰一下鼠标会重新连上。
- 从未上机验证：以上行为都是固件代码层的结论，第一次上机时可能还要调整。
5. 2.4G
开发中。 FN + 5 现在只切通道、亮一次紫灯，不会产生任何输入 —— 射频发送和 USB 接收器都还没做。
6. 改键（VIA）
- 用 Type-C 线连接电脑，按
FN + 4确认在 USB 通道（VIA 只在 USB 下可用）； - 打开 usevia.app（或 via.micah.vip）；
- 导入本键盘的 JSON 后再改键。
改键结果存在键盘里，换电脑、掉电都不会丢。FN + PgUp 可以把键位恢复出厂。
可选键值里除常规键盘键码外，还有本键盘自己的功能键（VIA 里的名字）：
| VIA 名称 | 作用 |
|---|---|
| Mode USB | 切到 USB 有线 |
| Mode BT1 / BT2 / BT3 | 切到蓝牙 1 / 2 / 3 号通道 |
| BT Next | 蓝牙下一个通道 |
| BT Pair | 蓝牙重新配对 |
| Mode 2G4 | 切到 2.4G（开发中） |
| NKRO | NKRO / 6KRO 切换 |
| Battery | 上报电量 |
| LED Tog / LED + / LED - / LED Next | 灯光开关 / 亮度加减 / 下一个灯效 |
| Bootldr | 进入 bootloader |
| Reset | 恢复出厂键位 |
7. 灯光
- 22 颗轴下灯，49 种灯效，亮度 / 效果 / 速度 / 色相 / 饱和度都掉电记忆；
- 效果切换在 FN2 层（长按
P/）； - 音乐律动（效果列表里叫 Audio Reactive）由电脑推频谱，键盘上没有麦克风，所以需要 PC 端跑一次工具；仅 USB 通道可用。
8. 固件与下载
开发中：固件正在整理，暂时没有公开的下载入口。需要固件或有使用问题，请到 QQ 交流群 677654482（群内有各种文件）。
刷机与改键遇到的常见问题，见 常见问题 QA。
9. 已知限制
| 项目 | 状态 |
|---|---|
| USB 有线 | ✅ 已在真机验证（枚举 / 打字 / VIA / 落盘） |
| 蓝牙 BLE | ⚠ 代码完成，未上机验证；媒体键不可用；缺按槽位定向重连 |
| 2.4G | ⚠ 骨架，缺射频发送与接收器 |
| 低功耗 / 休眠 | ❌ 未实现 |
| 电量测量 | ❌ 未实现（蓝牙上报固定 100%） |
| 音乐律动 | ⚠ 需 PC 端工具，未上机验证 |
| VIA 改键 | ✅ USB 下可用；蓝牙 / 2.4G 下不可用 |
评论 / 提问 （填个昵称就能留言，无需注册；邮箱选填，填了能收到回复通知）