Case study

ry5088-flasher: reconstructing a magnetic keyboard's HID-DFU path

ry5088-flasher reconstructs the USB HID-DFU update path used by RongYuan RY5088 magnetic keyboards. A Rust flasher reads the board's dev_id, obtains the matching stock image and transfers it through the documented bootloader protocol. The repository also provides profile-driven AT32F405 reference firmware, whose hardware bring-up is still experimental.

Targets: Firmware · Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06

Stars: 18
Last commit: 2026-06-16
Language: C
License (GitHub): MIT

GitHub data as of 2026-11-09

Copy as Markdown View JSON Cite

Requirements & limits

Prerequisites: An RY5088 keyboard, USB access and libhidapi are required for the flasher.
Prerequisites: Building the custom firmware requires arm-none-eabi-gcc and the separately obtained Artery BSP.
Limits: The author reports that the custom firmware builds and passes host tests but has not completed on-hardware bring-up.
License: MIT license.

Cite

BibTeX

@misc{ry5088-flasher-case,
  title = {{ry5088-flasher: reconstructing a magnetic keyboard's HID-DFU path}},
  howpublished = {\url{https://github.com/dot-agi/ry5088-flasher}},
  url = {https://github.com/dot-agi/ry5088-flasher},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/ry5088-flasher-case/}}
}

Plain text

ry5088-flasher: reconstructing a magnetic keyboard's HID-DFU path. https://github.com/dot-agi/ry5088-flasher (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/ry5088-flasher-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

docs/protocol.md GitHub · dot-agi/ry5088-flasher · Revision 2a7db6a
README.md GitHub · dot-agi/ry5088-flasher · Revision 2a7db6a
firmware/README.md GitHub · dot-agi/ry5088-flasher · Revision 2a7db6a
LICENSE GitHub · dot-agi/ry5088-flasher · Revision 2a7db6a