可爱二进制键盘

✨ BinaryKeyboard ✨

---

项目简介

基于CH552G的低成本键盘，拥有4个按键，大小分别为1U、1U、2U、2U。
如果你需要无线款 - 转到可爱无线二进制键盘

项目文档 Github

介绍视频

花10元DIY一款可爱的小键盘

3种款式可供选择

各种各样小键盘

键盘参数

基础款

• 4个按键均使用热插拔座子
• 自制硅胶减震垫
• 得益于CH552G简略的外部电路，不到5个阻容，非常好焊接
• RGB支持

旋钮款

• 基础款特性支持
• 4个按键
• 一个旋钮

五键款

• 基础款特性支持
• 5个按键

系统框图&成本统计

安装方式 (基础款)

1. 材料准备

• 2个标准键帽、2个2U大小键帽
• 4个轴
• 2.6mm * 10自攻螺钉4只
• 3mm厚硅胶垫
• 焊接好的PCB
• 3D打印尾壳
• 3D打印定位板

注意事项

• （忽略USB-C接口上那一坨锡）注意用的是贴片USB-C，我买成直插的，结果掰弯引脚才焊上去的
• 热插拔座子有方向，确保圆孔通畅。若焊错，我建议与其拆下，不如直接用烙铁烫掉阻挡孔的多余部分

2. 裁剪硅胶垫 (可选择直接使用3D打印件)

基于定位板裁剪硅胶垫子，我这里使用的是3MM厚度的硅胶垫子，某宝购买，非常便宜。然后用美工刀裁剪，裁的有点歪歪扭扭但是勉强能用。

3. 叠叠乐

按照下面这个顺序从上到下把这几个叠在一起，然后用2.6mm*10mm自攻螺钉固定

使用硅胶垫的情况

1. 定位板
2. 硅胶垫
3. PCB
4. 尾盖
   

不使用使用硅胶垫的情况

1. 一体化前盖
2. PCB
3. 尾盖
   

4. 安装轴和键帽

5. 完成了

---

软件代码 & 3D模型

BinaryKeyboard｜100% 开源
开源内容：键盘固件源代码、改键软件、3D 工程源文件（Shapr3D）
仓库：https://github.com/MeowKJ/BinaryKeyboard
协议：GPL-3.0
欢迎 Contribute / Issue / PR

编辑环境

编译键盘 CMake Ninja SDCC-4.5.0 Python3.10+
编译改键软件 Node20+ Pnpm

快速开始

• 在线文档：https://meowkj.github.io/BinaryKeyboard/ （由AI生成，不要抱有太大期待）
• 神奇喵喵终端工具：python tools/scripts/console.py

推荐入口

仓库根目录下直接运行：

python tools/scripts/console.py

代码纯小白，环境不会配置，但是想改动功能？

> 仓库地址: https://github.com/MeowKJ/BinaryKeyboard

1. 进入 GitHub 仓库，先点右上角的 Star (重要) ，然后再 Fork 一份到你自己的账号
2. 使用 AI Agent，比如 Codex / GitHub Copilot 之类的工具，告诉它：你的仓库地址、你想改什么
3. push 到 main 可以触发 GitHub Actions 自动编译
4. 提交到你自己的 main 分支，等待 action 自动编译对应固件
5. 去 Release 下载固件，回来测试
6. (可选) 如果你觉得这个功能确实不错，适合所有人用，可以再让 AI 帮你发 PR 到主仓库 (仓库不反对使用 AI 提交代码，但 PR 内容还是要遵循贡献规范，不要一次性提交大量非同模块改动，代码最终还是会经过检查)

HID Report ID 说明

Report ID	功能	数据	说明
1	键盘	8字节	用于模拟键盘输入
2	控制器	16位 * 4	用于模拟控制器输入
3	鼠标	5字节	用于模拟鼠标输入
4	主机 -> 键盘	31字节	主机发送数据到键盘
5	键盘 -> 主机	31字节	键盘发送数据到主机

改键软件

改键软件采用 Vue3 开发，目前自动部署在Vercel。可访问https://github.com/MeowKJ/BinaryKeyboard/deployments 查看部署日志。此键盘的通讯方式基于 HID协议。能够自动识别3款键盘进行改变键位映射。目前支持映射键盘，多媒体，鼠标3种键位设置。
使用方法：使用Chrome或Edge浏览器访问 http://key.mpas.top/ 即可。
也可自己部署或者打包为桌面软件。

旧版

新版

新版增加了 RGB设置、层切换、宏管理。

层！

层的数量 = 轴的数量
按住FUNC键的同时按下轴，就可以切换到对应的层。如果安装了RGB，对应的RGB会闪烁。

改键软件左侧的小键盘可以切换你需要改键的层。

宏！

CH552g版本支持2个小杯宏，采用特别设计的MeowMarco宏描述语言。需要去Github的Release页面下载最新固件。

3D打印

普通的FDM就能打！

固件

固件由Github Action自动编译而成，可以在改键软件中看到最新的固件版本。

固件发布地址
https://github.com/MeowKJ/BinaryKeyboard/releases

📌 固件文件说明

• CH552G_BASIC_xxxx.hex - 适用于 基础款
• CH552G_5KEYS_xxxx.hex - 适用于 五键款
• CH552G_KNOB_xxxx.hex - 适用于 旋钮款

📌 3D打印文件

基础款

• Basic.stl - 尾盖 + 1.5mm 定位板

五键款

• FiveKeysBox.stl - 尾盖
• FiveKeyPlateCube.stl - 一体化上盖 (无需定位板)
• FiveKeysPlate.stl - 1.5mm 定位板

旋钮款

• KnobBox.stl - 尾盖
• KnobPlateCube.stl - 一体化上盖 (无需定位板)
• KnobPlate.stl - 1.5mm 定位板

📌 软件工具

• binary-keyboard-studio-web.zip - 编译好的 Web 版改键工具

烧录固件的方式

使用WCHISPStudio烧录CH552g。
如果插入直接USB-C后没有识别到，则拔掉USB-C，长按住BOOT按钮 (距离边缘更近的那个小按钮) 然后接入USB-C，进入BOOTLOADER模式。

项目更新日志

日志：https://github.com/MeowKJ/BinaryKeyboard/commits/main/

BUG 提交

https://github.com/MeowKJ/BinaryKeyboard/issues
留下邮箱。

想要新功能？想知道三模版本进度？加入下面的群吧！

交流 & 复刻

参考&感谢

3键CV小键盘_三键工程师键盘_CH552G
Ch55xduino
WCH沁恒微电子
Shapr3D
Bambu Lab
Aaaou