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`.
@@ -0,0 +1,16 @@
+# Home Assistant add-on - diagrams and VLAN notes
+
+This directory stores the Home Assistant add-on topology diagrams in both languages.
+
+- [Polish notes](./README.pl.md)
+- [English notes](./README.en.md)
+
+## Diagrams
+
+### Polish
+
+![Topologia HA OS + VLAN + GREE](./topologia-ha-vlan-gree-pl.png)
+
+### English
+
+![Home Assistant OS + VLAN + GREE topology](./topology-ha-vlan-gree-en.png)
@@ -0,0 +1,21 @@
+# Home Assistant add-on - sieć i VLAN
+
+Ten katalog zawiera materiały dotyczące topologii Home Assistant OS, VLAN-ów i wielu interfejsów sieciowych dla GREE Controller.
+
+## Diagram PL
+
+![Topologia HA OS + VLAN + GREE](./topologia-ha-vlan-gree-pl.png)
+
+## Diagram EN
+
+![Home Assistant OS + VLAN + GREE topology](./topology-ha-vlan-gree-en.png)
+
+## Model sieciowy
+
+- VLAN-y oraz adresy IP są konfigurowane na hoście Home Assistant OS.
+- Add-on działa z `host_network: true`, więc korzysta bezpośrednio z interfejsów hosta.
+- Nie ma potrzeby tworzenia `macvlan` wewnątrz dodatku.
+- Dla kilku bezpośrednio podłączonych podsieci `gree_interface` można pozostawić puste, aby kontroler dobierał interfejs do adresu urządzenia.
+- Discovery UDP broadcast wykonuje się per podsieć/VLAN; broadcast zwykle nie przechodzi przez router.
+
+Pełny opis: `../NETWORKING.md` oraz `../repository/gree-controller/DOCS.pl.md`.