{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/k0rventen/avea/blob/f2cd98c20821d12069d4ff6cca970c29bf7da993/LICENSE"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "avea implements Python control of the Elgato Avea bulb using a BLE protocol investigated through an Android btsnoop log and Wireshark. Its documentation maps the control characteristic and color, brightness and name commands; the library discovers bulbs and reads or sets their state through Bleak.",
  "description_zh": "avea 根据 Android btsnoop 日志和 Wireshark 对 Elgato Avea 灯泡的 BLE 通信进行分析，并用 Python 实现控制。文档列出控制特征值以及颜色、亮度和名称命令；程序通过 Bleak 搜索灯泡并读取或设置状态。",
  "entry_url": "https://awesomerea.org/resources/avea-bulb-protocol-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/avea-bulb-protocol-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/k0rventen/avea/blob/f2cd98c20821d12069d4ff6cca970c29bf7da993/README.md",
  "group": "cases",
  "id": "avea-bulb-protocol-case",
  "json_url": "https://awesomerea.org/resources/avea-bulb-protocol-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/avea-bulb-protocol-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/avea-bulb-protocol-case/index.md",
  "name": "avea: controlling the Elgato Avea bulb through its BLE protocol",
  "name_zh": "avea：通过 BLE 协议控制 Elgato Avea 灯泡",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Python 3, Bleak, a working Bluetooth stack and an Elgato Avea bulb.",
    "Bluetooth discovery may require additional operating-system permissions.",
    "Mood-based ambiance commands remain to be reverse engineered.",
    "MIT licence."
  ],
  "requirements_zh": [
    "需要 Python 3、Bleak、可用的蓝牙协议栈和 Elgato Avea 灯泡。",
    "蓝牙搜索可能需要额外的系统权限。",
    "情景氛围模式的命令仍待逆向分析。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/k0rventen/avea",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}