Skip to content

HHKB Classic Nightly — 2026.11.16

Pre-release
Pre-release

Choose a tag to compare

@aroum aroum released this 16 Nov 19:41
· 1 commit to main since this 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 via uv 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, and release_pm are automatically bounded by curve[125] (maximum physical bottom-out travel), preventing dead-zone key states.

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.
  • 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>
  • 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)
  • Channel Documentation:
    • Documented all active console channels ([EC], [CAL], [RATE], [VIA_DIAG], [BOOT]) in via.md.

Build System & Documentation

  • Toolchain & Build Automation:
    • build_all.sh now automatically detects and uses locally built picotool from 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.

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