v0.13.9-ha_addon

2026-09-09 15:19:10 +02:00
parent 4196fbe0ef
commit fa0d4d0754
32 changed files with 1941 additions and 30 deletions
@@ -0,0 +1,21 @@
+# 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`.