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 — это модульная механическая клавиатура с открытым исходным кодом, где каждая клавиша — отдельная маленькая сменная плата (Keybit) со встроенным микроконтроллером на архитектуре RISC-V. Платы соединяются контактами pogo pins и удерживаются магнитными корпусами, поддерживаются Bluetooth и USB.
Как мне её собрать?Закажите платы Keybit и Keyword (файлы лежат в репозитории, спроектированы в KiCad) на производстве, например в JLCPCB, изготовьте магнитные корпуса по 3D-моделям или вырежьте их по файлам STEP из папки cad в Onshape, припаяйте переключатели Cherry MX и контакты pogo pins, затем прошейте каждую плату Keybit через её площадки для программирования.
Какие инструменты и детали нужны для сборки?Нужны KiCad для просмотра и правки файлов печатных плат, Onshape для файлов STEP корпусов, STM32CubeMX для прошивки основной платы, сервис производства и сборки плат, например JLCPCB, а также базовые навыки пайки: на плате Keybit стоит CH32V003, а на Keyword — STM32WB55RGV6.
Работает ли перестановка клавиш сразу, без настроек?Только если каждая плата Keybit повернута правильно: контакты pogo pins на сторонах N/W передают питание и I2C. Если плата повернута неправильно, на SCL приходит 3.3V, на SDA — GND, и она остаётся без подсветки. Кроме того, все платы Keybit должны работать на одной версии прошивки, иначе они не смогут обмениваться данными.
Как платы Keybit общаются с основной платой и между собой?Они обмениваются данными по I2C через контакты pogo pins на всех четырёх сторонах. Проводка устроена так, что питание, SDA и SCL совпадают только тогда, когда плата Keybit правильно сориентирована относительно соседней платы или основной платы Keyword.
Что означает светодиод статуса на каждой плате Keybit?Белый — ожидание; быстрые белые мигания — плата присоединилась к Keyword; синее мигание — плата стоит на контактах для программирования; зелёный — прошита и актуальна; постоянный или мигающий красный — признак зависшего обновления или неправильно повернутой платы.
Как обновить прошивку на всех платах Keybit?Плата Keyword хранит прошивку для Keybit. После обновления Keyword ставьте каждую плату Keybit по очереди на её контакты для программирования и ждите зелёного светодиода, так как платы с разными версиями прошивки не смогут обмениваться данными.
Делал ли автор другие проекты с открытым железом?Да, в README указаны связанные проекты того же автора: Ember — Bluetooth-плитка для пайки оплавлением; Cyberboard — отладочная плата на STM32 размером с Pico; Trace — линейка для печатных плат; Linea — EMR-планшет.
Автор
notaroomba
Размер
268.1 MB
Звёзды
465
Обновлён
КоммитNov 13
Возраст
10 мес
Коммиты · 90 дней