Skip to the content
2 layers90 × 98 mmGbc handheld, the printed circuit board in 3D

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

Automated PCB toolchain

One script sets up a headless, scriptable PCB workflow on Ubuntu 24.04 (x86_64):

ToolPurpose
KiCad 9.0 (PCBNew, kicad-cli)Board editor, DRC, Gerber/drill export, Python pcbnew API
SKiDlDescribe circuits in Python, emit KiCad netlists
Fabrication Toolkit (Benny Megidish)JLCPCB-ready Gerber / BOM / CPL output
FreeroutingHeadless autorouter (Specctra DSN in, SES out)

Install

bash
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 only

The script is idempotent. Open a new shell afterwards (or source /etc/profile.d/eda.sh).

Pipeline

text
SKiDl script ──► netlist ──► PCBNew (place, outline) ──► DSN ──► Freerouting ──► SES
                                                                                  │
                        JLCPCB files ◄── Fabrication Toolkit ◄── routed .kicad_pcb ◄┘

Route a board headless:

bash
freerouting -de board.dsn -do board.ses --gui.enabled=false

Gotchas this script already handles

  • SKiDl defaults to KiCad 10 mode; scripts must call set_default_tool(KICAD9).
  • SKiDl needs KICAD9_SYMBOL_DIR and KiCad's global fp-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 interpreter pcbnew is 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):

bash
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.net

Or 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
QtyValueFootprintReferences
4MountingHole_3.2mm_M3_PadMountingHole_3.2mm_M3_PadH1, H2, H3, H4
2100uFCapacitor_THT:CP_Radial_D5.0mm_P2.50mmC_AMP, C_BULK
21kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR_BL, R_LED
1100nFCapacitor_THT:C_Disc_D5.0mm_W2.5mm_P5.00mmC_HF
115kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR_S1
12.8in ILI9341 (MSP2807)Connector_PinSocket_2.54mm:PinSocket_1x14_P2.54mm_VerticalJ_LCD
122kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR_S2
1ESP32-S3-DevKitC-1 J1Connector_PinSocket_2.54mm:PinSocket_1x22_P2.54mm_VerticalJ1
1ESP32-S3-DevKitC-1 J3Connector_PinSocket_2.54mm:PinSocket_1x22_P2.54mm_VerticalJ3
1LED 3mmLED_THT:LED_D3.0mmD_STATUS
1MAX98357A: LRC BCLK DIN GAIN SD GND VINConnector_PinSocket_2.54mm:PinSocket_1x07_P2.54mm_VerticalJ_AMP
1Power (slide)gbc:SW_Slide_SS12D00G3SW_PWR
1SD wires: CS MOSI MISO SCKConnector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ_SD
1SW_AButton_Switch_THT:SW_PUSH_6mmSW5
1SW_BButton_Switch_THT:SW_PUSH_6mmSW6
1SW_DOWNButton_Switch_THT:SW_PUSH_6mmSW2
1SW_LEFTButton_Switch_THT:SW_PUSH_6mmSW3
1SW_RIGHTButton_Switch_THT:SW_PUSH_6mmSW4
1SW_SELECTButton_Switch_THT:SW_PUSH_6mmSW8
1SW_STARTButton_Switch_THT:SW_PUSH_6mmSW7
1SW_UPButton_Switch_THT:SW_PUSH_6mmSW1

Similar boards

  • 2 layers57.3 × 19 mm11ua, the printed circuit board in 3D

    11ua

    rene-dev/stmbl

    AC Servo Driver for STM32F4

    26 parts990GPL-3.0
  • 2 layers98 × 59.5 mmMCP23017 PCB, the printed circuit board in 3D

    MCP23017 PCB

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    26 parts915
  • 2 layers142.9 × 98.5 mmCantor MX, the printed circuit board in 3D

    Cantor MX

    diepala/cantor

    Cantor keyboard, a 42 key diodeless split keyboard.

    26 parts756GPL-3.0
  • 2 layers103.8 × 50 mmGalagino pcb set, the printed circuit board in 3D

    Galagino pcb set

    harbaum/galagino

    A Galaga, Pac-Man and Donkey Kong arcade emulator for the ESP32

    26 parts558
  • 2 layers20.3 × 34.8 mmL0 ESP32, the printed circuit board in 3D

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

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

    Doj v2

    kelu124/echomods

    Open source ultrasound processing modules and building blocks

    26 parts463

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.