# Halo Home for Home Assistant: reconstructing local Avi-on mesh control

> 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.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/tinic/ha-halo-home>
- Primary source: <https://github.com/tinic/ha-halo-home/blob/1dc4727bce0b41bb5f7bce7cbd16001a845432d7/docs/protocol.md>
- Catalog page: <https://awesomerea.org/resources/halo-home-home-assistant-case/>
- Record JSON: <https://awesomerea.org/resources/halo-home-home-assistant-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/halo-home-home-assistant-case/index.md)

## Requirements & limits

- **Prerequisites:** Requires Home Assistant 2024.12 or newer with Bluetooth enabled, plus an adapter or Bluetooth proxy within range of a fixture.
- **Prerequisites:** Initial setup requires an Avi-on / Halo Home account, or a previously saved avion_backup.json containing the location passphrase.
- **Testing evidence:** The author reports testing only the MicroEdge (HLB) on real hardware; transitions are unsupported.
- **License:** MIT license.

## Primary sources

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>

## More in Protocols

- [foobot-local: local Foobot service and reconstructed protocols](https://awesomerea.org/resources/foobot-local-case/index.md) · Case study
- [noirm1: reconstructing NOIR M1 mouse settings](https://awesomerea.org/resources/noirm1-mouse-protocol-case/index.md) · Case study
- [PetMarvel C1: reconstructing local litter-box control](https://awesomerea.org/resources/petmarvel-c1-local-case/index.md) · Case study
- [omen-lcd: reconstructing HP OMEN cooler LCD control](https://awesomerea.org/resources/omen-lcd-hp-cooler-case/index.md) · Case study
- [QCY Control for macOS: implementing MeloBuds Pro BLE controls](https://awesomerea.org/resources/qcy-control-macos-case/index.md) · Case study
- [BTHackers: reconstructing the AIREC recorder’s BLE protocol](https://awesomerea.org/resources/bthackers-airec-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.