Repository navigation
HHKB Classic Nightly — 2026.11.14
Pre-releasePre-release nightly build for HHKB Professional Classic (PD-KB401*, AHHX01) and Classic Type-S (PD-KB401*SC, AHHS01) running on the stock STM32L072 microcontroller. No hardware modifications or controller replacements are required.
Important: Recommended Initial Key Calibration
Although the firmware comes with robust default capacitive threshold baselines, it is strongly advised to perform a full custom calibration of all 60 keys after your initial flash to adapt to your specific PCB capacitance and spring tolerances.
Step-by-step calibration instructions, live console monitoring, and visual tracking via the Key Tester (Test Matrix) tab are provided in the VIA Calibration Process Guide.
Important Notice: Scan Rate Limitation
Matrix scan rate is currently capped to a maximum of 500 Hz. The 1000 Hz scan rate mode is temporarily restricted while timing optimization, power profiling, and stability validation are being completed. Hardware ADC 4x oversampling remains fully supported and recommended at 50–500 Hz.
What's Changed
Actuation & Typing Dynamics
- Set default actuation point to 75% key travel (~2.8 mm) with a 0.4 mm release hysteresis for typing stability out of the box.
- Rapid Trigger is disabled by default and can be enabled via VIA when required.
- Standardized stock baseline thresholds across builds; decoupled factory thresholds from CI.
Calibration Subsystem & Live Monitoring
- Added real-time calibration progress monitoring to the USB HID Console: displays baseline capture, per-key peak travel registration, and a dynamic progress bar (
[CAL] [====> ] X% (N/60)). - Added console notifications when a higher peak travel value is registered for an existing key (
[CAL] Key C... R... peak updated: ... -> ...). - Added
Calibration statusindicator andRefresh statusbutton to the VIA Calibration submenu. - Documented in VIA definitions and guides that custom UI labels do not poll continuously in VIA Web, and that navigating to the HID Console tab or Key Tester tab does not reset or interrupt active calibration.
- Documented workflow to visually monitor actuated keys during calibration by switching to the Key Tester tab and enabling Test Matrix.
VIA Configuration & Key Tester Fix
- Fixed VIA Key Tester matrix mode: corrected buffer offset and byte-endianness in the switch matrix state protocol handler (
VIA_SUB_SWITCH_MATRIX_STATE) so pressed physical keys highlight the exact corresponding keys in VIA's Test Matrix mode. - Added dedicated Debug submenu in VIA with selective toggles:
- Topre Matrix Stream (per-key ADC raw, permille travel, press/release events)
- Calibration Monitor (real-time progress output)
- Polling Rate Monitor (scan frequency reporting)
- VIA Telemetry Diag (protocol message inspection)
- Disabled all debug streaming channels by default to ensure minimal MCU load and zero USB overhead.
- Fixed a VIA Web UI crash caused by cross-menu conditional visibility rules (
showIf). - Added troubleshooting guidance for transient blank key legends on Layer 0 during initial VIA Web load.
- Added dedicated Debug section in VIA documentation linking to the diagnostic guide.
Flasher, Protocol Verification & Hardware Documentation
- Documented the verified PFU Raw HID firmware update protocol (
0xE0,0xE1,0xE2,0xE3) with 57-byte payload chunks in 64-byte HID reports. - Confirmed byte-for-byte fidelity of flashed Bank 2 firmware via hardware SWD readback.
- Added documentation for
hhkb_flasher.pyvalidation flags (--skip-crc,--skip-model-check,--force). - Added architectural overview and model reference for ANSI and JIS Classic and Type-S variants.
- Documented recovery procedures via SW6.
System & Memory Optimizations
- Reduced BSS memory footprint (optimized calibration baseline accumulation buffer and console formatting buffers) to prevent RAM exhaustion on STM32L072.
- Fixed USB Vial OUT endpoint
wMaxPacketSizeconfiguration (set to 64 bytes) to ensure proper short-packet completion. - Enhanced HID console synchronization to eliminate cross-key log message interleaving.
Included Assets
dmk-hhkb-classic-classic-via.hfb: Firmware for HHKB Professional Classic (Model AHHX01, HFB version A4.50).dmk-hhkb-classic-type-s-via.hfb: Firmware for HHKB Professional Classic Type-S (Model AHHS01, HFB version A8.50).via.json: Complete VIA v3 draft definition containing layout definitions, custom Topre settings, calibration controls, and debug toggles.
Installation & Documentation
- Installation Guide: https://github.com/aroum/dmk/blob/dev/keyboards/hhkb_classic/docs/en/install.md
- VIA Configuration: https://github.com/aroum/dmk/blob/dev/keyboards/hhkb_classic/docs/en/via.md
- Debugging & HID Console: https://github.com/aroum/dmk/blob/dev/keyboards/hhkb_classic/docs/en/debug.md
- Flashing can be performed using
tools/hhkb/hhkb_flasher.pyor the official PFU HHKB Keymap Tool.