Repository navigation
HHKB Classic Nightly — 2026.11.16
Pre-release
Pre-release
Pre-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.
Headline: Travel Calibration, Curve Modeling & Complete VIA Diagnostic Suite
This release introduces per-key physical travel curve calibration with PCHIP spline interpolation, extended factory reset safety controls, unified HID console diagnostics, and deep VIA configuration integration.
- 5-Point Monotonic Travel Calibration: Accurate physical travel modeling from 0.0 mm up to the user-configured max bottom-out depth (3.1–4.5 mm, default 4.0 mm) using PCHIP (Piecewise Cubic Hermite Interpolating Polynomial) spline interpolation with zero overshoot or non-monotonic oscillation.
- Actuation Clamping & Safety Bounds: Strict firmware-level clamping guarantees actuation points and Rapid Trigger sensitivities can never exceed calibrated bottom-out depth.
- Guarded Factory Reset in VIA: Added dedicated EEPROM reset menu with two-step safety confirmation toggle and hardware DIP SW6 protection against accidental wipes.
- Standardized HID Console Diagnostics: Unified reporting across all debugging channels with structured key coordinates, raw ADC readings, floating baseline, and travel percentages.
What's Changed
Calibration & Travel Curve Modeling
- 5-Point Calibration Curve:
- Modeled key travel using 5 control points: 0% (0.0 mm baseline), 25%, 50%, 75%, and 100% of the user-configured bottom-out depth (3.1–4.5 mm).
- Implemented monotonic cubic spline interpolation (PCHIP) evaluated into a 126-entry lookup table mapping ADC delta directly to travel depth.
- Added interactive visualizer utility (
tools/ec_curve_visualizer.py, executable viauv run tools/ec_curve_visualizer.py) for inspecting individual dome curves.
- Dynamic Baseline & Temperature Compensation:
- Documented and refined baseline tracker: moving average over 16 non-actuated samples with slow continuous background drift tracking.
- Actuation Point Bounds Checking:
- Enforced strict hardware clamping:
act_pm,press_pm, andrelease_pmare automatically bounded bycurve[125](maximum physical bottom-out travel), preventing dead-zone key states.
- Enforced strict hardware clamping:
VIA Controls & Settings Storage
- Guarded Factory Reset Submenu:
- Added dedicated reset action with a two-step confirmation toggle (
Confirm Reset) directly in the VIA custom menu. - Implemented hardware interlock: factory reset via VIA is blocked unless DIP switch SW6 is set to ON, preventing accidental wiping during standard usage.
- Added dedicated reset action with a two-step confirmation toggle (
- Calibrated EEPROM Storage:
- Hardened EEPROM magic storage guards to persist customized key calibration baselines and peaks reliably across firmware updates.
- Maintained backward compatibility with legacy keymap structures.
- Dynamic Status Label Refresh:
- Documented WebHID / VIA v3 menu limitations: dynamic status indicators (such as calibration completion) require selecting another submenu or reloading the tab to poll fresh values.
- Status Indicator Naming:
- Standardized LED indicator naming in VIA definitions (Blue and Orange LEDs).
HID Console Diagnostics
- Standardized EC Matrix Streaming:
- Unified matrix debug stream format across diagnostic tools:
[EC] R<row> C<col> : raw=<raw> base=<base> peak=<peak> travel=<norm/10>% <DN|UP>
- Unified matrix debug stream format across diagnostic tools:
- Enhanced Calibration Progress Monitoring:
- Real-time ASCII progress bar and percentage completion reporting for all 60 keys:
[CAL] [====> ] 45% (27/60) | Key R1 C3 peak: 2840 (base: 1120)
- Real-time ASCII progress bar and percentage completion reporting for all 60 keys:
- Channel Documentation:
- Documented all active console channels (
[EC],[CAL],[RATE],[VIA_DIAG],[BOOT]) invia.md.
- Documented all active console channels (
Build System & Documentation
- Toolchain & Build Automation:
build_all.shnow automatically detects and uses locally builtpicotoolfrom CMake dependencies with fallback to system binaries (#3).- Added build target directory ignores for local development hygiene.
- Documentation Overhaul:
- Integrated complete VIA, HID console debugging, and calibration guides into
keyboards/hhkb_classic/docs/via.md(both Russian and English versions). - Documented hardware research notes and model matrix references for HHKB Hybrid and Studio controllers.
- Integrated complete VIA, HID console debugging, and calibration guides into
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/EC 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 & Calibration: 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.