2 layers65 × 56 mm
2 layers66.7 × 66.7 mm
Sampler keyboard
aizuknight/sampler_keyboardA keyboard for beginners
- Size
- 66.7 × 66.7 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 23
- Nets
- 32
- Pads
- 110
- Tracks, vias
- 154, 37
- Pours
- 1
- Routed
- Yes
- KiCad
- KiCad 8.0 (file 20240108)
- Created
- 20 Apr 2026
- Updated
- 7 Oct 2026
Overview
Sampler keyboard is an open-source printed circuit board by aizuknight, from the aizuknight/sampler_keyboard repository on GitHub. It is a 2-layer board of 66.7 × 66.7 mm with 23 parts on 32 nets, routed with 154 tracks and 37 vias.
Its parts include 12 diodes, 6 switches and 1 IC. It belongs with the keyboards and input boards and the RP2040 boards of this library.
README
README.mdsampler_keyboard
sampler_keyboard is a keyboard with 6 keys to learn the basics of custom built keyboard design.
Bill of Materials
How to Build Firmware
[!NOTE] If you are going to build the firmware on CentOS in AINS (University of Aizu), go straight to step 2.
[!TIP] I recommend you to build the firmware on CentOS in the AINS (University of Aizu) if you are a beginner. You can SSH into CentOS server just by
ssh s13XXXXX@linsv.u-aizu.ac.jpwhile connected to the AINS network.
1. Prepare Docker Engine
If Docker is already installed and it can be run without sudo, go straight to step 2. The build script uses Docker. If Docker is not installed yet, install Docker Engine on your Linux system (including WSL):
curl -fsSL https://get.docker.com | sudo shIf docker cannot be run without sudo, add your user to docker group:
sudo usermod -aG docker $USER[!NOTE] For the user group changes to take effect, you will need to log out. You might need to reboot your computer instead of logging out for the user group changes to take effect.
These commands require curl and permission to install system software.
2. Clone Repository
git clone https://github.com/aizuknight/sampler_keyboard.git
cd sampler_keyboard/This command requires git to be installed.
3. Build Firmware
After cloning the repository, run the command below from the repository root (You should be there already) for your chosen keymap. The script prepares the build environment and compiles the firmware.
[!WARNING] You need at least 6.16 GB of disk space with Docker.
[!NOTE] The first build requires internet access and takes longer because the script automatically builds the QMK container image (about 4 minutes with Docker on Intel Core i5-12400). Later builds reuse the image.
[!NOTE] When you build the firmware on CentOS in the AINS (University of Aizu), you may build the QMK container image all the time unless you frequently build the firmware. Since the script uses
/tmp/directory to store the QMK container image (9.6 GB), the stored data will be deleted without frequent access. If you do not like that, you can manually set the location to store the QMK container image with environment variablePODMAN_STRAGE_DIRECTORY(Advanced).
Option 1: Build the Default Keymap
./firmware/build.shThe built firmware is located at firmware/output/sampler_keyboard_default.uf2.
Option 2: Build Firmware with VIA Compatibility
./firmware/build.sh viaThe built firmware is located at firmware/output/sampler_keyboard_via.uf2.
How to Install Firmware to The Keyboard
- Connect Seeed Studio XIAO RP2040 to your computer with USB cable while pressing reset button on the Seeed Studio XIAO RP2040.
- Release the reset button on the Seeed Studio XIAO RP2040.
- Drag and drop the firmware to the USB mass strage device named "RPI-RP2".
Parts
23| Qty | Value | Footprint | References |
|---|---|---|---|
| 6 | D | kbd:D3_SMD_v2 | D1, D2, D3, D4, D5, D6 |
| 6 | SW_PUSH | kbd:CherryMX_Hotswap | SW1, SW2, SW3, SW4, SW5, SW6 |
| 6 | YS-SK6812MINI-E | kbd:YS-SK6812MINI-E | LED1, LED2, LED3, LED4, LED5, LED6 |
| 4 | MountingHole | MountingHole:MountingHole_2.2mm_M2 | H1, H2, H3, H4 |
| 1 | XIAO-RP2040-DIP | Seeed Studio XIAO Series Library:XIAO-RP2040-DIP | U1 |
Questions
How big is the Sampler keyboard PCB?
It measures 66.7 × 66.7 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Sampler keyboard use?
23 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 Sampler keyboard KiCad files?
From the aizuknight/sampler_keyboard repository on GitHub, at the commit this page was made from: the board is pcb/sampler_keyboard.kicad_pcb and its schematic pcb/sampler_keyboard.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Sampler keyboard design in my own project?
Its repository states no licence, so its author keeps all rights: ask aizuknight before reusing the design.
Similar boards
- 2 layers14 × 100 mm
Yunomi
google/mozc-devices
Circuit diagrams and firmware source code for Gboard DIY keyboards
23 parts3kApache-2.0 - 2 layers50.8 × 52.2 mm
- 2 layers138.8 × 89.8 mm
- 2 layers32.9 × 53.3 mm
- 2 layers35.5 × 50 mm
- 2 layers19 × 19 mm
- 2 layers88.5 × 28 mm
ExpBreakout
Duet3D/Duet-2-Hardware
The KiCAD source for the Duet 3d printer controller see www.duet3d.com
23 parts258