Skip to the content
2 layers306.4 × 122.2 mmBhoo 75, the printed circuit board in 3D

ZMK firmware for the BHOO-75 wireless keyboard and BHOO-20 numpad with OLED (nice!nano v2, split)

Size
306.4 × 122.2 mm
Copper layers
2
Thickness
1.6 mm
Parts
169
Nets
111
Pads
627
Tracks, vias
512, 18
Pours
1
Routed
Yes
KiCad
KiCad 8.0 (file 20240108)
Created
4 Nov 2024
Updated
6 Oct 2026

Overview

Bhoo 75 is an open-source printed circuit board by dhillon-m, from the dhillon-m/custom-keyboard repository on GitHub, published under the MIT licence. It is a 2-layer board of 306.4 × 122.2 mm with 169 parts on 111 nets, routed with 512 tracks and 18 vias.

Its parts include 84 diodes, 84 switches and 1 IC. It belongs with the keyboards and input and lEDs and displays boards and the nRF52 and nRF5x boards of this library.

README

README.md

BHOO Keyboard

Build ZMK firmware ZMK MCU License: MIT

The finished BHOO-75 keyboard

A custom wireless keyboard setup with two parts. This repo has the ZMK firmware, the KiCad PCB and the case CAD.

DeviceRoleDescription
BHOO-75Split centralCustom PCB, 75% ISO (UK) with an F-row and arrow cluster. 84 keys.
BHOO-20Split peripheralHandwired numpad with a 128×64 SSD1306 OLED (WIP). 19 keys.

Both run on a nice!nano v2 (nRF52840). The BHOO-75 pairs with the host over Bluetooth or USB. The BHOO-20 connects to the BHOO-75 as a ZMK split peripheral, so both boards share one keymap and appear to the computer as a single keyboard.

Features

  • Two boards, one keymap. Positions 0–18 are the numpad and 19–102 are the main keyboard, all defined in bhoo_75.keymap.
  • UK layout via zmk-locales (keys_en_gb.h).
  • OLED battery screen (WIP) on the BHOO-20. See below.
  • Bluetooth layer for switching between 4 profiles, clearing a pairing, and entering the bootloader.
  • Custom PCB and case. The KiCad project and STEP/STL files are in hardware/. See Hardware.
  • CI builds on every push through GitHub Actions. A settings_reset image is built too.

OLED display (work in progress)

Not working yet. Nothing shows on the screen at the moment. The code and images below are the design being worked towards, not the current behaviour.

OLED layout: two battery bars with percentages

The planned screen shows two battery bars, one per device. Each bar will fill 1 px per percent, with a hand-drawn 5×9 percentage readout next to it. At 100% the number turns into a lightning bolt. The drawing is done directly on an LVGL canvas in battery_screen.c.

5x9 digit font and lightning bolt glyph
  • Top bar: BHOO-75.
  • Bottom bar: BHOO-20, meant to update from zmk_battery_state_changed.
  • The panel is mounted upside down. The overlay is set up to rotate it in hardware with segment-remap and com-invdir.
  • The display should blank when the keyboard is idle (CONFIG_ZMK_DISPLAY_BLANK_ON_IDLE).
  • Even once the screen works, the BHOO-75 bar needs more wiring: bhoo_battery_set_central() exists, but nothing sends the central's battery level to the peripheral yet.

Keymap

Layer 0: Default

BHOO-75

text
Esc   F1  F2  F3  F4  F5  F6  F7  F8  F9  F10 F11 F12 Del  PrtSc
`     1   2   3   4   5   6   7   8   9   0   -   =   Bksp Home
Tab   Q   W   E   R   T   Y   U   I   O   P   [   ]        End
Caps  A   S   D   F   G   H   J   K   L   ;   '   #   Ent  PgUp
Shift \   Z   X   C   V   B   N   M   ,   .   /   Shift ↑  PgDn
Ctrl  Win Alt         Space           Alt Fn  Ctrl  ←   ↓   →

BHOO-20

text
            ┌─────┬─────┐
            │  —  │  —  │
┌─────┬─────┼─────┼─────┤
│ Num │  /  │  *  │  -  │
├─────┼─────┼─────┼─────┤
│  7  │  8  │  9  │     │
├─────┼─────┼─────┤  +  │
│  4  │  5  │  6  │     │
├─────┼─────┼─────┼─────┤
│  1  │  2  │  3  │     │
├─────┴─────┼─────┤ Ent │
│     0     │  .  │     │
└───────────┴─────┴─────┘

The two — keys at the top are unassigned (&none).

Layer 1: Bluetooth (hold Fn)

KeyAction
F1–F4Select Bluetooth profile 0–3
F5Clear the current profile's bond
F6Enter bootloader (BHOO-75)

Repository layout

text
.
├── build.yaml                       # Build matrix (board + shield combos)
├── .github/workflows/build.yml      # Uses ZMK's reusable build workflow (v0.2)
├── config/
│   ├── west.yml                     # Pins ZMK v0.2 + zmk-locales
│   └── boards/shields/
│       ├── bhoo_75/                 # Main keyboard: central
│       │   ├── bhoo_75.overlay      # 6×15 GPIO matrix + transform (padded to 19 cols)
│       │   ├── bhoo_75.keymap       # Keymap for both devices
│       │   └── bhoo_75.conf         # Split central
│       └── bhoo_20/                 # Numpad: peripheral
│           ├── bhoo_20.overlay      # 6×4 GPIO matrix, SSD1306 on i2c0
│           ├── bhoo_20.conf         # Display, battery, LVGL canvas
│           ├── battery_screen.c     # Custom status screen (WIP)
│           └── CMakeLists.txt
├── hardware/
│   ├── bhoo_75/pcb/                 # KiCad 8 PCB project
│   ├── bhoo_75/case/                # Top case, bottom case, plate, foot (STEP)
│   └── bhoo_20/case/                # Numpad case parts (STL)
├── docs/images/                     # Photos, renders, OLED mock-ups
└── zephyr/module.yml

Building

GitHub Actions (recommended)

  1. Push to any branch, or run the workflow manually from the Actions tab.
  2. Open the finished run and download the firmware artifact.
  3. It contains three images:
    • bhoo_75-nice_nano_v2-zmk.uf2
    • bhoo_20-nice_nano_v2-zmk.uf2
    • settings_reset-nice_nano_v2-zmk.uf2

Local build

With a ZMK development environment set up:

sh
west build -s zmk/app -d build/bhoo_75 -b nice_nano_v2 -- \
  -DSHIELD=bhoo_75 -DZMK_CONFIG="$(pwd)/config"

west build -s zmk/app -d build/bhoo_20 -b nice_nano_v2 -- \
  -DSHIELD=bhoo_20 -DZMK_CONFIG="$(pwd)/config"

Flashing

  1. Plug the nice!nano into USB and double-tap reset. It mounts as a USB drive (NICENANO).
  2. Copy the matching .uf2 onto the drive. It reboots on its own when the copy finishes.
  3. Do the same for the other board.

Pairing problems? Flash settings_reset to both boards, then reflash the normal firmware. This clears stale split and Bluetooth bonds. Afterwards, remove the keyboard from your computer's Bluetooth list and pair it again.

Hardware

BHOO-75: custom PCB

Cross-section render of the BHOO-75 case, plate and PCB

The BHOO-75 uses a two-layer PCB designed in KiCad 8. It's about 336 mm wide, with:

  • solder-in MX switch footprints
  • one SOD-123 diode per key
  • a nice!nano v2 and a LiPo battery on the underside
Layout in KiCadBare board
KiCad PCB layoutBare BHOO-75 PCB
Populated (underside)Diodes up close
Populated PCB with nice!nano and batteryClose-up of soldered SOD-123 diodes
FileDescription
hardware/bhoo_75/pcb/KiCad 8 project: schematic (PCB.kicad_sch) and board (PCB.kicad_pcb)
hardware/bhoo_75/case/Top Case.stepTop case
hardware/bhoo_75/case/Bottom Case.stepBottom case
hardware/bhoo_75/case/Plate.stepSwitch plate
hardware/bhoo_75/case/Foot.stepFoot

Opening the PCB in KiCad: footprints are stored inside the board file, so the PCB opens without any extra libraries. To edit the schematic symbols or see the 3D view, you also need:

  • ScottoKicad: symbols, the nice!nano and diode footprints, and 3D models. Set the SCOTTOKEEBS_KICAD path variable to wherever you put it.
  • ai03 MX_V2: the MX_Solderable switch footprints.

The switch 3D models point to a file on the original author's PC, so they won't show in the 3D viewer.

BHOO-20: handwired numpad

The BHOO-20 is handwired: switches are wired directly into a 6 × 4 matrix with diodes, no PCB. Printable case parts are in hardware/bhoo_20/case/:

  • Top Case.stl
  • Bottom Case.stl
  • Plate.stl
  • Foot.stl

Wiring

BoardMatrixDiodesRows (GPIO)Columns (GPIO)
BHOO-756 × 15col2rowP1.02 P1.07 P1.06 P1.04 P0.11 P1.00P1.01 P0.02 P0.24 P0.22 P0.20 P0.17 P0.08 P0.06 P0.09 P0.10 P1.11 P1.13 P1.15 P0.29 P0.31
BHOO-206 × 4col2rowP0.09 P0.10 P1.11 P1.13 P1.15 P0.02P0.24 P1.00 P0.11 P1.04

The BHOO-20 OLED is an SSD1306 at I²C address 0x3C on i2c0, using the nice!nano default SDA/SCL pins.

The BHOO-75 matrix transform declares 19 columns. Columns 15–18 are virtual padding that reserve key positions 0–18 for the BHOO-20, so a single keymap can cover both devices.

Roadmap

  • Get the BHOO-20 OLED working
  • Send the BHOO-75 battery level to the BHOO-20 display
  • More layers (media, navigation)

Acknowledgements

License

Everything in this repository, including the firmware, the PCB and the case CAD, is released under the MIT License.

Parts

169
QtyValueFootprintReferences
84DiodeScottoKeebs_Components:Diode_SOD-123D1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +68
74KeyswitchMX_Solderable:MX-Solderable-1US1, S2, S10, S11, S12, S13, S14, S15, S16, S17, S18, S19, S20, S21, S22, S23 +58
4KeyswitchMX_Solderable:MX-Solderable-1.25US60, S75, S76, S77
2KeyswitchMX_Solderable:MX-Solderable-1.75US45, S72
1KeyswitchMX_Solderable:MX-Solderable-ISOS58
1KeyswitchMX_Solderable:MX-Solderable-6.25US78
1KeyswitchMX_Solderable:MX-Solderable-1.5US31
1KeyswitchMX_Solderable:MX-Solderable-2US29
1Nice_Nano_V2ScottoKeebs_MCU:Nice_Nano_V2U1

Similar boards

  • 2 layers410 × 128.5 mmFranklin ace-1000-keyboard, the printed circuit board in 3D

    Franklin ace-1000-keyboard

    osiweb/unified_retro_keyboard

    Project to provide keyboard replacements for various classic computers, as well as classic ASCII keyboard

    169 parts122
  • 2 layers281 × 108.3 mmPDP8, the printed circuit board in 3D

    PDP8

    douggilliland/Retro-Computers

    Retro-Computer Designs (Z80, 65C816, etc)

    169 parts87
  • 2 layers148.6 × 192.2 mmBadge, the printed circuit board in 3D

    Badge

    NuttyShell/NuttyBadge

    NuttyBadge: A NuttyShell crafted multi-tool. Opensourced Hardawre and Software

    169 parts31GPL-3.0
  • 2 layers284.7 × 94.2 mmStoryboard, the printed circuit board in 3D

    Storyboard

    cbskii/storyboard-keyboard

    5x12 split ortholinear keyboard with an E-INK display

    169 parts30MIT
  • 2 layers90 × 109 mmInterface 303, the printed circuit board in 3D

    Interface 303

    jeanpri/303

    303 eurorack interface for x0x-heart

    169 parts23
  • 2 layers301.9 × 106.3 mmXavien gateron millmax, the printed circuit board in 3D

    Xavien gateron millmax

    yyevax/xavient-kbd

    xavient is a thin split mechanical keyboard that does not sacrifice repairability and upgradablility. Inspired by the sleek design of the Corne-ish Zen but with hotswappalbe switches and components.

    169 parts22CC-BY-4.0
  • 2 layers174 × 111 mmPedalboard hw, the printed circuit board in 3D

    Pedalboard hw

    pedalboard/pedalboard-hw

    pedalboard audio midi processor open hardware

    169 parts14CERN-OHL-P-2.0
  • 2 layers285.1 × 94.6 mmYuTofu PCB, the printed circuit board in 3D

    YuTofu PCB

    ymkn/YuTofu

    YuTofu is an unofficial compatible PCB for the well-known custom keyboard Tofu60 2.0.

    169 parts5MIT

Questions

How big is the Bhoo 75 PCB?

It measures 306.4 × 122.2 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Bhoo 75 use?

169 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 Bhoo 75 KiCad files?

From the dhillon-m/custom-keyboard repository on GitHub, at the commit this page was made from: the board is hardware/bhoo_75/pcb/PCB.kicad_pcb and its schematic hardware/bhoo_75/pcb/PCB.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Bhoo 75 design in my own project?

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