Skip to the content
2 layers308.8 × 130.3 mmCyberKeeb2040, the printed circuit board in 3D

Hardware design for a mechanical keyboard based on RP2040 that also has a Pi Zero onboard.

Size
308.8 × 130.3 mm
Copper layers
2
Thickness
1.6 mm
Parts
182
Nets
155
Pads
1,207
Tracks, vias
2,145, 709
Pours
2
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
10 Jun 2023
Updated
22 Apr 2025

Overview

CyberKeeb2040 is an open-source printed circuit board by zli117, from the zli117/CyberKeeb2040 repository on GitHub, published under the CC-BY-SA-4.0 licence. It is a 2-layer board of 308.8 × 130.3 mm with 182 parts on 155 nets, routed with 2,145 tracks and 709 vias.

It is built around the WS2812. Its parts include 84 diodes, 69 switches, 5 resistors, 5 connectors and 2 capacitors. It belongs with the keyboards and input boards and the RP2040 and Raspberry Pi (Linux) boards of this library.

Main components

1

README

README.md

CyberKeeb 2040

A mechnical keyboard and a cyberdeck. Powered by PicoMK for communication between RP2040 and Pi Zero. Watch the demo on YouTube 👇.

Watch the demo video

Table of Contents

Build

V2 parts list and build instructions

V1 parts list and build instructions

PCB

Everything is in PCB/MainBoard dir. Designed with Kicad 7.0. Make sure Perfect DOS VGA 437 Font is intalled on Windows, or if you use Arch, install the ttf-perfectdos package. PCB/MainBoard/Gerber dir contains the Gerber files for three fab houses: JLCPCB, PCBWay, and OSHPark. For JLCPCB and PCBWay, make sure to select the Castellated Holes option (this will increase the price, but I found it necessary for good castellated holes).

Frame

The frame has three acrylic plates and is held together with screws and standoffs.

Photos

V2

Photo1 Photo2 Photo3 Photo4

V1

Photo1 Photo2 Photo3

Q&A

Special thanks to icon-oclast for asking these great questions.

What are the dip switches used for? Is there a recommended default setting for these?

The 4 positions are for each line of the SPI connection between the pi pico and pi zero. This allows cutting the connections between pi pico and pi zero without cutting the power connections. I initially designed it for the (paranoid) scenario where I can't kill the pi zero, but doesn't want it to do autotype or receiving the key strokes, but I found such scenario increasing unlikely. So, if you don't want to solder the DIP switches, feel free to just short the corresponding pins.

Presumably the switch/jumper labeled "pi power" controls pass-through power from the Pico to the Zero?

Yes.

Is there a minimum USB current needed when powering both boards

I don't have the empirical measurements, but here's the estimate: Pico: <20mA. Data source: https://mjoldfield.com/atelier/2021/11/pico-power.html SSD1306: <7mA. Data source: https://hsel.co.uk/2018/12/04/ssd1306-power-consumption/ Pi Zero W: <400mA under stress. Data source: https://www.tomshardware.com/reviews/raspberry-pi-zero-2-w-review Pi Zero 2 W: <600mA under stress.

So let's say it's 700mA if you want to stress the pi zero. I did run the stressberry on pi zero 2 w, with the display hat, and a wireless mouse receiver. The board is connected to the USB3.0 port and there's no under voltage warning, and no visible heat up on the cable or the connectors. However, due to differences on the motherboards, YMMY. I currently don't have a USB power meter to measure the actual current drawn.

Is there a maximum safe current to pass-through (when using the optional display hat for example)?

The trace between pico and pi zero has width of 1mm, and length around 300mm. Assuming you're using 1oz copper thickness, it should result in a maximum current of 1.2 A for temperature rise of 10 degree C.

Is it safe to power the zero independently by setting the pi power switch/jumper to off?

Yes.

What about the two connectors at the bottom of the board, either 4-pin jst sockets as in the build instructions, or possibly 5-pin headers on some revisions of the pcb, how are they intended to be used?

They are for my future plans :) Essentially, they expose three buttons from the key scan matrix, and pin 26 and 27. Pin 26 and 27 are analog input pins and I2C 1. I'm planning to create a plugin module for the joystick mouse pad similar to the one I have on the Pico-Keyboard, and an I2C expansion board for more modules like a num pad.

What cool things can we do if we include the optional 90 degree pin header(s)?

The pin header under the small screen has been removed, because I figured it'll be difficult to use it for anything without creating a giant mess in the firmware. The other header exposes the addressable LEDs. Only WS2812 is supported and tested because it's used in the Pico-Keyboard. However, you might be able to use for other things as it's essentially a GPIO pin with ground and 5V, and a 330 ohm resister on the GPIO pin.

PCB Library Licenses

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

CC BY-SA 4.0

Parts

182
QtyValueFootprintReferences
84DDiode_THT_Custom:D_DO-35_SOD27_P7.62mm_HorizontalD1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +68
410kCustomResitor:R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_Horizontal_0402R2, R3, R4, R5
20.01 μFCustomCapacitor:C_1206_3216Metric_Pad1.33x1.80mm_HandSolderC1, locked
1330CustomResitor:R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_Horizontal_0603R1
1Extra_KeysConnector_PinSocket_2.54mm:PinSocket_1x05_P2.54mm_HorizontalJ4
1JMD0.96CJMD0.96C:JMD0.96CJ2
1JoyStick_Or_I2C1Connector_PinSocket_2.54mm:PinSocket_1x05_P2.54mm_HorizontalJ5
1PiPowerSwitchConnector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalSW1
1Pi_ZeroPiZero:Raspberry_Pi_Zero_Socketed_THT_MountingHoles_CastellatedJ1
1PicoMCU_RaspberryPi_and_Boards:RPi_Pico_SMD_THU1
1RotaryEncoder_SwitchRotaryEncoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mm_CircularMountingHolesSW3
1SPI_SWButton_Switch_THT:SW_DIP_SPSTx04_Slide_6.7x11.72mm_W7.62mm_P2.54mm_LowProfileSW2
1SW_'HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW42
1SW_+HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW16
1SW_,HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW52
1SW_-HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW15
1SW_.HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW53
1SW_/HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW54
1SW_0HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW14
1SW_1HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW5
1SW_2HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW6
1SW_3HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW7
1SW_4HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW8
1SW_5HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW9
1SW_6HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW10
1SW_7HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW11
1SW_8HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW12
1SW_9HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW13
1SW_;HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW41
1SW_[HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW29
1SW_]HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW43
1SW_`HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW4
1SW_aHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW33
1SW_altHotswapFix:SW_Hotswap_Kailh_MX_1.25uSW60
1SW_bHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW49
1SW_backHotswapFix:SW_Hotswap_Kailh_MX_2.00uSW30
1SW_bkslashHotswapFix:SW_Hotswap_Kailh_MX_1.50uSW56
1SW_cHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW61
1SW_capsHotswapFix:SW_Hotswap_Kailh_MX_1.75uSW32
1SW_ctrlHotswapFix:SW_Hotswap_Kailh_MX_1.25uSW58
1SW_dHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW62
1SW_delHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW31
1SW_downHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW66
1SW_eHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW21
1SW_enterHotswapFix:SW_Hotswap_Kailh_MX_2.25uSW69
1SW_escHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW17
1SW_fHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW35
1SW_fn1HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW57
1SW_fn2HotswapFix:SW_Hotswap_Kailh_MX_1.00uSW64
1SW_gHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW36
1SW_hHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW37
1SW_iHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW26
1SW_insHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW44
1SW_jHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW38
1SW_kHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW39
1SW_lHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW40
1SW_leftHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW65
1SW_mHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW51
1SW_nHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW50
1SW_oHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW27
1SW_pHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW28
1SW_qHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW19
1SW_rHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW22
1SW_r_shiftHotswapFix:SW_Hotswap_Kailh_MX_2.75uSW55
1SW_rightHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW68
1SW_sHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW34
1SW_shiftHotswapFix:SW_Hotswap_Kailh_MX_2.25uSW45
1SW_spaceHotswapFix:SW_Hotswap_Kailh_MX_6.25uSW63
1SW_superHotswapFix:SW_Hotswap_Kailh_MX_1.25uSW59
1SW_tHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW23
1SW_tabHotswapFix:SW_Hotswap_Kailh_MX_1.50uSW18
1SW_uHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW25
1SW_upHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW67
1SW_vHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW48
1SW_wHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW20
1SW_xHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW47
1SW_yHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW24
1SW_zHotswapFix:SW_Hotswap_Kailh_MX_1.00uSW46
1WS2812Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalJ3

The 166 most common of 182 parts.

Similar boards

  • 2 layers99.1 × 99.1 mmTangNanoDCJ11MEM, the printed circuit board in 3D

    TangNanoDCJ11MEM

    ryomuk/TangNanoDCJ11MEM

    Memory system and UART implemented on Tang Nano 20K for DEC DCJ11 PDP-11 Processor

    45 parts86MIT
  • 2 layers49.5 × 30 mmAirpcb smd old, the printed circuit board in 3D

    Airpcb smd old

    issalig/toshiba_air_cond

    AB protocol decoder for toshiba air conditioners

    30 parts65
  • 4 layers50 × 50 mmHSCanT, the printed circuit board in 3D

    HSCanT

    cherry-embedded/HSCanT-hardware

    HSCanT is a USB to 4-channel CAN FD tool designed based on the HPM5321 chip.

    130 parts52Apache-2.0
  • 2 layers230.5 × 82 mmVitamins included, the printed circuit board in 3D

    Vitamins included

    Duckle29/Vitamins-included

    This repo holds a variation of the lets split. This board requires no soldering

    214 parts49BSD-3-Clause
  • 2 layers120 × 90 mmMy babys got led, the printed circuit board in 3D

    My babys got led

    mcqn/my-babys-got-led

    Simple ESP8266 board to drive WS2812 LED strips

    51 parts18
  • 4 layers70 × 70 mmDmx, the printed circuit board in 3D

    Dmx

    versioduo/dmx

    🚥 MIDI to DMX Bridge

    63 parts18
  • 2 layers38 × 38 mmStm32f103, the printed circuit board in 3D

    Stm32f103

    VIPQualityPost/easy-esc-stm32f103-mt6701-ncp81155

    small, closed loop simpleFOC driver board, that can be assembled for <$10 with mostly basic components at LCSC. has support for current sensing and mounting WS2812 RGBLED for indicating, as well as USB C for serial…

    105 parts18

Questions

How big is the CyberKeeb2040 PCB?

It measures 308.8 × 130.3 mm and has 2 copper layers, 1.6 mm thick.

What parts does the CyberKeeb2040 use?

182 parts, built around the WS2812. 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 CyberKeeb2040 KiCad files?

From the zli117/CyberKeeb2040 repository on GitHub, at the commit this page was made from: the board is PCB/MainBoard/MainBoard.kicad_pcb and its schematic PCB/MainBoard/MainBoard.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the CyberKeeb2040 design in my own project?

Its repository publishes it under the CC-BY-SA-4.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).