

Keyswitch pcb
Retro Keyboards for emulators
- Size
- 357.2 × 140.5 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 165
- Nets
- 160
- Pads
- 1,599
- Tracks, vias
- 5,462, 33
- Pours
- 68
- Routed
- Yes
- KiCad
- KiCad 7 (file 20221018)
- Created
- 11 Aug 2023
- Updated
- 17 Feb 2025
Overview
Keyswitch pcb is an open-source printed circuit board by JeremyJStarcher, from the JeremyJStarcher/retro-keys repository on GitHub. It is a 2-layer board of 357.2 × 140.5 mm with 165 parts on 160 nets, routed with 5,462 tracks and 33 vias.
It is built around the MAX7219M. Its parts include 36 diodes, 36 switches, 4 capacitors, 3 resistors and 2 ICs. It belongs with the keyboards and input and retro computing and games boards of this library.
Main components
1README
README.mdretro-keys
Retro Keyboards for Emulators
Purpose
The purpose of this project is to set up a tools to make it easier to create a custom keyboard to use retro-style computers on modern emulators.
This includes the PCB, keycaps and (in time) a case.
Better integration with QMK is planned.
Keyboard support
- Atari 800/800XL style keyboard.
Requirements
- Python 3.10
- OpenSCAD
- KiCad
- VcCode (other editors will work but may require configuration)
After clone
All of the Python scripts run in a virtual environment which will allow them to
access privately installed libraries.
Step 1 - Install Python venv
This package must be installed globally.
pip install venvStep 2 - Create the virtual environment (only needs done once after clone)
In your shell/commandline of choice, change directory to the project root py
directory.
python3 -m venv .venvStep 3 - Enter virtual environment (needs done every time you with with retro-keys)
From the py directory, enter the following command
Linux/Unix:
source .venv/bin/activateStep 4 - Install the required libraries into the virtual environment.
./py_libs.shDirectory layout
The keyboards directory contains the data required for each unique keyboard
as well as common code (and graphics) libraries that are used by all keyboards.
* `atari-a8` - Keyboard 800/800XL layout
* `c64-vic20` - C64/VIC20 keyboard (in development)
* `kicad-lib` - Graphics libraries
* `openscad` - Open SCAD libraries
* `retrologo-kb` - Fake keyboard used to generate website graphics.For each actual keyboard, the directory structure is:
* `kicad` - The KiCad project for that keyboard
* `keycaps` - The OpenSCAD scripts to generate the keyboard.It is important to note that the generated key graphics, stl and wrl files are NOT checked into the repo as they would take up a large amount of space and must be regenerated when working on that keyboard.
Working with an existing keyboard
Yet to be documented. This workflow is still somewhat reliant on a QMK script
outside the retro-keys project directory structure.
Parts
165| Qty | Value | Footprint | References |
|---|---|---|---|
| 4 | MountingHole | MountingHole:MountingHole_3.2mm_M3 | H101, H102, H103, H104 |
| 2 | 0.1uF | Capacitor_THT:C_Axial_L3.8mm_D2.6mm_P10.00mm_Horizontal | C102, C104 |
| 2 | 22K | keebio:Resistor-Hybrid | R101, R102 |
| 2 | 47uF | Capacitor_THT:CP_Radial_D5.0mm_P2.50mm | C101, C103 |
| 2 | MAX7219 | Package_DIP:DIP-24_W7.62mm_Socket_LongPads | U101, U102 |
| 1 | 0 | mx_alps:MX-1U | SW237 |
| 1 | 0 | retro-kbd:Diode-dual | D237 |
| 1 | 1 | retro-kbd:Diode-dual | D201 |
| 1 | 1 | mx_alps:MX-1U | SW201 |
| 1 | 2 | retro-kbd:Diode-dual | D202 |
| 1 | 2 | mx_alps:MX-1U | SW202 |
| 1 | 220R | keebio:Resistor-Hybrid | R103 |
| 1 | 3 | retro-kbd:Diode-dual | D203 |
| 1 | 3 | mx_alps:MX-1U | SW203 |
| 1 | 4 | mx_alps:MX-1U | SW204 |
| 1 | 4 | retro-kbd:Diode-dual | D204 |
| 1 | 5 | mx_alps:MX-1U | SW205 |
| 1 | 5 | retro-kbd:Diode-dual | D205 |
| 1 | 6 | retro-kbd:Diode-dual | D206 |
| 1 | 6 | mx_alps:MX-1U | SW206 |
| 1 | 7 | mx_alps:MX-1U | SW207 |
| 1 | 7 | retro-kbd:Diode-dual | D207 |
| 1 | 8 | mx_alps:MX-1U | SW208 |
| 1 | 8 | retro-kbd:Diode-dual | D208 |
| 1 | 9 | mx_alps:MX-1U | SW236 |
| 1 | 9 | retro-kbd:Diode-dual | D236 |
| 1 | A | retro-kbd:Diode-dual | D219 |
| 1 | A | mx_alps:MX-1U | SW219 |
| 1 | ASTRIX | mx_alps:MX-1U | SW248 |
| 1 | ASTRIX | retro-kbd:Diode-dual | D248 |
| 1 | B | mx_alps:MX-1U | SW232 |
| 1 | B | retro-kbd:Diode-dual | D232 |
| 1 | BREAK | mx_alps:MX-1U | SW241 |
| 1 | BREAK | retro-kbd:Diode-dual | D241 |
| 1 | BS | mx_alps:MX-1U | SW240 |
| 1 | BS | retro-kbd:Diode-dual | D240 |
| 1 | C | mx_alps:MX-1U | SW230 |
| 1 | C | retro-kbd:Diode-dual | D230 |
| 1 | CAPS | mx_alps:MX-1.25U | SW247 |
| 1 | CAPS | retro-kbd:Diode-dual | D247 |
| 1 | COMMA | mx_alps:MX-1U | SW235 |
| 1 | COMMA | retro-kbd:Diode-dual | D235 |
| 1 | CONTROL | retro-kbd:Diode-dual | D218 |
| 1 | CONTROL | mx_alps:MX-2U | SW218 |
| 1 | C_DOWN | mx_alps:MX-1U | SW260 |
| 1 | C_DOWN | retro-kbd:Diode-dual | D260 |
| 1 | C_LEFT | mx_alps:MX-1U | SW259 |
| 1 | C_LEFT | retro-kbd:Diode-dual | D259 |
| 1 | C_RIGHT | retro-kbd:Diode-dual | D261 |
| 1 | C_RIGHT | mx_alps:MX-1U | SW261 |
| 1 | C_UP | retro-kbd:Diode-dual | D246 |
| 1 | C_UP | mx_alps:MX-1U | SW246 |
| 1 | D | mx_alps:MX-1U | SW221 |
| 1 | D | retro-kbd:Diode-dual | D221 |
| 1 | DASH | retro-kbd:Diode-dual | D244 |
| 1 | DASH | mx_alps:MX-1U | SW244 |
| 1 | Development Connector | Connector_PinSocket_2.54mm:PinSocket_2x20_P2.54mm_Vertical | J102 |
| 1 | E | retro-kbd:Diode-dual | D212 |
| 1 | E | mx_alps:MX-1U | SW212 |
| 1 | EQUAL | retro-kbd:Diode-dual | D252 |
| 1 | EQUAL | mx_alps:MX-1U | SW252 |
| 1 | ESC | mx_alps:MX-1.25U | SW200 |
| 1 | ESC | retro-kbd:Diode-dual | D200 |
| 1 | F | retro-kbd:Diode-dual | D222 |
| 1 | F | mx_alps:MX-1U | SW222 |
| 1 | FN | mx_alps:MX-1U | SW255 |
| 1 | FN | retro-kbd:Diode-dual | D255 |
| 1 | G | retro-kbd:Diode-dual | D223 |
| 1 | G | mx_alps:MX-1U | SW223 |
| 1 | GT | retro-kbd:Diode-dual | D239 |
| 1 | GT | mx_alps:MX-1U | SW239 |
| 1 | H | retro-kbd:Diode-dual | D224 |
| 1 | H | mx_alps:MX-1U | SW224 |
| 1 | HELP | mx_alps:MX-1.25U | SW265 |
| 1 | HELP | retro-kbd:Diode-dual | D265 |
| 1 | I | mx_alps:MX-1U | SW217 |
| 1 | I | retro-kbd:Diode-dual | D217 |
| 1 | I2C DISPLAY | Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_Horizontal | J103 |
| 1 | INV | retro-kbd:Diode-dual | D245 |
| 1 | INV | mx_alps:MX-1U | SW245 |
The 87 most common of 165 parts.
More from JeremyJStarcher/retro-keys
3- 2 layers180.3 × 27.9 mm

- 2 layers180.3 × 27.9 mm

- 2 layers

Similar boards
- 2 layers181 × 97 mm

OpenDeck r3.1.2
shanteacontrols/OpenDeck
A platform for building interactive control and sensing devices using MIDI and OSC built with Zephyr RTOS.
262 parts960Apache-2.0 - 2 layers482.6 × 35.6 mm

- 2 layers85.6 × 41 mm

Hl alyx glove
StarGate01/hl-alyx-glove
Firmware and Hardware for a Half-Life: Alyx Gravity Glove Replica
38 parts21MIT - 2 layers191.8 × 48.4 mm

- 2 layers542.3 × 27.3 mm

Glowboardng
Eigenbaukombinat/glowboard
The Glowboard Plotter plots images using 64 UV LEDs attached in a line moved over a 120cmx60cm glow-in-the-dark sheet by a stepper.
69 parts6 - 2 layers70 × 50.1 mm

- 2 layers91.4 × 119.4 mm

- 2 layers142.2 × 64.4 mm

Questions
How big is the Keyswitch pcb PCB?
It measures 357.2 × 140.5 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Keyswitch pcb use?
165 parts, built around the MAX7219M. 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 Keyswitch pcb KiCad files?
From the JeremyJStarcher/retro-keys repository on GitHub, at the commit this page was made from: the board is keyboards/atari-a8/kicad/keyswitch_pcb/keyswitch_pcb.kicad_pcb and its schematic keyboards/atari-a8/kicad/controller-pico/controller-pico.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Keyswitch pcb design in my own project?
Its repository states no licence, so its author keeps all rights: ask JeremyJStarcher before reusing the design.