

MiniMelody
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
1README
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.
> Built for **Music Week (Week 3), "Design Your Instrument"**: circuits that turn voltage into sound.
📖 Table of contents
| Jump to | |
|---|---|
| What is it? | Hardware |
| Features | Pin map |
| How it works | Build it yourself |
| Controls | Design decisions |
| Project structure | Roadmap |
🎵 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
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- 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).
- 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.
- Mix: the active notes are added together and scaled to avoid distortion.
- Play: the mixed audio is sent to the amplifier over I2S, and the amplifier drives the speaker.
- Show: the OLED updates a few times per second with what is playing.
🎛️ Controls
| Control | What it does |
|---|---|
| 8 note keys | Play C, D, E, F, G, A, B, and high C (hold several for chords) |
| MODE button | Cycles through sounds (square, saw, triangle, sine, and so on) |
| OCT button | Shifts the whole keyboard up or down an octave |
| Rotary encoder | Turn to change the volume |
🧰 Hardware
Bill of materials (click to expand)
| Qty | Part | Notes |
|---|---|---|
| 1 | Raspberry Pi Pico (RP2040) | Main controller, also provides USB power |
| 1 | MAX98357A I2S amplifier breakout | Drives the speaker |
| 1 | Small speaker, 4 or 8 ohm, about 28 mm | Wired to the 2-pin speaker header |
| 1 | 0.96" 128x64 OLED (SSD1306, I2C) | 4-pin module |
| 10 | Tactile push buttons | 8 note keys, plus MODE and OCT |
| 1 | Rotary encoder | Volume |
| 1 | 10 uF capacitor | Amplifier supply decoupling |
| 1 | 100 nF capacitor | Supply decoupling |
| 1 | 2-pin header | Speaker connection |
| 1 | Custom PCB | Files in hardware/ |
🔌 Pin map
Raspberry Pi Pico connections (click to expand)
| Function | Pico pins | Notes |
|---|---|---|
| I2S DIN / BCLK / LRCLK | GP13 / GP14 / GP15 | LRCLK must be the pin right after BCLK |
| OLED SDA / SCL | GP0 / GP1 | I2C0 |
| Note keys, MODE, OCT, encoder | See hardware/ schematic | Each button connects its pin to GND |
| Amplifier power | VBUS (5 V) | |
| OLED power | 3V3_OUT |
Always check this table against the final schematic in
hardware/, which is the source of truth.
🗂️ Project structure
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🔨 Build it yourself
1. Hardware
- Open the project in KiCad and run the Electrical Rules Check and the Design Rules Check. Both should come back clean.
- Export the Gerber and drill files (File > Plot) and send them to a PCB manufacturer.
- Solder the parts. A good order is: capacitors, buttons, headers, amplifier, Pico, display, and finally the speaker wires.
- 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).
cd firmware
pio run # build
pio run -t upload # flashTo 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| Qty | Value | Footprint | References |
|---|---|---|---|
| 10 | 320.01E11WHT | 320.01E11WHT:SW_320.01E11WHT | BTN_MODE1, BTN_OCT1, KEY_A1, KEY_B1, KEY_C1, KEY_D1, KEY_E1, KEY_F1, KEY_G1, KEY_H1 |
| 1 | 100nF | Capacitor_SMD:C_0603_1608Metric | C2 |
| 1 | 10uF | Capacitor_SMD:C_0805_2012Metric | C1 |
| 1 | OLED_Display | OLED_128X64_1.3_I2C:LCD_OLED_128X64_1.3_I2C | DS1 |
| 1 | RotaryEncoder | Rotary_Encoder:RotaryEncoder_Alps_EC12E_Vertical_H20mm_CircularMountingHoles | SW2 |
| 1 | Sound Amp | 3006:MODULE_3006 | U2 |
| 1 | Speaker pin | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | -1 |
| 1 | pi-Pico | SC0917:MODULE_SC0917 | U1 |
The 17 most common of 22 parts.
Similar boards
- 2 layers

- 2 layers158 × 11 mm

Daylight Matchstick
VoronDesign/Voron-Hardware
Cool Hardware designed by the Voron Design group
22 parts1.1kGPL-3.0 - 2 layers57 × 65 mm

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 mm

RP2040-Macropad
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
22 parts915 - 2 layers54.6 × 70.9 mm

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 mm

Connecting piece
Chrismettal/flipper-zero-backpacks
Backpack-style addon boards for the Flipper Zero!
22 parts456 - 2 layers51 × 70 mm

- 2 layers19.7 × 19.7 mm

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.