Skip to the content
2 layers357.2 × 140.5 mmKeyswitch pcb, the printed circuit board in 3D

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

1

README

README.md

retro-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.

text
pip install venv

Step 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.

text
python3 -m venv .venv

Step 3 - Enter virtual environment (needs done every time you with with retro-keys)

From the py directory, enter the following command

Linux/Unix:

text
source .venv/bin/activate

Step 4 - Install the required libraries into the virtual environment.

text
./py_libs.sh

Directory 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.

text
* `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:

text
* `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
QtyValueFootprintReferences
4MountingHoleMountingHole:MountingHole_3.2mm_M3H101, H102, H103, H104
20.1uFCapacitor_THT:C_Axial_L3.8mm_D2.6mm_P10.00mm_HorizontalC102, C104
222Kkeebio:Resistor-HybridR101, R102
247uFCapacitor_THT:CP_Radial_D5.0mm_P2.50mmC101, C103
2MAX7219Package_DIP:DIP-24_W7.62mm_Socket_LongPadsU101, U102
10mx_alps:MX-1USW237
10retro-kbd:Diode-dualD237
11retro-kbd:Diode-dualD201
11mx_alps:MX-1USW201
12retro-kbd:Diode-dualD202
12mx_alps:MX-1USW202
1220Rkeebio:Resistor-HybridR103
13retro-kbd:Diode-dualD203
13mx_alps:MX-1USW203
14mx_alps:MX-1USW204
14retro-kbd:Diode-dualD204
15mx_alps:MX-1USW205
15retro-kbd:Diode-dualD205
16retro-kbd:Diode-dualD206
16mx_alps:MX-1USW206
17mx_alps:MX-1USW207
17retro-kbd:Diode-dualD207
18mx_alps:MX-1USW208
18retro-kbd:Diode-dualD208
19mx_alps:MX-1USW236
19retro-kbd:Diode-dualD236
1Aretro-kbd:Diode-dualD219
1Amx_alps:MX-1USW219
1ASTRIXmx_alps:MX-1USW248
1ASTRIXretro-kbd:Diode-dualD248
1Bmx_alps:MX-1USW232
1Bretro-kbd:Diode-dualD232
1BREAKmx_alps:MX-1USW241
1BREAKretro-kbd:Diode-dualD241
1BSmx_alps:MX-1USW240
1BSretro-kbd:Diode-dualD240
1Cmx_alps:MX-1USW230
1Cretro-kbd:Diode-dualD230
1CAPSmx_alps:MX-1.25USW247
1CAPSretro-kbd:Diode-dualD247
1COMMAmx_alps:MX-1USW235
1COMMAretro-kbd:Diode-dualD235
1CONTROLretro-kbd:Diode-dualD218
1CONTROLmx_alps:MX-2USW218
1C_DOWNmx_alps:MX-1USW260
1C_DOWNretro-kbd:Diode-dualD260
1C_LEFTmx_alps:MX-1USW259
1C_LEFTretro-kbd:Diode-dualD259
1C_RIGHTretro-kbd:Diode-dualD261
1C_RIGHTmx_alps:MX-1USW261
1C_UPretro-kbd:Diode-dualD246
1C_UPmx_alps:MX-1USW246
1Dmx_alps:MX-1USW221
1Dretro-kbd:Diode-dualD221
1DASHretro-kbd:Diode-dualD244
1DASHmx_alps:MX-1USW244
1Development ConnectorConnector_PinSocket_2.54mm:PinSocket_2x20_P2.54mm_VerticalJ102
1Eretro-kbd:Diode-dualD212
1Emx_alps:MX-1USW212
1EQUALretro-kbd:Diode-dualD252
1EQUALmx_alps:MX-1USW252
1ESCmx_alps:MX-1.25USW200
1ESCretro-kbd:Diode-dualD200
1Fretro-kbd:Diode-dualD222
1Fmx_alps:MX-1USW222
1FNmx_alps:MX-1USW255
1FNretro-kbd:Diode-dualD255
1Gretro-kbd:Diode-dualD223
1Gmx_alps:MX-1USW223
1GTretro-kbd:Diode-dualD239
1GTmx_alps:MX-1USW239
1Hretro-kbd:Diode-dualD224
1Hmx_alps:MX-1USW224
1HELPmx_alps:MX-1.25USW265
1HELPretro-kbd:Diode-dualD265
1Imx_alps:MX-1USW217
1Iretro-kbd:Diode-dualD217
1I2C DISPLAYConnector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_HorizontalJ103
1INVretro-kbd:Diode-dualD245
1INVmx_alps:MX-1USW245

The 87 most common of 165 parts.

More from JeremyJStarcher/retro-keys

3
  • 2 layers180.3 × 27.9 mmController pro micro, the printed circuit board in 3D

    Controller pro micro

    JeremyJStarcher/retro-keys

    Retro Keyboards for emulators

    20 parts
  • 2 layers180.3 × 27.9 mmController pico, the printed circuit board in 3D

    Controller pico

    JeremyJStarcher/retro-keys

    Retro Keyboards for emulators

    16 parts
  • 2 layersLogo, the printed circuit board in 3D

    Logo

    JeremyJStarcher/retro-keys

    Retro Keyboards for emulators

    14 parts

Similar boards

  • 2 layers181 × 97 mmOpenDeck r3.1.2, the printed circuit board in 3D

    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 mmPrecision clock, the printed circuit board in 3D

    Precision clock

    mitxela/PrecisionClock-Hardware

    PCB design for the Precision Clock Mk III

    49 parts41
  • 2 layers85.6 × 41 mmHl alyx glove, the printed circuit board in 3D

    Hl alyx glove

    StarGate01/hl-alyx-glove

    Firmware and Hardware for a Half-Life: Alyx Gravity Glove Replica

    38 parts21MIT
  • 2 layers542.3 × 27.3 mmGlowboardng, the printed circuit board in 3D

    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 mmDoom clock, the printed circuit board in 3D

    Doom clock

    stecman/avr-doomclock

    GPS clock on an ATTiny with MAX7219 7-segment driver

    24 parts5MIT
  • 2 layers91.4 × 119.4 mmPainel pcb1, the printed circuit board in 3D

    Painel pcb1

    ArqueologiaDigital/PatinhoFeio_Painel_KICAD

    63 parts4
  • 2 layers142.2 × 64.4 mmFcu mb, the printed circuit board in 3D

    Fcu mb

    VirtualGit/HomeCockpitA320

    A320 Home Cockpit project

    69 parts4

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.