Skip to the content
2 layers362 × 114.3 mmRivasmario 96% Hotswap Rp2040, the printed circuit board in 3D

Rivasmario 96% Hotswap Rp2040

RivasMario/SKYWAY-96

Mechanical Keyboard PCB and Plate powered by QMK for a 96% board

Size
362 × 114.3 mm
Copper layers
2
Thickness
1.6 mm
Parts
299
Nets
175
Pads
1,238
Tracks, vias
1,889, 330
Pours
1
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
28 Mar 2026
Updated
26 Oct 2026

Overview

Rivasmario 96% Hotswap Rp2040 is an open-source printed circuit board by RivasMario, from the RivasMario/SKYWAY-96 repository on GitHub. It is a 2-layer board of 362 × 114.3 mm with 299 parts on 175 nets, routed with 1,889 tracks and 330 vias.

It is built around the RP2040, W25Q128JVSIQ and AMS1117-3.3, with the 1N4148W, WS2812B and PRTR5V0U2X among its other parts. Its parts include 117 diodes, 44 capacitors, 11 resistors, 3 ICs and 2 connectors. It belongs with the keyboards and input boards and the RP2040 boards of this library.

Main components

6

README

README.md

SKYWAY 96 — Hotswap Keyboard PCB

A 96% mechanical keyboard PCB built around the RP2040, with Kailh hotswap sockets and underglow RGB. Designed for JLCPCB assembly and Melody96-compatible cases.

Keyboard

Contents


Specs

MCURP2040 (QFN-56)
FlashW25Q128JVS (128 Mb, SOIC-8)
Layout96% — 99 keys
SwitchesKailh hotswap (MX compatible)
RGB18× WS2812B underglow
USBUSB-C (HRO TYPE-C-31-M-12)
RegulatorAMS1117-3.3
ESDPRTR5V0U2X
FirmwareQMK + VIA / Vial
CaseMelody96 / YMDK96 compatible (see Case/)

Photos & Renders

Rendered TopRendered Back
Rendered TopRendered Back
Board TopBoard Bottom
Board TopBoard Bottom

All renders and 2D images (keycaps, stabilizers, layouts, alternate angles) live in Photos/.

Switch Plate

Switch/stabilizer mounting plate (99 cutouts, 11× Ø4.0 screw holes, 361.95×114.30 mm). DXF + details in Plate/.

Switch plate

3D-Printable Cases

Two Melody96-compatible printed cases — pick either. Full part breakdowns in Case/.

Melody96 (HughMann)RobotDoctor 96%
Melody96 caseRobotDoctor case
Multi-part: Body L/R + Stripe + Risers. Details » · Thingiverse #3883Tray-style, flat or angled. PCB-mount holes opened to Ø2.4 (M2). Details » · Thingiverse #4401525

Layout

96% — 99 keys. Matrix is 6 rows × 19 columns (COL2ROW).

2D LayoutKLE
96% LayoutLayout

Wiring, key labels, and VIA labelling diagrams are in KLE DATA/.


Repository Layout

FolderContents
qmk_src/QMK firmware source + VIA keymap
Manufacturing & Assembly Files/BOM, CPL, Gerbers (for JLCPCB)
KiCAD Source Files/KiCad project + schematics
Schematic/Schematic PDF
3D Step File/STEP / 3D model files
Photos/Renders and 2D images
KLE DATA/Keyboard-Layout-Editor data + diagrams
VIA Json/VIA / Vial config + layout backups
Layout PDFs/Printable layout / keymap PDFs
Plate/Switch plate DXF (laser/waterjet)
Case/3D-printable cases (Melody96 + RobotDoctor)

Firmware: Setup & Flashing

1. Install the toolchain

You need the QMK CLI and the arm-none-eabi toolchain. On Fedora:

bash
sudo dnf install -y arm-none-eabi-gcc-cs-c++ arm-none-eabi-newlib arm-none-eabi-binutils

2. Link the source into QMK

bash
ln -sf "$(pwd)/qmk_src" ~/qmk_firmware/keyboards/skyway96

3. Compile

bash
qmk compile -kb skyway96 -km via

Produces skyway96_via.uf2 in your qmk_firmware directory.

4. Flash

  1. Enter bootloader: hold BOOT → tap RESET → release BOOT.
  2. The board mounts as a USB drive named RPI-RP2.
  3. Drag skyway96_via.uf2 onto that drive, or run:
    bash
    qmk flash -kb skyway96 -km via

Troubleshooting

Linux USB detection (udev)

If VIA / Remap doesn't see the board on Linux, add a udev rule:

bash
export USER_GID=`id -g`; sudo --preserve-env=USER_GID sh -c 'echo "KERNEL==\"hidraw*\", SUBSYSTEM==\"hidraw\", ATTRS{idVendor}==\"6969\", ATTRS{idProduct}==\"0096\", MODE=\"0660\", GROUP=\"$USER_GID\", TAG+=\"uaccess\", TAG+=\"udev-acl\"" > /etc/udev/rules.d/99-skyway96.rules && udevadm control --reload && udevadm trigger'

Restore the "known good" layout

A verified layout backup (with RGB controls on Layer 1) lives at: VIA Json/skyway96_GOOD_BACKUP_2026-04-23.json Sideload it in VIA / Remap after flashing.

GitHub push fails (password auth disabled)

Switch the remote to SSH:

bash
git remote set-url origin git@github.com:RivasMario/SKYWAY-96.git

Make sure your SSH key (e.g. ~/.ssh/github) is loaded in your SSH agent or set in ~/.ssh/config.


Credits

Parts

299
QtyValueFootprintReferences
991N4148WAhsan Libs:D_SOD-123D1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D100, D101 +83
99MX-NoLEDAhsan Libs:SW_Hotswap_Kailh_1.00uMX1, MX2, MX10, MX11, MX12, MX13, MX14, MX15, MX16, MX17, MX18, MX19, MX20, MX21, MX22, MX23 +83
29100nfAhsan Libs:JLCPCB_C0402C11, C12, C13, C14, C15, C16, C18, C19, C20, C21, C22, C23, C24, C25, C26, C34 +13
18WS2812BAhsan Libs:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mmLED1, LED2, LED3, LED4, LED5, LED6, LED7, LED10, LED11, LED12, LED13, LED14, LED15, LED16, LED17, LED18 +2
11MountingHoleMountingHole:MountingHole_2.2mm_M2_PadH1, H2, H3, H4, H5, H6, H7, H8, H9, H10, H11
710ufAhsan Libs:C_0805_2012MetricC1, C3, C10, C17, C27, C29, C31
5MX-StabiliserAhsan Libs:Stabilizer_Cherry_MX_2.00u_kbdST1, ST2, ST3, ST5, ST7
4100nfAhsan Libs:C_0805_2012MetricC2, C4, C30, C32
3470Ahsan Libs:JLCPCB_R0402R1, R2, R17
210kAhsan Libs:JLCPCB_R0402R21, R22
21kAhsan Libs:JLCPCB_R0402R20, R27
21ufAhsan Libs:JLCPCB_C0402C33, C43
222Ahsan Libs:JLCPCB_R0402R25, R26
222pfAhsan Libs:JLCPCB_C0402C44, C45
25.1KAhsan Libs:JLCPCB_R0402R18, R19
2LEDLED_SMD:LED_0402_1005MetricPwr1, Test1
2SW_SPSTAhsan Libs:K2-1187SQ-A4SW-06Boot1, RST1
112MHzAhsan Libs:Crystal_SMD_3225-4Pin_3.2x2.5mmY1
1AMS1117-3.3Package_TO_SOT_SMD:SOT-223-3_TabPin2U1
1MX-StabiliserAhsan Libs:Stabilizer_Cherry_MX_6.25u_kbdST4
1PRTR5V0U2XAhsan Libs:PRTR5V0U2XESD1
1RP2040Ahsan Libs:RP2040-QFN-56U4
1Screw_Terminal_01x06Connector_PinHeader_1.27mm:PinHeader_1x06_P1.27mm_VerticalJ9
1USB_C_Receptacle_USB2.0Ahsan Libs:USB_C_Receptacle_HRO_TYPE-C-31-M-12J4
1W25Q128JVSAhsan Libs:SOIC-8_5.23x5.23mm_P1.27mmU3

Similar boards

  • 2 layers457.4 × 132 mmSP110Duo, the printed circuit board in 3D

    SP110Duo

    printsmith/keyboards

    Custom keyboard featuring a modified Southpaw 1800 layout with 2 nav clusters, LCD display and rotary encoders.

    309 parts
  • 2 layers285 × 94.6 mmPH60Slim Choc, the printed circuit board in 3D

    PH60Slim Choc

    ph-design/PH60-SC

    A printable low-profile 60% wireless mechanical keyboard kit powered by ZMK firmware.

    219 parts132
  • 4 layers50.8 × 25.4 mmRP2040-DebugProbe, the printed circuit board in 3D

    RP2040-DebugProbe

    red-scorp/RP2040-DebugProbe

    RP2040-based debug probe board

    66 parts8
  • 2 layers100 × 160 mmPcb octoprobe, the printed circuit board in 3D

    Pcb octoprobe

    octoprobe/tentacle

    Open source hardware as part of octoprobe

    660 parts5MIT
  • 2 layers95.5 × 99 mmMacropad, the printed circuit board in 3D

    Macropad

    devramsean0/copperkeyboard

    My WIP Mechanical Keyboard

    88 parts
  • 4 layers76 × 50 mmWigglecam, the printed circuit board in 3D

    Wigglecam

    jadenrhee/wigglecam-controller

    RP2040 co-processor board for a 4-lens wigglegram camera: constant-current flash, controls, battery telemetry, Pi 5 I2C interface. 4-layer, DRC-clean, fab-ready.

    105 parts
  • 2 layers100 × 100 mmCombo laser driver, the printed circuit board in 3D

    Combo laser driver

    adeboni/laser-projector

    This project is for a quadruple laser projection controller, aimed at supporting room-scale projections

    169 partsGPL-3.0
  • 2 layers321.3 × 119 mmAmethyst, the printed circuit board in 3D

    Amethyst

    Keyaan-07/Amethyst

    A 75% keyboard with 84 keys!

    204 parts

Questions

How big is the Rivasmario 96% Hotswap Rp2040 PCB?

It measures 362 × 114.3 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Rivasmario 96% Hotswap Rp2040 use?

299 parts, built around the RP2040, W25Q128JVSIQ, AMS1117-3.3 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 Rivasmario 96% Hotswap Rp2040 KiCad files?

From the RivasMario/SKYWAY-96 repository on GitHub, at the commit this page was made from: the board is KiCAD Source Files/rivasmario 96% Hotswap Rp2040.kicad_pcb and its schematic KiCAD Source Files/Hotswap Switch Matrix.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Rivasmario 96% Hotswap Rp2040 design in my own project?

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