keybytes README

项目的 README,来自 github.com/notaroomba/keybytes。合并为一个 markdown 文件:README.md。


Keybytes

A truly modular keyboard with rearrangeable keys, magnetic cases and Bluetooth!

KiCad CH592F RISC-V Onshape Blender

Key Features • Video Demo • Connecting Keybits • PCB • Credits • License

Keybytes

Keybits snapping together
(v2 preview)

Video Demo

https://github.com/user-attachments/assets/19bec26d-6e01-4ee0-906e-7e69bace2f9c

Typing over USB:

https://github.com/user-attachments/assets/b6abd347-b68b-40f1-8e2d-c50744b8104e

Key Features

V1

V1 had a CH32V003 on every key with pogo pins on all 4 sides and an STM32WB55 Keyword split into two stacked PCBs. It lives in the v1 branch.

Connecting Keybits

The side contacts are the magnets themselves. Every side has 6 contact magnets on a 2.38mm grid with the A and B nets alternating, so two keybits connect no matter which way round they are and at any 0/25/50/75% stagger. Each side has a small FET bridge that connects whichever net is higher to VBUS and the other one to GND, so polarity doesn't matter either.

Flashing keybits: the 4 pogo pins on top of the keyword (GND, TIO, TCK, 3V3) line up with the pads on the bottom of every keybit, so a keybit gets flashed by pressing it onto the keyword. After that it updates over OTA.

The v2 firmware for the CH592F is still in progress. The v1 status LED codes are in the v1 branch.

PCB

Designed in KiCad! There are two main boards, the Keybit and the Keyword, plus passive flex spacers (1u, 0.75u and 0.5u) that pass power across gaps.

Keybit

A single key on a cross shaped 2 layer flex PCB with a CH592F in the middle, a WS2812 RGB LED and Mill-Max 3305 hot swap sockets for the switch. The 4 flaps fold up into the case and have FR4 stiffeners, and each one has 6 contact magnets and a FET bridge for power. The pads on the bottom are for flashing it from the keyword. The hall variant has a TMAG3001 3-axis hall sensor, so the same board can be a hall key, a knob (in the encoder case) or a joystick.

Schematic:

Keybit Schematic Keybit Hall Schematic

Layout:

Keybit Layout

3D View:

Keybit 3D View Keybit 3D View

Keyword

The main board that the keybits connect to. It is now one flex board with a CH592F for BLE and USB-C, a BQ25185 charger for a small LiPo and a USBLC6 for ESD protection. The 4 SMD pogo pins on the top (GND, TIO, TCK, 3V3) are for flashing the keybits.

Schematic:

Keyword Schematic

Layout:

Keyword Layout

3D View:

Keyword 3D View Keyword 3D View

Manufacturing

Everything is panelized for JLC flex PCBA. The files are in production/panels: 8x3-panel is the full order, 2x3-test-panel is a smaller test order and spacer-panel is the bare flex spacers.

Credits

This project uses:

You may also like...

License

MIT


notaroomba.dev  ·  GitHub @NotARoomba  · 

keybytes (notaroomba/keybytes)

正在搜索数据库…

这是什么?Keybytes 是一款开源模块化机械键盘,每个按键都是一块可更换的小型 PCB(即 Keybit),内置 RISC-V 微控制器,通过 pogo pin 连接,并由磁吸外壳固定在一起,支持蓝牙和 USB。
我到底该怎么做一个?从 JLCPCB 等打样服务订购 Keybit 和 Keyword 的 PCB(文件位于仓库中,使用 KiCad 设计);用 cad 文件夹里的 Onshape STEP 文件 3D 打印或切割磁吸外壳;焊接 Cherry MX 轴和 pogo pin,然后通过编程焊盘逐个刷写每个 keybit。
组装这个需要哪些工具和零件?需要 KiCad 来查看或修改 PCB 文件,需要 Onshape 来打开外壳 STEP 文件,需要 STM32CubeMX 来处理主板固件,需要 JLCPCB 等 PCB 打样或贴片服务,还需要基本的焊接技能,因为 Keybit 使用 CH32V003,Keyword 使用 STM32WB55RGV6。
重新排列按键能直接用吗?只有每个 keybit 方向正确才行:N/W 两侧的 pogo pin 负责供电和 I2C,如果 keybit 方向装反,它的 SCL 会接到 3.3V、SDA 接到 GND,因此保持不亮。所有 keybit 还必须运行相同的固件版本,否则无法互相通信。
keybit 如何与主板以及彼此通信?它们通过四个方向的 pogo pin 使用 I2C 通信。接线设计使得只有当 keybit 与相邻 keybit 或主板 Keyword 正确朝向时,供电、SDA 和 SCL 才会对齐。
每个 keybit 上的状态 LED 是什么意思?白色常亮表示空闲,白色快速闪烁表示已连接到 Keyword,蓝色闪烁表示位于编程引脚上,绿色表示已刷写且为最新版本,红色常亮或红色闪烁则表示更新卡住或 keybit 方向装反。
如何更新所有 keybit 的固件?Keyword 板保存 keybit 固件。更新 Keyword 后,依次将每个 keybit 放到其编程引脚上,等待绿色 LED 亮起,因为固件版本不匹配的 keybit 无法通信。
作者是否还做过类似的开源硬件项目?做过。README 中链接了同一作者的相关项目:Ember,一款支持蓝牙的回流焊热板;Cyberboard,一款 Pico 尺寸的 STM32 开发板;Trace,一把 PCB 尺子;以及 Linea,一款 EMR 平板。
大小
268.1 MB
星标
465
更新
提交Nov 13
时长
10个月
提交 · 90 天