2 layers22.5 × 31 mm
SSD1306 FFC Adapter
famichu/MagLevSwitch_ReferenceKeyboard
The reference keyboard for the MagLev Switch MX
10 parts2MIT
2 layers176 × 105 mm
Reference Keyboard
famichu/MagLevSwitch_ReferenceKeyboard2The reference keyboard for the MagLev Switch MX
- Size
- 176 × 105 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 91
- Nets
- 68
- Pads
- 408
- Tracks, vias
- 612, 1,532
- Pours
- 276
- Routed
- Yes
- KiCad
- KiCad 8.0 (file 20240108)
- Created
- 29 Apr 2024
- Updated
- 29 Mar 2025
Overview
Reference Keyboard is an open-source printed circuit board by famichu, from the famichu/MagLevSwitch_ReferenceKeyboard repository on GitHub, published under the MIT licence. It is a 2-layer board of 176 × 105 mm with 91 parts on 68 nets, routed with 612 tracks and 1,532 vias.
It is built around the RP2040, W25Q16JVSSIM and LM1117RS-3.3, with the 1SS387, SKQGAFE010 and NX3225SA-12MHZ-STD-CSR-6 among its other parts. Its parts include 28 switches, 17 capacitors, 12 resistors, 10 diodes and 3 ICs. It belongs with the keyboards and input boards and the RP2040 boards of this library.
Main components
7
RP2040
LQFN-56(7x7)12bit 133MHz 30 LQFN-56(7x7) Microcontrollers (MCU/MPU/SOC) ROHSRaspberry PiMicrocontrollers (MCU/MPU/SOC)
W25Q16JVSSIM
SOIC-8-208mil-40℃~+85℃ 100,000 cycles 133MHz 16Mbit 2.7V~3.6V 20 Years 3ms SPI SOIC-8-208mil NOR FLASH ROHSWinbond ElecNOR FLASH
LM1117RS-3.3
TO-252-2(DPAK)-40℃~+125℃@(Tj) 1 1.2V@(1A) 100uV 12V 1A 3.3V 5mA 75dB@(120Hz) Fixed Over Temperature Protection Positive TO-252-2(DPAK) Voltage Regulators - Linear, Low Drop Out (LDO) Regulators ROHSHTC Korea TAEJIN TechVoltage Regulators - Linear, Low Drop Out (LDO) Regulators
1SS387
SOD-5231.2V@100mA 100mA 150mW 2A 4ns 500nA@80V 80V Independent SOD-523 Switching Diodes ROHSJiangsu Changjing Electronics Technology (CJ)Switching Diodes
SKQGAFE010
SMD-4P,5.2x5.2mm-40℃~+90℃ 1.5mm 12V 1N 5.2mm 5.2mm 500,000 Cycles 50mA Round Button SPST-NO Surface Mount,Vertical SMD-4P,5.2x5.2mm Tactile Switches ROHSALPSALPINETactile Switches
NX3225SA-12MHZ-STD-CSR-6
SMD3225-4P-40℃~+85℃ 100Ω 12MHz 8pF ±15ppm ±25ppm SMD3225-4P Crystals ROHSNDKCrystals
RB161MM-20TR
SOD-123F1 Independent 1A 20V 30A 350mV@1A 700uA@20V SOD-123F Schottky Diodes ROHSROHM SemiconductorSchottky Diodes
README
README.mdMagLev Switch Reference Keyboard
Summary
This keyboard is a reference keyboard for using the MagLev switch, which has linear-output Hall effect sensors and magnetic levitation switches.
Features
- A 28-switches keyboard for the left hand
- Uses 4 MagLev switches for the WASD keys
- Able to read the depth of the MagLev switches
- Built-in OLED displaying MagLev switch depth graphs
BOM
Main PCB
- Main PCB x1
- Kailh Switch Socket x24
- Cherry MX compatible switch x24
- MagLev Switch MX x4
- Stabilizer(2U) x2
- Incremental rotary encoder(PEC12R series of compatible) x1
- RP2040 x1
- Other small devices(refer to the schematic)
Flex-PCB with OLED
- Flex-PCB x1
- OLED SSD1366 x1
- Other small devices(please refer the schematic)
Shell
- Top case(3D printed) x1
- Top plate(3D printed) x1
- knob(3D printed) x1
- Bottom case(3D printed) x1
- Stand(3D printed) x2
- Rubber foot(25mmx8mm oval) x2
- Bottom switch cap(3D printed) x1
- Screw M2x5mm x4
- Screw M2x8mm x4
- Insert nut M2x3mm(OD3.5mm) x8
- Cherry MX compatible keycap x28
3D Printing
Use FFF 3D printers to print shell parts.
PCB
I had manufactured at JLCPCB. The main PCB in this repository has an LCSC number as well. This allows you to order the PCBA without selecting individual devices.
Assembly
-
- Solder all devices.
-
- Insert switches through a top plate.
- Insert switches through a top plate.
-
- Place the bottom switch cap onto the bottom case (Insert nuts into holes on the bottom plate if you print it by yourself.).
- Place the bottom switch cap onto the bottom case (Insert nuts into holes on the bottom plate if you print it by yourself.).
-
- Fix the PCB with screws.
- Fix the PCB with screws.
-
- 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).
-
- Connect the flex-PCB with the main PCB.
- Connect the flex-PCB with the main PCB.
-
- Close the top and bottom cases with screws.
- Close the top and bottom cases with screws.
-
- Stick rubber feets.
- Stick rubber feets.
-
- Install keycaps and a knob.
- Install keycaps and a knob.
-
- Finish!
- Finish!
Directory configuration
- bin: Binary of the firmware
- pcb: Schematics & PCB artworks
- libs: PCB libraries
- Reference_Keyboard: Main PCB
- SSD1366_FFC_Adapter: Flex-PCB with OLED
- shell: 3D models for FFF printer
- src: Source codes of the firmware
Parts
91| Qty | Value | Footprint | References |
|---|---|---|---|
| 19 | SW_Push | MX_Hotswap:MX-Hotswap-1U | SW1, SW2, SW3, SW4, SW5, SW10, SW11, SW13, SW14, SW16, SW17, SW18, SW19, SW21, SW22, SW23 +3 |
| 10 | 0.1u | Capacitor_SMD:C_0603_1608Metric | C2, C3, C4, C5, C7, C10, C11, C12, C16, C17 |
| 9 | 1SS387 | Diode_SMD:D_SOD-523 | D2, D3, D4, D5, D6, D7, D8, D9, D10 |
| 8 | MountingHole | MountingHole:MountingHole_2.2mm_M2 | H1, H2, H3, H4, H5, H6, H7, H8 |
| 4 | 10k | Resistor_SMD:R_0603_1608Metric | R9, R10, R11, R12 |
| 4 | 1k | Resistor_SMD:R_0603_1608Metric | R5, R6, R7, R8 |
| 4 | MagLevSwich | MagLevSwitch:MagLevSwitch_Up | ML-SW1, ML-SW2, ML-SW3, ML-SW4 |
| 3 | SKQGAFE010 | Button_Switch_SMD:SW_SPST_SKQG_WithStem | SW25, SW27, SW28 |
| 2 | 0.01u | Capacitor_SMD:C_0603_1608Metric | C13, C14 |
| 2 | 10u | Capacitor_SMD:C_0603_1608Metric | C15, C18 |
| 2 | 27 | Resistor_SMD:R_0603_1608Metric | R1, R2 |
| 2 | 5.1k | Resistor_SMD:R_0603_1608Metric | R3, R4 |
| 2 | 5.6p | Capacitor_SMD:C_0603_1608Metric | C1, C8 |
| 2 | SW_Push | MX_Hotswap:MX-Hotswap-2.25U | SW15, SW24 |
| 1 | 2.2u | Capacitor_SMD:C_0603_1608Metric | C9 |
| 1 | 84953-4 | Connector_FFC-FPC:TE_84953-4_1x04-1MP_P1.0mm_Horizontal | J4 |
| 1 | Conn_01x01_Pin | TestPoint:TestPoint_Pad_D1.5mm | TP1 |
| 1 | Conn_01x03_Pin | Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_Vertical | J1 |
| 1 | LM1117RS-3.3 | Package_TO_SOT_SMD:TO-252-3_TabPin2 | U3 |
| 1 | LOGO | LOGO:MX_KiCAD | G*** |
| 1 | LOGO | LOGO:famichu | G*** |
| 1 | LOGO | LOGO:WebQR | G*** |
| 1 | NX3225SA-12MHz-STD-CSR-6 | Crystal:Crystal_SMD_3225-4Pin_3.2x2.5mm | Y1 |
| 1 | Polyfuse | Fuse:Fuse_0805_2012Metric | F1 |
| 1 | RB161MM-20TR | Diode_SMD:D_SOD-123F | D1 |
| 1 | RP2040 | Package_DFN_QFN:QFN-56-1EP_7x7mm_P0.4mm_EP3.2x3.2mm | U1 |
| 1 | RotaryEncoder_Switch | Rotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mm | SW26 |
| 1 | SW_Push | MX_Hotswap:MX-Hotswap-1.75U | SW12 |
| 1 | SW_Push | MX_Hotswap:MX-Hotswap-1.5U | SW7 |
| 1 | SW_Push | MX_Hotswap:MX-Hotswap-1.25U | SW20 |
| 1 | USB_C_Receptacle_USB2.0 | Connector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12 | J2 |
| 1 | W25Q16JVSSIM | Package_SO:SOIC-8_5.23x5.23mm_P1.27mm | U2 |
More from famichu/MagLevSwitch_ReferenceKeyboard
1Similar boards
- 4 layers267 × 100.5 mm
- 2 layers61.6 × 53.7 mm
Osborne floppy emulator
khaddra/osborne-floppy-emulator
Floppy disk drive emulator for the Osborne 1. Unfinished.
82 parts2 - 2 layers109.1 × 77.9 mm
- 6 layers100 × 100 mm
- 6 layers45 × 75 mm
- 6 layers68 × 45 mm
- 2 layers61 × 100 mm
- 2 layers17.8 × 33 mm
C pro micro
zgtk-guri/c-pro-micro
The atmega32u4 micro-controller board with USB Type-C receptacle, which is compatible with SparkFun Pro Micro
24 parts36
Questions
How big is the Reference Keyboard PCB?
It measures 176 × 105 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Reference Keyboard use?
91 parts, built around the RP2040, W25Q16JVSSIM, LM1117RS-3.3 and 1SS387. 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.
Where can I download the Reference Keyboard KiCad files?
From the famichu/MagLevSwitch_ReferenceKeyboard repository on GitHub, at the commit this page was made from: the board is pcb/Reference_Keyboard/Reference_Keyboard.kicad_pcb and its schematic pcb/Reference_Keyboard/Reference_Keyboard.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Reference Keyboard design in my own project?
Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).