GbbConnect2 — addon Home Assistant#
GbbConnect2 jest dostępny jako addon Home Assistant, co pozwala uruchomić go bezpośrednio w HA bez potrzeby osobnego komputera z Windows czy kontenera Docker.
Addon uruchamia aplikację GbbConnect2Console i łączy falownik z GbbOptimizer przez ModbusInMqtt.
Wymagania#
- Home Assistant OS lub Home Assistant Supervised (wymagany Supervisor)
- Aktywne konto w GbbOptimizer z instalacją typu GbbConnect2
- Falownik hybrydowy z dataloggerem (WiFi lub Ethernet)
- Stały adres IP dataloggera w sieci lokalnej
Instalacja#
1. Dodaj repozytorium#
Kliknij poniższy przycisk, aby automatycznie dodać repozytorium do Home Assistant:
Lub ręcznie:
- W Home Assistant przejdź do Ustawienia -> Dodatki -> Sklep z dodatkami
- Kliknij menu (⋮) w prawym górnym rogu -> Repozytoria
- Dodaj URL repozytorium:
1https://github.com/KrzysztofHajdamowicz/gbbconnect2-ha-addon - Kliknij Dodaj
2. Zainstaluj addon#
- W Sklepie z dodatkami wyszukaj GbbConnect2
- Kliknij Zainstaluj
- Poczekaj na zakończenie instalacji
Konfiguracja#
Przed uruchomieniem addonu przygotuj dane z GbbOptimizer — patrz konfiguracja GbbConnect2 (kroki 2–5).
W zakładce Konfiguracja addonu wypełnij pola:
| Pole | Opis |
|---|---|
plant_name | Nazwa instalacji (jak w GbbOptimizer) |
plant_driver_no | Typ drivera: 0 = SolarmanV5 (WiFi), 1 = ModBusTCP (Ethernet) |
plant_address_ip | Adres IP dataloggera w sieci lokalnej |
plant_port_no | Port dataloggera (zwykle 8899) |
plant_serial_number | Numer seryjny dataloggera (nie falownika!) |
gbboptimizer_plant_id | PlantId z GbbOptimizer |
gbboptimizer_plant_token | PlantToken z GbbOptimizer |
gbboptimizer_mqtt_address | Adres serwera MQTT — patrz Serwery MQTT |
gbboptimizer_mqtt_port | Port MQTT (zwykle 8883) |
server_autostart | Automatyczny start serwera (zalecane: true) |
Datalogger musi mieć stały adres IP w sieci lokalnej. Ustaw rezerwację DHCP na routerze.
Numer seryjny to numer dataloggera, nie falownika. Typowe formaty: 17xxxxxxx, 21xxxxxxx, 40xxxxxxx. Możesz go znaleźć za pomocą wersji Windows GbbConnect2 (funkcja Search for Inverters).
Uruchomienie#
- Przejdź do zakładki Informacje addonu
- Kliknij Uruchom
- Sprawdź zakładkę Logi — poczekaj na komunikat o nawiązaniu połączenia
- W GbbOptimizer zweryfikuj, czy dane z falownika są odbierane
Addon powinien działać 24/7, aby GbbOptimizer mógł zbierać dane i wysyłać polecenia do falownika.
Rozwiązywanie problemów#
- Brak połączenia z falownikiem — sprawdź adres IP, port i numer seryjny dataloggera. Upewnij się, że HA ma dostęp do dataloggera w sieci.
- Brak połączenia z MQTT — zweryfikuj PlantId, PlantToken i adres serwera MQTT. Sprawdź, czy port 8883 nie jest blokowany przez firewall.
- Błąd autoryzacji — wygeneruj nowy token w GbbOptimizer i zaktualizuj konfigurację addonu.
Włącz opcje is_verbose_log, is_driver_log i is_driver_log2 w konfiguracji, aby uzyskać szczegółowe logi diagnostyczne.