Case study

MK Typist research: mapping a keyboard and its bootloader

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.

Targets: Firmware · Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C2 code & docs, no demo or download

Stars: 0
Last commit: 2026-10-25
License (GitHub): CC-BY-4.0

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code and documentation observed; no download method or demo found.
Checked: 2026-11-08

How evidence classes are assigned

Requirements & limits

Scope: Findings come from one MK Typist unit with stock firmware V1.00.05; the QMK port is maintained in a separate repository.
Limits: The chip ships with flash protection enabled; unlocking it mass-erases the stock IAP bootloader.
License: Documentation, photos and OpenOCD configuration use CC BY 4.0.

Cite

BibTeX

@misc{mk-typist-research-case,
  title = {{MK Typist research: mapping a keyboard and its bootloader}},
  howpublished = {\url{https://github.com/jpsutton/mk-typist-research}},
  url = {https://github.com/jpsutton/mk-typist-research},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/mk-typist-research-case/}}
}

Plain text

MK Typist research: mapping a keyboard and its bootloader. https://github.com/jpsutton/mk-typist-research (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/mk-typist-research-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · jpsutton/mk-typist-research · Revision 4b2ca5f
docs/boot-modes.md GitHub · jpsutton/mk-typist-research · Revision 4b2ca5f