Reference Keyboard
famichu·MagLevSwitch_ReferenceKeyboard·pcb/Reference_Keyboard/Reference_Keyboard.kicad_pcb
About the Reference Keyboard PCB
Reference Keyboard is an open source RP2040/RP2350 PCB design by famichu, published on GitHub under the MIT license. It is a 2-layer board measuring 176 × 105 mm, with 79 components from 27 distinct parts.
Its main chip is the RP2040, from the RP2040/RP2350 family. Other key parts include the W25Q16JVSSIM and LM1117RS-3.3. By type, the board carries 28 switches, 17 capacitors, 12 resistors, 10 diodes, 3 ICs and 3 connectors.
It belongs with the keyboards designs in this gallery.
From the project
The reference keyboard for the MagLev Switch MX
- 2. Insert switches through a top plate.
- 3. Place the bottom switch cap onto the bottom case (Insert nuts into holes on the bottom plate if you print it by yourself.).
- 5. Insert an OLED module with a flex PCB into the top case (Insert nuts into holes on the top plate if you print it by yourself).
- 6. Connect the flex-PCB with the main PCB.
- 7. Close the top and bottom cases with screws.

Main components on the Reference Keyboard
Reference Keyboard bill of materials (BOM)
79 components, 27 distinct parts — part numbers from the project's BOM.
| Qty | Part | Footprint | Refs |
|---|---|---|---|
| 1 | RP2040 | QFN-56-1EP_7x7mm_P0.4mm_EP3.2x3.2mm | U1 |
| 1 | W25Q16JVSSIM | SOIC-8_5.23x5.23mm_P1.27mm | U2 |
| 1 | LM1117RS-3.3 | TO-252-3_TabPin2 | U3 |
| 1 | NX3225SA-12MHZ-STD-CSR-6 NX3225SA-12MHz-STD-CSR-6 | Crystal_SMD_3225-4Pin_3.2x2.5mm | Y1 |
| 1 | Conn_01x03_Pin | PinHeader_1x03_P2.54mm_Vertical | J1 |
| 1 | USB_C_RECEPTACLE_USB2.0 USB_C_Receptacle_USB2.0 | USB_C_Receptacle_HRO_TYPE-C-31-M-12 | J2 |
| 1 | 84953-4 | TE_84953-4_1x04-1MP_P1.0mm_Horizontal | J4 |
| 1 | C524650 Polyfuse | Fuse_0805_2012Metric | F1 |
| 4 | MagLevSwich | MagLevSwitch_Up | ML-SW1, ML-SW2, ML-SW3, ML-SW4 |
| 19 | SW_Push | MX-Hotswap-1U | SW1, SW2, SW3, SW4, SW5, SW6, SW8, SW9 +11 |
| 1 | SW_Push | MX-Hotswap-1.5U | SW7 |
| 1 | SW_Push | MX-Hotswap-1.75U | SW12 |
| 2 | SW_Push | MX-Hotswap-2.25U | SW15, SW24 |
| 1 | SW_Push | MX-Hotswap-1.25U | SW20 |
| 3 | SKQGAFE010 | SW_SPST_SKQG_WithStem | SW25, SW27, SW28 |
| 1 | RotaryEncoder_Switch | RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mm | SW26 |
| 1 | RB161MM-20TR | D_SOD-123F | D1 |
| 9 | 1SS387 | D_SOD-523 | D2, D3, D4, D5, D6, D7, D8, D9 +1 |
| 2 | 5.6P 5.6p | C_0603_1608Metric | C1, C8 |
| 10 | 0.1U 0.1u | C_0603_1608Metric | C2, C3, C4, C5, C7, C10, C11, C12 +2 |
Show 7 more
| Qty | Part | Footprint | Refs |
|---|---|---|---|
| 1 | 2.2U 2.2u | C_0603_1608Metric | C9 |
| 2 | 0.01U 0.01u | C_0603_1608Metric | C13, C14 |
| 2 | 10U 10u | C_0603_1608Metric | C15, C18 |
| 2 | 27 | R_0603_1608Metric | R1, R2 |
| 2 | 5.1K 5.1k | R_0603_1608Metric | R3, R4 |
| 4 | 1k | R_0603_1608Metric | R5, R6, R7, R8 |
| 4 | 10K 10k | R_0603_1608Metric | R9, R10, R11, R12 |
Reference Keyboard design files
The KiCad project lives in the famichu/MagLevSwitch_ReferenceKeyboard repository on GitHub; these links point at the commit this page was built from.
Reference Keyboard: common questions
What microcontroller does the Reference Keyboard use?
The Reference Keyboard is built around the RP2040, from the RP2040/RP2350 family.
How big is the Reference Keyboard PCB?
The Reference Keyboard measures 176 × 105 mm, has 2 copper layers and is 1.6 mm thick.
How many components are on the Reference Keyboard?
79 components, from 27 distinct parts, with part numbers taken from the project's own BOM. The full bill of materials is listed on this page.
Where can I download the Reference Keyboard design files?
From the famichu/MagLevSwitch_ReferenceKeyboard repository on GitHub, which has the KiCad layout, the schematic and the BOM; the links under Design files point to each one.
Can I use the Reference Keyboard design in my own project?
Yes, under the terms of its MIT license, which famichu chose for the repository.
Can I test firmware for the Reference Keyboard without the hardware?
Yes. HardLabs builds a simulation of the board from its netlist and BOM, so you can run and debug RP2040/RP2350 firmware against it before you order a PCB.
More boards in MagLevSwitch_ReferenceKeyboard
Similar boards
RP2040/RP2350
Open Book Abridged Edition
joeycastillo
85 × 115 mm29 parts2LCC-BY-SA-4.08.1kRP2040/RP2350
Corne
foostan
277.2 × 107.5 mm164 parts2LCC-BY-4.07.7kRP2040/RP2350
Corne
foostan
277.2 × 107.5 mm164 parts2LCC-BY-4.07.7kRP2040/RP2350
Msa
Mentra-Community
47.8 × 9.4 mm53 parts2LMIT1.2kRP2040/RP2350
Open Source Smart Glasses
Mentra-Community
93 × 10.5 mm80 parts4LMIT1.2kRP2040/RP2350
MSA
Mentra-Community
30.5 × 138 mm61 parts2LMIT1.2k