Skip to the content
4 layers100 × 60 mmPikocore gamepad, the printed circuit board in 3D

Pikocore gamepad

sebasdv/pikocore_gamepad

Fork of pikocore ported to run on the Waveshare RP2350-PiZero + GamePi13 handheld — full-color LCD dashboard, 12-button menu, and save/load state on a lo-fi sampler that was originally knob-only.

Size
100 × 60 mm
Copper layers
4
Thickness
1.6 mm
Parts
76
Nets
76
Pads
312
Tracks, vias
656, 134
Pours
7
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
27 Sep 2026
Updated
5 Nov 2026

Overview

Pikocore gamepad is an open-source printed circuit board by sebasdv, from the sebasdv/pikocore_gamepad repository on GitHub, published under the MIT licence. It is a 4-layer board of 100 × 60 mm with 76 parts on 76 nets, routed with 656 tracks and 134 vias.

It is built around the PT2308-S, H11L1SR2M and SN74LVC1G17DCKR, with the 1N4148W among its other parts. Its parts include 27 capacitors, 21 resistors, 13 switches, 7 ICs and 5 connectors. It belongs with the keyboards and input and lEDs and displays boards and the RP2350 boards of this library.

Main components

4

README

README.md

pikocore GamePi13 boot splash

pikocore — RP2350-PiZero + GamePi13 port

A community port of pikocore, the hackable open-source lo-fi sampler, to run on the Waveshare RP2350-PiZero paired with the GamePi13 handheld HAT — trading the original's bare-bones potentiometer interface for a 240×240 color LCD dashboard and a 12-button game-console layout.

This is an independent fork, not officially affiliated with the original pikocore project or with Waveshare.

What's different from stock pikocore

  • Full-color 240×240 LCD dashboard — BPM, clock source, sample name/index, live waveform with playhead and per-slice highlighting, the active parameter's value as a segmented bar, and the current mode.
  • 12 physical buttons (D-pad + Y/X/B/A + Select/Start/L/R) replace the original's 8 buttons + 3 potentiometers, with a full on-screen menu system to reach every parameter without needing analog knobs.
  • Save/Load device state to flash — one persisted slot covering every parameter, the sequencer pattern, and each mode's own knob position, with on-screen save/load confirmation icons.
  • Onboard step sequencer with visible record/play/clear feedback instead of a blind knob.
  • USB bank-loader web app (React + Vite, in web/) to build .pikobank files from your own samples and load them straight over USB.
  • MIDI clock and transport over USB — start, stop, continue and clock from a computer or phone sync the sequencer, in either clock-input mode.
  • microSD .pikobank browsing exists in the codebase but ships disabled by default behind a build flag (PIKO_GAMEPI13_SD) — see GAMEPI13-INTERFACE.md for why.

All of the original pikocore's audio engine — sample playback, slicing, retrigger/ stutter, probability-driven jump/gate/reverse/tunnel effects, filter, timestretch — is untouched; this port only adds the screen, the button-driven menu, and the persistence layer around it.

Hardware

  • Waveshare RP2350-PiZero — RP2350B, dual Cortex-M33/Hazard3, 520KB SRAM, 16MB flash, Pi Zero form factor.
  • Waveshare GamePi13 — 1.3" 240×240 ST7789 LCD, 12-button handheld HAT, onboard speaker/headphone jack.
  • microSD card (optional, FAT32) — only needed if you rebuild with PIKO_GAMEPI13_SD=ON.

Building

text
mkdir -p build-gamepi && cd build-gamepi
cmake -DPICO_SDK_PATH=../pico-sdk -DPIKO_GAMEPI13=ON ..
make -j4

Flash build-gamepi/pikocore.uf2 (hold BOOTSEL while plugging in USB).

The original, unmodified stock-hardware build (potentiometers, no LCD) still works from the same tree — see the upstream build instructions below. The custom carrier-PCB variant (RP2350-Plus + I2S DAC) builds with -DPIKO_GAMEPAD=ON instead — see hardware/pikocore_gamepad/README.md.

Loading samples

Use the loader at sebasdv.github.io/pikocore_gamepad — no local server needed, just open it in a browser that supports Web Serial (Chrome/Edge).

Build a bank from your own samples and either load it straight over USB, or use the "Download bank" button to produce a .pikobank file for a microSD card (if built with SD support).

To run the loader locally instead (e.g. for development):

text
cd web && npm install && npm run dev

Controls

ControlFunction
D-pad + Y/X/B/Apikocore's 8 music buttons
Selectcycle parameter mode (tap), or hold + a music button to jump directly to that mode
L / Rdecrease/increase the active parameter (Function A); hold to repeat
Start (tap)mute / start-stop
Start (hold) + L/Redit Function B instead of Function A
Up+Down+B+Areset FX (filter, distortion, all probabilities)
Down+Left+X+Btoggle clock lock

Full mode table, per-button behavior, retrigger mechanics, and every hardware finding from bring-up are in GAMEPI13-INTERFACE.md (Spanish). Build/flash/pinout quick reference: README-GAMEPI13.md (Spanish).

Upstream pikocore

For the original potentiometer-based hardware, schematic, BOM, and firmware releases, see the upstream project:

text
SAMPLE_RATE=31000 make

(make build2 if you're on a 2MB Pico; the default targets 16MB.) See the upstream README for the full prerequisites list (make prereqs).

Acknowledgments

This port stands entirely on other people's work:

  • Zack Scholl (infinitedigits.co) — created pikocore, the sampler engine this whole project is built on. pikocore is the deliberately minimal, cheap sibling of his larger zeptocore sampler; both descend from the same _core lineage.
  • Waveshare — designed the RP2350-PiZero board and the GamePi13 HAT this port targets. The vendored LCD driver (src/gamepi13/lcd/) and board files (RP2350-PiZero/, Gamepi13-RP2040-Demo/) are adapted from Waveshare's own demo code for this hardware.
  • Raspberry Pi Foundation — the Pico SDK this firmware (and the RP2350) builds on.
  • carlk3 — the microSD FatFS driver used for the (currently parked) SD bank-browsing mode, itself built on ChaN's FatFs, an SPI block-device driver derived from Mbed OS 5's SDBlockDevice, and an SDIO driver derived from ZuluSCSI-firmware.
  • Raspberry Pi (Trading) Ltd and ForsakenNGS — the WS2812 driver (doth/WS2812.cpp), inherited from upstream pikocore under its original BSD-3-Clause / GPL-3 dual attribution (see the file header).
  • andrewikenberry and Jacob Vosmaer — the one-wire MIDI implementation (doth/onewiremidi.h), MIT licensed, inherited from upstream pikocore.
  • ittybittymidi — the MIDI clock-in hardware pikocore's MIDI_IN_ENABLED build option targets.
  • Lopaka — the pixel-art tool used to design every LCD UI bitmap in this port (digits, mode labels, icons, splash screen).

License

MIT — see LICENSE. Some vendored third-party components carry their own licenses; see the file headers under doth/ and the Acknowledgments section above.

Parts

76
QtyValueFootprintReferences
8100nFCapacitor_SMD:C_0603_1608MetricC7, C10, C11, C13, C15, C20, C27, C56
610kResistor_SMD:R_0603_1608MetricR9, R10, R12, R14, R16, R17
510uFCapacitor_SMD:C_0603_1608MetricC4, C12, C14, C16, C29
41uFCapacitor_SMD:C_0603_1608MetricC21, C22, C25, C26
44.7kResistor_SMD:R_0603_1608MetricR18, R19, R20, R43
322uFCapacitor_SMD:C_0805_2012MetricC5, C6, C28
22.2nFCapacitor_SMD:C_0603_1608MetricC17, C18
22.2uFCapacitor_SMD:C_0603_1608MetricC8, C9
22.2uHInductor_SMD:L_1210_3225MetricL1, L2
220kResistor_SMD:R_0603_1608MetricR11, R13
2470RResistor_SMD:R_0603_1608MetricR7, R8
2470uFCapacitor_SMD:CP_Elec_6.3x5.4C23, C24
1100kResistor_SMD:R_0603_1608MetricR6
1100uFCapacitor_SMD:C_1206_3216MetricC19
110RResistor_SMD:R_0603_1608MetricR41
11N4148WDiode_SMD:D_SOD-123D3
1200kResistor_SMD:R_0603_1608MetricR4
1220RResistor_SMD:R_0603_1608MetricR42
127kResistor_SMD:R_0603_1608MetricR5
133RResistor_SMD:R_0603_1608MetricR40
147kResistor_SMD:R_0603_1608MetricR15
1BTN_AButton_Switch_THT:SW_PUSH_6mmSW7
1BTN_BButton_Switch_THT:SW_PUSH_6mmSW8
1BTN_LButton_Switch_THT:SW_Tactile_SPST_Angled_PTS645Vx39-2LFSSW9
1BTN_RButton_Switch_THT:SW_Tactile_SPST_Angled_PTS645Vx39-2LFSSW10
1BTN_SELECTButton_Switch_THT:SW_PUSH_6mmSW12
1BTN_STARTButton_Switch_THT:SW_PUSH_6mmSW11
1BTN_XButton_Switch_THT:SW_PUSH_6mmSW5
1BTN_YButton_Switch_THT:SW_PUSH_6mmSW6
1DPAD_DOWNButton_Switch_THT:SW_PUSH_6mmSW2
1DPAD_LEFTButton_Switch_THT:SW_PUSH_6mmSW3
1DPAD_RIGHTButton_Switch_THT:SW_PUSH_6mmSW4
1DPAD_UPButton_Switch_THT:SW_PUSH_6mmSW1
1H11L1SR2MPackage_DIP:SMDIP-6_W7.62mmU10
1MIDI INConnector_Audio:Jack_3.5mm_CUI_SJ1-3535NG_HorizontalJ6
1MIDI OUTConnector_Audio:Jack_3.5mm_CUI_SJ1-3535NG_HorizontalJ7
1PAM8302Agamesetup_lcsc:MSOP-8_L3.0-W3.0-P0.65-LS5.0-BLU4
1PCM5102APWRgamesetup_lcsc:TSSOP-20_L6.5-W4.4-P0.65-LS6.4-BLU5
1PHONESConnector_Audio:Jack_3.5mm_CUI_SJ1-3535NG_HorizontalJ1
1PT2308-SPackage_SO:SOIC-8_3.9x4.9mm_P1.27mmU3
1PWRgamesetup_lcsc:SW-TH_SK12D07VG3SW15
1RP2350-Plus-16MBgamesetup_fp:RP2350-Plus_CastellatedU1
1SN74LVC1G17DCKRPackage_TO_SOT_SMD:SOT-353_SC-70-5U9
1SPEAKER 8RConnector_JST:JST_PH_B2B-PH-K_1x02_P2.00mm_VerticalJ5
1ST7789_240x240gamesetup_fp:LCD_ST7789_240x240_7PJ4
1TPS61023DRLRPackage_TO_SOT_SMD:SOT-563U2

Similar boards

  • 2 layers24.5 × 15.2 mmMidi io, the printed circuit board in 3D

    Midi io

    Harvie/Designs

    Plans of physical things that i've designed

    13 parts3
  • 2 layers95 × 46 mmLEDDs, the printed circuit board in 3D

    LEDDs

    VasilKalchev/LEDDs

    PCB and enclosure design of a trailing edge light bulbs dimmer

    91 parts2MIT
  • 2 layers134 × 88 mmTulipcc, the printed circuit board in 3D

    Tulipcc

    shorepine/tulipcc

    The Tulip Creative Computer and AMYboard - portable Python synthesizers

    103 parts978
  • 6 layers49.6 × 103 mmAnalogue board pico revb routed, the printed circuit board in 3D

    Analogue board pico revb routed

    Eight4aWish/eurorack_electronics

    Analogue designs and breadboard layouts: the Dual Pingable LPG, and the board behind Boy.

    361 parts1
  • 4 layers31.7 × 110 mmTiliqua motherboard, the printed circuit board in 3D

    Tiliqua motherboard

    antoinevg/tiliqua

    A powerful, hackable FPGA-based audio multitool for Eurorack.

    134 partsCERN-OHL-S-2.0
  • 2 layersOpensync, the printed circuit board in 3D

    Opensync

    ErichZimmer/OpenSync

    An open source synchronizer for velocimetry of fluids.

    230 parts4CERN-OHL-S-2.0

Questions

How big is the Pikocore gamepad PCB?

It measures 100 × 60 mm and has 4 copper layers, 1.6 mm thick.

What parts does the Pikocore gamepad use?

76 parts, built around the PT2308-S, H11L1SR2M, SN74LVC1G17DCKR and 1N4148W. 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 Pikocore gamepad KiCad files?

From the sebasdv/pikocore_gamepad repository on GitHub, at the commit this page was made from: the board is hardware/pikocore_gamepad/pcb/pikocore_gamepad.kicad_pcb and its schematic hardware/pikocore_gamepad/pcb/01_alimentacion.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Pikocore gamepad design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).