GbbOptimizer — Handleiding

Batterijprognose

Mon, 01 Jan 0001 00:00:00 +0000

Batterijprognose#

De centrale module van GbbOptimizer. Analyseert de SOC van de batterij voor de komende 24 uur (of langer) op basis van PV-lading, netlading, ontlading en verbruik door het huis. Bevat een optimizer die automatisch de laad- en ontlaadparameters kiest.

In deze module kun je:

De prognose van de batterij-SOC voor de komende 24 uur analyseren
Zien wanneer de SOC onder of boven de minimale of maximale waarden komt
Laad- en ontlaadplannen optimaliseren
Inkoop- en verkoopprijzen en winsten bekijken

Kolommen van de prognosetabel#

De tabel toont gegevens voor de komende 24 uur. Afkortingen: DC = gelijkstroom, AC = wisselstroom.

C# IoT-procedures

Mon, 01 Jan 0001 00:00:00 +0000

C# IoT-procedures#

GbbOptimizer maakt het mogelijk eigen procedures in C# te schrijven die IoT-apparaten aansturen op basis van prognoses, energieprijzen en verbruiksgeschiedenis.

Een procedure mag niet langer dan 100 ms duren en mag de werking van het programma niet verstoren. Anders wordt de procedure opgeschort.

Object App#

Elke IoT-procedure ontvangt het App-object als parameter. Hieronder staat een lijst met beschikbare eigenschappen.

Belangrijkste eigenschappen#

Eigenschap	Type	Beschrijving
`App.CurrDate`	`DateTime?`	Datum waarop het apparaat aan/uit moet worden gezet
`App.CurrHour`	`decimal?`	Uur (12:30 = 12.5; 12:45 = 12.75)
`App.CurrForecastIndex`	`int?`	Index in `App.Forecast` voor de huidige datum en uur
`App.StringVariables`	`Dictionary<string, string?>`	Tekstvariabelen van de gebruiker (persistent tussen aanroepen)
`App.DecimalVariables`	`Dictionary<string, decimal?>`	Numerieke variabelen van de gebruiker (persistent tussen aanroepen)

Prognose (Forecast)#

Eigenschap	Type	Beschrijving
`App.Forecast`	`IForecast[]`	Array van de batterijprognose. `[0]` = huidig uur, `[1]` = volgend uur enz.
`.Date`	`DateTime`	Datum van de prognose
`.DateNo`	`int`	0 = vandaag, 1 = morgen enz.
`.Hour`	`decimal`	Uur van de prognose
`.HourNo`	`decimal`	Uur geteld vanaf het begin van de prognose (`[0].HourNo == 0` altijd)
`.StartBattery_kWhAC`	`decimal`	kWh in de batterij (AC) aan het begin van het uur
`.StartBattery_kWh`	`decimal`	kWh in de batterij (DC) aan het begin van het uur
`.Prod_KWhAC`	`decimal?`	Productie (PV + wind) in dat uur
`.Loads_kWhAC`	`decimal?`	Verbruik in dat uur
`.GridCharge_kWhAC`	`decimal?`	kWh uit het net naar de batterij (netzijde)
`.GridCharge_kWh`	`decimal?`	kWh uit het net naar de batterij (batterijzijde)
`.Discharge_kWhAC`	`decimal?`	kWh uit de batterij naar het net (netzijde)
`.Discharge_kWh`	`decimal?`	kWh uit de batterij naar het net (batterijzijde)
`.EndBattery_kWhAC`	`decimal?`	kWh in de batterij (AC) aan het einde van het uur
`.EndBattery_kWh`	`decimal?`	kWh in de batterij (DC) aan het einde van het uur
`.Meteo_SOC`	`decimal?`	null = geen weerswaarschuwingen; waarde = doel-SOC voor de waarschuwing
`.Temperature_C`	`decimal?`	Temperatuur (°C) in dat uur
`.ExtraLoads_kWh`	`decimal?`	Som van extra verbruik
`.FromGrid_kWh`	`decimal?`	kWh uit het net
`.PurchasePrice`	`decimal?`	Inkoopprijs
`.PurchaseAmount`	`decimal?`	Inkoopbedrag
`.ToGrid_kWh`	`decimal?`	kWh naar het net
`.SalePrice`	`decimal?`	Verkoopprijs
`.SaleAmount`	`decimal?`	Verkoopbedrag

Prijzen (Prices)#

Eigenschap	Type	Beschrijving
`App.Prices`	`Dictionary<(DateTime, decimal), IPrice>`	Prijzen voor gisteren, vandaag en morgen
`.Day`	`DateTime`	Datum van de prijs
`.Hour`	`decimal`	Uur van de prijs
`.PurchasePrice`	`decimal?`	Inkoopprijs
`.SalesPrice`	`decimal?`	Verkoopprijs
`.Imported_PurchasePrice`	`decimal?`	Uit de prijsbron geïmporteerde inkoopprijs
`.Imported_SalesPrice`	`decimal?`	Uit de prijsbron geïmporteerde verkoopprijs

Geschiedenis (History)#

Eigenschap	Type	Beschrijving
`App.History`	`IHistory[]`	Historische gegevens. `[0]` = uur vóór het huidige, `[1]` = twee uur eerder enz.
`.Date`	`DateTime`	Datum
`.Hour`	`decimal`	Uur
`.FromGrid_kWh`	`decimal?`	kWh uit het net
`.PurchasePrice`	`decimal?`	Inkoopprijs
`.PurchaseAmount`	`decimal?`	Inkoopbedrag
`.ToGrid_kWh`	`decimal?`	kWh naar het net
`.SalePrice`	`decimal?`	Verkoopprijs
`.SaleAmount`	`decimal?`	Verkoopbedrag
`.Loads_kWh`	`decimal?`	Verbruik (kWh)
`.LoadsPrice`	`decimal?`	Prijs van verbruikte energie
`.LoadsAmount`	`decimal?`	Bedrag van verbruikte energie
`.PV_kWh`	`decimal?`	PV-productie (kWh)
`.SOC_Start`	`decimal?`	SOC aan het begin van het uur
`.SOC_End`	`decimal?`	SOC aan het einde van het uur
`.ExtraLoads_Price`	`decimal?`	Prijs van extra verbruik
`.ExtraLoads_kWh`	`decimal?`	Som van extra verbruik (kWh)

IoT-apparaten (IoTDevices)#

Eigenschap	Type	Beschrijving
`App.IoTDevices`	`Dictionary<string, IIoTDevice>`	Lijst van IoT-apparaten
`.Name`	`string`	Naam van het apparaat
`.IsOn`	`bool`	Huidige status van de schakelaar

Speciale functies#

Functie	Beschrijving
`void App.ToLog(string message)`	Toon een bericht in het Log-menu
`bool App.IsInLowerPrices(DateTime CurrDate, decimal CurrHour, int LowerHours, bool Purchase)`	Valt het gegeven uur in de goedkoopste uren van de dag?
`bool App.IsInHigherPrices(DateTime CurrDate, decimal CurrHour, int HigherHours, bool Purchase)`	Valt het gegeven uur in de duurste uren van de dag?

Beschikbare libraries#

mscorlib.dll
system.runtime.dll
System.Text.RegularExpressions.dll
system.linq.dll
System.Collections.dll

Voorbeeld#

1
2
3
4
5


public bool IoTDevice_0036_IsOn(IApp App)
{
 return App.IsInLowerPrices(App.CurrDate, App.CurrHour, 3, false)
 || App.Forecast[App.CurrForecastIndex].FromGrid_kWh > 3;
}

Dit voorbeeld schakelt het apparaat in wanneer:

Deye

Mon, 01 Jan 0001 00:00:00 +0000

Modusmapping — Deye#

deye-only

Hoe de GbbOptimizer-modi zich vertalen naar de instellingen van de Deye-omvormer, afhankelijk van de verbindingsmethode.

Solarman / DeyeCloud (nieuwe verbindingsmethode)#

recommended

Operatie	Work Mode	GridCharge (TimeOfUse)	Time (TimeOfUse)	SOC (TimeOfUse)	Power (TimeOfUse)	Charge A	MaxSellPower
Normal	—	nee	ja	5%*	Max Battery Discharge, anders: Max Inverter Discharge	ongewijzigd	—
Charge	—	ja	ja	SOC%	ChargeLimitW, anders: Max Battery Charge, anders: Max Inverter Charge	ChargeLimitW, anders: Max Battery Charge, anders: Max Inverter Charge	—
Discharge	SellingFirst (na afloop: terug naar vorige waarde)	nee	ja	SOC%	Max Battery Discharge, anders: Max Inverter Discharge	ongewijzigd; KeepSOC: 0W	Max GridSetpoint / Discharge (W); als ontladen langzamer moet, berekent het programma de waarde; na afloop: terug naar vorige waarde
DisableCharge	—	nee	ja	5%*	Max GridSetpoint / Discharge (W)	wijzigt naar 0 (na afloop: terug naar vorige waarde)	—

* 5% kan worden gewijzigd met de parameter „Default MinSOC after discharge" in de instellingen van het ontlaadschema.

Installatieparameters

Mon, 01 Jan 0001 00:00:00 +0000

Installatieparameters#

Hieronder worden alle configuratieparameters van een installatie in GbbOptimizer beschreven, thematisch gegroepeerd.

Type#

Parameter	Eenheid	Beschrijving
Type	—	Type verbinding met de omvormer (Victron, Solarman, GbbConnect2, DongleDirect, SolarAssistant)
Aantal tijdsintervallen per dag	—	Aantal tijdsintervallen per dag. In Polen geldt 60 intervallen voor particuliere klanten

Installatie#

Parameter	Eenheid	Beschrijving
Naam	—	Unieke naam van de installatie binnen het account
Tijdzone	—	Tijdzone van de locatie van de installatie
Maximaal importvermogen uit het net	kW	Aansluitparameter — maximaal vermogen dat uit het net kan worden afgenomen
Maximaal exportvermogen naar het net	kW	Aansluitparameter — maximaal vermogen dat naar het net kan worden geleverd
Welk % PV is aangesloten aan de DC-zijde?	%	`0%` — alle PV aangesloten op AC. `100%` — alle PV aangesloten op DC
Breedte-/lengtegraad	—	Geografische locatie van de installatie. Wordt gebruikt door de modules: Meteo en PV-prognoses

Prijsbronnen#

Parameter	Beschrijving
Inkoop: Tarief voor inkoopprijzen	Bron van de geïmporteerde inkoopprijzen voor energie
Transport: Tarief voor transportprijzen	Bron van de transportprijzen (netbeheer). Leeg = 0
Verkoop: Tarief voor verkoopprijzen	Bron van de geïmporteerde verkoopprijzen voor energie

Details over de prijsformules — in de module Prijzen.

Mosquitto Bridge

Mon, 01 Jan 0001 00:00:00 +0000

Mosquitto Bridge#

Om GbbOptimizer met Home Assistant te laten communiceren, moet je een bridge instellen tussen de lokale Mosquitto-broker in HA en de MQTT-server van GbbOptimizer.

Vereisten#

Home Assistant met de Mosquitto broker-add-on geïnstalleerd
Een actieve installatie in GbbOptimizer met toegewezen PlantId en PlantToken
Het MQTT-serveradres — zie MQTT-servers

Stap-voor-stap configuratie#

1. Configuratiemap in Mosquitto inschakelen#

Ga in Home Assistant naar Instellingen -> Add-ons -> Mosquitto broker -> Configuratie.

Signalen

Mon, 01 Jan 0001 00:00:00 +0000

MQTT-signalen#

GbbOptimizer verstuurt elk uur signalen naar externe programma’s (bijv. Home Assistant) op basis van de prognose voor het lopende uur.

MQTT-verbindingsparameters (adres, poort, TLS, ClientID) — zie Requests / Responses.

Signalen moeten eerst worden ingeschakeld in de module Ontladen

Een signaal wordt niet verstuurd als de parameter „X" niet is gedefinieerd (veld leeg)

Binaire signalen#

Een extern programma kan de volgende topics abonneren:

PUB {PlantId}/signals/SOCHigherEqThanXQoS 0

"1" als SOC ≥ X, anders "0"

Solarman

Mon, 01 Jan 0001 00:00:00 +0000

Solarman#

Solarman is een cloud-gebaseerde methode om de omvormer met GbbOptimizer te verbinden. De gegevens gaan via de Solarman-servers — er is geen extra software nodig.

Stap-voor-stap configuratie#

Voeg een installatie toe: Nieuwe installatie met een omvormer verbonden met Solarman toevoegen
Vul de velden in de groep „Solarman" in (details in Installatieparameters)
Log in op de Solarman-servers: voer je e-mail en wachtwoord in (dezelfde als voor de Solarman-app) en klik op Verbinden

Victron

Mon, 01 Jan 0001 00:00:00 +0000

Victron#

victron-only

De configuratie van een Victron-omvormer met GbbOptimizer vereist een correcte instelling van het ESS-systeem en het VRM-portaal.

Checklist#

Controleer de volgende instellingen voordat je GbbOptimizer start:

Installeer geen Beta-versies van de firmware
DESS moet uitgeschakeld zijn
Schedules — de optie „Self-consumption above limit" moet worden ingesteld op PV (en niet op „PV & Battery"). Zo veroorzaken de schema’s ’s nachts geen ontlading van de batterij
Battery Life in ESS moet uitgeschakeld zijn — kies de modus: Optimized (without BatteryLife)
Log interval (in VRM Online Portal) instellen op 1 min
VRM-rechten — de gebruiker moet het recht Full Control hebben
Herstart de Cerbo na het doorvoeren van de wijzigingen

Onjuiste instellingen van Battery Life of Schedules kunnen onverwachte nachtelijke ontlading van de batterij veroorzaken.

Wat is GbbOptimizer

Mon, 01 Jan 0001 00:00:00 +0000

Wat is GbbOptimizer#

GbbOptimizer (voorheen GbbVictronWeb) is een programma dat het gebruik van energie in een huishoudelijke zonne-installatie met energieopslag (batterij) optimaliseert. Het analyseert prognoses van PV-productie, het energieverbruiksprofiel en de in- en verkoopprijzen van energie om de omvormer automatisch aan te sturen — en bepaalt wanneer de batterij moet worden opgeladen, wanneer ontladen en wanneer energie van of naar het net moet worden gekocht of verkocht.

Hoe het werkt#

Het programma draait in de cloud en communiceert via internet met de omvormer. Elk uur voert het berekeningen uit en stuurt het commando’s naar de omvormer.

Woordenlijst

Mon, 01 Jan 0001 00:00:00 +0000

Woordenlijst#

Battery Full Date

Specifieke dagen van de maand waarop de optimizer de batterij tot 100% SOC probeert op te laden. Opgegeven als door komma's gescheiden waarden (bijv. '1, 15'). Maakt periodieke volledige laadcycli mogelijk voor de gezondheid van de batterij.

Correction Factor

Een vermenigvuldiger die in ongeveer een week bedrijf wordt berekend en die de waarden van de PV-prognose corrigeert zodat ze overeenkomen met de werkelijke productie, waardoor de nauwkeurigheid van de voorspelling verbetert.

GbbConnect2 Addon

Mon, 01 Jan 0001 00:00:00 +0000

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:

Deye

Mon, 01 Jan 0001 00:00:00 +0000

Deye#

deye-only

Deye-hybride omvormers kunnen op meerdere manieren met GbbOptimizer worden verbonden. Op deze pagina vind je een checklist met de instellingen van de omvormer en een vergelijking van de verbindingsmethoden.

Checklist#

Controleer op de Deye-omvormer voordat je GbbOptimizer start:

Werkingsmodus — Zero export to CT of Zero export to Loads (niet „Selling First"!)

Controleer de werkingsmodus niet tijdens een actieve ontlading — GbbOptimizer wijzigt de modus tijdelijk.

DeyeCloud

Mon, 01 Jan 0001 00:00:00 +0000

DeyeCloud#

deye-only

DeyeCloud is een back-up-verbindingsmethode die beschikbaar is voor installaties van het type Solarman. Kan worden gebruikt als back-up bij problemen met Solarman of als enige verbinding.

Werkingsmodi#

Modus	Beschrijving
Uitgeschakeld	DeyeCloud wordt niet gebruikt
Ingeschakeld	DeyeCloud wordt automatisch geactiveerd wanneer Solarman een fout meldt
Alleen back-up	Gebruik Solarman niet — altijd DeyeCloud

Configuratie#

Kies in de sectie Back-upverbinding — DeyeCloud van de installatieparameters de werkingsmodus
Voer de inloggegevens voor DeyeCloud in (kunnen afwijken van die voor Solarman)
Vink Inloggegevens onthouden aan — zonder dit is handmatig opnieuw inloggen vereist
Kies na verbinding het SerialNo van de omvormer

Een gedetailleerde beschrijving van de parameters vind je in Installatieparameters.

evcc

Mon, 01 Jan 0001 00:00:00 +0000

Integratie met evcc#

evcc.io is software voor slim laden van elektrische voertuigen. GbbOptimizer kan ermee communiceren via MQTT om het laden van de EV te coördineren met de optimalisatie van de thuisbatterij.

Vereisten#

Werkende evcc-installatie
Lokale MQTT-broker (Mosquitto in Home Assistant of standalone)
Geconfigureerde Mosquitto Bridge

Bridge-configuratie#

Voeg in het Mosquitto-configuratiebestand (/share/mosquitto/GbbOptimizer.conf) topic-regels toe voor evcc:

1
2
3
4
5
6


connection GbbOptimizer_<PlantId>
remote_username <PlantId>
remote_password <PlantToken>
address <mqtt-server-adres>:8883
bridge_capath /etc/ssl/certs
topic # both 2 evcc/loadpoints/ <PlantId>/evcc/site/loadpoints/

MQTT-topics#

Gegevens uit evcc (evcc -> GbbOptimizer)#

Topic	Beschrijving
`{PlantId}/evcc/site/statistic/total/chargedKWh`	Totale naar EV geladen energie (kWh)

Commando’s vanuit GbbOptimizer (GbbOptimizer -> evcc)#

Topic	Payload	Beschrijving
`{PlantId}/evcc/loadpoints/{chargerId}/mode`	`off` of `now`	Laden in-/uitschakelen
`{PlantId}/evcc/loadpoints/{chargerId}/maxCurrent`	getal (A)	Maximale laadstroom
`{PlantId}/evcc/loadpoints/{chargerId}/connected`	`true`/`false`	Verbindingsstatus met de lader

Waarbij {chargerId} de identificatie van het laadpunt in evcc is.

GBB Shunt

Mon, 01 Jan 0001 00:00:00 +0000

GBB Shunt#

GBB Shunt is een GbbOptimizer-module voor installaties met loodaccu’s (zuur, gel, AGM).

Wat is GBB Shunt?#

In installaties met loodaccu’s kan de standaard SOC-meting door de omvormer onnauwkeurig zijn. Met GBB Shunt kun je de laadtoestand nauwkeuriger volgen op basis van de stroommeting via een shunt.

Belangrijkste functies#

Nauwkeurige SOC-meting — op basis van stroommeting (coulombmeter), niet van spanning
Temperatuurcompensatie — houdt rekening met de invloed van temperatuur op de capaciteit van loodaccu’s
Batterijbescherming — voorkomt diepe ontladingen die de levensduur van loodaccu’s verkorten

Wanneer gebruiken?#

GBB Shunt wordt aanbevolen als:

GoodWe

Mon, 01 Jan 0001 00:00:00 +0000

Modusmapping — GoodWe#

Hoe de GbbOptimizer-modi zich vertalen naar de instellingen van het GoodWe-protocol.

Battery Charge-Discharge#

Operatie	BatteryCDEnable	BatteryCDMode	BatteryCDPW
Normal	nee	—	—
Charge	ja	2	ChargeLimitW
Discharge	ja	3	DischargeLimitW: Max GridSetpoint / Discharge (W). Als het ontladen langzamer moet gaan om een heel uur te duren, berekent het programma de juiste waarde. Na afloop: terug naar vorige waarde.
DisableCharge	ja	2	0

Ontbrekende opties#

Het GoodWe-protocol ondersteunt niet:

Laden

Mon, 01 Jan 0001 00:00:00 +0000

Laden#

De module Laden beheert de schema’s voor het laden van de batterij uit het net. In het Victron-systeem komt dit overeen met Schedules in de ESS-module.

victron-only We gaan ervan uit dat „Self-consumption above limit" op PV staat (en niet op „PV & Battery"), omdat we willen dat het schema ’s nachts het ontladen van de batterij stopt.

Omvormermodi

Mon, 01 Jan 0001 00:00:00 +0000

Omvormermodi#

GbbOptimizer stuurt de omvormer aan met vier basismodi (protocoloperaties). Elke omvormer implementeert deze op zijn eigen manier — gedetailleerde mappings vind je in de sectie Modusmappings.

Vereiste gegevens uit de omvormer#

De omvormer moet de volgende gegevens leveren:

Veld	Beschrijving
`soc_perc`	SOC van de batterij in procenten (of `V` als aansturing via spanning)
`loads_total_kWh`	Verbruiksteller (kWh, cumulatief)
`fromgrid_total_kWh`	Teller van uit het net genomen energie (kWh)
`togrid_total_kWh`	Teller van naar het net gestuurde energie (kWh)
`pv_total_kWh`	PV-productieteller (kWh)

Optioneel:

Requests / Responses

Mon, 01 Jan 0001 00:00:00 +0000

MQTT-requests en -responses#

GbbOptimizer ondersteunt request/response-queries via MQTT. Een extern programma stuurt een request en GbbOptimizer antwoordt met de gegevens.

Verbinding#

Het externe programma moet verbinding maken met MQTT met de volgende parameters:

Parameter	Waarde
Adres	Zie MQTT-servers
Poort	8883
Gebruiker	`{PlantId}`
Wachtwoord	`{PlantToken}`
UseTLS	true
ClientID	moet eindigen op `_{PlantId}`

Topics#

Richting	Topic
Request →	`{PlantId}/ha_gbb/dataserver/serverrequest`
← Response	`{PlantId}/ha_gbb/dataserver/serverresponse`

Voor achterwaartse compatibiliteit ondersteunt het programma ook {PlantId}/dataserver/serverrequest en {PlantId}/dataserver/serverresponse (niet aanbevolen).

Snelstart

Mon, 01 Jan 0001 00:00:00 +0000

Snelstart#

Een stap-voor-stap handleiding om GbbOptimizer voor jouw PV-installatie in gebruik te nemen.

1. Maak een account aan en voeg een installatie toe#

Ga naar de GbbOptimizer-website en maak een account aan. Voeg vervolgens een nieuwe installatie toe door de juiste optie te kiezen, afhankelijk van jouw omvormer:

Omvormer	Menu-optie
Victron (Cerbo GX of ander GX-apparaat)	„Nieuwe installatie met Victron System toevoegen"
Deye via DeyeCloud	„Nieuwe installatie met een Deye-omvormer verbonden met DeyeCloud toevoegen"
Deye via Solarman	„Nieuwe installatie met Solarman toevoegen"
Deye via Home Assistant	„Nieuwe installatie met Home Assistant toevoegen"
Andere omvormer via Solarman	„Nieuwe installatie met Solarman toevoegen"
Andere omvormer via Home Assistant	„Nieuwe installatie met Home Assistant toevoegen"
SofarSolar	„Installatie met DongleDirect (Deye, SofarSolar)"

Als je Deye-omvormers in een Master-Slave-opstelling hebt, kies dan „Installatie met Solarman" en voeg de Master toe als hoofdomvormer en de Slave als extra omvormer in de installatieparameters.

SolarAssistant

Mon, 01 Jan 0001 00:00:00 +0000

SolarAssistant#

deye-only

Integratie van GbbOptimizer met een Deye-omvormer via SolarAssistant en Home Assistant.

Ondersteunde configuraties#

Home Assistant (HA) met SolarAssistant (SA) verbonden met een hybride Deye-omvormer als inverter_1

Vereisten#

Home Assistant met Mosquitto broker
SolarAssistant geïnstalleerd en verbonden met de Deye-omvormer
Geconfigureerde Mosquitto Bridge met een topic voor SolarAssistant

SolarAssistant-configuratie#

Ga in de SolarAssistant-instellingen naar Configuration -> Advanced MQTT en wijzig:

Automatisering

Mon, 01 Jan 0001 00:00:00 +0000

Home Assistant-automatisering#

Nadat je de Mosquitto Bridge hebt geconfigureerd, kun je automatiseringen in Home Assistant maken die:

Gegevens versturen van HA-sensoren naar GbbOptimizer
Reageren op commando’s ontvangen van GbbOptimizer

Gegevens naar GbbOptimizer versturen#

GbbOptimizer verwacht gegevens op het topic ha_gbb/sensor (lokaal in HA; via de bridge wordt het <PlantId>/ha_gbb/sensor).

Verplichte velden#

Veld	Beschrijving
`soc_perc`	SOC van de batterij in procenten (of `V` als aansturing via spanning is ingesteld)
`loads_total_kWh`	Verbruiksteller (kWh, cumulatief)
`fromgrid_total_kWh`	Teller van uit het net genomen energie (kWh)
`togrid_total_kWh`	Teller van naar het net gestuurde energie (kWh)
`pv_total_kWh`	PV-productieteller (kWh)

Optionele velden#

Veld	Beschrijving
`ev_charge_total_kWh`	EV-laadteller
`hp_total_kWh`	Warmtepompteller
`other1_total_kWh` … `other6_total_kWh`	Aanvullende tellers

Meerdere PV-installaties#

Gebruik het veld more om gegevens van meerdere PV-vlakken te versturen:

Best practices

Mon, 01 Jan 0001 00:00:00 +0000

Best practices#

Adviezen en tips van ervaren GbbOptimizer-gebruikers.

Geduld#

De meest voorkomende fout van nieuwe gebruikers is te snel de configuratie aanpassen. Het programma heeft tijd nodig om te kalibreren.

GbbOptimizer is een programma dat geduld aanleert. In de eerste week:

Wordt de Correction Factor voor de PV-prognose gekalibreerd
Verzamelt het verbruiksprofiel historische gegevens
“Leert” de optimizer jouw installatie kennen

Schakel Test Mode niet eerder uit dan na een week. Geef het programma de tijd om gegevens te verzamelen.

Datacommando's

Mon, 01 Jan 0001 00:00:00 +0000

MQTT-datacommando’s#

Commando’s waarmee externe programma’s gegevens in GbbOptimizer kunnen wijzigen. Elk commando stuurt data naar een speciaal topic en ontvangt het resultaat op {PlantId}/ha_gbb/api/result.

Commandoresultaat#

PUB {PlantId}/ha_gbb/api/result

Resultaat van elk datacommando — OK of foutbeschrijving

Veld	Type	Beschrijving
`OrderId`	string?	Gekopieerd uit de request
`Result`	string	`"OK"` of foutbeschrijving
`Data`	object	Gegevens uit de oorspronkelijke request

SetManualPrices Handmatige energieprijzen instellen

{PlantId}/ha_gbb/api/setmanualprices

Veld		Type	Vereist	Beschrijving
`OrderId`		string	nee	Tekst die naar het antwoord wordt gekopieerd
`Data`		array	ja
	`Date`	date	ja	Datum van de prijs
	`StartHour`	int (0-23)	ja	Beginuur
	`StartMinute`	int (0-59)	nee	Minuut (standaard 0)
	`PurchasePrice`	decimal	nee	Inkoopprijs
	`TransferPrice`	decimal	nee	Transportprijs
	`SalePrice`	decimal	nee	Verkoopprijs

Voorbeeld:

GbbConnect2

Mon, 01 Jan 0001 00:00:00 +0000

GbbConnect2#

GbbConnect2 is software die in het lokale netwerk draait en de omvormer rechtstreeks met GbbOptimizer verbindt via ModbusInMqtt, waarbij de cloud-servers worden omzeild.

Vereisten#

Een computer met Windows of een Docker-container die 24/7 in het lokale netwerk draait
Een hybride Deye-omvormer met WiFi-logger (dongle)
Een vast IP-adres voor de logger in het lokale netwerk

Stap-voor-stap configuratie#

Download en installeer GbbConnect2: github.com/gbbsoft/GbbConnect2

GoodWe

Mon, 01 Jan 0001 00:00:00 +0000

GoodWe#

Voor de configuratie van een GoodWe-omvormer met GbbOptimizer moet toegang worden verleend via het SEMS-portaal en moeten er instellingen worden gedaan aan de GbbOptimizer-zijde.

Stap-voor-stap configuratie#

Log in op het SEMS-portaal (GoodWe)
Voeg in het menu Beheer, bij de gegevens van je installatie, het e-mailadres gbbsoft@gbbsoft.pl toe als Gast
Voeg in GbbOptimizer een installatie toe met GoodWe, maar selecteer geen SerialNo — de lijst moet leeg zijn (met uitzondering van de tekst „SerialNo kiezen")
Vink onderaan de pagina De installatie delen met technische ondersteuning aan
Neem contact op met de technische ondersteuning (bijv. via Discord: gbbsoft) en geef het SerialNo van je omvormer door
De technische ondersteuning selecteert jouw SerialNo

De configuratie van GoodWe vereist een eenmalige actie van de technische ondersteuning om het serienummer van de omvormer aan jouw installatie te koppelen.

Hinen

Mon, 01 Jan 0001 00:00:00 +0000

Modusmapping — Hinen#

Hoe de GbbOptimizer-modi zich vertalen naar de instellingen van het Hinen-protocol.

Mappingtabel#

Operatie	Work Mode	Charge/Discharge Enable	Charge/Discharge Start/End	Charge/Discharge SOC	Charge/Discharge Rate	AntiBackflow Enable	AntiBackflow Limit Rate
Normal	Self-consumption	nee	—	100%	—	—	—
Charge	Time period control	ja	ja	SOC%	= ChargeLimit / (MaxInverterChargeDC_kW of MaxBatteryChargeDC_kW) * 100%	nee	—
Discharge	Time period control	ja	ja	SOC%	= -abs(DischargeLimit) / (MaxInverterChargeDC_kW of MaxBatteryChargeDC_kW) * 100%. DischargeLimit = Max GridSetpoint / Discharge (W). Als het ontladen langzamer moet — het programma berekent de waarde.	ja	gelijk aan Charge/Discharge Rate, maar > 0
DisableCharge	Time period control	ja	ja	huidige SOC	1%	nee	—

Opmerkingen#

Rate wordt uitgedrukt als percentage van het maximale vermogen van de omvormer (of batterij), niet in watt
In de modus Normal keert het systeem terug naar Self-consumption met SOC = 100% en Charge/Discharge uitgeschakeld
In de modus DisableCharge wordt SOC ingesteld op het huidige niveau en Rate op het minimum van 1%

Ontladen

Mon, 01 Jan 0001 00:00:00 +0000

Ontladen#

De ontlaadmodule bepaalt wanneer en hoe energie uit de batterij naar het net wordt gestuurd of wordt gebruikt om het huis te voeden. De sleutelparameter is GridSetpoint.

GridSetpoint — hoe het werkt#

De GridSetpoint bepaalt hoeveel energie er door de netmeter moet stromen:

Positieve waarde (bijv. +100 W) — het systeem neemt energie uit het net. Overschot uit PV gaat naar de batterij.
Negatieve waarde (bijv. -5000 W) — het systeem exporteert energie naar het net. Eerst uit PV, daarna uit de batterij.

Voorbeeld 1: GridSetpoint = +100 W

Tuya

Mon, 01 Jan 0001 00:00:00 +0000

Integratie met Tuya#

GbbOptimizer kan Tuya-apparaten (bijv. slimme stopcontacten) aansturen via de Tuya Cloud API. Dit vereist het aanmaken van een ontwikkelaarsproject op het Tuya-platform en het verkrijgen van API-sleutels.

Access ID en Access Secret verkrijgen#

1. Maak een ontwikkelaarsaccount aan#

Registreer op platform.tuya.com.

2. Maak een Cloud Project aan#

Ga naar Cloud -> Development
Klik op Create Cloud Project (rechtsboven)
Vul het formulier in:
- Projectnaam — naar keuze
- Industry — kies de juiste sector
- Development Method — Smart Home
- Data Center — kies degene die het dichtst bij jouw locatie ligt
Klik in het volgende scherm op Authorize

3. Koppel de mobiele app#

Ga naar Devices -> Link App Account
Klik op Add App Account
Er verschijnt een QR-code
In de mobiele Tuya/Smart Life-app: Me (onderste menu) -> scan-icoon (rechtsboven)
Scan de QR-code

Na koppeling verschijnt in het tabblad All Devices een lijst met jouw apparaten.

Afore

Mon, 01 Jan 0001 00:00:00 +0000

Afore#

Configuratie van de Afore-omvormer met GbbOptimizer. GbbOptimizer stuurt de Afore-omvormer aan via het Modbus-protocol.

Mapping van GbbOptimizer-modi op Afore-instellingen#

Bewerking	Register	Waarde	Na afloop
AC charging maximum SOC	Laden: doel-MaxSOC	—	—
ACCharging start/end time (1-4)	Laden: array van de volgende 4 perioden	—	—
Forced charging start/end time (1-4)	Laden: array van de volgende 4 perioden	—	—
ACCharging power percentage	Laden: Input Limit	% van MaxBuyPower of MaxBatteryChargeDC	Oorspronkelijke waarde herstellen
Forced charging power percentage	Laden: Charge Limit	% van MaxBatteryChargeDC	Oorspronkelijke waarde herstellen
Minimum SOC for forced discharge	Ontladen: doel-MinSOC	—	—
Forced discharge start time (1-4)	Ontladen: array van de volgende 4 perioden	—	—
Power grid power limit percentage	Ontladen: GridSetpoint	% van MaxSellPower of MaxBatteryDischargeDC	—
Maximum charging current	Laadblokkering: ingesteld op `0`	—	Oorspronkelijke waarde herstellen

Checklist#

Timing DChg ON/OFF = Enable
PDisChgMax (Forced discharge power percentage) = 100%

DongleDirect

Mon, 01 Jan 0001 00:00:00 +0000

DongleDirect#

DongleDirect werkt vergelijkbaar met GbbConnect2 — het verbindt de omvormer met GbbOptimizer, maar zonder extra software in het lokale netwerk. De dongle (WiFi-logger) wordt rechtstreeks doorverwezen naar de GbbOptimizer-server.

Sinds 09-03-2026 is het wijzigen van dongle-instellingen op sommige modellen mogelijk niet meer mogelijk. In dat geval is een reset van de dongle en het herstellen van de oorspronkelijke instellingen vereist.

Grafieken

Mon, 01 Jan 0001 00:00:00 +0000

Grafieken in Home Assistant#

GbbOptimizer biedt interactieve grafieken (PV-productie, verbruik, SOC, energieprijzen enz.) via de webinterface. Je kunt ze inbedden in een Home Assistant-dashboard.

Grafieken inbedden#

Gebruik de Webpage-kaart (of iFrame) in een HA-dashboard:

Ga naar het HA-dashboard -> Bewerken -> Kaart toevoegen
Kies de kaart Webpage (of een handmatige iframe-kaart)
Plak het grafieken-URL van GbbOptimizer in het URL-veld

1
2
3


type: iframe
url: "https://<server>.gbbsoft.pl/Charts?PlantId=<PlantId>"
aspect_ratio: "16:9"

Vervang <server> en <PlantId> door de juiste waarden voor jouw installatie.

Home Assistant-topics

Mon, 01 Jan 0001 00:00:00 +0000

MQTT-topics voor Home Assistant#

Topics gebruikt voor communicatie tussen GbbOptimizer en Home Assistant / GbbConnect.

Gegevens van Home Assistant naar GbbOptimizer#

Verplichte velden:

Veld	Type	Beschrijving
`soc_perc`	decimal	Batterij-SOC (%). Gebruik `V` indien „Aansturing via V" is aangevinkt
`loads_total_kWh`	decimal	Verbruik — cumulatieve teller
`fromgrid_total_kWh`	decimal	Import uit het net — cumulatieve teller
`togrid_total_kWh`	decimal	Export naar het net — cumulatieve teller
`pv_total_kWh`	decimal	PV-productie — cumulatieve teller

Optionele velden:

Prijzen

Mon, 01 Jan 0001 00:00:00 +0000

Prijzen#

De module voor de configuratie van in- en verkoopprijzen van energie. De bronnen van de prijsgegevens worden ingesteld in de installatieparameters, de overige parameters hier.

Inkoopprijs#

Formule:

1
2


Inkoopprijs = (Geïmporteerde prijs × Multiplier + Transportprijs + Transportkosten) × BTW/100
 + (Maandelijkse kosten / aantal uren in de maand)

Component	Beschrijving
Geïmporteerde prijs	Vast → 0. Afhankelijk van geïmporteerde prijzen en transportkosten → prijs uit de bron opgegeven in de installatieparameters. Afhankelijk van verkoopprijzen → Verkoopprijs
Multiplier	„Geïmporteerde inkoopprijzen vermenigvuldigen met"
Transportprijs	Prijs uit de bron opgegeven in de installatieparameters (item „Transport: Tarief voor transportprijzen"). 0 indien niet opgegeven
Transportkosten	Prijs uit de tabel onder de knop „Transportkosten / vaste inkoopprijzen wijzigen"
Maandelijkse kosten	Som van de vaste inkoopkosten — gelijkmatig verdeeld over alle uren in de maand

Verkoopprijs#

Formule:

Sofar

Mon, 01 Jan 0001 00:00:00 +0000

Modusmapping — Sofar#

Hoe de GbbOptimizer-modi zich vertalen naar de instellingen van de Sofar-omvormer in Passive Mode.

Passive Mode#

Operatie	Gdes (Grid setpoint)	Blo (Battery high)	Bup (Battery low)	Gdzup (Grid high)	Gdzlo (Grid low)
Normal	Default GridSetpoint (menu Discharge)	ChargeLimit of MaxBatteryChargePower of MaxInverterChargePower	-(DischargeLimit of MaxBatteryDischargePower of MaxInverterDischargeLimit)	MaxBuyPower of MaxInverterChargePower	-(MaxSellPower of MaxInverterDischargePower)
Charge	= Gdzup	ChargeLimit of MaxBatteryChargePower of MaxInverterChargePower (gecorrigeerd om de doel-SOC binnen een vol uur te bereiken)	0	InputLimit of MaxBuyPower of MaxInverterChargePower	0
Discharge	= Gdzlo	= Bup	-(DischargeLimit of MaxBatteryDischargePower of MaxInverterDischargeLimit) (gecorrigeerd om de doel-SOC binnen een vol uur te bereiken)	0	-(MaxSellPower of MaxInverterDischargePower)
DisableCharge	0	0	0	MaxBuyPower of MaxInverterChargePower	-(MaxSellPower of MaxInverterDischargePower)

Parameters#

Gdes — Grid setpoint: doelwaarde voor de energie-uitwisseling met het net
Blo — Battery high: maximaal batterijlaadvermogen
Bup — Battery low: maximaal batterijontlaadvermogen (negatieve waarde)
Gdzup — Grid high: maximaal opnamevermogen uit het net
Gdzlo — Grid low: maximaal exportvermogen naar het net (negatieve waarde)

Opmerkingen#

Als de optie „SofarSolar: Support for 5 parameters (not 3) in PassiveMode" is uitgeschakeld, worden Gdzup en Gdzlo niet gewijzigd (omdat ze niet beschikbaar zijn in de 3-parameter-modus).

Supla

Mon, 01 Jan 0001 00:00:00 +0000

Integratie met Supla#

GbbOptimizer kan Supla-apparaten (bijv. relais, stopcontacten) aansturen via directe links (Direct Links).

Configuratie#

Om een Supla-apparaat met GbbOptimizer te verbinden, moet je een directe link aanmaken in het Supla Cloud-paneel:

Log in op cloud.supla.org
Ga naar het apparaat dat je wilt aansturen
Maak een directe link (Direct Link) aan met de juiste rechten (aan/uit)
Kopieer de gegenereerde URL
Plak de URL in de GbbOptimizer-configuratie onder IoT -> Supla

Een gedetailleerde beschrijving van het aanmaken van directe links vind je in de Supla-documentatie.

Hinen

Mon, 01 Jan 0001 00:00:00 +0000

Hinen#

Configuratie van de Hinen-omvormer met GbbOptimizer.

Mapping van GbbOptimizer-modi op Hinen-instellingen#

GbbOptimizer stuurt de Hinen-omvormer aan door de juiste Work Mode en de laad-/ontlaadparameters in te stellen.

GbbOptimizer-bewerking	Work Mode	Charge/Discharge Enable	Start/End	SOC	Rate	AntiBackflow Enable	AntiBackflow Limit Rate
Normal	Self-consumption	Nee	—	100%	—	—	—
Charge	Time period control	Ja	Ja	Doel-SOC%	`ChargeLimit / (MaxInverterChargeDC of MaxBatteryChargeDC) * 100%`	Nee	—
Discharge	Time period control	Ja	Ja	Doel-SOC%	`DischargeLimit / (MaxInverterChargeDC of MaxBatteryChargeDC) * 100%` (negatieve waarde)	Ja	Zelfde als Rate, maar > 0
DisableCharge	Time period control	Ja	Ja	Actuele SOC	1%	Nee	—

Opmerkingen over de Discharge-bewerking#

De waarde DischargeLimit komt overeen met de parameter „Max GridSetpoint / Discharge (W)"
Als de ontlading trager moet om het hele uur te beslaan, corrigeert het programma deze waarde automatisch
AntiBackflow wordt ingeschakeld tijdens het ontladen om de export naar het net te beheersen

ModbusInMqtt

Mon, 01 Jan 0001 00:00:00 +0000

ModbusInMqtt-protocol#

Protocol voor communicatie tussen GbbOptimizer en GbbConnect2 — het overbrengen van Modbus-commando’s via MQTT.

GbbOptimizer → GbbConnect2#

PUB {PlantId}/ModbusInMqtt/toDevice

Modbus-commando's verstuurd naar GbbConnect2

Veld		Type	Vereist	Beschrijving
`OrderId`		string	nee	Tekst die naar het antwoord wordt gekopieerd
`Lines`		array	ja
	`LineNo`	int	ja	Regelnummer
	`Tag`	string	nee	Willekeurige tekst die naar het antwoord wordt gekopieerd
	`Timestamp`	int	nee	Unix-tijd UTC (seconden)
	`Modbus`	string	ja	Modbus-commando om naar de omvormer te sturen
`LogLevel`		string	nee	Wijzig logniveau: `OnlyErrors`, `Min`, `Max`
`SendLastLog`		int	nee	1 = logs bij het antwoord voegen (incrementeel)

Voorbeeld:

MQTT-servers

Mon, 01 Jan 0001 00:00:00 +0000

MQTT-servers#

GbbOptimizer gebruikt meerdere MQTT-servers voor communicatie met omvormers en integraties. Welke server aan jouw installatie is toegewezen, hangt af van de PlantId-prefix.

Servertabel#

Applicatieserver	MQTT-server	PlantId-prefix
gbboptimizer.gbbsoft.pl	gbboptimizer-mqtt.gbbsoft.pl	(geen)
gbboptimizer2.gbbsoft.pl	gbboptimizer2-mqtt.gbbsoft.pl	B
gbboptimizer3.gbbsoft.pl	gbboptimizer3-mqtt.gbbsoft.pl	C
gbboptimizer4.gbbsoft.pl	gbboptimizer4-mqtt.gbbsoft.pl	D
gbboptimizer5.gbbsoft.pl	gbboptimizer5-mqtt.gbbsoft.pl	E
gbboptimizer6.gbbsoft.pl	gbboptimizer6-mqtt.gbbsoft.pl	F
gbboptimizer7.gbbsoft.pl	gbboptimizer7-mqtt.gbbsoft.pl	G
gbboptimizer8.gbbsoft.pl	gbboptimizer8-mqtt.gbbsoft.pl	H
gbboptimizer9.gbbsoft.pl	gbboptimizer9-mqtt.gbbsoft.pl	I
gbboptimizer10.gbbsoft.pl	gbboptimizer10-mqtt.gbbsoft.pl	J
gbboptimizer11.gbbsoft.pl	gbboptimizer11-mqtt.gbbsoft.pl	K
gbboptimizer12.gbbsoft.pl	gbboptimizer12-mqtt.gbbsoft.pl	L
gbboptimizer13.gbbsoft.pl	gbboptimizer13-mqtt.gbbsoft.pl	M
gbboptimizer14.gbbsoft.pl	gbboptimizer14-mqtt.gbbsoft.pl	N
gbboptimizer15.gbbsoft.pl	gbboptimizer15-mqtt.gbbsoft.pl	O
gbboptimizer16.gbbsoft.pl	gbboptimizer16-mqtt.gbbsoft.pl	P
gbboptimizer17.gbbsoft.pl	gbboptimizer17-mqtt.gbbsoft.pl	Q
gbboptimizer18.gbbsoft.pl	gbboptimizer18-mqtt.gbbsoft.pl	R
gbboptimizer19.gbbsoft.pl	gbboptimizer19-mqtt.gbbsoft.pl	S
gbboptimizer20.gbbsoft.pl	gbboptimizer20-mqtt.gbbsoft.pl	T

De server uit PlantId afleiden#

De PlantId-prefix (eerste letter) geeft aan welke server jouw installatie gebruikt:

Verbruiksprofielen

Mon, 01 Jan 0001 00:00:00 +0000

Verbruiksprofielen#

Module voor het voorspellen van het energieverbruik van het huis. Het verbruik is onderverdeeld in uren en weekdagen.

Handmatige invoer#

Voer de kWh voor elk uur en elke weekdag rechtstreeks in de tabel in.

Gegevens uit de installatie importeren#

Stel de importperiode in en klik op Importeren uit installatie. Het programma berekent het gemiddelde verbruik voor elk uur en elke weekdag op basis van de gegevens uit de omvormer.

Victron

Mon, 01 Jan 0001 00:00:00 +0000

Modusmapping — Victron#

victron-only

Victron-omvormers worden aangestuurd door ESS (Energy Storage System) via VRM en MQTT.

ESS-modus#

GbbOptimizer stuurt het Victron-systeem aan via ESS-schema’s (ESS Schedules) op de Cerbo GX. De schema’s bepalen:

Werkmodus — laden, ontladen, normale werking
Doel-SOC — tot welk niveau laden/ontladen
Vermogensgrens — maximaal laad-/ontlaadvermogen
Tijdvenster — uren waarop het schema van toepassing is

Initiële configuratie#

Schakel in het VRM-portaal externe toegang tot de Cerbo in
Stel in ESS de modus „Optimized (without BatteryLife)" in
Zorg ervoor dat GbbOptimizer de juiste VRM-gegevens heeft (PlantId, PlantToken)

Als Battery Life in ESS is ingeschakeld, kan GbbOptimizer de batterij niet volledig aansturen. Schakel het uit en stel in op „Optimized (without BatteryLife)".

EVCC-topics

Mon, 01 Jan 0001 00:00:00 +0000

MQTT-topics voor EVCC#

Integratie van GbbOptimizer met evcc.io via MQTT.

Configuratie#

Maak in de Mosquitto-broker (of HA) een bridge-configuratiebestand:

1
2
3
4
5
6


connection GbbOptimizer_<PlantId>
remote_username <PlantId>
remote_password <PlantToken>
address <MQTT-adres>:8883
bridge_capath /etc/ssl/certs
topic # both 2 evcc/loadpoints/ <PlantId>/evcc/site/loadpoints/

MQTT-serveradressen — zie MQTT-servers.

Gegevens van EVCC naar GbbOptimizer#

Commando’s van GbbOptimizer naar EVCC#

PUB {PlantId}/evcc/loadpoints/{chargerId}/mode

Laadmodus: off of now

Extra verbruik / EV

Mon, 01 Jan 0001 00:00:00 +0000

Extra verbruik / EV#

Extra verbruik is het deel van het energieverbruik dat niet wordt meegenomen in het huisgemiddelde — bijvoorbeeld het opladen van een elektrische auto of een warmtepomp. Het doel is om het onvoorspelbare, variabele deel uit het standaardverbruik te halen.

Gegevensstroom:

IoT-meters → Extra verbruik → Winsten → Batterijprognose
EV-laders → Extra verbruik → Winsten → Batterijprognose

AutoConverter#

AutoConverter detecteert pieken in het verbruik en zet deze automatisch om in het laden van een auto (of een ander type Extra verbruik).

Sofar

Mon, 01 Jan 0001 00:00:00 +0000

Sofar#

Configuratie van de Sofar-omvormer met GbbOptimizer. De Sofar-omvormer wordt aangestuurd in Passive Mode.

Mapping van GbbOptimizer-modi op Sofar-instellingen (Passive Mode)#

Het programma stelt StorageMode = 3 (Passive Mode) in en (bij ondersteuning van 5 parameters) ManagementMode = 1 (Manual).

Bewerking	Gdes (Grid setpoint)	Blo (battery high)	Bup (battery low)	Gdzup (grid high)	Gdzlo (grid low)
Normal	Standaard-GridSetpoint (uit het menu Discharge)	ChargeLimit of MaxBatteryChargePower of MaxInverterChargePower	-(DischargeLimit of MaxBatteryDischargePower of MaxInverterDischargeLimit)	MaxBuyPower of MaxInverterChargePower	-(MaxSellPower of MaxInverterDischargePower)
Charge	= Gdzup	ChargeLimit (gecorrigeerd om TargetSOC in een heel uur te bereiken)	0	InputLimit of MaxBuyPower of MaxInverterChargePower	0
Discharge	= Gdzlo	= Bup	-(DischargeLimit, gecorrigeerd om TargetSOC in een heel uur te bereiken)	0	-(MaxSellPower of MaxInverterDischargePower)
DisableCharge	0	0	0	MaxBuyPower of MaxInverterChargePower	-(MaxSellPower of MaxInverterDischargePower)

Als de optie „SofarSolar: Support for 5 parameters (not 3) in PassiveMode" niet is aangevinkt, worden de parameters Gdzup en Gdzlo niet gewijzigd (omdat ze niet beschikbaar zijn in de 3-parameter-modus).

Veelvoorkomende fouten

Mon, 01 Jan 0001 00:00:00 +0000

Veelvoorkomende fouten#

Lijst van de meest voorkomende foutmeldingen in GbbOptimizer, hun bronnen en mogelijke oplossingen.

Solarman#

Melding	Beschrijving
`SolarmanError: Solarman timeout!`	Solarman kan geen gegevens naar de omvormer sturen. Controleer het lokale netwerk.
`Solarman error: 2101040-device not found`	De omvormer stuurt geen gegevens naar Solarman. Controleer de netwerkverbinding van de omvormer.
`Response status code: 503 / 500 / 504`	De Solarman-API werkt niet correct. Probleem aan de kant van Solarman — wacht even en probeer het opnieuw.

DeyeCloud#

Melding	Beschrijving
`DeyeCloud error: timeout`	DeyeCloud kan geen gegevens naar de omvormer sturen. Controleer het lokale netwerk.
`DeyeCloud error: 2104006-device offline`	De omvormer stuurt geen gegevens naar DeyeCloud. Controleer de netwerkverbinding van de omvormer.
`DeyeCloud error: 2101042-auth no operation permission`	Te weinig rechten voor het DeyeCloud-account (bijv. een door de installateur aangemaakt account). Neem contact op met de installateur om volledige rechten te krijgen.

GbbConnect2#

Melding	Beschrijving
`Mqtt to GbbConnect2: timeout!`	GbbOptimizer kan geen verbinding maken met de lokale GbbConnect2. Controleer of GbbConnect2 draait.
`GbbConnect2Error: Connection timed out 192.168.x.xx:8899`	GbbConnect2 kan geen verbinding maken met de Deye-dongle. Controleer of de dongle in het netwerk zit.

Victron#

Melding	Beschrijving
`Victron Mqtt: timeout! (15 sec)`	GbbOptimizer kan geen verbinding maken met de Cerbo via de MQTT-servers van Victron. Controleer het lokale netwerk en externe toegang in VRM.
`Error during checking whether Schedules reached Cerbo successfully`	ESS-schema’s zijn niet bij de Cerbo aangekomen. Controleer de internetverbinding van de Cerbo.

Energieprijzen#

Melding	Bron	Beschrijving
`Get Prices: The SSL connection could not be established`	ENTSO-E	De ENTSO-E-prijzen-API werkt niet. Probleem aan de kant van de provider.
`Get Prices: Proba polaczenia nie powiodla sie`	ENTSO-E	ENTSO-E-API niet beschikbaar.
`Get Prices: HTTP POST ... Gateway timeout / 502 Bad Gateway`	Tibber	De Tibber-prijzen-API werkt niet.
`Get Prices: Response status code: 502 (Bad Gateway)`	AU Amber	De Amber-prijzen-API werkt niet.

Overig#

Melding	Bron	Beschrijving
`Solcast.com: Too many requests`	Solcast	Dagelijkse limiet van 10 verzoeken naar Solcast.com bereikt. Wacht tot middernacht.
`ERROR from Cache: Response status code: 500`	Pstryk	Fout aan de kant van de Pstryk-API.
`B0220-System function downgrade`	Hinen	De Hinen-API wordt bijgewerkt. Wacht tot de update is voltooid.

Foutmeldingen worden per e-mail vanuit het programma verzonden. De meeste „timeout"- en „device offline"-fouten hangen samen met problemen in het lokale netwerk — controleer de verbinding tussen de omvormer en de router.

Warmtepomp / airco

Mon, 01 Jan 0001 00:00:00 +0000

Prognose warmtepomp / airco#

Module voor het voorspellen van het verbruik van een warmtepomp (WP) of airco op basis van de buitentemperatuur.

Waarom een aparte module?#

Warmtepompen en airco’s werken (net als EV-laders) niet volgens het dagritme — ze hangen af van de temperatuur. Daarom is het beter om ze uit te sluiten van het gemiddelde in de module Verbruiksprofielen en ze onder te brengen in Extra verbruik.

Stap-voor-stap configuratie#

Voer breedte- en lengtegraad in in de installatieparameters
Importeer de weersvoorspelling
Klik op WP-parameters en voer het kWh-verbruik van de WP/airco in voor elk uur (minimaal 2 waarden voor verschillende temperaturen)
Klik op WP-prognose berekenen en controleer de resultaten
Klik op WP-prognose exporteren naar module Extra verbruik (menu: Verbruiksprofielen → Extra verbruik → Filter: „Type" = „Warmtepomp")
Schakel uurlijkse taken in: Weersvoorspelling importeren, WP-prognose berekenen, WP-prognose exporteren naar module Extra verbruik

WP-parameters — tabel temperatuur vs. verbruik#

Geef voor elk uur aan hoeveel kWh de WP/airco verbruikt bij de betreffende buitentemperatuur.

Winsten

Mon, 01 Jan 0001 00:00:00 +0000

Winsten#

Deze module verzamelt gegevens uit de installatie en berekent de opbrengsten van de PV. Importeer handmatig ten minste één keer per dag, of vink Gegevens automatisch uit installatie importeren aan.

Gegevens worden weergegeven per uur, dag of maand:

Uurgegevens — 2 maanden bewaard
Daggegevens — 2 jaar bewaard
Maandgegevens — voor altijd bewaard

Kolommen — Winst#

Kolom	Beschrijving
Dag / Uur	Dag en uur
Winstwaarde	= Verbruikswaarde - Omvormerwaarde - (Inkoopwaarde - Waardeverandering batterij) + Verkoopwaarde
Winst / Verbruik	KPI: Winstwaarde / Verbruik kWh
Profit / Solar	KPI: Winstwaarde / PV kWh
Energiekosten	Inkoopwaarde - Verkoopwaarde
Uit het net (kWh)	Hoeveel uit het net is genomen
Uit het net gesaldeerd (kWh)	Genomen na saldering per uur (voor Polen)
Inkoopprijs	Inkoopprijs van energie
Inkoopwaarde	Uit het net [gesaldeerd] × Inkoopprijs + Maandelijkse kosten
Inkoop / Productie	KPI: Inkoopwaarde / Verbruikswaarde
(Inkoop - Verkoop) / Productie	KPI: welk percentage van je energierekening je betaalt
Naar het net (kWh)	Hoeveel naar het net is gestuurd
Naar het net gesaldeerd (kWh)	Gestuurd na saldering per uur (voor Polen)
Verkoopprijs	Verkoopprijs van energie
Verkoopwaarde	Naar het net [gesaldeerd] × Verkoopprijs − Waarde van de naar het net gestuurde energie
Verbruik (kWh)	Stroomverbruik door het huis
Verbruiksprijs	Prijs van de door het huis verbruikte energie (inclusief de omvormer)
Verbruikswaarde	Verbruik kWh × Verbruiksprijs
Omvormerverbruik (kWh)	Stroomverbruik van de omvormer
Omvormerwaarde	Omvormerverbruik kWh × Verbruiksprijs
Zelfconsumptie	KPI: 1 - (Naar het net kWh / PV kWh) — hoeveel PV-energie niet naar het net gaat
Zelfvoorziening	KPI: PV / Verbruik — hoeveel % van de energie uit PV het verbruik dekt
RTE	KPI: Naar het net kWh / (Uit het net kWh + PV kWh - Verbruik kWh)
PV (kWh)	PV-productie
Naar de batterij (kWh)	Energie verstuurd naar de batterij (voor conversie naar DC)
min/max/gem SOC (%)	Minimale, maximale en gemiddelde SOC van de batterij

Kolommen — Waarde van de energie in de batterij#

Kolom	Beschrijving
Begin SOC (%)	Begin-SOC (berekend uit MinSOC en MaxSOC, als de installatie dit niet aanlevert)
Eind SOC (%)	Eind-SOC
Batterijverandering (kWh)	>0 laden, <0 ontladen — berekend uit EindSOC - BeginSOC
Laden uit het net (kWh)	Energie gebruikt voor laden uit het net (AC-zijde)
Laden uit PV (kWh)	Energie gebruikt voor laden uit PV (AC-zijde)
Verliezen bij laden (kWh)	Verschil tussen DC en AC tijdens laden
Laadrendement (%)	1 - Verliezen / (Laden uit het net + uit PV)
Ontladen naar het net (kWh)	Energie uit de batterij naar het net (AC)
Ontladen naar verbruik (kWh)	Energie uit de batterij naar het huis (AC)
Verliezen bij ontladen (kWh)	Verschil DC/AC tijdens ontladen
Ontlaadrendement (%)	1 - Verliezen / (Ontladen naar het net + naar verbruik)
Begin / Eind kWh in de batterij	Energie in de batterij boven MinSOC
Begin / Eind Waarde (PLN)	Waarde van de energie in de batterij
Waardeverandering batterij (PLN)	Ontladen: kWh × Gemiddelde prijs (vorig uur). Laden: kWh × Inkoopprijs
Gemiddelde eindprijs (PLN)	Eindwaarde / Eind kWh in de batterij
MinSOC (%)	Onthouden waarde „Minimale SOC batterij %" uit de installatieparameters

Kolommen — Extra verbruik#

Kolom	Beschrijving
Prijs Extra verbruik (PLN)	Gemiddelde prijs per kWh: gemiddelde van 0 (PV), de gemiddelde batterijprijs en de inkoopprijs (in verhouding van gebruik)
Elektrische auto (kWh / PLN)	Energie en waarde van het EV-laden
Warmtepomp (kWh / PLN)	Energie en waarde van de warmtepomp
Andere1 (kWh / PLN)	Energie en waarde van „Andere1"
Andere2 (kWh / PLN)	Energie en waarde van „Andere2"