Skip to the content
2 layersMiniMelody, the printed circuit board in 3D

a pocket-sized music board

Copper layers
2
Thickness
1.6 mm
Parts
22
Nets
48
Pads
128
Tracks, vias
294, 57
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
19 Oct 2026
Updated
25 Oct 2026

Overview

MiniMelody is an open-source printed circuit board by ahmadjamal789, from the ahmadjamal789/MiniMelody repository on GitHub. It is a 2-layer board with 22 parts on 48 nets, routed with 294 tracks and 57 vias.

It is built around the 320.01E11WHT. Its parts include 2 capacitors, 2 ICs and 1 switch.

Main components

1

README

README.md

🎹 MiniMelody

A pocket-sized synth keyboard you can build yourself: 8 keys, a live OLED display, a rotary volume knob, and a real speaker, all on one custom PCB.

KiCad MCU Firmware Status License

> Built for **Music Week (Week 3), "Design Your Instrument"**: circuits that turn voltage into sound. Screenshot from 2026-10-23 18-20-23


📖 Table of contents


🎵 What is it?

MiniMelody is a small electronic keyboard. Each of the 8 keys plays its own note, and you can press several keys at once to play chords and build up music. A small OLED shows the note and sound you are playing, and the audio comes out of a proper speaker through a digital amplifier, so it sounds much better than a basic buzzer.

Everything (schematic, PCB layout, and firmware) is open, so you can rebuild it, change it, or use it to learn how a synth works.

✨ Features

  • 🎹 8 note keys: one octave, from C up to the high C
  • 🎶 Polyphonic: the firmware mixes multiple notes at the same time (4 voices planned)
  • 🔊 Real speaker output: clean digital audio (I2S) into a MAX98357A amplifier
  • 📺 OLED display: shows the current note, sound type, and volume
  • 🎛️ Rotary encoder for volume, plus MODE and OCT buttons for sound and octave
  • 🧩 Custom KiCad PCB: keys, display, speaker, and controller on a single board
  • 🔌 Powered over USB through the Pico's own port, no battery needed

⚙️ How it works

mermaid
flowchart LR
    K["8 note keys"] --> P
    C["MODE / OCT buttons<br/>Rotary encoder"] --> P
    P["Raspberry Pi Pico<br/>(RP2040)"] -- "I2C" --> D["OLED display"]
    P -- "I2S digital audio" --> A["MAX98357A<br/>amplifier"]
    A --> S["Speaker"]
    U["USB 5 V"] --> P
    P -- "VBUS 5 V" --> A
Screenshot from 2026-10-24 11-52-34
  1. Scan: the Pico checks every button many times per second. Each button connects its pin to ground when pressed (the Pico's internal pull-up resistors do the rest).
  2. Generate: for every key held down, the firmware reads a stored waveform (sine, square, saw, or triangle) at that note's frequency and shapes it with a simple volume envelope so notes don't click.
  3. Mix: the active notes are added together and scaled to avoid distortion.
  4. Play: the mixed audio is sent to the amplifier over I2S, and the amplifier drives the speaker.
  5. Show: the OLED updates a few times per second with what is playing.

🎛️ Controls

ControlWhat it does
8 note keysPlay C, D, E, F, G, A, B, and high C (hold several for chords)
MODE buttonCycles through sounds (square, saw, triangle, sine, and so on)
OCT buttonShifts the whole keyboard up or down an octave
Rotary encoderTurn to change the volume

🧰 Hardware

Bill of materials (click to expand)
QtyPartNotes
1Raspberry Pi Pico (RP2040)Main controller, also provides USB power
1MAX98357A I2S amplifier breakoutDrives the speaker
1Small speaker, 4 or 8 ohm, about 28 mmWired to the 2-pin speaker header
10.96" 128x64 OLED (SSD1306, I2C)4-pin module
10Tactile push buttons8 note keys, plus MODE and OCT
1Rotary encoderVolume
110 uF capacitorAmplifier supply decoupling
1100 nF capacitorSupply decoupling
12-pin headerSpeaker connection
1Custom PCBFiles in hardware/

🔌 Pin map

Raspberry Pi Pico connections (click to expand)
FunctionPico pinsNotes
I2S DIN / BCLK / LRCLKGP13 / GP14 / GP15LRCLK must be the pin right after BCLK
OLED SDA / SCLGP0 / GP1I2C0
Note keys, MODE, OCT, encoderSee hardware/ schematicEach button connects its pin to GND
Amplifier powerVBUS (5 V)
OLED power3V3_OUT

Always check this table against the final schematic in hardware/, which is the source of truth.

🗂️ Project structure

text
MiniMelody/
├── hardware/        # KiCad project: schematic, PCB, footprints, 3D models
│   └── gerbers/     # Manufacturing files for ordering the PCB
├── firmware/        # PlatformIO project for the Pico
├── docs/
│   └── images/      # Photos and 3D renders
└── README.md
Screenshot from 2026-10-22 21-24-55 Screenshot from 2026-10-23 18-20-23

🔨 Build it yourself

1. Hardware

  1. Open the project in KiCad and run the Electrical Rules Check and the Design Rules Check. Both should come back clean.
  2. Export the Gerber and drill files (File > Plot) and send them to a PCB manufacturer.
  3. Solder the parts. A good order is: capacitors, buttons, headers, amplifier, Pico, display, and finally the speaker wires.
  4. Connect the speaker to the 2-pin header (the amplifier output has no polarity requirement for a basic speaker).

2. Firmware

You need PlatformIO (VS Code extension or CLI).

bash
cd firmware
pio run                 # build
pio run -t upload       # flash

To flash, hold the BOOTSEL button on the Pico while plugging in the USB cable, then run the upload command.

3. Play

Plug in USB, wait for the display to light up, and press the keys. 🎶

🧠 Design decisions

  • Why a Pico and not an Arduino? A basic Arduino tone() can only play one note at a time. The RP2040 is fast enough to mix several notes in software and stream audio over I2S.
  • Why I2S and an amplifier chip? Digital audio is much cleaner and louder than PWM into a buzzer.
  • Why no diodes or button matrix? The Pico has enough pins to give every button its own, so every chord works and the schematic stays simple.
  • Why no pull-up resistors? The Pico has internal pull-ups on every pin, and the firmware turns them on.
  • Why power the amplifier from 5 V? It gives the speaker more headroom and volume than 3.3 V.

🗺️ Roadmap

  • Concept and parts selection
  • Schematic in KiCad
  • PCB layout and routing
  • Final design checks and PCB order
  • Firmware: button scanning and single-note tone
  • Firmware: polyphonic mixing
  • Firmware: OLED display and sound modes
  • 3D-printed or laser-cut enclosure
  • Demo video

🤝 Contributing

Ideas and improvements are welcome. Open an issue or a pull request.

👤 Author

Made by Ahmad Adesoye · GitHub


Make. Some. Noooooooooise.

Parts

22
QtyValueFootprintReferences
10320.01E11WHT320.01E11WHT:SW_320.01E11WHTBTN_MODE1, BTN_OCT1, KEY_A1, KEY_B1, KEY_C1, KEY_D1, KEY_E1, KEY_F1, KEY_G1, KEY_H1
1100nFCapacitor_SMD:C_0603_1608MetricC2
110uFCapacitor_SMD:C_0805_2012MetricC1
1OLED_DisplayOLED_128X64_1.3_I2C:LCD_OLED_128X64_1.3_I2CDS1
1RotaryEncoderRotary_Encoder:RotaryEncoder_Alps_EC12E_Vertical_H20mm_CircularMountingHolesSW2
1Sound Amp3006:MODULE_3006U2
1Speaker pinConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical-1
1pi-PicoSC0917:MODULE_SC0917U1

The 17 most common of 22 parts.

Similar boards

  • 2 layersPrac5, the printed circuit board in 3D

    Prac5

    jis0017/Practicas-KiCad

    Practicas de KiCad en Arquitectura De Sistemas Electrónicos

    14 parts
  • 2 layers158 × 11 mmDaylight Matchstick, the printed circuit board in 3D

    Daylight Matchstick

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    22 parts1.1kGPL-3.0
  • 2 layers57 × 65 mmRgb to hdmi, the printed circuit board in 3D

    Rgb to hdmi

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    22 parts1kGPL-3.0
  • 2 layers81 × 57.2 mmRP2040-Macropad, the printed circuit board in 3D

    RP2040-Macropad

    hackclub/OnBoard

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

    22 parts915
  • 2 layers54.6 × 70.9 mmBeagleLogic Cape, the printed circuit board in 3D

    BeagleLogic Cape

    abhishek-kakkar/BeagleLogic

    A Software Suite that implements a logic analyzer with the PRU on the BeagleBone / BeagleBone Black.

    22 parts479GPL-3.0
  • 2 layers66.4 × 24.5 mmConnecting piece, the printed circuit board in 3D

    Connecting piece

    Chrismettal/flipper-zero-backpacks

    Backpack-style addon boards for the Flipper Zero!

    22 parts456
  • 2 layers51 × 70 mmDMG A04-01, the printed circuit board in 3D

    DMG A04-01

    HDR/NintendoPCBs

    Replacement pcb's for Nintendo games.

    22 parts321

Questions

What parts does the MiniMelody use?

22 parts, built around the 320.01E11WHT. 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 MiniMelody KiCad files?

From the ahmadjamal789/MiniMelody repository on GitHub, at the commit this page was made from: the board is MiniMelody/MiniMelody.kicad_pcb and its schematic MiniMelody/MiniMelody.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the MiniMelody design in my own project?

Its repository states no licence, so its author keeps all rights: ask ahmadjamal789 before reusing the design.