{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/tinic/ha-halo-home/blob/1dc4727bce0b41bb5f7bce7cbd16001a845432d7/README.md",
    "https://github.com/tinic/ha-halo-home/blob/1dc4727bce0b41bb5f7bce7cbd16001a845432d7/LICENSE"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "Halo Home for Home Assistant controls Eaton HALO Home Bluetooth mesh lights locally and targets other Avi-on lights using the same protocol. Its CSRmesh protocol document describes GATT characteristics, encrypted packet delivery and passphrase-based key derivation for on/off, brightness and color-temperature controls.",
  "description_zh": "Halo Home for Home Assistant 在本地控制 Eaton HALO Home 蓝牙网状灯具，也面向使用同一协议的其他 Avi-on 灯具。其 CSRmesh 协议文档说明用于开关、亮度和色温控制的 GATT 特征、加密数据包传输及基于口令的密钥派生。",
  "entry_url": "https://awesomerea.org/resources/halo-home-home-assistant-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/halo-home-home-assistant-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/tinic/ha-halo-home/blob/1dc4727bce0b41bb5f7bce7cbd16001a845432d7/docs/protocol.md",
  "group": "cases",
  "id": "halo-home-home-assistant-case",
  "json_url": "https://awesomerea.org/resources/halo-home-home-assistant-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/halo-home-home-assistant-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/halo-home-home-assistant-case/index.md",
  "name": "Halo Home for Home Assistant: reconstructing local Avi-on mesh control",
  "name_zh": "Halo Home for Home Assistant：重建 Avi-on 网状灯具的本地控制",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "testing",
    "license"
  ],
  "requirements": [
    "Requires Home Assistant 2024.12 or newer with Bluetooth enabled, plus an adapter or Bluetooth proxy within range of a fixture.",
    "Initial setup requires an Avi-on / Halo Home account, or a previously saved avion_backup.json containing the location passphrase.",
    "The author reports testing only the MicroEdge (HLB) on real hardware; transitions are unsupported.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 Home Assistant 2024.12 或更新版本并启用蓝牙，还需要位于灯具通信范围内的蓝牙适配器或蓝牙代理。",
    "初次配置需要 Avi-on / Halo Home 账户，或事先保存且含有位置口令的 avion_backup.json。",
    "作者报告仅在 MicroEdge（HLB）实物设备上测试过；不支持渐变过渡。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/tinic/ha-halo-home",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}