

Tutorial
Small and simple mechanical gamepad/macropad.
- Size
- 95.3 × 71.4 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 26
- Nets
- 34
- Pads
- 119
- Tracks, vias
- 152, 0
- Routed
- Yes
- KiCad
- KiCad 5 (file 20171130)
- Created
- 8 Jul 2019
- Updated
- 24 Dec 2019
Overview
Tutorial is an open-source printed circuit board by Pimentoso, from the Pimentoso/Paddino02 repository on GitHub, published under the GPL-3.0 licence. It is a 2-layer board of 95.3 × 71.4 mm with 26 parts on 34 nets, routed with 152 tracks and 0 vias.
It belongs with the keyboards and input boards and the AVR (ATmega, ATtiny) boards of this library.
README
README.mdPaddino02
10-keys DIY mechanical macropad/gamepad. Features staggered columns, 2 thumb keys, symmetric PCB (you can build right-handed and left-handed versions with the same PCB). Intended to use with QMK firmware.

What you need
- a Paddino02 PCB. I suggest ordering it at JLCPCB, you can get 5 PCBs for just $2. Instructions for ordering below.
- an Arduino Pro Micro. Aliexpress link https://www.aliexpress.com/item/32849563958.html
- x10 1N4148 diodes. Aliexpress link https://www.aliexpress.com/item/32804799676.html
- x10 mechanical keyboard switches of your choice. Aliexpress link https://www.aliexpress.com/item/32679823499.html
- x10 keycaps. Aliexpress link https://www.aliexpress.com/item/32850729893.html
- Access to a soldering iron
- Access to a 3d printer
- x5 small M2 screws, 5mm long or so.
- Optional adhesive rubber feets.
Building the pad
- solder the 10 diodes. The black heads of the diodes must be oriented towards the square-marked holes in the PCB.
- solder the header pins.
- solder the Pro Micro. Either you are building the right or left version, the USB port side must face the PCB.
- cut away the excess of the header pins using pliers/nippers.
- print a plate and snap the switches into the holes.
- insert the switches pins into the PCB and solder them in.
- flash the firmware (see next section).
- print a case and screw the two parts together.
Some PCBs. The white ones are from the first revision, they're just in the pic for show.
Pro Micro soldered with header pins. The pins are too long and need to be snipped.
Plate with blue switches snapped in place.
PCB joined with plate.
Right and left versions.
Finished pads (first revision)
Finished pad (second revision). Compared to the first revision, the screw holes are hidden between the switches.
Flashing the firmware
The firmware folder contains the keymap .json files and firmware .hex files for both the right and left handed versions.
Editing the keymap
The provided keymap files are very basic, and the second layer is empty. So some customization is recommended.
To edit the keys, you have to load the .json file into https://kbfirmware.com/, configure the keys as you like, and compile a .hex file directly from the site. You can then flash the .hex file on the pad using avrdude.
Flashing
The easiest way is to install QMK Toolbox
Connect your pad to USB, enter programming mode, select the .hex file into QMK Toolbox, and flash.
To enter programming mode, use the hole on the bottom of the case. You can stick a bent clip/screwdriver into it to short the RESET and GROUND pins of the Pro Micro. (There are actually 2 holes, because in the right-handed version the Pro Micro is flipped and the pins are on the other side)
Keyboard Layout Editor links
- http://www.keyboard-layout-editor.com/#/gists/999c722bfd1635b06a1ac5182787ecb8 (left handed version)
- http://www.keyboard-layout-editor.com/#/gists/7b56ab607e70723b96f63006d65ebe46 (right handed version)
Ordering the PCB
Head over to https://jlcpcb.com/quote and upload the gerber.zip file, located inside the kicad/gerber folder. The default options are good (you can change the color for swag). Just make sure PCB Thickness is set to 1.6.
Since the PCB is smaller than 100mm, the cost will be $2 for 5 of them, and shipping will be free if it's your first order.
License
This project is licensed under the GPLv3 License - see the LICENSE.md file for details
Parts
26| Qty | Value | Footprint | References |
|---|---|---|---|
| 10 | 1N4148 | Diode_THT:D_DO-35_SOD27_P7.62mm_Horizontal | D0, D1, D2, D3, D4, D5, D6, D7, D8, D9 |
| 10 | MX-NoLED | keyswitches:MX_reversible | MX0, MX1, MX2, MX3, MX4, MX5, MX6, MX7, MX8, MX9 |
| 5 | MountingHole | MountingHole:MountingHole_2.2mm_M2 | H0, H1, H2, H3, H4 |
| 1 | ProMicro | keebio:ArduinoProMicro | ProMicro1 |
Similar boards
- 2 layers57.3 × 19 mm

- 2 layers98 × 59.5 mm

MCP23017 PCB
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
26 parts915 - 2 layers142.9 × 98.5 mm

- 2 layers86.1 × 86.1 mm

- 2 layers103.8 × 50 mm

Galagino pcb set
harbaum/galagino
A Galaga, Pac-Man and Donkey Kong arcade emulator for the ESP32
26 parts558 - 2 layers20.3 × 34.8 mm

L0 ESP32
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.
26 parts546MIT - 2 layers40.6 × 50.8 mm

WALTsm
google/walt
A device for measuring latency of physical sensors and outputs on phones and computers
26 parts474Apache-2.0 - 2 layers158.5 × 75 mm

Questions
How big is the Tutorial PCB?
It measures 95.3 × 71.4 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Tutorial use?
26 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 Tutorial KiCad files?
From the Pimentoso/Paddino02 repository on GitHub, at the commit this page was made from: the board is kicad/tutorial.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.
Can I use the Tutorial design in my own project?
Its repository publishes it under the GPL-3.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).