GbbConnect2 — Home Assistant Addon#
GbbConnect2 is beschikbaar als Home Assistant addon, waarmee u het direct in HA kunt draaien zonder een aparte Windows-pc of Docker-container.
De addon draait de GbbConnect2Console-applicatie en verbindt de omvormer met GbbOptimizer via ModbusInMqtt.
Vereisten#
- Home Assistant OS of Home Assistant Supervised (Supervisor vereist)
- Een actief GbbOptimizer-account met een installatie van het type GbbConnect2
- Een hybride omvormer met een datalogger (WiFi of Ethernet)
- Een vast IP-adres voor de datalogger in het lokale netwerk
Installatie#
1. Voeg de repository toe#
Klik op de onderstaande knop om de repository automatisch toe te voegen aan Home Assistant:
Of handmatig:
- Ga in Home Assistant naar Instellingen -> Add-ons -> Add-on Store
- Klik op het menu (⋮) in de rechterbovenhoek -> Repositories
- Voeg de repository-URL toe:
1https://github.com/KrzysztofHajdamowicz/gbbconnect2-ha-addon - Klik op Toevoegen
2. Installeer de addon#
- Zoek in de Add-on Store naar GbbConnect2
- Klik op Installeren
- Wacht tot de installatie is voltooid
Configuratie#
Bereid vóór het starten van de addon de gegevens uit GbbOptimizer voor — zie GbbConnect2-configuratie (stappen 2–5).
Vul op het tabblad Configuratie van de addon de velden in:
| Veld | Beschrijving |
|---|---|
plant_name | Installatienaam (zoals in GbbOptimizer) |
plant_driver_no | Drivertype: 0 = SolarmanV5 (WiFi), 1 = ModBusTCP (Ethernet) |
plant_address_ip | IP-adres van de datalogger in het lokale netwerk |
plant_port_no | Poort van de datalogger (meestal 8899) |
plant_serial_number | Serienummer van de datalogger (niet de omvormer!) |
gbboptimizer_plant_id | PlantId uit GbbOptimizer |
gbboptimizer_plant_token | PlantToken uit GbbOptimizer |
gbboptimizer_mqtt_address | MQTT-serveradres — zie MQTT-servers |
gbboptimizer_mqtt_port | MQTT-poort (meestal 8883) |
server_autostart | Automatische serverstart (aanbevolen: true) |
De datalogger moet een vast IP-adres hebben in het lokale netwerk. Stel een DHCP-reservering in op uw router.
Het serienummer is het serienummer van de datalogger, niet van de omvormer. Veelvoorkomende formaten: 17xxxxxxx, 21xxxxxxx, 40xxxxxxx. U kunt het vinden met de Windows-versie van GbbConnect2 (functie Search for Inverters).
Opstarten#
- Ga naar het tabblad Informatie van de addon
- Klik op Starten
- Controleer het tabblad Logboek — wacht op een bericht dat de verbinding tot stand is gebracht
- Controleer in GbbOptimizer of gegevens van de omvormer worden ontvangen
De addon moet 24/7 draaien zodat GbbOptimizer gegevens kan verzamelen en commando’s naar de omvormer kan sturen.
Probleemoplossing#
- Kan geen verbinding maken met de omvormer — controleer het IP-adres, de poort en het serienummer van de datalogger. Zorg ervoor dat HA de datalogger in het netwerk kan bereiken.
- Kan geen verbinding maken met MQTT — controleer het PlantId, PlantToken en het MQTT-serveradres. Controleer of poort 8883 niet wordt geblokkeerd door een firewall.
- Authenticatiefout — genereer een nieuw token in GbbOptimizer en werk de addon-configuratie bij.
Schakel is_verbose_log, is_driver_log en is_driver_log2 in de configuratie in voor gedetailleerde diagnostische logboeken.