{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/MiguelSanzBr/8bitdo-ultimate2-linux/blob/03957a0c165b214a501337279149144e36764af3/README.md",
    "https://github.com/MiguelSanzBr/8bitdo-ultimate2-linux/blob/03957a0c165b214a501337279149144e36764af3/LICENSE"
  ],
  "category": "community-case-studies",
  "class": "hardware",
  "description_en": "ultimate2 reconstructs the configuration protocol for supported 8BitDo controllers and implements command-line, graphical and browser clients. Its protocol document reports using REA with Ghidra on a native DLL and ILSpy on .NET assemblies to recover HID reports and configuration records. The clients read, edit and write controller settings.",
  "description_zh": "ultimate2 重建部分 8BitDo 手柄的配置协议，并提供命令行、图形界面和浏览器客户端。协议文档报告使用 REA 配合 Ghidra 分析原生 DLL，并用 ILSpy 反编译 .NET 程序集，以整理 HID 报告和配置记录；客户端可读取、修改并写入手柄设置。",
  "entry_url": "https://awesomerea.org/resources/8bitdo-controller-hid-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/8bitdo-controller-hid-case/",
  "evidence_url": "https://github.com/MiguelSanzBr/8bitdo-ultimate2-linux/blob/03957a0c165b214a501337279149144e36764af3/docs/PROTOCOL.md",
  "group": "rea",
  "id": "8bitdo-controller-hid-case",
  "json_url": "https://awesomerea.org/resources/8bitdo-controller-hid-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/8bitdo-controller-hid-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/8bitdo-controller-hid-case/index.md",
  "name": "ultimate2: 8BitDo controller configuration protocol and Linux client",
  "name_zh": "ultimate2：8BitDo 手柄配置协议与 Linux 客户端",
  "record_type": "resource",
  "relationship": "community-reported-mixed-workflow",
  "requirement_facets": [
    "prerequisites",
    "testing",
    "limits",
    "license"
  ],
  "requirements": [
    "Python 3.8 or newer and Tk for the Linux GUI; a supported controller and hidraw access are needed for device use.",
    "The author reports testing a controller over USB; the cited 2.4G dongle path remains untested.",
    "The project labels the software beta and advises backing up the controller configuration before changes.",
    "MIT license."
  ],
  "requirements_zh": [
    "Linux 图形界面需要 Python 3.8 或更新版本及 Tk；操作设备还需要受支持的手柄和 hidraw 访问权限。",
    "作者报告已通过 USB 测试手柄；所述 2.4G 接收器路径尚未测试。",
    "项目标为测试版，并建议修改前备份手柄配置。",
    "MIT 许可证。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/MiguelSanzBr/8bitdo-ultimate2-linux",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}