Important
This repository is legacy. Active Ergohaven RMK work now lives in https://github.com/ergohaven/rmk, an official fork of HaoboGu/rmk. Keep this repository read-only for history unless a migration task explicitly requires it.
RMK BLE split firmware for Ergohaven keyboards and trackballs (nRF52840).
| Keyboard | Layout | Encoders | Trackball |
|---|---|---|---|
| K:03 | 5×6 + 5 thumb | 3+3 | — |
| K:04 | 5×6 + 5 thumb | 1+1 | — |
| K:04 Micro | 3×5 + 3 thumb | 1+1 | — |
| Imperial44 | 4×6 + 3 thumb | 1+1 | — |
| OP36 | 3×5 + 3 thumb | — | — |
| Velvet | 4×6 + 5 thumb | — | — |
| Velvet UI | 4×6 + 5 thumb | — | PMW3610 |
| Device | Buttons | Modes |
|---|---|---|
| Trackball Royale | 6 | Normal, Scroll, Sniper, Adjust |
| Trackball Mini v3.1 | 4 | Normal, Scroll, Sniper, Adjust |
| Trackball Mini v3.0 | 2 | Normal, Scroll, Sniper, Adjust |
| Tool | Description |
|---|---|
| settings_reset | Erases keymap and BLE bonds, resets to bootloader |
cd keyboards/k03
cargo build --release --bin central
cargo build --release --bin peripheral- Put device into bootloader (double-tap reset)
- Copy
.uf2file to the mounted USB drive - For split keyboards: flash central and peripheral separately
Flash settings_reset.uf2 to erase all saved keymap/BLE data, then re-flash keyboard firmware.
Every push builds all devices in parallel via GitHub Actions. UF2 artifacts available as build downloads.
Based on RMK 0.8.2 with nRF52840 BLE support.