# 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

![Home Assistant OS + VLAN + GREE topology](./topology-ha-vlan-gree-en.png)

## PL diagram

![Topologia HA OS + VLAN + GREE](./topologia-ha-vlan-gree-pl.png)

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