# Halo Home for Home Assistant：重建 Avi-on 网状灯具的本地控制

> Halo Home for Home Assistant 在本地控制 Eaton HALO Home 蓝牙网状灯具，也面向使用同一协议的其他 Avi-on 灯具。其 CSRmesh 协议文档说明用于开关、亮度和色温控制的 GATT 特征、加密数据包传输及基于口令的密钥派生。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-06
- 收录于：2026-11-08
- 原始资源：<https://github.com/tinic/ha-halo-home>
- 一手来源：<https://github.com/tinic/ha-halo-home/blob/1dc4727bce0b41bb5f7bce7cbd16001a845432d7/docs/protocol.md>
- 目录页面：<https://awesomerea.org/zh/resources/halo-home-home-assistant-case/>
- 记录 JSON：<https://awesomerea.org/resources/halo-home-home-assistant-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/halo-home-home-assistant-case/index.md)

## 使用条件与局限

- **前提条件：**需要 Home Assistant 2024.12 或更新版本并启用蓝牙，还需要位于灯具通信范围内的蓝牙适配器或蓝牙代理。
- **前提条件：**初次配置需要 Avi-on / Halo Home 账户，或事先保存且含有位置口令的 avion_backup.json。
- **测试证据：**作者报告仅在 MicroEdge（HLB）实物设备上测试过；不支持渐变过渡。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/tinic/ha-halo-home/blob/1dc4727bce0b41bb5f7bce7cbd16001a845432d7/docs/protocol.md>
2. <https://github.com/tinic/ha-halo-home/blob/1dc4727bce0b41bb5f7bce7cbd16001a845432d7/README.md>
3. <https://github.com/tinic/ha-halo-home/blob/1dc4727bce0b41bb5f7bce7cbd16001a845432d7/LICENSE>

## 同分区更多条目：协议

- [foobot-local：Foobot 本地服务与协议重建](https://awesomerea.org/zh/resources/foobot-local-case/index.md) · 案例
- [noirm1：重建 NOIR M1 鼠标设置协议](https://awesomerea.org/zh/resources/noirm1-mouse-protocol-case/index.md) · 案例
- [PetMarvel C1：重建猫砂盆本地控制](https://awesomerea.org/zh/resources/petmarvel-c1-local-case/index.md) · 案例
- [omen-lcd：重建 HP OMEN 散热器 LCD 控制](https://awesomerea.org/zh/resources/omen-lcd-hp-cooler-case/index.md) · 案例
- [QCY Control for macOS：实现 MeloBuds Pro 蓝牙控制](https://awesomerea.org/zh/resources/qcy-control-macos-case/index.md) · 案例
- [BTHackers：重建 AIREC 录音笔蓝牙协议](https://awesomerea.org/zh/resources/bthackers-airec-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。