78 lines
4.1 KiB
Markdown
78 lines
4.1 KiB
Markdown
# CMDR keyboard 42 (swedish layout)
|
||
|
||
_This HW(PCB) was original made for use with the TeensyLC module and is reused by patching it to fit the rp2040-zero module_
|
||
|
||
|
||
|
||
## Layout
|
||
|
||
```text
|
||
Layer 0
|
||
--------------------------------------- ---------------------------------------
|
||
| Tab | Q | W | E | R | T | | Y | U | I | O | P | Å |
|
||
| LCtrl | A | S | D | F | G | | H | J | K | L | Ö | Ä |
|
||
| Shift | Z | X | C | V | B | | N | M | ,; | .: | -_ | Shift |
|
||
--------------------| Alt | Fn | Spc | |Enter| Fn |AG+Fn|--------------------
|
||
------------------- -------------------
|
||
Layer 1 (Fn)
|
||
--------------------------------------- ---------------------------------------
|
||
| Esc | F1 | F2 | F3 | F4 | F5 | | F6 | F7 | F8 | F9 | F10 | BSpc |
|
||
| LCtrl | 1! | 2"@ | 3#£ | 4¤$ | 5% | | 6& | 7/{ | 8([ | 9)] | 0=} | Enter |
|
||
| Shift | 6& | 7/{ | 8([ | 9)] | 0=} | | <>| | ´`± | '*´ | ¨^~ | +?\ | Shift |
|
||
--------------------| Alt | Fn | Spc | | BSpc| Fn |AG+Fn|--------------------
|
||
------------------- -------------------
|
||
Layer 2 (Fn + Fn)
|
||
--------------------------------------- ---------------------------------------
|
||
| Esc | F11 | F12 | F13 | F14 |PrSrc| | § | SLk | Gui | OSLk| CpLk| BSpc |
|
||
| LCtrl | F15 | F16 | F17 | F18 | F19 | | Left| Down| Up |Right| Del | Enter |
|
||
| Shift | F20 | F21 | F22 | F23 | F24 | | Home| PgD | PgU | End | Ins | Shift |
|
||
--------------------| Alt | Fn | Spc | | BSpc| Fn |AG+Fn|--------------------
|
||
------------------- -------------------
|
||
```
|
||
|
||
## Firmware features
|
||
|
||
- 42 key split layout (36 finger keys + 6 thumb keys) with a Swedish-centric NKRO HID mapping across three layers.
|
||
- Function layer system with two Fn keys (40/43/44) enabling sticky lock, OS lock and deep modifier combos without ghosting.
|
||
- High-speed matrix scanning (250 µs cadence) with scan-based debounce, per-key press spacing protection and idle/suspend rate throttling.
|
||
- Bootloader entry options including `Fn+Fn+LCtrl+LShift+RShift` runtime chord and power-on detection on button index 0.
|
||
- Status LED heartbeat derived from joystick firmware: startup heartbeat, activity/idle transitions, sticky-state colors, Caps Lock flash, suspend blanking and error signalling.
|
||
- Power-aware USB handling that drops scan frequency 20× during suspend while honouring wake-on-input and immediate resume.
|
||
|
||
## Install script (`install.sh`)
|
||
|
||
The repository includes a host automation helper for the RP2040 firmware.
|
||
|
||
- Quick start: `./install.sh check` (compilation + clippy) or `./install.sh test` (full suite including host-side tests).
|
||
- Flashing: `./install.sh flash --local` for direct UF2 copy on Linux/macOS, or `./install.sh flash --ssh --target user@host --mount /path` for remote deployments.
|
||
- Cleaning: `./install.sh clean` removes cargo artefacts, generated binaries and UF2 images.
|
||
- Prerequisites are validated automatically (Rust toolchain, `thumbv6m-none-eabi`, `cargo-binutils`, `uf2conv.py`, optional SSH settings).
|
||
- Script output uses colour-coded sections for readability and fails fast on missing dependencies or connectivity issues.
|
||
|
||
## Build environment rp2040 Zero
|
||
|
||
Rust embedded, rp2040 HAL
|
||
|
||
- Cargo (cargo.toml)
|
||
- rustup target add thumbv6m-none-eabi
|
||
- Use install script to flash device
|
||
- Flashing via rp2040 USB bootloader
|
||
- Pressing reset/boot button on rp2040 Zero board
|
||
- Pressing upper left corner on the keyboard when connecting the usb cable
|
||
- Pressing Fn+Fn+Shift+Shift+Ctrl
|
||
|
||
## Hardware
|
||
|
||
[Schematics](eCAD/cmdr_mainboard_42_v1.pdf)
|
||
[patch instruction](/eCAD/rp2040_42_patch_instruction.md)
|
||
|
||
- 1x rp2040 Zero
|
||
- 36x Cherry MX compatible switches
|
||
- 6x Kailh Choc low profile switches
|
||
- 42x 1N4148 diodes
|
||
- 1x PCB [Gerber files](eCAD/cmdr_mainboard_42_gerber_v1.zip) (please see [patch instructions](/eCAD/rp2040_42_patch_instruction.md))
|
||
- 1x MCU cover [STL file](mCAD/cmdr_keyboard_42_cover.stl)
|
||
- 1x 6x3 Cherry MX mounting jig (optional) [STL file](mCAD/cmdr_mounting_jig-MountingJig.stl)
|
||
|
||
---
|