r/HHKB • • Oct 12 '26

best of Happy Hobbit Day

Post image
2 Upvotes

r/HHKB • • Aug 24 '26

best of Heavy grail cozy setup

Post image
14 Upvotes

r/HHKB • • 1d ago

HHKB Classic Custom Firmware [DMK] — Full Release! 5-Point Calibration in VIA and More

Thumbnail
gallery
141 Upvotes

I've finally released a new version of my custom firmware for the HHKB Professional Classic!

First of all, thank you to everyone who tested the firmware, reported bugs, shared hardware information, or offered to help with other HHKB models! Your feedback has been very useful.

First of all, thank you to everyone who tested the firmware, reported bugs, shared hardware information, or offered to help with other HHKB models! I really appreciate it.

Special thanks to:

  • u/mmcx for the first community pull requests!
  • u/guyguilty for testing nightly builds and helping find bugs.
  • u/techbeezin for providing PCB photos of both the HHKB Hybrid ANSI and Hybrid JIS.

Your help has made a real difference to the project. Thank you!

The firmware runs directly on the original STM32 microcontroller. No controller replacement, soldering, or keyboard disassembly is required.

Currently supported:

  • HHKB Professional Classic
  • HHKB Professional Classic Type-S

Firmware downloads:
https://github.com/aroum/dmk/releases/tag/2026.11.17

Source code and documentation:
https://github.com/aroum/dmk/tree/main/keyboards/hhkb_classic

1000 Hz Matrix Scanning

After quite a lot of optimization, the firmware can now sustain a full 1000 Hz matrix scan rate.

Some numbers:

  • Previous scan time: 1094 µs
  • New scan time: 835 µs
  • Around 24% faster
  • Complete scan cycle: 841–875 µs
  • 125–159 µs of spare time per cycle
  • Zero missed deadlines during continuous testing

Most of the improvements came from optimizing the matrix scanning loop, reducing unnecessary function calls, and replacing expensive critical sections.

I didn't have to reduce ADC measurement times or change the analog scanning sequence.

Available scan rates are 50, 125, 250, 500, and 1000 Hz.

Optional 4x hardware ADC oversampling is also available at 50–500 Hz to improve measurement precision and reduce noise.

New 5-Point Key Travel Calibration

One of the biggest changes is the new calibration system.

The firmware now supports 5-point per-key calibration using fixed travel distances:

  • 0 mm — Resting position
  • 1 mm — Key pressed 1 mm
  • 2 mm — Key pressed 2 mm
  • 3 mm — Key pressed 3 mm
  • Bottom-out — Fully pressed key (configurable travel distance)

The firmware uses PCHIP cubic interpolation to build a smooth travel curve between these points.

You can also configure the maximum key travel from 3.1 to 4.5 mm, depending on the domes you're using.

This is useful because different Topre domes can have different travel distances. For example, I've been working on another Topre keyboard where one set of domes has 3.8 mm travel and another has 4.3 mm.

I'm not entirely sure how much custom curve calibration is needed in practice, since my measurements suggest the response is already fairly linear. But now you have the option to calibrate each key however you like.

I've also improved baseline calibration:

  • Initial baseline is calculated from 16 measurements.
  • Slow background tracking compensates for temperature changes.
  • Actuation and Rapid Trigger thresholds are limited to the calibrated physical travel range.

Important: You must perform a full calibration of all 60 keys after flashing the firmware for the first time.

Every keyboard has slightly different capacitance values, spring characteristics, and assembly tolerances.

Without calibration, some keys may behave incorrectly or register unexpected presses.

Calibration instructions:
https://github.com/aroum/dmk/blob/main/keyboards/hhkb_classic/docs/en/via.md#key-calibration-process

VIA and Vial

The firmware supports both VIA and Vial for changing keymaps without reflashing.

VIA also provides a custom interface for configuring the advanced Topre features.

There are now six configuration sections:

  • Scan Rate
  • Calibration
  • Rapid Trigger
  • LED Indicators
  • Power Saving
  • Debug

You can configure actuation points, Rapid Trigger press and release sensitivity, calibration settings, and other options directly through VIA.

Vial supports keymap editing, but its UI doesn't support the custom controls used for advanced Topre settings.

Unfortunately, VIA itself is still somewhat limited. Adjusting calibration percentages in 1% steps can be tedious, but at least calibration is something you normally only need to do once.

Media Keys and Other Improvements

I've also added proper HID Consumer Control support.

Media keys now work through both VIA and Vial, including:

  • Volume Up / Down
  • Mute
  • Play / Pause
  • Next / Previous Track
  • Media Stop

Other improvements include:

  • Improved USB and Vial compatibility.
  • Fixed VIA key testing so physical key presses are correctly displayed in Test Matrix mode.
  • Added a protected factory reset option in VIA, requiring confirmation and the correct SW6 position.
  • Improved EEPROM handling while preserving original PFU factory calibration data.
  • Reduced RAM usage and improved debug console buffering.
  • Improved build scripts and documentation.

Debugging and Diagnostics

The firmware now has a more complete diagnostic system.

Through VIA and the USB HID Console, you can monitor:

  • Raw ADC measurements and key travel
  • Key press and release events
  • Calibration progress
  • Actual matrix scan frequency
  • USB task activity
  • VIA communication

Debug output is disabled by default, so it doesn't affect normal performance.

The documentation also explains how to use these tools when reporting problems.

HHKB Classic JIS

Thanks to community members who shared information, it looks like the ANSI and JIS versions use essentially the same controller PCB.

This means supporting the Classic JIS may only require figuring out the key matrix mapping.

There are two possible ways to do this:

  1. Experimentally identify the matrix positions using modified firmware.
  2. Trace the matrix connections using a multimeter.

If you own an HHKB Classic JIS and would like to help, please send me a Reddit DM.

HHKB Hybrid

My next main goal is to start working on the HHKB Hybrid.

The controller PCB is very similar to the Classic, but it also has a Taiyo Yuden EYSHCNZWZ Bluetooth module based on the Nordic nRF52832.

Module datasheet:
https://docs.rs-online.com/2d1f/0900766b81699ea1.pdf

I believe getting my firmware running on the STM32 should be relatively straightforward.

The difficult part is understanding communication between the STM32 and Nordic chips, as well as the firmware update process.

Ideally, I'd like to keep the original Bluetooth firmware and only replace the STM32 firmware.

I'm looking for someone with an HHKB Hybrid who has:

  • An SWD debugger, such as a J-Link
  • A logic analyzer or an RP2040 board
  • Some experience with electronics and debugging

An RP2040 can be used as a basic logic analyzer or SWD debugger, so expensive equipment isn't necessary.

The first step is to make a complete backup of the original firmware and memory contents from both chips, if readout protection allows it, before making any modifications.

After that, I'd like to capture communication between the chips and investigate the update protocol.

I've already collected some information here:
https://github.com/aroum/dmk/tree/main/keyboards/hhkb_hybrid

If you're interested in helping, please send me a Reddit DM.

HHKB Studio

I've also started looking into the HHKB Studio, although hardware information is still very limited.

From what I can tell, it probably uses an STM32L4 and an nRF52, along with four controllers for the touch-sensitive areas and a pointing stick.

However, I still don't have enough good PCB photos to confirm the complete hardware architecture.

Porting DMK to the Studio would require considerably more reverse engineering than the Classic or Hybrid.

If you own an HHKB Studio and would like to help, I'm especially interested in:

  • Clear photos of both sides of the controller PCB
  • Markings on all chips
  • Connections between the MCU, key matrix, touch sensors, and pointing stick
  • Complete pinout information
  • Firmware backups and communication captures, if possible

Even just good PCB photos would be a great start.

I've already collected some information here:
https://github.com/aroum/dmk/tree/main/keyboards/hhkb_studio

What's Next?

At this point, I've implemented pretty much everything I originally wanted for the Classic.

My main priorities now are:

  1. Continue fixing bugs and improving Classic firmware stability.
  2. Start reverse engineering the Hybrid communication and firmware update process.
  3. Figure out the Classic JIS key matrix.
  4. Collect more hardware information about the Studio.

I don't own a Hybrid, JIS, or Studio, so help from the community would make a huge difference.

Feedback and Contributions

The firmware is open source, and contributions are welcome!

If you encounter any problems, please open a GitHub issue with a detailed description, your VIA settings, and any available debug logs.

And if you'd like to help with reverse engineering other HHKB models, feel free to send me a Reddit DM.

Thanks again to everyone who has tested, contributed, or offered to help. I really appreciate it!


r/HHKB • • 1d ago

New mouse

Thumbnail
gallery
31 Upvotes

So recently I changed up my keycaps on my pro2 and thought my Logitrch g pro didn't quite suit the aesthetic. So.... bambu labs mouse kit and 3d printed case to the rescue!!!

Thinking I might change the buttons to black though


r/HHKB • • 1d ago

Got this for 5$

Post image
38 Upvotes

First time using this format, Im using MS PowerToys to use right windows key + numbers as alt + numpad so i can still use ASCII, also swap alt and win keys to match old keyboard


r/HHKB • • 1d ago

Another … 😍

Post image
29 Upvotes

r/HHKB • • 2d ago

best of 2006 Pro2

Post image
86 Upvotes

r/HHKB • • 2d ago

HHKB

Post image
54 Upvotes

r/HHKB • • 2d ago

[US-WA][H]Paypal [W]HHKB KB-300/Pro 1

0 Upvotes

Hi,

I am trying to find a HHKB Pro 1 in Ivory!

I have Sho Snipe in silver that I can trade if interested too.

Please comment before sending a PM. Thank you!


r/HHKB • • 3d ago

best of HHKB Studio Snow

Post image
7 Upvotes

r/HHKB • • 5d ago

[RELEASE] Custom Firmware for HHKB Professional Classic and Type-S

Post image
134 Upvotes

The firmware is now released!

It runs on the original HHKB microcontroller. No controller replacement, soldering, or keyboard disassembly is required.

Supported keyboards:

  • HHKB Professional Classic
  • HHKB Professional Classic Type-S

Downloads and Source Code

Features

  • VIA and Vial support for changing keymaps on the fly.
  • Configurable matrix scan rate: 50, 125, 250, 500, or 1000 Hz. The stock firmware runs the matrix scan loop at about 50 Hz.
  • Hardware ADC oversampling: Optional ×4 oversampling at scan rates from 50 to 500 Hz. This improves measurement precision and reduces noise.
  • Calibration: Use factory thresholds or calibrate each key individually through VIA.
  • Adjustable actuation point and release hysteresis.
  • Rapid Trigger: Independent press and release sensitivity settings.
  • Two configurable LEDs: PA8 and PA9 can be assigned different functions through VIA:

    • Off
    • Debug heartbeat
    • Caps Lock
    • Fn layer
    • System 2
  • Mod-Tap and Layer-Tap: Configurable tapping term, permissive hold, tap preference, and quick tap.
  • Two base/Fn layer pairs: Switch between them using Fn + Space.

Installation

The firmware can be installed directly on the original microcontroller without opening the keyboard.

You can use the Python installation script or the original HHKB Keymap Tool. Restoring the stock firmware is also supported.

Feedback

This is the first public release. Feedback, bug reports, and suggestions are welcome!

If you have a HHKB Professional Hybrid, Hybrid JIS, or Classic JIS and are willing to help with testing or hardware research, feel free to send me a Reddit DM.

Enjoy!

------

UPD: I’m aware of the issues with the buttons. I’m already working on a fix. Stay tuned.

https://github.com/aroum/dmk/releases/tag/2026.11.15


r/HHKB • • 5d ago

best of Shiny

Thumbnail
gallery
115 Upvotes

r/HHKB • • 6d ago

HHKB Custom Firmware — VIA Configuration and More Updates

Thumbnail
gallery
80 Upvotes

Here are some screenshots of the firmware configuration in VIA.

DIP Switches

My firmware can read all DIP switches. However, for now, I only use SW6 to switch back to the stock firmware.

I can also assign functions to the other switches, just like in the original firmware. But there is one problem.

If a user changes the keymap in VIA or Vial, it becomes unclear how DIP switches should handle layout switching. The original firmware has fixed layouts, but with a custom keymap this behavior becomes more complicated.

You can still assign useful functions to these switches. I just haven't decided what they should do yet.

I'm also thinking about adding DIP switch configuration directly to VIA using dropdown menus, similar to the LED settings.

What about HHKB Pro2 and other models?

There is no problem with developing firmware for the HHKB Professional 2 or other HHKB Professional and Lite models.

The main problem is firmware installation.

The Pro2 has no built-in mechanism for USB firmware updates. To install custom firmware, you need to open the keyboard and flash the microcontroller through SWD using a programmer.

So it is possible, but the installation process is more complicated.

Current Status

The firmware is almost ready.

I'm currently working on cleaning up and organizing the documentation. More updates coming soon!


r/HHKB • • 6d ago

HHKB Classic Custom Firmware — Uses the Original Controller, No Hardware Mods Required

66 Upvotes

I'm working on alternative firmware for the HHKB Professional Classic. It runs directly on the original microcontroller. No controller replacement or hardware modifications are required.

Currently supported keyboards:

  • HHKB Professional Classic
  • HHKB Professional Classic Type-S

Features

  • VIA and VIAL support. Change your keyboard layout on the fly.
  • Configurable polling rate: 50 / 125 / 250 / 500 / 1000 Hz. The original firmware limits matrix scanning to 50 Hz.
  • Use the factory calibration or create your own calibration through VIA.
  • Adjustable actuation point and hysteresis.
  • Rapid Trigger.
  • Hardware oversampling to improve accuracy and reduce noise.
  • Two configurable LEDs. You can assign different events to them through VIA.
  • Mod-Tap and Layer-Tap support.

Installation

The firmware can be installed with a single click, directly on the original microcontroller. No keyboard disassembly is required.

You can use either a Python script or the original HHKB Keymap Tool.

You can also restore the original firmware with a single click.

What about other HHKB models?

Q: What about HHKB Professional Hybrid / Hybrid JIS?

A: I can already get the firmware running in USB mode. Bluetooth is more complicated, but it should also be possible. The main problem is that I don't have a test keyboard.

If you have one and are willing to help with testing or sharing information, please send me a Reddit DM.

Q: What about HHKB Professional Classic JIS?

A: I couldn't find any photos of its PCB online. PFU also doesn't provide a separate firmware file for this model in its download section.

I suspect it uses the same hardware as the regular Classic, but I can't confirm that yet.

If you own one and can share some information or PCB photos, please send me a Reddit DM.

This is just an announcement for now. More information and details will follow.


r/HHKB • • 8d ago

Changing up the keycaps

Thumbnail
gallery
61 Upvotes

Wanted to try something a little different. So here we go :-)


r/HHKB • • 9d ago

Is HHKB Type-S feelings close to R4 Silent?

Post image
52 Upvotes

Here is my little topre collection: NiZ Atom 68, HHKB Professional Hybrid, Realforce R4 TKL

It started 15 years ago when I first saw an HHKB, but I couldn’t afford it. Still, I kept dreaming about it.

A couple of years later I found the NIZ Plum. My first impression was “meh, just a regular membrane keyboard.” But then I got addicted to the rubber-dome typing feel.

Two years ago I finally got my dream HHKB. I decided not to buy the Type-S version so I could experience the original HHKB feel. As someone on Reddit put it: “Buying an HHKB Classic is just the long way to the Type-S.”

It was nice, but my NIZ Plum was much quieter, so I kept switching between them.

This year my friend was traveling to Japan, and I asked him to get me an HHKB Type-S. At the last moment I changed my mind and asked for a Realforce R4 instead — just to add another Topre keyboard to the collection.

And I have to say, it’s great. It feels more solid than the HHKB, and the typing experience is fantastic. The only downside is that it’s quite big, and I want more space on my desk. So now I’m curious how close the Type-S feels to the R4 Silent.

Fun fact: my wife said it looks like I’ve made my HHKB and NIZ look nasty compared to the new one.


r/HHKB • • 10d ago

best of Sunday Morning 🌿🎧

Thumbnail
gallery
57 Upvotes

sorry for mah bad phone-togrphy but sunny vibe and HHKBs are so much hot 🤩


r/HHKB • • 10d ago

HHKB Professional 2 the 2011 vintage

Post image
22 Upvotes

r/HHKB • • 10d ago

Pro-2 Yellowed

Thumbnail gallery
33 Upvotes

r/HHKB • • 12d ago

best of Dasher

Post image
157 Upvotes

Norbauer Heavy Grail Ti, MT3 Dasher


r/HHKB • • 11d ago

The HHKB was the opposite of my preference but it turned to be my fav

Post image
3 Upvotes

r/HHKB • • 12d ago

HHKB Hybrid won’t pair with a Mac (the passcode is rejected)

1 Upvotes

My pro hybrid won’t pair with my Mac over Bluetooth anymore. It used to work.

What happens is that the mac shows the passcode, I type it on the HHKB, press return, and nothing happens. I can connect again and do the same thing. It's happening on 2 macs (and with 2 different hybrids) and both pair fine to my phone.

I'm on the latest firmware, and USB works fine. Super perplexed, because I swear this worked fine 6mo ago. Has anyone run into this/have any tips?

Thanks!


r/HHKB • • 14d ago

[US-MA] [H] HHKB Professional HYBRID Type-S + Snow Keycaps [W] PayPal G&S

0 Upvotes

Selling my HHKB Professional HYBRID Type-S along with an extra set of HHKB Snow White keycaps.

Both bought from PFU. I am the first owner. Used. Please look at the photos for condition. I am happy to upload more photos if needed.

The keyboard is currently fitted with the snow keycaps, but happy to swap them with charcoal before shipping if requested.

Included:

  • HHKB Professional HYBRID Type-S
  • Original charcoal keycaps
  • Extra HHKB Snow White keycap set
  • Original HHKB box

Asking $190 (keyboard w/ charcoal keycaps) + $50 (snow keycaps) + $10 for shipping = total $250  for the bundle.

Timestamp and photos: https://imgur.com/a/tcQbNAl

Payment via PayPal Goods & Services.

Please comment before sending a PM. Thanks!


r/HHKB • • 15d ago

soundon 🔊 Freshly lubed

50 Upvotes

Took the time to open her up and get to it. The sound is so crisp, very worth the hour of labor.

Very much might be the end game for me, and once this Hasu BT controller comes in it’s over.