
Open micro sister
TomBonness/open-micro
Open-source USB/BLE desktop programming controller with RGB status integration

Open-source USB/BLE desktop programming controller with RGB status integration
Open micro top is an open-source printed circuit board by TomBonness, from the TomBonness/open-micro repository on GitHub. It is a 4-layer board of 96 × 96 mm with 52 parts on 77 nets, routed with 330 tracks and 66 vias.
It is built around the SK6812MINI-E, CPG151101S11-16 and DF40C-24DS-0.4V(51), with the PEC11R-4215F-S0024 among its other parts. Its parts include 13 capacitors, 13 diodes, 12 switches and 1 connector. It belongs with the radio and wireless boards of this library.
Open Micro is an original open-source 96 × 96 mm desktop programming controller. Its industrial stack uses a CNC 6061-T6 aluminum bottom, a continuous neutral-frosted polycarbonate light-carrying wall, and a matte-black control PCB as the exposed structural top. A lower sister PCB carries the MCU, power, USB, RF, and eight hidden wall emitters.
This repository describes an unqualified two-board first article. Automated source, protocol, host, firmware, fabrication, CAD, collision, and artifact checks are design evidence only. No fabricated unit has completed docs/qualification.md; do not represent the design as production-qualified.
Build the host tools, then run the simulator and daemon in separate terminals:
cd host
cargo build --locked --workspace
./target/debug/open-micro-simcd host
./target/debug/open-microd --transport sim
./target/debug/open-microctl doctor
./target/debug/open-microctl led set agent-1 --effect breathe --primary '#4D8DFF' --period 1400 --ttl 15The simulator device endpoint is 127.0.0.1:47950; its control endpoint is 127.0.0.1:47951. The daemon creates a private local socket at $TMPDIR/open-micro-$UID.sock on macOS, $XDG_RUNTIME_DIR/open-micro.sock on Linux when available, and \\.\pipe\open-micro on Windows.
python3 protocol/generate.py --check
python3 hardware/generate.py --check
python3 hardware/check.py
python3 firmware/check.py
cargo test --manifest-path host/Cargo.toml --workspace
python3 hardware/export.py --output hardware/generated/fabrication-release
.venv-cad/bin/python mechanical/export.py --output mechanical/generatedThe hardware export contains independent top/ and sister/ manufacturing jobs. The mechanical export contains aluminum-bottom and frosted-wall production solids, two PCB envelopes, vendor keycap fit references, a validated full assembly, GLB/3MF, and 2200 × 1600 hero/cutaway renders. Vendor keycap references are not printable production keycaps.
| Path | Purpose |
|---|---|
protocol/ | Canonical 20-byte device protocol 1.1, local IPC schema, generator, and fixtures |
hardware/ | Two-board KiCad sources, electrical/interconnect manifests, routes, fabrication exporter, and checks |
firmware/ | Pinned ZMK board/shield, Open Micro module, tests, and UF2 bootloader configuration |
host/ | Rust protocol crate, daemon, CLI, and simulator |
integrations/omp/ | OMP lifecycle, command-light, selection, and encoder-thinking adapter |
integrations/generic/ | Standalone newline-delimited JSON state producer |
mechanical/ | Shared enclosure/board stack contract, CadQuery sources, production exporter, and checks |
docs/ | Assembly, flashing, setup, SDK, inspection, and first-article qualification |
releases/ | Deterministic versioned release builder |
docs/assembly.md — dual-board ordering, vendor keycaps, and plate-free physical assembly.docs/flashing.md — initial SWD recovery, UF2 updates, ZMK, pairing, and encoder bond recovery.docs/setup.md — daemon, CLI, simulator, platform permissions, and OMP installation.docs/sdk.md — local IPC and raw protocol 1.1 contracts.docs/inspection.md — electrical, optical, mechanical, RF, and control inspection.docs/qualification.md — explicitly unperformed first-article evidence gate.The first article uses provisional USB identity 0x1209:0x4D50, device protocol 1.1, vendor HID report ID 5, and BLE name Open Micro. The VID/PID is not an assigned production identity. Obtain an appropriate assignment before distribution and change only the canonical protocol manifest before regenerating every consumer.
Hardware and mechanical sources: CERN-OHL-S-2.0. Software: Apache-2.0. Documentation: CC-BY-4.0. Third-party notices remain under LICENSES/ and generated release notices. See LICENSE, NOTICE, and REUSE.toml.
| Qty | Value | Footprint | References |
|---|---|---|---|
| 13 | 100nF | Capacitor_SMD:C_0402_1005Metric | C21, C22, C23, C24, C25, C26, C27, C28, C29, C30, C32, C33, C44 |
| 13 | SK6812MINI-E | OpenMicro:SK6812MINI-E_ReverseMount | D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13 |
| 12 | CPG151101S11-16 | OpenMicro:Kailh_CPG151101S11_Hotswap | SW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8, SW9, SW10, SW11, SW12 |
| 4 | M2 mounting hole | MountingHole:MountingHole_2.4mm_M2 | H1, H2, H3, H4 |
| 1 | 5V_LED | TestPoint:TestPoint_Pad_D1.0mm | TP_TOP1 |
| 1 | CAP_TOUCH_RING | OpenMicro:Touch_Ring_14mm | J4 |
| 1 | DF40C-24DS-0.4V(51) | OpenMicro:DF40C-24DS-0.4V_24 | JTOP |
| 1 | ENCODER_GROUP | TestPoint:TestPoint_Pad_D1.0mm | TP_TOP6 |
| 1 | GND | TestPoint:TestPoint_Pad_D1.0mm | TP_TOP2 |
| 1 | MX_GROUP | TestPoint:TestPoint_Pad_D1.0mm | TP_TOP5 |
| 1 | PEC11R-4215F-S0024 | OpenMicro:PEC11R-4215F-S0024 | ENC1 |
| 1 | RGB_DATA | TestPoint:TestPoint_Pad_D1.0mm | TP_TOP3 |
| 1 | RGB_RETURN | TestPoint:TestPoint_Pad_D1.0mm | TP_TOP4 |
| 1 | TOUCH_OUT | TestPoint:TestPoint_Pad_D1.0mm | TP_TOP7 |

TomBonness/open-micro
Open-source USB/BLE desktop programming controller with RGB status integration


dubnubdubnub/Giris
open source 32 key/half (64 total) analog TMR split ortholinear keyboard w/ 8kHz USB HS

gwaves/smart-keyboard
ESP32-S3 detachable USB macro keyboard: firmware, macOS configurator, protocol, and KiCad hardware prototype

jimmydin7/keydeck
Keydeck is a hardware project, a custom designed macropad with a fully built from scratch PCB, schematic, routing, and 3D model + printed case.

ai03-2725/duet-switch-tester
Switch tester designed for two of each switch for display and testability



It measures 96 × 96 mm and has 4 copper layers, 1.6 mm thick.
52 parts, built around the SK6812MINI-E, CPG151101S11-16, DF40C-24DS-0.4V(51) and PEC11R-4215F-S0024. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
From the TomBonness/open-micro repository on GitHub, at the commit this page was made from: the board is hardware/kicad/open-micro-top.kicad_pcb and its schematic hardware/kicad/open-micro-sister.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Its repository states no licence, so its author keeps all rights: ask TomBonness before reusing the design.