{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/kraln/macrosilicon_firmware/blob/caa3d270fd656858a5b004c5498fe03a52c57e5f/ms2109/rom/d7_rom_notes.md",
    "https://github.com/kraln/macrosilicon_firmware/blob/caa3d270fd656858a5b004c5498fe03a52c57e5f/docs/macrosilicon-notes.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "Macrosilicon Custom Firmware studies the 8051 mask ROM and EEPROM loading behavior of MS2107, MS2109 and MS9123 USB video chips, then builds replacement EEPROM images. Its chip notes map hooks, headers and memory addresses; host tools dump device memory and access new HID mailbox commands for status, GPIO and I2C.",
  "description_zh": "Macrosilicon Custom Firmware 研究 MS2107、MS2109 和 MS9123 USB 视频芯片的 8051 掩膜 ROM 与 EEPROM 加载行为，并构建替代 EEPROM 镜像。芯片笔记标注钩子、文件头和内存地址；宿主工具可转储设备内存，并通过新增 HID 命令邮箱访问状态、GPIO 和 I2C。",
  "entry_url": "https://awesomerea.org/resources/macrosilicon-custom-firmware-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/macrosilicon-custom-firmware-case/",
  "evidence_url": "https://github.com/kraln/macrosilicon_firmware/blob/caa3d270fd656858a5b004c5498fe03a52c57e5f/README.md",
  "group": "cases",
  "id": "macrosilicon-custom-firmware-case",
  "json_url": "https://awesomerea.org/resources/macrosilicon-custom-firmware-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/macrosilicon-custom-firmware-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/macrosilicon-custom-firmware-case/index.md",
  "name": "Macrosilicon Custom Firmware: rebuilding USB video chip EEPROM firmware",
  "name_zh": "Macrosilicon Custom Firmware：重建 USB 视频芯片 EEPROM 固件",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "testing",
    "license"
  ],
  "requirements": [
    "A supported MS2107, MS2109 or MS9123 device; build instructions use SDCC tooling.",
    "The MS2109 D7 mailbox has been tested from RAM, but its flashed image has not been run on hardware.",
    "No licence file in the repository."
  ],
  "requirements_zh": [
    "需要受支持的 MS2107、MS2109 或 MS9123 设备；构建说明使用 SDCC 工具链。",
    "MS2109 D7 命令邮箱已在 RAM 中测试，但刷入后的镜像尚未在硬件上运行。",
    "仓库中没有许可证文件。"
  ],
  "targets": [
    "firmware"
  ],
  "url": "https://github.com/kraln/macrosilicon_firmware",
  "verification": "source-reviewed",
  "verified_at": "2026-11-08"
}