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.