2 layers28.4 × 22.6 mm
2 layers31.6 × 14.3 mm
Oneencoder
shreeyuvan2020/Onekey- Size
- 31.6 × 14.3 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 2
- Nets
- 5
- Pads
- 11
- Tracks, vias
- 12, 0
- Routed
- Yes
- KiCad
- KiCad 10.0 (file 20260206)
- Created
- 18 Apr 2026
- Updated
- 28 Aug 2026
Overview
Oneencoder is an open-source printed circuit board by shreeyuvan2020, from the shreeyuvan2020/Onekey repository on GitHub. It is a 2-layer board of 31.6 × 14.3 mm with 2 parts on 5 nets, routed with 12 tracks and 0 vias.
Its parts include 1 connector and 1 switch.
README
readme.mdThe Onekey
The one key and knob macropad(available at onekey.hackclub.com)
Features
- Sandwhich mount for constistency of feel
- Magnetic Pogo Pin connectors for easily bonding the two sides of the macropad.
- Xiao RP2040 for cost efficiency
- Neopixel for shiny
Reasons I built this
- @maxstellar on slack asked me to help with his internship project, so I did!
Schematic
These schematics are very concise, it's just a MCU, whatever input device, and magnetic pogo pin connectors(generic symbol). Plus neopixel for key. First one is encoder, second is keyswitch
PCB
I designed the encoder PCB especially with a lot of care because the pcb had to stick out enough to reach into the case of the main onekey. The pcb with the key also took some time because at first I decided hotswap, but then changed to normal switches. I then made these basically centered. Also I had to work a bit on routing for the neopixel
Keyswitch PCB
Encoder PCB
CAD
I designed the CAD with portability, usability, and elegance in mind. I also had to design it with both a cutout for the USB and pogo pin connector.
Bottom Case of Encoder
Top Plate of Encoder
Bottom Case of Keyswitch
Top Plate of Keyswitch
Encoder Assembly
Keyswitch Assembly
Full Assembly
Firmware
The whole point of this YSWS is for people to create their own firmware for a one key macropad, so I don't have firmware here.
My Zine
Zine is at zine.pdf too, that might not load properly, try using chrome. Or download it and open. It's a known github issue.
Assembly Instructions
- First, obviously fabricate the PCB and solder everything.
- Next is printing the plates and cases.
- This is pretty simple, it was designed with tolerances, you can keep it at basically whatever setting
- Put heatset inserts through the bottom of the cases
- Then just screw the pcb and the bottom case together via those
- Then put the plate on
- Put the keycap on the switch
- You have a Onekey!
BOM
Credits
This project was helped by @owais. Thanks to fallout for sponsoring this!
Parts
2| Qty | Value | Footprint | References |
|---|---|---|---|
| 1 | Conn_01x04_Pin | 829-22-003-20-001101:MILL-MAX_829-22-003-20-001101 | J1 |
| 1 | RotaryEncoder_Switch | Rotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mm | SW1 |
More from shreeyuvan2020/Onekey
1Similar boards
- 2 layers37 × 19 mm
Passive rpi hub75-adapter
hzeller/rpi-rgb-led-matrix
Controlling up to three chains of 64x64, 32x32, 16x32 or similar RGB LED displays using Raspberry Pi GPIO
2 parts4.4kGPL-2.0 - 2 layers33 × 19 mm
- 2 layers
Diode template
adamws/kicad-kbplacer
KiCad plugin for automatic keyboard's key placement and routing
2 parts547GPL-3.0 - 2 layers20.3 × 15.2 mm
L0 button
Luos-io/luos_engine
Open-source and real-time orchestrator for cyber-physical-systems, to easily design, test and deploy embedded applications and digital twins.
2 parts546MIT - 2 layers35.1 × 46.8 mm
SDEX2M2 Breakout Board
NVNTLabs/switch2-SDEX2M2
Micro SD Express to M.2 NVME Adapter for Nintendo Switch 2
2 parts542GPL-3.0 - 2 layers59.3 × 36.6 mm
ExpansionBoardTemplate
BlueSCSI/BlueSCSI-v2
BlueSCSI v2/Ultra - an open source, open hardware, SCSI emulator using the Pi Pico PR2040 and Pico 2 RP2350
2 parts459GPL-3.0 - 2 layers
Alpha.9mm.wire
ohmtech-rdi/eurorack-blocks
Software to Hardware Prototyping for Eurorack using C++, Max/Gen~ or Faust
2 parts410 - 2 layers26.7 × 64 mm
Questions
How big is the Oneencoder PCB?
It measures 31.6 × 14.3 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Oneencoder use?
2 parts. 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 Oneencoder KiCad files?
From the shreeyuvan2020/Onekey repository on GitHub, at the commit this page was made from: the board is oneencoder/PCB/oneencoder.kicad_pcb and its schematic oneencoder/PCB/oneencoder.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Oneencoder design in my own project?
Its repository states no licence, so its author keeps all rights: ask shreeyuvan2020 before reusing the design.