{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/jpsutton/mk-typist-research/blob/4b2ca5f1355ab68b738b407196ea2f7c63df06b0/docs/boot-modes.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "MK Typist research maps the Mechanical Keyboards MK Typist keyboard and its stock firmware while developing a QMK port. The notes cover its Holtek HT32F52352 board, flash layout, Cheng Yong IAP boot flow, USB identities, update behavior, pinout and captured command output from one unit.",
  "description_zh": "MK Typist research 在移植 QMK 的过程中解析 Mechanical Keyboards MK Typist 键盘及原厂固件，记录 Holtek HT32F52352 电路板、闪存布局、Cheng Yong IAP 启动流程、USB 标识、更新行为、引脚和单台设备的命令抓取结果。",
  "entry_url": "https://awesomerea.org/resources/mk-typist-research-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/mk-typist-research-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/jpsutton/mk-typist-research/blob/4b2ca5f1355ab68b738b407196ea2f7c63df06b0/README.md",
  "group": "cases",
  "id": "mk-typist-research-case",
  "json_url": "https://awesomerea.org/resources/mk-typist-research-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/mk-typist-research-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/mk-typist-research-case/index.md",
  "name": "MK Typist research: mapping a keyboard and its bootloader",
  "name_zh": "MK Typist research：解析键盘硬件与启动加载器",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "scope",
    "limits",
    "license"
  ],
  "requirements": [
    "Findings come from one MK Typist unit with stock firmware V1.00.05; the QMK port is maintained in a separate repository.",
    "The chip ships with flash protection enabled; unlocking it mass-erases the stock IAP bootloader.",
    "Documentation, photos and OpenOCD configuration use CC BY 4.0."
  ],
  "requirements_zh": [
    "研究基于一台运行原厂固件 V1.00.05 的 MK Typist；QMK 移植代码位于另一仓库。",
    "芯片出厂启用闪存保护；解锁会整体擦除原厂 IAP 启动加载器。",
    "文档、照片和 OpenOCD 配置采用 CC BY 4.0。"
  ],
  "scope": "unknown",
  "targets": [
    "firmware",
    "protocol"
  ],
  "url": "https://github.com/jpsutton/mk-typist-research",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}