gree-controller-ha-addon/gree-controller/README.md

GREE Controller

Local GREE HVAC controller packaged as a Home Assistant add-on. It uses host_network: true so UDP discovery and the host VLAN/ethernet interfaces are directly available to the controller. Persistent data is stored in /data/gree-controller.db and is included in Home Assistant backups.

PL - topologia HA / VLAN / GREE

Najważniejsze:

• VLAN-y konfigurujesz na hoście Home Assistant OS,
• dodatek współdzieli interfejsy hosta przez host_network,
• nie trzeba tworzyć Docker macvlan,
• przy wielu bezpośrednio podłączonych podsieciach gree_interface może pozostać puste,
• discovery UDP broadcast wykonuj osobno dla każdego VLAN-u/podsieci.

Pełna dokumentacja: DOCS.pl.md.

EN - HA / VLAN / GREE topology

Key points:

• configure VLANs on the Home Assistant OS host,
• the add-on shares host interfaces via host_network,
• Docker macvlan is not required,
• with multiple directly attached subnets gree_interface may be left empty,
• run UDP broadcast discovery separately for each VLAN/subnet.

Full documentation: DOCS.md.

Versioning

The project version is maintained only in the root Cargo.toml. The build script copies it into the Home Assistant config.yaml and publishes one amd64 + aarch64 OCI manifest under that version. No separate architecture release tags are used.