{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/dot-agi/ry5088-flasher/blob/2a7db6ad83cf20385897b4080a586764916656e5/README.md",
    "https://github.com/dot-agi/ry5088-flasher/blob/2a7db6ad83cf20385897b4080a586764916656e5/firmware/README.md",
    "https://github.com/dot-agi/ry5088-flasher/blob/2a7db6ad83cf20385897b4080a586764916656e5/LICENSE"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "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.",
  "description_zh": "ry5088-flasher 重建 RongYuan RY5088 磁轴键盘的 USB HID-DFU 更新流程。Rust 刷写器读取所连接键盘的 dev_id，获取对应的原厂固件镜像，并通过文档记录的引导加载器协议传输。仓库还提供按机型配置的 AT32F405 参考固件，尚未完成实机调试。",
  "entry_url": "https://awesomerea.org/resources/ry5088-flasher-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/ry5088-flasher-case/",
  "evidence_url": "https://github.com/dot-agi/ry5088-flasher/blob/2a7db6ad83cf20385897b4080a586764916656e5/docs/protocol.md",
  "group": "cases",
  "id": "ry5088-flasher-case",
  "json_url": "https://awesomerea.org/resources/ry5088-flasher-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/ry5088-flasher-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/ry5088-flasher-case/index.md",
  "name": "ry5088-flasher: reconstructing a magnetic keyboard's HID-DFU path",
  "name_zh": "ry5088-flasher：重建磁轴键盘的 HID-DFU 刷写流程",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "An RY5088 keyboard, USB access and libhidapi are required for the flasher.",
    "Building the custom firmware requires arm-none-eabi-gcc and the separately obtained Artery BSP.",
    "The author reports that the custom firmware builds and passes host tests but has not completed on-hardware bring-up.",
    "MIT license."
  ],
  "requirements_zh": [
    "刷写器需要 RY5088 键盘、USB 访问权限和 libhidapi。",
    "构建自定义固件需要 arm-none-eabi-gcc 和另行获取的 Artery BSP。",
    "据作者报告，自定义固件可以构建并通过主机测试，但尚未完成实机启动调试。",
    "MIT 许可证。"
  ],
  "targets": [
    "firmware",
    "protocol"
  ],
  "url": "https://github.com/dot-agi/ry5088-flasher",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}