

Gbc handheld
5376455
- Size
- 90 × 98 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 26
- Nets
- 28
- Pads
- 124
- Tracks, vias
- 210, 3
- Pours
- 2
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 26 Aug 2026
- Updated
- 5 Nov 2026
Overview
Gbc handheld is an open-source printed circuit board by stpdgse, from the stpdgse/646464747447 repository on GitHub. It is a 2-layer board of 90 × 98 mm with 26 parts on 28 nets, routed with 210 tracks and 3 vias.
Its parts include 8 switches and 2 connectors. It belongs with the ESP32 boards of this library.
README
README.mdAutomated PCB toolchain
One script sets up a headless, scriptable PCB workflow on Ubuntu 24.04 (x86_64):
| Tool | Purpose |
|---|---|
KiCad 9.0 (PCBNew, kicad-cli) | Board editor, DRC, Gerber/drill export, Python pcbnew API |
| SKiDl | Describe circuits in Python, emit KiCad netlists |
| Fabrication Toolkit (Benny Megidish) | JLCPCB-ready Gerber / BOM / CPL output |
| Freerouting | Headless autorouter (Specctra DSN in, SES out) |
Install
sudo ./setup-eda.sh # install everything, then run the smoke test
sudo ./setup-eda.sh --no-test # install only
sudo ./setup-eda.sh --test # smoke test onlyThe script is idempotent. Open a new shell afterwards (or source /etc/profile.d/eda.sh).
Pipeline
SKiDl script ──► netlist ──► PCBNew (place, outline) ──► DSN ──► Freerouting ──► SES
│
JLCPCB files ◄── Fabrication Toolkit ◄── routed .kicad_pcb ◄┘Route a board headless:
freerouting -de board.dsn -do board.ses --gui.enabled=falseGotchas this script already handles
- SKiDl defaults to KiCad 10 mode; scripts must call
set_default_tool(KICAD9). - SKiDl needs
KICAD9_SYMBOL_DIRand KiCad's globalfp-lib-table, which KiCad only creates on first GUI launch. The script sets both up. - SKiDl's dependencies fail to build with the distro's patched pip, so it lives in a venv
(
/opt/eda/venv) on the system Python 3.12, which is the interpreterpcbnewis built for. - Freerouting 2.4.1 needs Java 25; the default Java 21 fails with
UnsupportedClassVersionError. - The Fabrication Toolkit download is verified against the SHA-256 published in KiCad's plugin index before it is installed.
Game Boy Color-style handheld (practice board)
A beginner-solderable, all through-hole handheld: ESP32-S3-DevKitC-1 on the underside, a 2.8"
ILI9341 LCD, 8 buttons, an I2S amplifier module. Board v0.3 is 90 x 98 mm (inside JLCPCB's cheapest
size tier). Full requirements and every verified fact: docs/gbc-handheld-spec.md.
Build and soldering instructions: gbc-handheld/ASSEMBLY.md. Shopping list: gbc-handheld/build/BOM.md.
Rebuild everything from source (after sudo ./setup-eda.sh):
source /etc/profile.d/eda.sh
python3 gbc-handheld/schematic.py # SKiDl -> netlist, ERC
python3 -I gbc-handheld/verify_netlist.py gbc-handheld/build/gbc_handheld.net
python3 gbc-handheld/build_board.py route # place, autoroute, fix thermals
python3 gbc-handheld/verify_board.py # board vs netlist, fab limits
kicad-cli pcb drc --severity-all --all-track-errors --output /tmp/drc.rpt gbc-handheld/build/gbc_handheld.kicad_pcb
python3 -I gbc-handheld/make_bom.py gbc-handheld/build/gbc_handheld.netOr run every check, the fab export, BOM and all pictures in one go: gbc-handheld/check_all.sh
(audit results and what each check proves: docs/gbc-handheld-spec.md, section 15).
Nothing here has been tested on real hardware yet.
Parts
26| Qty | Value | Footprint | References |
|---|---|---|---|
| 4 | MountingHole_3.2mm_M3_Pad | MountingHole_3.2mm_M3_Pad | H1, H2, H3, H4 |
| 2 | 100uF | Capacitor_THT:CP_Radial_D5.0mm_P2.50mm | C_AMP, C_BULK |
| 2 | 1k | Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_Horizontal | R_BL, R_LED |
| 1 | 100nF | Capacitor_THT:C_Disc_D5.0mm_W2.5mm_P5.00mm | C_HF |
| 1 | 15k | Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_Horizontal | R_S1 |
| 1 | 2.8in ILI9341 (MSP2807) | Connector_PinSocket_2.54mm:PinSocket_1x14_P2.54mm_Vertical | J_LCD |
| 1 | 22k | Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_Horizontal | R_S2 |
| 1 | ESP32-S3-DevKitC-1 J1 | Connector_PinSocket_2.54mm:PinSocket_1x22_P2.54mm_Vertical | J1 |
| 1 | ESP32-S3-DevKitC-1 J3 | Connector_PinSocket_2.54mm:PinSocket_1x22_P2.54mm_Vertical | J3 |
| 1 | LED 3mm | LED_THT:LED_D3.0mm | D_STATUS |
| 1 | MAX98357A: LRC BCLK DIN GAIN SD GND VIN | Connector_PinSocket_2.54mm:PinSocket_1x07_P2.54mm_Vertical | J_AMP |
| 1 | Power (slide) | gbc:SW_Slide_SS12D00G3 | SW_PWR |
| 1 | SD wires: CS MOSI MISO SCK | Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_Vertical | J_SD |
| 1 | SW_A | Button_Switch_THT:SW_PUSH_6mm | SW5 |
| 1 | SW_B | Button_Switch_THT:SW_PUSH_6mm | SW6 |
| 1 | SW_DOWN | Button_Switch_THT:SW_PUSH_6mm | SW2 |
| 1 | SW_LEFT | Button_Switch_THT:SW_PUSH_6mm | SW3 |
| 1 | SW_RIGHT | Button_Switch_THT:SW_PUSH_6mm | SW4 |
| 1 | SW_SELECT | Button_Switch_THT:SW_PUSH_6mm | SW8 |
| 1 | SW_START | Button_Switch_THT:SW_PUSH_6mm | SW7 |
| 1 | SW_UP | Button_Switch_THT:SW_PUSH_6mm | SW1 |
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 Gbc handheld PCB?
It measures 90 × 98 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Gbc handheld 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 Gbc handheld KiCad files?
From the stpdgse/646464747447 repository on GitHub, at the commit this page was made from: the board is gbc-handheld/build/gbc_handheld.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.
Can I use the Gbc handheld design in my own project?
Its repository states no licence, so its author keeps all rights: ask stpdgse before reusing the design.