{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/FNKG9527/fiil-pods-pc/blob/e7a11989e3ba007211ad548c8f04ad6fa4374bc2/README.md",
    "https://github.com/FNKG9527/fiil-pods-pc/blob/e7a11989e3ba007211ad548c8f04ad6fa4374bc2/docs/evidence/README.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "FIIL 耳机控制 implements a Windows client from reverse-engineered BLE GATT commands used by FIIL headphones. Protocol notes describe the fdb3 service, ff17 write and ff18 notification characteristics, message framing, unlock sequence and command responses. The desktop app controls supported modes and records raw traffic alongside parsed results.",
  "description_zh": "FIIL 耳机控制依据逆向得到的 BLE GATT 命令实现 Windows 客户端。协议文档记录了 fdb3 服务、ff17 写入与 ff18 通知特征、帧格式、解锁顺序和命令响应。桌面应用可控制已支持的耳机模式，并同时记录原始收发数据与解析结果。",
  "entry_url": "https://awesomerea.org/resources/fiil-headphone-control-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/fiil-headphone-control-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/FNKG9527/fiil-pods-pc/blob/e7a11989e3ba007211ad548c8f04ad6fa4374bc2/docs/PROTOCOL_PC.md",
  "group": "cases",
  "id": "fiil-headphone-control-case",
  "json_url": "https://awesomerea.org/resources/fiil-headphone-control-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/fiil-headphone-control-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/fiil-headphone-control-case/index.md",
  "name": "FIIL 耳机控制: a Windows client for FIIL headphone BLE commands",
  "name_zh": "FIIL 耳机控制：基于 BLE 命令的 Windows 客户端",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "testing",
    "limits",
    "license"
  ],
  "requirements": [
    "Live use requires Windows 10/11 and a supported FIIL headset; running from source requires Python 3.10 or newer.",
    "The author reports physical tests with FIIL Key Max firmware 3.0.1.1 and FIIL Atom.",
    "EQ writing is not confirmed to take effect; Linux and macOS are untested.",
    "GPL-3.0 license."
  ],
  "requirements_zh": [
    "实际连接耳机需要 Windows 10/11 和受支持的 FIIL 耳机；从源码运行还需要 Python 3.10 或更新版本。",
    "作者报告在固件版本为 3.0.1.1 的 FIIL Key Max 和 FIIL Atom 上进行了实机测试。",
    "EQ 写入尚未确认生效；Linux 和 macOS 未经测试。",
    "GPL-3.0 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/FNKG9527/fiil-pods-pc",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}