{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/m1sk9/HHKB-reverse-engineering/blob/33db39081a8081f128024ee62cf1ba022c63f360/docs/protocol.md",
    "https://github.com/m1sk9/HHKB-reverse-engineering/blob/33db39081a8081f128024ee62cf1ba022c63f360/docs/firmware.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "HHKB-reverse-engineering investigates the vendor USB HID protocol of the HHKB Professional Classic keyboard. It documents 64-byte request and response frames, command behavior, keymap layouts and firmware-dump behavior, with macOS IOKit tools for probing and changing keymaps.",
  "description_zh": "HHKB-reverse-engineering 研究 HHKB Professional Classic 键盘的厂商 USB HID 协议，记录 64 字节请求与响应帧、命令行为、键位映射布局及固件转储行为，并提供基于 macOS IOKit 的探测和修改工具。",
  "entry_url": "https://awesomerea.org/resources/hhkb-professional-classic-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/hhkb-professional-classic-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/m1sk9/HHKB-reverse-engineering/blob/33db39081a8081f128024ee62cf1ba022c63f360/README.md",
  "group": "cases",
  "id": "hhkb-professional-classic-case",
  "json_url": "https://awesomerea.org/resources/hhkb-professional-classic-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/hhkb-professional-classic-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/hhkb-professional-classic-case/index.md",
  "name": "HHKB Professional Classic: vendor HID and firmware investigation",
  "name_zh": "HHKB Professional Classic：厂商 HID 协议与固件研究",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "scope",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "The author reports measuring the findings on a PD-KB401B with firmware A4.29 under macOS 27.0.",
    "Building the tools requires the Xcode command line tools.",
    "Firmware flashing is not implemented; the author reports that dumping firmware leaves the keyboard read-only until it is unplugged and replugged.",
    "MIT License."
  ],
  "requirements_zh": [
    "作者称相关结果是在运行 A4.29 固件、连接至 macOS 27.0 的 PD-KB401B 上测得的。",
    "构建工具需要 Xcode 命令行工具。",
    "尚未实现固件刷写；作者称转储固件后，键盘须拔出重插才能退出只读状态。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "firmware",
    "protocol"
  ],
  "url": "https://github.com/m1sk9/HHKB-reverse-engineering",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}