可爱二进制无线键盘

✨ BinaryKeyboard ✨

_{Design by KJ · Made with love ❤️}

1. 项目介绍

这是一个带无线功能的可爱小键盘。硬件成本大概在 30 元 左右。
虽然是桌面小玩具键盘，但是功能非常丰富：

• 支持无线：蓝牙，以及自定义 2.4G。
• 低功耗友好：休眠电流低至 3uA，可以用很久。
• 支持 Web 改键：键盘、鼠标、多媒体、宏。
• 支持层切换：层数和按键数量对应。
• 宏编辑功能：支持可视化编辑和 MeowMacro 语言。
• 支持 RGB 灯效
• 多布局选择：有基础款、五键款、旋钮款三种布局。
• 全栈开源：硬件、固件、软件、工具链、3D 源文件全部开源，适合大伙折腾。
• 遵守开源协议规范，未经许可倒卖我会生气的！
• 自动构建：支持本地构建，也支持 GitHub Actions 自动构建。

⌨️ 有线款 vs 无线款 对比指南

对比维度	🔌 基础款（有线版）	🛜 无线款
主控芯片	CH552G	CH592F
连接方式	有线 (USB-C)	蓝牙 / 自定义 2.4G / 有线 (USB-C)
焊接难度	⭐	⭐⭐
RGB、层	支持	支持
宏功能	小杯宏 / 768B 动态空间	大杯宏 / 8KB 动态空间
可视化宏编辑 / MeowMacro 语言	支持 / 支持	支持 / 支持
最大回报率	1000Hz	8000Hz
一键更新固件	不支持	支持

别看旧版也这么多功能，实际上都是新版有才加的。

---

2. 快速复刻

2.1 PCB 打板参数

• 层数与工艺：普通的 2 层板 即可。
• 板厚：注意天线部分设计对应的是 1mm 板厚。如果需要其他板厚，在公开库里面更换对应的天线封装即可。

修改 PCB 的时候可以根据自己的喜好，做成自己喜欢的键盘布局。如果按键数量 / IO 口不改的话，也能直接用通用固件。

2.2 核心元器件与选型

• 主控与供电：无线版采用 CH592F 作为主控，使用 TPS62740 BUCK 到 2.5V 给系统供电。TPS61023 负责给 RGB 做升压，防止低电压下工作不稳定（也可不焊）。
• 电池选型：电池尺寸的话，可以用更大的电池增加续航，推荐 403040 尺寸。这样能减少整体厚度，防止顶到 USB-C 接口，保持外壳轻薄。
• 电池接口：使用 1.25 端子，红黑线序。
• RGB 灯珠：使用反贴灯珠 3528。

2.3 焊接电路板

🔍 焊接前确认：

• 先确认自己做的是基础款、五键款还是旋钮款。
• 有线版和无线版的 PCB 几乎完全不同，不要看错 PCB / BOM / 3D 了！

🔥 焊接中注意：

• 反贴 RGB 3528 灯珠有方向，不要焊错了。
• USB、BOOT、RESET 这些位置优先检查焊接质量。
• 焊接完 USB-C 和供电可以先测试 2.5V 没问题再焊接主控。

✅ 焊接后检查：

• 首次上电前先测短路，再接 USB 或电池。
• 固件混刷不会报错，但是尽量不要这么做（有线款的固件不可以给无线款刷）。

📋 推荐焊接顺序：

1. 先焊接供电，测试电压。
2. 然后焊接主控，确认能识别、能刷写。
3. 再焊按键和 RGB 灯珠。

2.4 固件下载

板子做好以后，在 Github Release 可以找到最新的固件！
https://github.com/MeowKJ/BinaryKeyboard/releases

github打不开也可以 ->
也可以在最下面文件中找到固件（不是最新），然后去改键软件自动最新。
也可以进Q群下载固件（不是最新），群地址在末尾，然后去改键软件自动最新。

下载固件的软件：

🐱 MeowISP （神奇小工具）
基于 Rust WCHISP 开发的多平台 ISP 工具，你可以在本项目的 Github Release 或者是最下面的文件列表里面找到。

✏️ 命名规则：

芯片型号 - 键盘类型 - 版本号 - 固件类型.hex

👉 名称解释：

• 无线款：CH592F
• 有线款：CH552G
• 经典款：BASIC
• 五键款：5KEY
• 旋钮款：KNOB

🐱 第一次下载固件：

• STEP 0：找到 固件类型 为 Full 的固件。
• STEP 1：关闭开关。
• STEP 2：按住 BOOT 按钮的同时插入 USB-C。
• STEP 3：刷写固件。

🎉 下载完成了？！浏览器打开 key.mpas.top，开始测试你的专属键盘吧！或者准备打印3D外壳！

---

3. 打印 3D 外壳与安装教程

和基础版一样，采用叠叠乐的方式安装。分为上盖和下盖两个部分。

安装推荐采用 1.6 * 12mm 自攻螺丝，从顶部反打到上面，螺丝头成为支撑脚。

3.1 贡献外壳（感谢群友贡献）

五键款外壳 #1

感谢newstars制作的五键款外壳！
https://makerworld.com.cn/zh/models/2486062-ke-ai-er-jin-zhi-wu-xian-jian-pan-wai-ke#profileId-2843070
有问题可以在群里沟通1077222070

4. 无线与低功耗休眠

在DEEP睡眠模式下，测到的锂电池电流仅为 2.87uA 左右～

其他功耗测试

• 蓝牙模式，RGB亮度100%，白光：140mA
• 蓝牙模式，RGB亮度20%，白光：20mA
• 蓝牙模式，RGB亮度20%，仅指示灯：11mA
• 蓝牙模式，LIGHT睡眠，1.4mA

5. 固件定制与开发

上一次做基础款的时候，最烦的事情就是每次 release 多种不同的型号都要手动改 #define、手动编译、手动改名，然后上传 GitHub，上传一半网络又超时了😭。

所以这次直接换成了 CMake + Python 脚本 的工作流。这样做之后：构建入口统一、Git 友好、不同版本切换更稳定、文件命名自动处理，GitHub Actions 还可以直接自动编译发布。

https://github.com/MeowKJ/BinaryKeyboard 喜欢的话请点个小星星！

5.1 开发环境

• 编译键盘：CMake | Ninja | MRS_Toolchain | Python 3.10+
• 编译改键软件：Node 24 LTS | Pnpm

协议：GPL-3.0 | 欢迎 Contribute / Issue / PR

5.2 技术文档

• 文档首页
• 有线开发文档
• 无线开发文档

5.3 喵喵工具：神奇的终端

开发推荐使用这个神奇的喵喵终端工具（能编译也能下载）：

python tools/scripts/console.py

5.4 固件定制：两条路线任你选

想要改动键盘的代码和功能？你可以选择以下两条路线：

✨ 路线一：AI 辅助（适合萌新）

0. 仓库地址：https://github.com/MeowKJ/BinaryKeyboard
1. 进入 GitHub 仓库，先点右上角的 Star（重要⭐），然后再 Fork 一份到你自己的账号。
2. 使用本地 AI Agent，或者 Codex / GitHub Copilot 之类的工具，告诉它：
   • “这是我的仓库地址，我想修改 [具体功能/按键映射]”
   • “请帮我修改代码，我知道 push 到 main 分支可以触发 GitHub Actions 自动编译。”
3. 提交代码到你自己的 main 分支，等待 Action 自动编译对应固件。
4. 去你仓库的 Release 页面下载编译好的固件，回来测试。
5. (可选) 如果你觉得这个功能很赞，可以再让 AI 帮你发 PR 到主仓库。

⌨️ 路线二：经典开发

1. 拉取代码：将仓库克隆到本地机器。

   git clone [https://github.com/MeowKJ/BinaryKeyboard.git](https://github.com/MeowKJ/BinaryKeyboard.git)
   

2. 环境配置 A：确保你的电脑上已经安装好了 CMake、Ninja、和 Python 3.10+。
3. 环境配置 B：下载 RSIC-V 编译工具链，点我进入页面。然后用喵喵终端工具设置工具链路径。
4. 编写代码：打开你最爱的 IDE（比如 VSCode 或 CLion），找到对应的源文件，配置环境，开始编程。
5. 本地编译与下载：呼唤神奇的喵喵终端，一键编译并烧录进你的键盘！

   # 打开喵喵终端
   python tools/scripts/console.py
   

🔴 CI

固件的发布方式不同于大多数其他的开源硬件项目，固件实际上是在云端编译自动分发的，这一切都由 Github Action 自动完成。只要任何贡献者推送了新的代码（PR），Action 就会自动编译一份最新的固件，计算版本号，然后放在 Release 上面！

5.5 BinaryKeyboard Studio

特别制作的，且独属于 可爱二进制键盘 的配置工具！
只要浏览器访问 https://key.mpas.top/ 就可以进行配置，无需下载多余软件。
下面是特性预览。

🎨 主页与色调系统

每个版本都对应一种色调，发现色调变化，就是更新固件的时候了！非常建议保持固件最新。

⌨️ 层模式与 RGB 设置

特殊设计的迷你键盘，对应不同的层！RGB 也可以进行相关参数设置。

🎹 按键编辑页面

支持键盘、媒体、鼠标、宏。

🌈 宏编辑

宏编辑界面支持 可视化编辑 与 MeowMacro 语言。

💬 内置 Log

通过内置的 log，实时查看信息与调试。

💎 联网更新

有新固件了？自动就能更新！

---

6. 复刻与交流

• 复刻成功了？ 欢迎在评论区展示你的键盘！
• 遇到了问题？ 欢迎大家进群交流！QQ 交流群：1077222070
• 发现 Bug？ 发现代码有 bug 的话可以在 GitHub Issues 提交。

---

7. 开源协议 (License)

本项目采用混合开源协议。请在遵守对应许可的前提下使用、修改或分发本项目的不同模块：
This project uses a mixed open-source license:

• 代码 (Code): GPL-3.0 License
• 硬件与 3D 模型 (Hardware & 3D Model): CC BY-NC-SA 4.0
  (包含 PCB 工程及 3D 打印文件 / Includes PCB and 3D design files)
• 文档与素材 (Docs & Assets): CC BY 4.0

---

8. 待完成项

• 自定义2.4G (我打算结合到其他项目中，比如桌面灯或者其他东西)

---

8. 感谢与相关链接

感谢：

• WCH 南京沁恒 (免费申请了芯片，虽然不是这一款)