Skip to the content
2 layers61 × 67 mmRp keyer1, the printed circuit board in 3D

RP2040 / RP2350 firmware that turns a Raspberry Pi Pico (or Pico 2) into a self-contained CW (Morse) keyer with:

Size
61 × 67 mm
Copper layers
2
Thickness
1.6 mm
Parts
11
Nets
61
Pads
125
Tracks, vias
45, 0
Pours
1
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
23 May 2026
Updated
25 May 2026

Overview

Rp keyer1 is an open-source printed circuit board by SP5TLS, from the SP5TLS/rp-keyer repository on GitHub, published under the Apache-2.0 licence. It is a 2-layer board of 61 × 67 mm with 11 parts on 61 nets, routed with 45 tracks and 0 vias.

Its parts include 4 switches, 3 connectors, 1 resistor and 1 transistor. It belongs with the RP2040 boards of this library.

README

README.md

rp-keyer

RP2040 / RP2350 firmware that turns a Raspberry Pi Pico (or Pico 2) into a self-contained CW (Morse) keyer with:

  • iambic / straight / bug / ultimatic / single-paddle keyer engine from radio-utils-keyer,
  • on-device CW decoder from radio-utils-cw-decoder feeding the OLED decoded-text row,
  • USB MIDI + USB CDC SERIAL_STATE paddle interface (same wire contract as cw-adapter),
  • PWM-driven passive piezo buzzer for sidetone,
  • 2N2222 NPN driver to key a real radio,
  • SSD1306 128×64 OLED + 4-button menu for keyer settings.

Pinout (default for both Pico / Pico 2)

Pins are grouped into two physical clusters on the Pico header so wiring stays tidy whether you fly leads or build a PCB.

Left edge — keyer hardware:

FunctionPinGPIONotes
Buzzer / GND13GNDShared with radio-key return
Buzzer14GP10PWM5A, drives passive piezo
Radio key out15GP11Drives 2N2222 base via 1 kΩ resistor
Paddle GND18GNDTRS sleeve
Dit paddle19GP14TRS tip, active-low, internal pull-up
Dah paddle20GP15TRS ring, active-low, internal pull-up

Right edge — OLED + 4-button combo module (single 8-wire connector):

Module pinPico pinGPIOFunction
K121GP16Button UP (top of stack)
K222GP17Button DOWN
GND23GNDModule ground
K324GP18Button OK
K425GP19Button BACK (bottom of stack)
SDA26GP20I2C0 SDA
SCL27GP21I2C0 SCL
VCC363V3Single jumper to 3V3 OUT

All eight module wires land on the same edge of the Pico — seven on the contiguous right-side strip (pins 21–27) plus one jumper to 3V3.

Radio key wiring

text
   GP11 ─── 1 kΩ ──── Base
                       │
                    2N2222 NPN
                       │
                    ┌──┴──┐
                    │     │
               Collector  Emitter
                    │     │
   radio key tip ───┘     └─── GND ─── radio key sleeve
   (or PTT)

Connections:

  • Base ← GP11 through the 1 kΩ current-limiting resistor.
  • Collector ← radio key tip (or PTT line). The radio's keying supply provides the pull-up; the 2N2222 sinks this line to ground when GP11 is high.
  • Emitter → GND, shared with the radio key sleeve so the firmware and the radio agree on ground reference.

Drop a flyback diode across the collector–emitter (cathode to collector) if your radio's key line is inductive.

The schematic uses a 2N3904 in this position; a 2N2222 is a drop-in substitute — both are general-purpose NPN signal transistors with more than enough current capacity for keying a typical radio.

Schematics

A KiCad 8 project for the reference carrier board lives under schematics/rp-keyer/. It contains:

  • rp-keyer1.kicad_pro — project file (open this in KiCad)
  • rp-keyer1.kicad_sch — schematic
  • rp-keyer1.kicad_pcb — PCB layout

Schematic

The schematic captures the pinout above 1:1: paddle TRS jack J1 on GP14/GP15, radio-key TRS jack J2 driven through Q1+R1 from GP11, buzzer BZ1 on GP10, and the 8-pin SSD1306_BUTTONS_MODULE connector J3 carrying SDA/SCL plus K1..K4 to GP16..GP21 with 3V3 + GND from the top of the Pico.

Pre-built firmware

Each tagged release publishes ready-to-flash .uf2 files for both boards on the GitHub Releases page. Hold BOOTSEL while plugging the board in, then drag the .uf2 onto the USB drive that appears.

Building from source

sh
# RP2040 (Pico)
cargo build --release \
  --target thumbv6m-none-eabi \
  --features rp2040,serial,midi \
  --bin rp2040

# RP2350 (Pico 2)
cargo build --release \
  --target thumbv8m.main-none-eabihf \
  --features rp2350,serial,midi \
  --bin rp2350

Generate a .uf2 from the ELF:

sh
cargo install elf2uf2-rs

elf2uf2-rs target/thumbv6m-none-eabi/release/rp2040 rp-keyer-rp2040.uf2
# For RP2350: elf2uf2-rs hardcodes the RP2040 family ID, so rewrite it
# afterwards or the Pico 2 BOOTSEL drive will reject the file.
elf2uf2-rs target/thumbv8m.main-none-eabihf/release/rp2350 rp-keyer-rp2350.uf2
python3 scripts/patch_uf2_family.py rp-keyer-rp2350.uf2

Flashing via probe-rs:

sh
cargo run --release \
  --target thumbv6m-none-eabi \
  --features rp2040,serial,midi \
  --bin rp2040

Menu

Boot screen shows the live mode / WPM / sidetone frequency. OK enters the settings list; UP/DOWN scroll, OK enters an item for editing, UP/DOWN change the value, OK / BACK return.

Settable parameters:

  • Mode (Straight / IambicA / IambicB / Bug / Ultimatic / SinglePaddle)
  • WPM (5 – 60)
  • Weight (25 – 75)
  • Sidetone frequency (300 – 1200 Hz)
  • Sidetone volume (0 – 100 %)
  • Hang time (0 – 2000 ms)
  • Keys reversed (Y / N)
  • Iambic-B CMOS timing percentage (0 – 100)
  • Farnsworth WPM (0 – 60, 0 = off)
  • Keying compensation (0 – 50 ms)

License

Dual-licensed under either of:

at your option.

Parts

11
QtyValueFootprintReferences
11kResistor_THT:R_Axial_DIN0204_L3.6mm_D1.6mm_P5.08mm_HorizontalR1
12N2222Package_TO_SOT_THT:TO-92L_InlineQ1
1BuzzerBuzzer_Beeper:Buzzer_15x7.5RM7.6BZ1
1CANCELButton_Switch_THT:SW_PUSH_6mmSW4
1CW Key InputConnector_Audio:Jack_3.5mm_CUI_SJ1-3515N_HorizontalJ1
1DOWNButton_Switch_THT:SW_PUSH_6mmSW2
1Key OutputConnector_Audio:Jack_3.5mm_CUI_SJ1-3515N_HorizontalJ2
1OKButton_Switch_THT:SW_PUSH_6mmSW3
1RaspberryPi_PicoModule:RaspberryPi_Pico_Common_UnspecifiedA1
1SSD1306_BUTTONS_MODULEConnector_PinHeader_2.54mm:PinHeader_1x08_P2.54mm_VerticalJ3
1UPButton_Switch_THT:SW_PUSH_6mmSW1

Similar boards

  • 2 layers60 × 30 mmController, the printed circuit board in 3D

    Controller

    google/mozc-devices

    Circuit diagrams and firmware source code for Gboard DIY keyboards

    11 parts3kApache-2.0
  • 2 layers103 × 30.5 mmTS Front Endcap, the printed circuit board in 3D

    TS Front Endcap

    EEVengers/ThunderScope

    ThunderScope GitHub Repo

    11 parts1.3kMIT
  • 2 layers26 × 30 mmExpansion Card, the printed circuit board in 3D

    Expansion Card

    FrameworkComputer/ExpansionCards

    Reference designs and documentation to create Expansion Cards for the Framework Laptop

    11 parts1.1kCC-BY-4.0
  • 2 layers53.9 × 23.2 mmBuffer, the printed circuit board in 3D

    Buffer

    hoglet67/RGBtoHDMI

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

    11 parts1kGPL-3.0
  • 2 layers10 × 20 mm2 connector Sensor Board, the printed circuit board in 3D

    2 connector Sensor Board

    hackclub/OnBoard

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

    11 parts915
  • 2 layersFet module, the printed circuit board in 3D

    Fet module

    ByteWelder/Decktility

    A handheld PC

    11 parts855CC-BY-SA-4.0
  • 2 layers47 × 33 mmSevensegment led display module, the printed circuit board in 3D

    Sevensegment led display module

    tardate/LittleArduinoProjects

    a collection of "Little Electronic & Arduino Projects", most involving electronics or an Arduino in one way or another!

    11 parts803MIT
  • 2 layers42.5 × 36.8 mmDevboard, the printed circuit board in 3D

    Devboard

    basilfx/TRADFRI-Hacking

    Hacking IKEA TRÅDFRI products, such as light bulbs, window blinds and other accessories.

    11 parts743CC-BY-4.0

Questions

How big is the Rp keyer1 PCB?

It measures 61 × 67 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Rp keyer1 use?

11 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 Rp keyer1 KiCad files?

From the SP5TLS/rp-keyer repository on GitHub, at the commit this page was made from: the board is schematics/rp-keyer/rp-keyer1.kicad_pcb and its schematic schematics/rp-keyer/rp-keyer1.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Rp keyer1 design in my own project?

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