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

Home Assistant add-on - networking and VLAN

This directory contains topology materials for Home Assistant OS, VLANs, and multiple network interfaces for GREE Controller.

EN diagram

PL diagram

Network model

• VLANs and IP addresses are configured on the Home Assistant OS host.
• The add-on runs with host_network: true, so it uses the host interfaces directly.
• There is no need to create macvlan inside the add-on.
• For several directly attached subnets you can leave gree_interface empty so the controller picks the interface that best matches the device IP.
• UDP broadcast discovery happens per subnet/VLAN; broadcast usually does not cross a router.

Full details: ../NETWORKING.en.md and ../repository/gree-controller/DOCS.md.