Skip to the content
2 layers96.7 × 95 mmOriginal keyboard, the printed circuit board in 3D

Original keyboard

n4subishin/nb1-keyboard

Nb.1 - A 12-position programmable macropad with swappable Cherry MX switches and rotary encoders (STM32F405 / QMK / Remap) Nb.1 - Cherry MX互換スイッチとロータリーエンコーダーを搭載した、12キー左手デバイス(STM32F405 / QMK / Remap対応)

Size
96.7 × 95 mm
Copper layers
2
Thickness
1.6 mm
Parts
58
Nets
82
Pads
307
Tracks, vias
686, 124
Pours
4
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
15 Aug 2026
Updated
17 Oct 2026

Overview

Original keyboard is an open-source printed circuit board by n4subishin, from the n4subishin/nb1-keyboard repository on GitHub, published under the GPL-2.0 licence. It is a 2-layer board of 96.7 × 95 mm with 58 parts on 82 nets, routed with 686 tracks and 124 vias.

It is built around the STM32F405RGT6, M78AR033-0.5 and 1N4148W, with the KT-0603R, USB4105-GF-A and BLM18KG601SN1 among its other parts. Its parts include 13 capacitors, 13 diodes, 12 switches, 8 resistors and 3 connectors. It belongs with the keyboards and input boards and the STM32 boards of this library.

Main components

6

README

README.md

Nb.1

日本語版はこちら / Japanese version

A 12-position programmable macropad. Every position accepts either a Cherry MX compatible switch or a rotary encoder — the two share a single footprint, so you can build it as twelve keys, twelve knobs, or any mix in between. One firmware build covers every variant.

MCUSTM32F405RGT6 (Cortex-M4F, 168 MHz, 1 MB Flash, 192 KB RAM)
Matrix3 rows × 4 columns, COL2ROW
EncodersUp to 12, wired directly to GPIO
ConnectionUSB Type-C, USB 2.0 Full Speed
FirmwareQMK Firmware (ChibiOS)
ConfiguratorRemap / VIA

Changing the keymap

No programming required — everything happens in the browser.

  1. Open https://remap-keys.app/ in Chrome or Edge (Firefox and Safari do not implement WebHID and will not connect)
  2. Choose Customize your keyboard and connect Nb.1
  3. Drag and drop keycodes onto the positions you want to change
  4. Press flash

Click a knob to set its clockwise and counter-clockwise actions separately.

Until Nb.1 is listed in the Remap catalog, load Nb1_remap_definition.json into Remap first.


Building the firmware

You need a working QMK environment. See the QMK setup guide if you don't have one.

sh
git clone https://github.com/qmk/qmk_firmware.git
cd qmk_firmware
qmk setup

# Drop this repository's keyboard directory into the QMK tree
cp -r /path/to/nb1-keyboard/keyboards/nb1 keyboards/

qmk compile -kb nb1 -km via

Two keymaps are provided. default is plain QMK; via adds Remap/VIA support and is what ships on the board.

Clock configuration

Y1 is a 16 MHz crystal. QMK's GENERIC_STM32_F405XG board assumes 12 MHz, so board.h and mcuconf.h override it:

text
PFD 2 MHz -> VCO 336 MHz -> SYSCLK 168 MHz, USB 48 MHz

Deleting those two files breaks USB entirely — the USB clock would land at 64 MHz instead of the required 48 MHz, and the core would run at 224 MHz, well past its 168 MHz limit.

EEPROM persistence

The STM32F405 has no real EEPROM, and QMK's flash emulation does not cover this part by default, so it would silently fall back to a RAM-backed fake EEPROM and lose every remap on unplug. keymaps/via/rules.mk selects the wear-leveling driver explicitly to prevent that. Do not remove those lines.


Flashing

Two ways into the bootloader:

Keycode — hold position 12 (bottom right) to reach layer 1, then press position 1. That is QK_BOOT in the shipped keymap.

BOOT0 button — unplug USB, hold the BOOT0 button on the PCB, plug USB back in. This works even when the firmware does not boot at all.

sh
qmk flash -kb nb1 -km via

Hardware

PCB96.72 × 95.00 mm, 2 layer
Key pitch19.2 mm
SwitchesCherry MX compatible, Kailh hotswap sockets
EncodersAlps EC12E2440301 (24 detent / 24 pulse, no push switch)
Crystal16 MHz, CL = 20 pF, HC-49/S

Full details in docs/SPECIFICATION.md.

Known limitations

  • No SWD header. Debugging requires soldering directly to MCU pins 46 and 49.
  • No reset button. Can be retrofitted by adding a tactile switch in parallel with C8.
  • Matrix rows pass through the J16–J17 cable. If that cable is disconnected, no key responds at all while the encoders keep working. This is the first thing to check when keys go dead.
  • The encoders have no push switch, so a position fitted with an encoder responds to rotation only.

JTAG pins

PA15 (JTDI), PB3 (JTDO) and PB4 (NJTRST) are used for the indicator LED and for matrix row 3 / column 1. The board is SWD-only by design; a JTAG probe will not work.


License

Based on QMK Firmware, so this project is GPL v2. See LICENSE.

USB VID 0x1209 is allocated by pid.codes for open source hardware. Projects using it must be released under a recognised open source license, which this repository satisfies.

Parts

58
QtyValueFootprintReferences
12C81598Diode_SMD:D_SOD-123D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12
12SW_MX_EC12EPCM_Switch_Keyboard_Hotswap_Kailh:original1SW13, SW14, SW15, SW16, SW17, SW18, SW19, SW20, SW21, SW22, SW23, SW24
6100nCapacitor_SMD:C_0603_1608MetricC3, C4, C5, C6, C8, C13
4MountingHoleMountingHole:MountingHole_3.2mm_M3H1, H2, H3, H4
210kResistor_SMD:R_0603_1608MetricR7, R8
21uCapacitor_SMD:C_0603_1608MetricC11, C12
22.2uCapacitor_SMD:C_0603_1608MetricC1, C2
222Resistor_SMD:R_0603_1608MetricR3, R4
230pCapacitor_SMD:C_0603_1608MetricC9, C10
25.1kResistor_SMD:R_0603_1608MetricR1, R2
2Conn_01x03_PinConnector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalJ16, J17
10Resistor_SMD:R_0603_1608MetricR5
11kResistor_SMD:R_0603_1608MetricR6
14.7uCapacitor_SMD:C_0603_1608MetricC7
1C15742Package_QFP:LQFP-64_10x10mm_P0.5mmU1
1C2286LED_SMD:LED_0603_1608MetricD13
1C3020560Connector_USB:USB_C_Receptacle_GCT_USB4105-xx-A_16P_TopMnt_HorizontalJ1
1C85833Capacitor_SMD:C_0603_1608MetricFB1
1CrystalCrystal:Crystal_HC49-U_VerticalY1
1M78AR033-0.52026_NewF:M78AR033-0.5U2
1SW_PushButton_Switch_THT:SW_PUSH_6mmbotton_1

Similar boards

  • 6 layers25.4 × 50.8 mmReDIP-64, the printed circuit board in 3D

    ReDIP-64

    daglem/reDIP-64

    Commodore 64 FPGA emulation platform

    150 parts20
  • 2 layers204 × 80 mmKicad source, the printed circuit board in 3D

    Kicad source

    keshikan/CureMIDI8

    USB-MIDI Interface(8IN/8OUT) for STM32F7

    105 parts26
  • 4 layers200 × 123 mmDualEMS PCB, the printed circuit board in 3D

    DualEMS PCB

    HirokiOhara/DualEMS_PCB

    This repository contains source code of software from our work "DualEMS: Two-Channel Arbitrary Waveform Electrical Muscle Stimulation Device to Design Interference Stimulation" (ACM AHs2022).

    62 parts3
  • 2 layers42.5 × 70 mmPicomniRover, the printed circuit board in 3D

    PicomniRover

    eyr1n/PicomniRover

    プロジェクトファイル一式は KiCad/PicomniRover (PicomniRover.kicadpro / .kicadpcb / .kicadsch) にあり、製造用ガーバーデータは KiCad/PicomniRover/jlcpcb/productionfiles/GERBER-PicomniRover.zip にまとめています。

    17 partsMIT
  • 4 layers40 × 40 mmSTM Board V3, the printed circuit board in 3D

    STM Board V3

    Tay0710/Design_S1_006

    This project integrates hardware, firmware, and design elements to develop a fully functional autonomous 3D mapping drone system.

    46 parts3
  • 6 layers34.4 × 20 mmGigaControl, the printed circuit board in 3D

    GigaControl

    kaminaris/GigaESC-ControlBoard

    Compact six-layer control card for modular GigaESC motor controllers. The MCU, CAN transceiver, IMU and signal conditioning live here; the MOSFET power stage and power supply are separate boards.

    54 parts
  • 4 layers40 × 40 mmDrone fc, the printed circuit board in 3D

    Drone fc

    FidelOdok/MetaForge

    AI Engineering Agent

    38 parts8Apache-2.0
  • 4 layers33 × 41.9 mmOE PyBoard, the printed circuit board in 3D

    OE PyBoard

    oeps-tech/OE-PyBoard

    Our MicroPyhton version using USB-C

    57 parts

Questions

How big is the Original keyboard PCB?

It measures 96.7 × 95 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Original keyboard use?

58 parts, built around the STM32F405RGT6, M78AR033-0.5, 1N4148W and KT-0603R. 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 Original keyboard KiCad files?

From the n4subishin/nb1-keyboard repository on GitHub, at the commit this page was made from: the board is hardware/original_keyboard.kicad_pcb and its schematic hardware/original_keyboard.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Original keyboard design in my own project?

Its repository publishes it under the GPL-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).