GbbOptimizer — Podręcznik

Czym jest GbbOptimizer

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

Czym jest GbbOptimizer#

GbbOptimizer (dawniej GbbVictronWeb) to program optymalizujący wykorzystanie energii w domowej instalacji fotowoltaicznej z magazynem energii (baterią). Analizuje prognozy produkcji PV, profil zużycia energii oraz ceny zakupu i sprzedaży, aby automatycznie sterować falownikiem — decydując kiedy ładować baterię, kiedy rozładowywać i kiedy kupować lub sprzedawać energię z/do sieci.

Jak to działa#

Program działa w chmurze i komunikuje się z falownikiem przez internet. Co godzinę wykonuje obliczenia i wysyła komendy do falownika.

Deye

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

Mapowanie trybów — Deye#

deye-only

Jak tryby GbbOptimizer przekładają się na ustawienia falownika Deye w zależności od metody połączenia.

Solarman / DeyeCloud (nowa metoda połączenia)#

recommended

Operacja	Work Mode	GridCharge (TimeOfUse)	Time (TimeOfUse)	SOC (TimeOfUse)	Power (TimeOfUse)	Charge A	MaxSellPower
Normal	—	nie	tak	5%*	Max Battery Discharge, jeśli brak: Max Inverter Discharge	bez zmian	—
Charge	—	tak	tak	SOC%	ChargeLimitW, jeśli brak: Max Battery Charge, jeśli brak: Max Inverter Charge	ChargeLimitW, jeśli brak: Max Battery Charge, jeśli brak: Max Inverter Charge	—
Discharge	SellingFirst (po zakończeniu: powrót do poprzedniej wartości)	nie	tak	SOC%	Max Battery Discharge, jeśli brak: Max Inverter Discharge	bez zmian; KeepSOC: 0W	Max GridSetpoint / Discharge (W); jeśli rozładowanie musi być wolniejsze, program oblicza wartość; po zakończeniu: powrót do poprzedniej wartości
DisableCharge	—	nie	tak	5%*	Max GridSetpoint / Discharge (W)	zmiana na 0 (po zakończeniu: powrót do poprzedniej wartości)	—

* 5% można zmienić parametrem “Default MinSOC after discharge” w ustawieniach planu rozładowania.

Mosquitto Bridge

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

Mosquitto Bridge#

Aby GbbOptimizer mógł komunikować się z Home Assistant, należy skonfigurować most (bridge) między lokalnym brokerem Mosquitto w HA a serwerem MQTT GbbOptimizer.

Wymagania#

Home Assistant z zainstalowanym dodatkiem Mosquitto broker
Aktywna instalacja w GbbOptimizer z przypisanym PlantId i PlantToken
Adres serwera MQTT — patrz Serwery MQTT

Konfiguracja krok po kroku#

1. Włącz folder konfiguracyjny w Mosquitto#

W Home Assistant przejdź do Ustawienia -> Dodatki -> Mosquitto broker -> Konfiguracja.

Parametry instalacji

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

Parametry instalacji#

Poniżej opisane są wszystkie parametry konfiguracyjne instalacji w GbbOptimizer, pogrupowane tematycznie.

Typ#

Parametr	Jednostka	Opis
Typ	—	Typ połączenia z falownikiem (Victron, Solarman, GbbConnect2, DongleDirect, SolarAssistant)
Przedziałów czasu dziennie	—	Liczba przedziałów czasu dziennie. W Polsce obowiązuje 60 przedziałów dla klientów indywidualnych

Instalacja#

Parametr	Jednostka	Opis
Nazwa	—	Unikalna nazwa instalacji w ramach konta
Strefa czasowa	—	Strefa czasowa lokalizacji instalacji
Maksymalna moc pobierania z sieci	kW	Parametr przyłącza — maksymalna moc pobierana z sieci
Maksymalna moc wysyłania do sieci	kW	Parametr przyłącza — maksymalna moc oddawana do sieci
Jaki % PV jest podłączony po stronie DC?	%	`0%` — wszystkie PV podłączone do AC. `100%` — wszystkie PV podłączone do DC
Szerokość/Długość geograficzna	—	Położenie geograficzne instalacji. Używane przez moduły: Meteo i Prognozy PV

Źródła cen#

Parametr	Opis
Zakup: Taryfa dla cen zakupu	Źródło zaimportowanych cen zakupu energii
Przesył: Taryfa dla cen przesyłu	Źródło cen przesyłu (transport). Puste = 0
Sprzedaż: Taryfa dla cen sprzedaży	Źródło zaimportowanych cen sprzedaży energii

Szczegóły wzorów cenowych — w module Ceny.

Procedury C# IoT

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

Procedury C# IoT#

GbbOptimizer pozwala tworzyć własne procedury w języku C#, które sterują urządzeniami IoT na podstawie prognoz, cen energii i historii zużycia.

Procedura musi działać nie dłużej niż 100 ms i nie może zakłócać pracy programu. W przeciwnym razie zostanie zawieszona.

Obiekt App#

Każda procedura IoT otrzymuje obiekt App jako parametr. Poniżej lista dostępnych właściwości.

Właściwości główne#

Właściwość	Typ	Opis
`App.CurrDate`	`DateTime?`	Data, dla której urządzenie ma być włączone/wyłączone
`App.CurrHour`	`decimal?`	Godzina (12:30 = 12.5; 12:45 = 12.75)
`App.CurrForecastIndex`	`int?`	Indeks w `App.Forecast` dla bieżącej daty i godziny
`App.StringVariables`	`Dictionary<string, string?>`	Zmienne tekstowe użytkownika (trwałe między wywołaniami)
`App.DecimalVariables`	`Dictionary<string, decimal?>`	Zmienne liczbowe użytkownika (trwałe między wywołaniami)

Prognoza (Forecast)#

Właściwość	Typ	Opis
`App.Forecast`	`IForecast[]`	Tablica prognozy baterii. `[0]` = bież. godzina, `[1]` = nast. godzina itd.
`.Date`	`DateTime`	Data prognozy
`.DateNo`	`int`	0 = dzisiaj, 1 = jutro itd.
`.Hour`	`decimal`	Godzina prognozy
`.HourNo`	`decimal`	Godzina licząc od początku prognozy (`[0].HourNo == 0` zawsze)
`.StartBattery_kWhAC`	`decimal`	kWh w baterii (AC) na początku godziny
`.StartBattery_kWh`	`decimal`	kWh w baterii (DC) na początku godziny
`.Prod_KWhAC`	`decimal?`	Produkcja (PV + wiatr) w danej godzinie
`.Loads_kWhAC`	`decimal?`	Zużycie w danej godzinie
`.GridCharge_kWhAC`	`decimal?`	kWh z sieci do baterii (strona sieci)
`.GridCharge_kWh`	`decimal?`	kWh z sieci do baterii (strona baterii)
`.Discharge_kWhAC`	`decimal?`	kWh z baterii do sieci (strona sieci)
`.Discharge_kWh`	`decimal?`	kWh z baterii do sieci (strona baterii)
`.EndBattery_kWhAC`	`decimal?`	kWh w baterii (AC) na koniec godziny
`.EndBattery_kWh`	`decimal?`	kWh w baterii (DC) na koniec godziny
`.Meteo_SOC`	`decimal?`	null = brak ostrzeżeń meteo; wartość = docelowy SOC dla ostrzeżenia
`.Temperature_C`	`decimal?`	Temperatura (st. C) w danej godzinie
`.ExtraLoads_kWh`	`decimal?`	Suma dodatkowych obciążeń
`.FromGrid_kWh`	`decimal?`	kWh z sieci
`.PurchasePrice`	`decimal?`	Cena zakupu
`.PurchaseAmount`	`decimal?`	Kwota zakupu
`.ToGrid_kWh`	`decimal?`	kWh do sieci
`.SalePrice`	`decimal?`	Cena sprzedaży
`.SaleAmount`	`decimal?`	Kwota sprzedaży

Ceny (Prices)#

Właściwość	Typ	Opis
`App.Prices`	`Dictionary<(DateTime, decimal), IPrice>`	Ceny za wczoraj, dzisiaj i jutro
`.Day`	`DateTime`	Data ceny
`.Hour`	`decimal`	Godzina ceny
`.PurchasePrice`	`decimal?`	Cena zakupu
`.SalesPrice`	`decimal?`	Cena sprzedaży
`.Imported_PurchasePrice`	`decimal?`	Cena zakupu zaimportowana ze źródła cen
`.Imported_SalesPrice`	`decimal?`	Cena sprzedaży zaimportowana ze źródła cen

Historia (History)#

Właściwość	Typ	Opis
`App.History`	`IHistory[]`	Dane historyczne. `[0]` = godzina przed bież., `[1]` = dwie godziny przed itd.
`.Date`	`DateTime`	Data
`.Hour`	`decimal`	Godzina
`.FromGrid_kWh`	`decimal?`	kWh z sieci
`.PurchasePrice`	`decimal?`	Cena zakupu
`.PurchaseAmount`	`decimal?`	Kwota zakupu
`.ToGrid_kWh`	`decimal?`	kWh do sieci
`.SalePrice`	`decimal?`	Cena sprzedaży
`.SaleAmount`	`decimal?`	Kwota sprzedaży
`.Loads_kWh`	`decimal?`	Zużycie (kWh)
`.LoadsPrice`	`decimal?`	Cena energii zużycia
`.LoadsAmount`	`decimal?`	Kwota energii zużycia
`.PV_kWh`	`decimal?`	Produkcja PV (kWh)
`.SOC_Start`	`decimal?`	SOC na początku godziny
`.SOC_End`	`decimal?`	SOC na koniec godziny
`.ExtraLoads_Price`	`decimal?`	Cena dodatkowych obciążeń
`.ExtraLoads_kWh`	`decimal?`	Suma dodatkowych obciążeń (kWh)

Urządzenia IoT (IoTDevices)#

Właściwość	Typ	Opis
`App.IoTDevices`	`Dictionary<string, IIoTDevice>`	Lista urządzeń IoT
`.Name`	`string`	Nazwa urządzenia
`.IsOn`	`bool`	Aktualny stan włącznika

Funkcje specjalne#

Funkcja	Opis
`void App.ToLog(string message)`	Wyświetl wiadomość w menu Log
`bool App.IsInLowerPrices(DateTime CurrDate, decimal CurrHour, int LowerHours, bool Purchase)`	Czy dana godzina jest w najniższych godzinach dnia?
`bool App.IsInHigherPrices(DateTime CurrDate, decimal CurrHour, int HigherHours, bool Purchase)`	Czy dana godzina jest w najwyższych godzinach dnia?

Dostępne biblioteki#

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

Przykład#

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;
}

Ten przykład włącza urządzenie, gdy:

Prognoza baterii

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

Prognoza baterii#

Centralny moduł GbbOptimizer. Analizuje SOC baterii na najbliższe 24h (lub więcej) w oparciu o ładowanie z PV, ładowanie z sieci, rozładowanie i zużycie przez dom. Zawiera optymalizator, który automatycznie dobiera parametry ładowania i rozładowania.

W tym module możesz:

Analizować prognozę SOC baterii na najbliższe 24h
Zobaczyć, kiedy SOC przekracza minimalne lub maksymalne wartości
Optymalizować plany ładowania i rozładowania
Podglądać ceny zakupu i sprzedaży oraz zyski

Kolumny tabeli prognozy#

Tabela pokazuje dane na najbliższe 24h. Skróty: DC = prąd stały, AC = prąd zmienny.

Słowniczek

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

Słowniczek#

Battery Full Date

Konkretne dni miesiąca, w których optymalizator dąży do naładowania baterii do 100% SOC. Podawane jako wartości rozdzielone przecinkami (np. '1, 15'). Umożliwia okresowe pełne cykle ładowania dla zdrowia baterii.

Correction Factor

Mnożnik obliczany w ciągu około tygodnia pracy, który koryguje wartości prognozy PV tak, aby odpowiadały rzeczywistej produkcji, poprawiając dokładność przewidywań.

DongleDirect

Metoda połączenia, w której dongle WiFi falownika jest przekonfigurowany tak, aby komunikował się bezpośrednio z serwerem GbbOptimizer zamiast z chmurą producenta.

Solarman

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

Solarman#

Solarman to chmurowa metoda połączenia falownika z GbbOptimizer. Dane przechodzą przez serwery Solarman — nie wymaga instalacji dodatkowego oprogramowania.

Konfiguracja krok po kroku#

Dodaj instalację: Dodaj nową instalację z falownikiem połączonym do Solarman
Wypełnij pola do grupy „Solarman” (szczegóły w Parametry instalacji)
Zaloguj się do serwerów Solarman: wprowadź email i hasło (te same co do aplikacji Solarman) i naciśnij Połącz
Wybierz z listy Wybierz SerialNo falownika swój falownik
Wybierz Rodzaj falownika

Sygnały

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

Sygnały MQTT#

GbbOptimizer wysyła sygnały do zewnętrznych programów (np. Home Assistant) co godzinę, na podstawie prognozy dla bieżącej godziny.

Parametry połączenia z MQTT (adres, port, TLS, ClientID) — patrz Zapytania / Odpowiedzi.

Sygnały muszą być najpierw włączone w module Rozładowanie

Dany sygnał nie jest wysyłany, jeśli parametr „X" nie jest zdefiniowany (pole puste)

Sygnały binarne#

Zewnętrzny program może subskrybować następujące tematy:

PUB {PlantId}/signals/SOCHigherEqThanXQoS 0

"1" jeśli SOC ≥ X, w przeciwnym razie "0"

Victron

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

Victron#

victron-only

Konfiguracja falownika Victron z GbbOptimizer wymaga poprawnego ustawienia systemu ESS oraz portalu VRM.

Lista kontrolna#

Przed uruchomieniem GbbOptimizer sprawdź następujące ustawienia:

Nie instaluj wersji Beta oprogramowania sprzętowego (firmware)
DESS musi być wyłączony
Schedules — opcja „Self-consumption above limit" powinna być ustawiona na PV (a nie „PV & Battery"). Dzięki temu harmonogramy nie powodują rozładowania baterii w nocy
Battery Life w ESS musi być wyłączone — wybierz tryb: Optimized (without BatteryLife)
Log interval (w VRM Online Portal) ustaw na 1 min
Uprawnienia VRM — użytkownik musi mieć włączone prawo Full Control
Zrestartuj Cerbo po wprowadzeniu zmian

Nieprawidłowe ustawienia Battery Life lub Schedules mogą powodować nieoczekiwane rozładowanie baterii w nocy.

GbbConnect2 Addon

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

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:

Deye

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

Deye#

deye-only

Falowniki hybrydowe Deye mogą być podłączone do GbbOptimizer na kilka sposobów. Na tej stronie znajdziesz listę kontrolną ustawień falownika oraz porównanie metod połączenia.

Lista kontrolna#

Przed uruchomieniem GbbOptimizer sprawdź na falowniku Deye:

Tryb pracy — Zero export to CT lub Zero export to Loads (nie „Selling First”!)

Nie sprawdzaj trybu pracy podczas aktywnego rozładowania — GbbOptimizer tymczasowo zmienia tryb.

DeyeCloud

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

DeyeCloud#

deye-only

DeyeCloud to zapasowa metoda połączenia dostępna dla instalacji typu Solarman. Może być używana jako backup w przypadku problemów z Solarman lub jako jedyne połączenie.

Tryby działania#

Tryb	Opis
Wyłączone	DeyeCloud nie jest używane
Włączone	DeyeCloud aktywuje się automatycznie, gdy Solarman zgłosi błąd
Tylko zapasowe	Nie używaj Solarman — zawsze DeyeCloud

Konfiguracja#

W sekcji Zapasowe połączenie — DeyeCloud parametrów instalacji wybierz tryb działania
Wprowadź dane logowania do DeyeCloud (mogą być inne niż do Solarman)
Zaznacz Zapamiętaj dane do logowania — bez tego wymagane ręczne ponowne logowanie
Po połączeniu wybierz SerialNo falownika

Szczegółowy opis parametrów znajdziesz w Parametry instalacji.

evcc

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

Integracja z evcc#

evcc.io to oprogramowanie do inteligentnego ładowania pojazdów elektrycznych. GbbOptimizer może się z nim komunikować przez MQTT, aby koordynować ładowanie EV z optymalizacją baterii domowej.

Wymagania#

Działająca instalacja evcc
Lokalny broker MQTT (Mosquitto w Home Assistant lub samodzielny)
Skonfigurowany Mosquitto Bridge

Konfiguracja bridge#

W pliku konfiguracyjnym Mosquitto (/share/mosquitto/GbbOptimizer.conf) dodaj linie topic dla evcc:

1
2
3
4
5
6


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

Topiki MQTT#

Dane z evcc (evcc -> GbbOptimizer)#

Topik	Opis
`{PlantId}/evcc/site/statistic/total/chargedKWh`	Całkowita energia załadowana do EV (kWh)

Komendy z GbbOptimizer (GbbOptimizer -> evcc)#

Topik	Payload	Opis
`{PlantId}/evcc/loadpoints/{chargerId}/mode`	`off` lub `now`	Włącz/wyłącz ładowanie
`{PlantId}/evcc/loadpoints/{chargerId}/maxCurrent`	liczba (A)	Maksymalny prąd ładowania
`{PlantId}/evcc/loadpoints/{chargerId}/connected`	`true`/`false`	Stan połączenia z ładowarką

Gdzie {chargerId} to identyfikator punktu ładowania w evcc.

GBB Shunt

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

GBB Shunt#

GBB Shunt to moduł GbbOptimizer przeznaczony do instalacji z bateriami ołowiowymi (kwasowymi, żelowymi, AGM).

Czym jest GBB Shunt?#

W instalacjach z bateriami ołowiowymi standardowy pomiar SOC przez falownik może być niedokładny. GBB Shunt pozwala na dokładniejsze śledzenie stanu naładowania baterii na podstawie pomiaru prądu przez bocznik (shunt).

Kluczowe funkcje#

Dokładny pomiar SOC — na podstawie pomiaru prądu (kulomierz), a nie napięcia
Kompensacja temperatury — uwzględnia wpływ temperatury na pojemność baterii ołowiowej
Ochrona baterii — zapobiega głębokim rozładowaniom, które skracają żywotność baterii ołowiowych

Kiedy używać?#

GBB Shunt jest zalecany, jeśli:

GoodWe

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

Mapowanie trybów — GoodWe#

Jak tryby GbbOptimizer przekładają się na ustawienia protokołu GoodWe.

Battery Charge-Discharge#

Operacja	BatteryCDEnable	BatteryCDMode	BatteryCDPW
Normal	nie	—	—
Charge	tak	2	ChargeLimitW
Discharge	tak	3	DischargeLimitW: Max GridSetpoint / Discharge (W). Jeśli rozładowanie musi być wolniejsze, aby trwało całą godzinę — program oblicza odpowiednią wartość. Po zakończeniu: powrót do poprzedniej wartości.
DisableCharge	tak	2	0

Brakujące opcje#

Protokół GoodWe nie obsługuje:

Limitu docelowego SOC (TargetSOC)

Opcji dla ceny < 0

Ładowanie

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

Ładowanie#

Moduł ładowania zarządza harmonogramami ładowania baterii z sieci. W systemie Victron odpowiada za Schedules w module ESS.

victron-only Zakładamy, że „Self-consumption above limit" jest ustawiony na PV (a nie „PV & Battery"), ponieważ chcemy, aby harmonogram zatrzymywał rozładowywanie baterii w nocy.

Pobierz tablicę z instalacji#

victron-only Program łączy się z instalacją i pobiera 5 harmonogramów (Schedulerów).

SolarAssistant

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

SolarAssistant#

deye-only

Integracja GbbOptimizer z falownikiem Deye przez SolarAssistant i Home Assistant.

Obsługiwane konfiguracje#

Home Assistant (HA) z SolarAssistant (SA) połączonym z hybrydowym falownikiem Deye jako inverter_1

Wymagania#

Home Assistant z Mosquitto broker
SolarAssistant zainstalowany i połączony z falownikiem Deye
Skonfigurowany Mosquitto Bridge z topikiem dla SolarAssistant

Konfiguracja SolarAssistant#

W ustawieniach SolarAssistant przejdź do Configuration -> Advanced MQTT i zmień:

Szybki start

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

Szybki start#

Przewodnik krok po kroku, jak uruchomić GbbOptimizer dla Twojej instalacji fotowoltaicznej.

1. Załóż konto i utwórz instalację#

Wejdź na stronę GbbOptimizer i załóż konto. Następnie dodaj nową instalację wybierając odpowiednią opcję w zależności od Twojego falownika:

Falownik	Opcja w menu
Victron (Cerbo GX lub inny moduł GX)	„Dodaj nową instalację z Victron System"
Deye przez DeyeCloud	„Dodaj nową instalację z inwerterem Deye podłączonym do DeyeCloud"
Deye przez Solarman	„Dodaj nową instalację z Solarman"
Deye przez Home Assistant	„Dodaj nową instalację z Home Assistant"
Inny falownik przez Solarman	„Dodaj nową instalację z Solarman"
Inny falownik przez Home Assistant	„Dodaj nową instalację z Home Assistant"
SofarSolar	„Instalacja z DongleDirect (Deye, SofarSolar)"

Jeżeli masz falowniki Deye w układzie Master-Slave, wybierz „Instalacja z Solarman" i dodaj Master jako główny falownik, a Slave jako dodatkowy w parametrach instalacji.

Tryby falowników

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

Tryby falowników#

GbbOptimizer steruje falownikiem za pomocą czterech podstawowych trybów (operacji protokołu). Każdy falownik implementuje je w inny sposób — szczegółowe mapowania znajdziesz w sekcji Mapowania trybów.

Wymagane dane z falownika#

Falownik musi dostarczać następujące dane:

Pole	Opis
`soc_perc`	SOC baterii w procentach (lub `V` jeśli sterowanie przez napięcie)
`loads_total_kWh`	Licznik zużycia (kWh, narastająco)
`fromgrid_total_kWh`	Licznik energii pobranej z sieci (kWh)
`togrid_total_kWh`	Licznik energii wysłanej do sieci (kWh)
`pv_total_kWh`	Licznik produkcji PV (kWh)

Opcjonalnie:

Zapytania / Odpowiedzi

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

Zapytania i odpowiedzi MQTT#

GbbOptimizer obsługuje zapytania request/response przez MQTT. Zewnętrzny program wysyła zapytanie, a GbbOptimizer odpowiada z danymi.

Połączenie#

Zewnętrzny program powinien połączyć się z MQTT z parametrami:

Parametr	Wartość
Adres	Patrz serwery MQTT
Port	8883
Użytkownik	`{PlantId}`
Hasło	`{PlantToken}`
UseTLS	true
ClientID	musi kończyć się na `_{PlantId}`

Tematy#

Kierunek	Temat
Zapytanie →	`{PlantId}/ha_gbb/dataserver/serverrequest`
← Odpowiedź	`{PlantId}/ha_gbb/dataserver/serverresponse`

Dla kompatybilności wstecznej program obsługuje też {PlantId}/dataserver/serverrequest i {PlantId}/dataserver/serverresponse (nie rekomendowane).

Odpowiedź z błędem#

Każde zapytanie może zwrócić błąd:

Automatyzacja

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

Automatyzacja Home Assistant#

Po skonfigurowaniu Mosquitto Bridge możesz tworzyć automatyzacje w Home Assistant, które:

Wysyłają dane z czujników HA do GbbOptimizer
Reagują na komendy otrzymane z GbbOptimizer

Wysyłanie danych do GbbOptimizer#

GbbOptimizer oczekuje danych na topiku ha_gbb/sensor (lokalnie w HA; przez bridge trafia jako <PlantId>/ha_gbb/sensor).

Wymagane pola#

Pole	Opis
`soc_perc`	SOC baterii w procentach (lub `V` jeśli zaznaczono sterowanie przez napięcie)
`loads_total_kWh`	Licznik zużycia (kWh, narastająco)
`fromgrid_total_kWh`	Licznik energii pobranej z sieci (kWh)
`togrid_total_kWh`	Licznik energii wysłanej do sieci (kWh)
`pv_total_kWh`	Licznik produkcji PV (kWh)

Pola opcjonalne#

Pole	Opis
`ev_charge_total_kWh`	Licznik ładowania EV
`hp_total_kWh`	Licznik pompy ciepła
`other1_total_kWh` … `other6_total_kWh`	Dodatkowe liczniki

Wiele instalacji PV#

Aby wysłać dane z kilku płaszczyzn PV, użyj pola more:

GbbConnect2

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

GbbConnect2#

GbbConnect2 to oprogramowanie działające w sieci lokalnej, które łączy falownik bezpośrednio z GbbOptimizer przez ModbusInMqtt, omijając serwery chmurowe.

Wymagania#

Komputer z Windows lub kontener Docker działający 24/7 w sieci lokalnej
Falownik hybrydowy Deye z loggerem (donglem) WiFi
Stały adres IP loggera w sieci lokalnej

Konfiguracja krok po kroku#

Pobierz i zainstaluj GbbConnect2: github.com/gbbsoft/GbbConnect2
W GbbOptimizer stwórz nową instalację typu GbbConnect2 (lub zmień typ istniejącej)

GoodWe

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

GoodWe#

Konfiguracja falownika GoodWe z GbbOptimizer wymaga udostępnienia dostępu przez portal SEMS oraz konfiguracji po stronie GbbOptimizer.

Konfiguracja krok po kroku#

Zaloguj się do portalu SEMS (GoodWe)
W menu Zarządzanie, w danych swojej elektrowni, dodaj email gbbsoft@gbbsoft.pl jako Gość
W GbbOptimizer dodaj instalację z GoodWe, ale nie wybieraj SerialNo — lista powinna być pusta (z wyjątkiem napisu „Wybierz SerialNo”)
Na końcu strony zaznacz Udostępnij instalację pomocy technicznej
Skontaktuj się z pomocą techniczną (np. przez Discord: gbbsoft) i podaj SerialNo swojego falownika
Pomoc techniczna wybierze Twój SerialNo

Konfiguracja GoodWe wymaga jednorazowej interwencji pomocy technicznej w celu powiązania numeru seryjnego falownika z Twoją instalacją.

Hinen

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

Mapowanie trybów — Hinen#

Jak tryby GbbOptimizer przekładają się na ustawienia protokołu Hinen.

Tabela mapowania#

Operacja	Work Mode	Charge/Discharge Enable	Charge/Discharge Start/End	Charge/Discharge SOC	Charge/Discharge Rate	AntiBackflow Enable	AntiBackflow Limit Rate
Normal	Self-consumption	nie	—	100%	—	—	—
Charge	Time period control	tak	tak	SOC%	= ChargeLimit / (MaxInverterChargeDC_kW lub MaxBatteryChargeDC_kW) * 100%	nie	—
Discharge	Time period control	tak	tak	SOC%	= -abs(DischargeLimit) / (MaxInverterChargeDC_kW lub MaxBatteryChargeDC_kW) * 100%. DischargeLimit = Max GridSetpoint / Discharge (W). Jeśli rozładowanie musi być wolniejsze — program oblicza wartość.	tak	taki sam jak Charge/Discharge Rate, ale > 0
DisableCharge	Time period control	tak	tak	aktualny SOC	1%	nie	—

Uwagi#

Rate jest wyrażany jako procent maksymalnej mocy falownika (lub baterii), a nie w watach
W trybie Normal system wraca do trybu Self-consumption z SOC = 100% i wyłączonym Charge/Discharge
W trybie DisableCharge SOC jest ustawiany na aktualny poziom, a Rate na minimalne 1%

Komendy danych

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

Komendy danych MQTT#

Komendy pozwalające zewnętrznym programom zmieniać dane w GbbOptimizer. Każda komenda wysyła dane na dedykowany temat i otrzymuje wynik na {PlantId}/ha_gbb/api/result.

Wynik komend#

PUB {PlantId}/ha_gbb/api/result

Wynik każdej komendy danych — OK lub opis błędu

Pole	Typ	Opis
`OrderId`	string?	Skopiowany z zapytania
`Result`	string	`"OK"` lub opis błędu
`Data`	object	Dane z oryginalnego zapytania

SetManualPrices Ustaw ręczne ceny energii

{PlantId}/ha_gbb/api/setmanualprices

Pole		Typ	Wymagane	Opis
`OrderId`		string	nie	Tekst skopiowany do odpowiedzi
`Data`		tablica	tak
	`Date`	date	tak	Data ceny
	`StartHour`	int (0-23)	tak	Godzina rozpoczęcia
	`StartMinute`	int (0-59)	nie	Minuta (domyślnie 0)
	`PurchasePrice`	decimal	nie	Cena zakupu
	`TransferPrice`	decimal	nie	Cena przesyłu
	`SalePrice`	decimal	nie	Cena sprzedaży

Przykład:

Najlepsze praktyki

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

Najlepsze praktyki#

Porady i wskazówki od doświadczonych użytkowników GbbOptimizer.

Cierpliwość#

Najczęstszy błąd nowych użytkowników to zbyt szybkie zmiany konfiguracji. Program potrzebuje czasu na kalibrację.

GbbOptimizer to program, który uczy cierpliwości. Przez pierwszy tydzień pracy:

Correction Factor dla prognozy PV się kalibruje
Profil zużycia zbiera dane historyczne
Optymalizator “uczy się” Twojej instalacji

Nie wyłączaj Test Mode wcześniej niż po tygodniu. Daj programowi czas na zebranie danych.

Rozładowanie

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

Rozładowanie#

Moduł rozładowania kontroluje, kiedy i jak energia z baterii jest wysyłana do sieci lub używana do zasilania domu. Kluczowym parametrem jest GridSetpoint.

GridSetpoint — jak działa#

GridSetpoint określa, ile energii powinna przepływać przez licznik sieci:

Wartość dodatnia (np. +100 W) — system pobiera energię z sieci. Nadwyżka z PV idzie do baterii.
Wartość ujemna (np. -5000 W) — system eksportuje energię do sieci. Najpierw z PV, potem z baterii.

Przykład 1: GridSetpoint = +100 W

Tuya

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

Integracja z Tuya#

GbbOptimizer może sterować urządzeniami Tuya (np. gniazdkami smart) przez Tuya Cloud API. Wymaga to utworzenia projektu deweloperskiego na platformie Tuya i uzyskania kluczy API.

Uzyskanie Access ID i Access Secret#

1. Utwórz konto deweloperskie#

Zarejestruj się na platform.tuya.com.

2. Utwórz projekt Cloud#

Przejdź do Cloud -> Development
Kliknij Create Cloud Project (prawy górny róg)
Wypełnij formularz:
- Nazwa projektu — dowolna
- Industry — wybierz odpowiednią branżę
- Development Method — Smart Home
- Data Center — wybierz najbliższy Twojej lokalizacji
Na następnym ekranie kliknij Authorize

3. Połącz aplikację mobilną#

Przejdź do Devices -> Link App Account
Kliknij Add App Account
Wyświetli się kod QR
W aplikacji mobilnej Tuya/Smart Life: Me (dolne menu) -> ikona skanowania (prawy górny róg)
Zeskanuj kod QR

Po połączeniu w zakładce All Devices pojawi się lista Twoich urządzeń.

Afore

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

Afore#

Konfiguracja falownika Afore z GbbOptimizer. GbbOptimizer steruje falownikiem Afore przez protokół Modbus.

Mapowanie trybów GbbOptimizer na ustawienia Afore#

Operacja	Rejestr	Wartość	Po zakończeniu
AC charging maximum SOC	Ładowanie: docelowy MaxSOC	—	—
ACCharging start/end time (1-4)	Ładowanie: tablica następnych 4 okresów	—	—
Forced charging start/end time (1-4)	Ładowanie: tablica następnych 4 okresów	—	—
ACCharging power percentage	Ładowanie: Input Limit	% z MaxBuyPower lub MaxBatteryChargeDC	Przywrócenie oryginalnej wartości
Forced charging power percentage	Ładowanie: Charge Limit	% z MaxBatteryChargeDC	Przywrócenie oryginalnej wartości
Minimum SOC for forced discharge	Rozładowanie: docelowy MinSOC	—	—
Forced discharge start time (1-4)	Rozładowanie: tablica następnych 4 okresów	—	—
Power grid power limit percentage	Rozładowanie: GridSetpoint	% z MaxSellPower lub MaxBatteryDischargeDC	—
Maximum charging current	Blokada ładowania: ustawia `0`	—	Przywrócenie oryginalnej wartości

Lista kontrolna#

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

Ceny

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

Ceny#

Moduł konfiguracji cen zakupu i sprzedaży energii. Źródła danych cen ustawia się w parametrach instalacji, pozostałe parametry — tutaj.

Cena zakupu#

Wzór:

1
2


Cena Zakupu = (Cena zaimportowana × Mnożnik + Cena przesyłu + Koszt Transportu) × VAT/100
 + (Koszty miesięczne / ilość godzin w miesiącu)

Składnik	Opis
Cena zaimportowana	Stałe → 0. Zależna od zaimportowanych cen i kosztów transportu → cena ze źródła wskazanego w parametrach instalacji. Zależna od cen sprzedaży → Cena Sprzedaży
Mnożnik	„Zaimportowane Ceny Zakupu pomnóż przez"
Cena przesyłu	Cena ze źródła wskazanego w parametrach instalacji (pozycja „Przesył: Taryfa dla cen przesyłu"). 0 jeśli nie wskazano
Koszt Transportu	Cena z tablicy pod przyciskiem „Zmień Koszty Transportu / stałe Ceny Zakupu"
Koszty miesięczne	Suma stałych kosztów zakupu — rozbita równo na wszystkie godziny w miesiącu

Cena sprzedaży#

Wzór:

DongleDirect

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

DongleDirect#

DongleDirect działa podobnie jak GbbConnect2 — łączy falownik z GbbOptimizer, ale bez instalacji dodatkowego oprogramowania w sieci lokalnej. Dongle (logger WiFi) jest przekierowywany bezpośrednio na serwer GbbOptimizer.

Od 2026-03-09 zmiana ustawień Dongle może być niemożliwa na niektórych modelach. W takim przypadku konieczny jest reset Dongle i przywrócenie oryginalnych ustawień.

Konfiguracja krok po kroku#

Zapamiętaj nazwę serwera GbbOptimizer z adresu przeglądarki (np. gbboptimizer5.gbbsoft.pl)
Zaloguj się do Dongle — musisz znać jego adres IP w sieci lokalnej (login: admin, hasło: admin)
Przejdź na stronę http://<ip_dongla>/config_hide.html (zmień ręcznie adres w przeglądarce)
Zrób zdjęcia ekranu ze wszystkimi aktualnymi ustawieniami (na wypadek potrzeby przywrócenia!)
Zmień Server A Setting:
- Usuń adres IP
- Zapamiętaj oryginalną nazwę domeny Server A
- Zmień domenę na nazwę serwera GbbOptimizer (np. gbboptimizer10.gbbsoft.pl)
- Port: 10000
- Połączenie: TCP
- Save + Restart
Zmień Optional Server Setting na te same dane — Save + Restart
W GbbOptimizer zmień typ instalacji na DongleDirect (lub stwórz nową)
W ustawieniach instalacji wpisz:
- Numer seryjny falownika
- Numer seryjny Dongle (tylko cyfry)
- Oryginalną nazwę domeny Server A — jeśli pole będzie puste, GbbOptimizer nie skopiuje danych do Solarman i Solarman/DeyeCloud przestanie działać
Zapisz i odczekaj 2-5 minut (Dongle łączy się z serwerem GbbOptimizer po kilku minutach)

W logu powinny pojawić się wpisy typu:

1
2


2025-06-21 11:00:27: From Dongle: A501001047F585579AF6A5005E15
2025-06-21 11:00:28: From Server: A50A001017F685579AF6A50001AB745668780000008E15

Reset Dongle#

Jeśli trzeba przywrócić oryginalne ustawienia Dongle:

Sofar

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

Mapowanie trybów — Sofar#

Jak tryby GbbOptimizer przekładają się na ustawienia falownika Sofar w trybie pasywnym (Passive Mode).

Tryb pasywny (Passive Mode)#

Operacja	Gdes (Grid setpoint)	Blo (Battery high)	Bup (Battery low)	Gdzup (Grid high)	Gdzlo (Grid low)
Normal	Default GridSetpoint (menu Discharge)	ChargeLimit lub MaxBatteryChargePower lub MaxInverterChargePower	-(DischargeLimit lub MaxBatteryDischargePower lub MaxInverterDischargeLimit)	MaxBuyPower lub MaxInverterChargePower	-(MaxSellPower lub MaxInverterDischargePower)
Charge	= Gdzup	ChargeLimit lub MaxBatteryChargePower lub MaxInverterChargePower (korygowane, aby osiągnąć docelowy SOC w pełnej godzinie)	0	InputLimit lub MaxBuyPower lub MaxInverterChargePower	0
Discharge	= Gdzlo	= Bup	-(DischargeLimit lub MaxBatteryDischargePower lub MaxInverterDischargeLimit) (korygowane, aby osiągnąć docelowy SOC w pełnej godzinie)	0	-(MaxSellPower lub MaxInverterDischargePower)
DisableCharge	0	0	0	MaxBuyPower lub MaxInverterChargePower	-(MaxSellPower lub MaxInverterDischargePower)

Parametry#

Gdes — Grid setpoint: docelowa wartość wymiany energii z siecią
Blo — Battery high: maksymalna moc ładowania baterii
Bup — Battery low: maksymalna moc rozładowania baterii (wartość ujemna)
Gdzup — Grid high: maksymalna moc poboru z sieci
Gdzlo — Grid low: maksymalna moc eksportu do sieci (wartość ujemna)

Uwagi#

Jeśli opcja “SofarSolar: Support for 5 parameters (not 3) in PassiveMode” jest odznaczona, parametry Gdzup i Gdzlo nie są zmieniane (ponieważ nie są dostępne w trybie 3-parametrowym).

Supla

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

Integracja z Suplą#

GbbOptimizer może sterować urządzeniami Supla (np. przekaźnikami, gniazdkami) przez linki bezpośrednie (Direct Links).

Konfiguracja#

Aby połączyć urządzenie Supla z GbbOptimizer, należy utworzyć link bezpośredni w panelu Supla Cloud:

Zaloguj się do cloud.supla.org
Przejdź do urządzenia, które chcesz sterować
Utwórz link bezpośredni (Direct Link) z odpowiednimi uprawnieniami (włącz/wyłącz)
Skopiuj wygenerowany URL
Wklej URL w konfiguracji GbbOptimizer w sekcji IoT -> Supla

Szczegółowy opis tworzenia linków bezpośrednich znajdziesz w dokumentacji Supla.

Tematy Home Assistant

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

Tematy MQTT dla Home Assistant#

Tematy używane do komunikacji między GbbOptimizer a Home Assistant / GbbConnect.

Dane z Home Assistant do GbbOptimizer#

Wymagane pola:

Pole	Typ	Opis
`soc_perc`	decimal	SOC baterii (%). Użyj `V` jeśli zaznaczono „Steruj poprzez V”
`loads_total_kWh`	decimal	Zużycie — licznik narastający
`fromgrid_total_kWh`	decimal	Import z sieci — licznik narastający
`togrid_total_kWh`	decimal	Eksport do sieci — licznik narastający
`pv_total_kWh`	decimal	Produkcja PV — licznik narastający

Opcjonalne pola:

Wykresy

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

Wykresy w Home Assistant#

GbbOptimizer udostępnia interaktywne wykresy (produkcja PV, zużycie, SOC, ceny energii itp.) przez interfejs webowy. Można je osadzić w dashboardzie Home Assistant.

Osadzanie wykresów#

Użyj karty Webpage (lub iFrame) w dashboardzie HA:

Przejdź do dashboardu HA -> Edytuj -> Dodaj kartę
Wybierz kartę Webpage (lub kartę ręczną typu iframe)
W polu URL wklej adres wykresów z GbbOptimizer

1
2
3


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

Zamień <serwer> i <PlantId> na odpowiednie wartości Twojej instalacji.

Hinen

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

Hinen#

Konfiguracja falownika Hinen z GbbOptimizer.

Mapowanie trybów GbbOptimizer na ustawienia Hinen#

GbbOptimizer steruje falownikiem Hinen ustawiając odpowiedni Work Mode oraz parametry ładowania/rozładowania.

Operacja GbbOptimizer	Work Mode	Charge/Discharge Enable	Start/End	SOC	Rate	AntiBackflow Enable	AntiBackflow Limit Rate
Normal	Self-consumption	Nie	—	100%	—	—	—
Charge	Time period control	Tak	Tak	Docelowy SOC%	`ChargeLimit / (MaxInverterChargeDC lub MaxBatteryChargeDC) * 100%`	Nie	—
Discharge	Time period control	Tak	Tak	Docelowy SOC%	`DischargeLimit / (MaxInverterChargeDC lub MaxBatteryChargeDC) * 100%` (ujemna wartość)	Tak	Taki sam jak Rate, ale > 0
DisableCharge	Time period control	Tak	Tak	Bieżący SOC	1%	Nie	—

Uwagi do operacji Discharge#

Wartość DischargeLimit odpowiada parametrowi „Max GridSetpoint / Discharge (W)"
Jeśli rozładowanie musi być wolniejsze, aby wystarczyło na całą godzinę, program automatycznie koryguje tę wartość
AntiBackflow jest włączany podczas rozładowania, aby kontrolować eksport do sieci

ModbusInMqtt

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

Protokół ModbusInMqtt#

Protokół komunikacji między GbbOptimizer a GbbConnect2 — transfer komend Modbus przez MQTT.

GbbOptimizer → GbbConnect2#

PUB {PlantId}/ModbusInMqtt/toDevice

Komendy Modbus wysyłane do GbbConnect2

Pole		Typ	Wymagane	Opis
`OrderId`		string	nie	Tekst skopiowany do odpowiedzi
`Lines`		tablica	tak
	`LineNo`	int	tak	Numer linii
	`Tag`	string	nie	Dowolny tekst skopiowany do odpowiedzi
	`Timestamp`	int	nie	Czas Unix UTC (sekundy)
	`Modbus`	string	tak	Komenda Modbus do przesłania do falownika
`LogLevel`		string	nie	Zmień poziom logów: `OnlyErrors`, `Min`, `Max`
`SendLastLog`		int	nie	1 = dołącz logi do odpowiedzi (przyrostowo)

Przykład:

Profile zużycia

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

Profile zużycia#

Moduł prognozowania zużycia energii przez dom. Zużycie jest podzielone na godziny i dni tygodnia.

Ręczne wprowadzanie#

Wpisz kWh dla każdej godziny i dnia tygodnia bezpośrednio w tabeli.

Import danych z instalacji#

Ustaw okres importu i naciśnij Importuj z Instalacji. Program oblicza średnie zużycie dla każdej godziny i dnia tygodnia na podstawie danych z falownika.

Automatyczny import#

Zaznacz Automatycznie importuj dane w nocy — program co noc importuje dane z ostatnich 28 dni.

Serwery MQTT

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

Serwery MQTT#

GbbOptimizer używa wielu serwerów MQTT do komunikacji z falownikami i integracjami. Serwer przypisany do Twojej instalacji zależy od prefiksu PlantId.

Tabela serwerów#

Serwer aplikacji	Serwer MQTT	Prefiks PlantId
gbboptimizer.gbbsoft.pl	gbboptimizer-mqtt.gbbsoft.pl	(brak)
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

Jak odczytać serwer z PlantId#

Prefiks PlantId (pierwsza litera) wskazuje, z którego serwera korzysta Twoja instalacja:

Victron

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

Mapowanie trybów — Victron#

victron-only

Falowniki Victron są sterowane przez ESS (Energy Storage System) za pośrednictwem VRM i MQTT.

Tryb ESS#

GbbOptimizer steruje systemem Victron poprzez harmonogramy ESS (ESS Schedules) na Cerbo GX. Harmonogramy określają:

Tryb pracy — ładowanie, rozładowanie, normalna praca
Docelowy SOC — do jakiego poziomu ładować/rozładowywać
Limit mocy — maksymalna moc ładowania/rozładowania
Okno czasowe — godziny obowiązywania harmonogramu

Konfiguracja wstępna#

W portalu VRM włącz dostęp zdalny do Cerbo
W ESS ustaw tryb “Optimized (without BatteryLife)”
Upewnij się, że GbbOptimizer ma poprawne dane VRM (PlantId, PlantToken)

Jeśli Battery Life jest włączony w ESS, GbbOptimizer nie będzie mógł w pełni kontrolować baterii. Wyłącz go i ustaw na “Optimized (without BatteryLife)”.

Extra Zużycie / EV

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

Extra Zużycie / EV#

Extra Zużycie to część zużycia energii, która nie wchodzi do średniej domu — np. ładowanie samochodu elektrycznego czy pompa ciepła. Celem jest wydzielenie nieprzewidywalnej, zmiennej części ze standardowego zużycia.

Przepływ danych:

Liczniki IoT → Extra Zużycie → Zyski → Prognoza baterii
Ładowarki EV → Extra Zużycie → Zyski → Prognoza baterii

AutoKonwerter#

AutoKonwerter wykrywa piki w zużyciu i automatycznie zamienia je na ładowanie samochodu (lub inny typ Extra Zużycia).

Najczęstsze błędy

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

Najczęstsze błędy#

Lista najczęściej spotykanych komunikatów o błędach w GbbOptimizer, ich źródeł i możliwych rozwiązań.

Solarman#

Komunikat	Opis
`SolarmanError: Solarman timeout!`	Solarman nie może wysłać danych do falownika. Sprawdź sieć lokalną.
`Solarman error: 2101040-device not found`	Falownik nie wysyła danych do Solarmana. Sprawdź połączenie sieciowe falownika.
`Response status code: 503 / 500 / 504`	API Solarman nie działa poprawnie. Problem po stronie Solarmana — poczekaj i spróbuj ponownie.

DeyeCloud#

Komunikat	Opis
`DeyeCloud error: timeout`	DeyeCloud nie może wysłać danych do falownika. Sprawdź sieć lokalną.
`DeyeCloud error: 2104006-device offline`	Falownik nie wysyła danych do DeyeCloud. Sprawdź połączenie sieciowe falownika.
`DeyeCloud error: 2101042-auth no operation permission`	Za mało uprawnień dla konta DeyeCloud (np. konto nadane przez instalatora). Skontaktuj się z instalatorem w celu nadania pełnych uprawnień.

GbbConnect2#

Komunikat	Opis
`Mqtt to GbbConnect2: timeout!`	GbbOptimizer nie może się połączyć z lokalnym GbbConnect2. Sprawdź, czy GbbConnect2 jest uruchomiony.
`GbbConnect2Error: Connection timed out 192.168.x.xx:8899`	GbbConnect2 nie może się połączyć z donglem Deye. Sprawdź, czy dongle jest w sieci.

Victron#

Komunikat	Opis
`Victron Mqtt: timeout! (15 sec)`	GbbOptimizer nie może się połączyć z Cerbo przez serwery MQTT Victrona. Sprawdź sieć lokalną i dostęp zdalny w VRM.
`Error during checking whether Schedules reached Cerbo successfully`	Harmonogramy ESS nie dotarły do Cerbo. Sprawdź połączenie Cerbo z internetem.

Ceny energii#

Komunikat	Źródło	Opis
`Get Prices: The SSL connection could not be established`	ENTSO-E	API ENTSO-E z cenami nie działa. Problem po stronie dostawcy.
`Get Prices: Proba polaczenia nie powiodla sie`	ENTSO-E	API ENTSO-E niedostępne.
`Get Prices: HTTP POST ... Gateway timeout / 502 Bad Gateway`	Tibber	API Tibber z cenami nie działa.
`Get Prices: Response status code: 502 (Bad Gateway)`	AU Amber	API Amber z cenami nie działa.

Inne#

Komunikat	Źródło	Opis
`Solcast.com: Too many requests`	Solcast	Osiągnięty limit 10 zapytań dziennie do Solcast.com. Poczekaj do północy.
`ERROR from Cache: Response status code: 500`	Pstryk	Błąd po stronie API Pstryka.
`B0220-System function downgrade`	Hinen	API Hinen jest aktualizowane. Poczekaj aż aktualizacja się zakończy.

Komunikaty o błędach są wysyłane e-mailem z programu. Większość błędów typu “timeout” i “device offline” jest związana z problemami sieci lokalnej — sprawdź połączenie falownika i routera.

Sofar

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

Sofar#

Konfiguracja falownika Sofar z GbbOptimizer. Falownik Sofar jest sterowany w trybie Passive Mode.

Mapowanie trybów GbbOptimizer na ustawienia Sofar (Passive Mode)#

Program ustawia StorageMode = 3 (Passive Mode) oraz (przy obsłudze 5 parametrów) ManagementMode = 1 (Manual).

Operacja	Gdes (Grid setpoint)	Blo (battery high)	Bup (battery low)	Gdzup (grid high)	Gdzlo (grid low)
Normal	Domyślny GridSetpoint (z menu Discharge)	ChargeLimit lub MaxBatteryChargePower lub MaxInverterChargePower	-(DischargeLimit lub MaxBatteryDischargePower lub MaxInverterDischargeLimit)	MaxBuyPower lub MaxInverterChargePower	-(MaxSellPower lub MaxInverterDischargePower)
Charge	= Gdzup	ChargeLimit (korygowane, aby osiągnąć TargetSOC w pełnej godzinie)	0	InputLimit lub MaxBuyPower lub MaxInverterChargePower	0
Discharge	= Gdzlo	= Bup	-(DischargeLimit, korygowane, aby osiągnąć TargetSOC w pełnej godzinie)	0	-(MaxSellPower lub MaxInverterDischargePower)
DisableCharge	0	0	0	MaxBuyPower lub MaxInverterChargePower	-(MaxSellPower lub MaxInverterDischargePower)

Jeśli opcja „SofarSolar: Support for 5 parameters (not 3) in PassiveMode" jest odznaczona, parametry Gdzup i Gdzlo nie są zmieniane (ponieważ nie są dostępne w trybie 3-parametrowym).

Tematy EVCC

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

Tematy MQTT dla EVCC#

Integracja GbbOptimizer z evcc.io przez MQTT.

Konfiguracja#

W brokerze Mosquitto (lub HA) stwórz plik konfiguracji bridge:

1
2
3
4
5
6


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

Adresy serwerów MQTT — patrz serwery MQTT.

Dane z EVCC do GbbOptimizer#

Pompa ciepła / Klimatyzacja

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

Prognoza pompy ciepła / klimatyzacji#

Moduł prognozowania zużycia pompy ciepła (PC) lub klimatyzacji na podstawie temperatury zewnętrznej.

Dlaczego osobny moduł?#

Pompy ciepła i klimatyzacja (podobnie jak ładowarki EV) nie działają zgodnie z rytmem dnia — zależą od temperatury. Dlatego lepiej je wykluczyć ze średniej w module Profile zużycia i umieścić w Extra Zużycie.

Konfiguracja krok po kroku#

Wpisz szerokość geograficzną i długość geograficzną w parametrach instalacji
Zaimportuj prognozę pogody
Naciśnij Parametry PC i wpisz zużycie kWh pompy/klimatyzacji na każdą godzinę (minimum 2 wartości dla różnych temperatur)
Naciśnij Policz prognozę PC i sprawdź wyniki
Naciśnij Eksportuj prognozę PC do modułu Extra Zużycie (menu: Profile Zużycia → Extra Zużycia → Filtr: „Typ" = „Pompa Ciepła")
Włącz zadania godzinowe: Importuj prognozę pogody, Oblicz prognozę PC, Eksportuj prognozę PC do modułu Extra Zużycie

Parametry PC — tabela temperatury vs. zużycie#

Dla każdej godziny podaj, ile kWh zużywa PC/klimatyzacja przy danej temperaturze zewnętrznej.

Zyski

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

Zyski#

Moduł zbiera dane z instalacji i oblicza zyski z fotowoltaiki. Importuj dane ręcznie przynajmniej raz dziennie lub zaznacz Automatycznie importuj dane z Instalacji.

Dane wyświetlane są wg godzin, dni lub miesięcy:

Dane godzinowe — przechowywane przez 2 miesiące
Dane dzienne — przechowywane przez 2 lata
Dane miesięczne — przechowywane na zawsze

Kolumny — Zysk#

Kolumna	Opis
Dzień / Godzina	Dzień i godzina
Wartość zysku	= Wartość Zużycia - Wartość Inwertera - (Wartość Zakupu - Zmiana Wartości baterii) + Wartość Sprzedaży
Zysk / Zużycie	KPI: Wartość zysku / Zużycie kWh
Profit / Solar	KPI: Wartość zysku / PV kWh
Koszt energii	Wartość Zakupu - Wartość Sprzedaży
Z sieci (kWh)	Ile pobrano z sieci
Z sieci zbilansowane (kWh)	Pobrano po bilansowaniu godzinowym (dla Polski)
Cena Zakupu	Cena zakupu energii
Wartość Zakupu	Z sieci [zbilansowane] × Cena Zakupu + Koszt Miesięczny
Zakup / Produkcja	KPI: Wartość Zakupu / Wartość Zużycia
(Zakup - Sprzedaż) / Produkcja	KPI: ile procent rachunku za energię zapłacisz
Do sieci (kWh)	Ile wysłano do sieci
Do sieci zbilansowane (kWh)	Wysłano po bilansowaniu godzinowym (dla Polski)
Cena Sprzedaży	Cena sprzedaży energii
Wartość Sprzedaży	Do sieci [zbilansowane] × Cena Sprzedaży − Wartość energii wysłanej do sieci
Zużycie (kWh)	Zużycie prądu przez dom
Cena Zużycia	Cena energii zużytej przez dom (wliczając falownik)
Wartość Zużycia	Zużycie kWh × Cena Zużycia
Zużycie Inwertera (kWh)	Zużycie prądu przez falownik
Wartość Inwerter	Zużycie Inwertera kWh × Cena Zużycia
Autokonsumpcja	KPI: 1 - (Do sieci kWh / PV kWh) — ile energii z PV nie idzie do sieci
Samowystarczalność	KPI: PV / Zużycie — ile % energii z PV pokrywa zużycie
RTE	KPI: Do sieci kWh / (Z sieci kWh + PV kWh - Zużycie kWh)
PV (kWh)	Produkcja PV
Do baterii (kWh)	Energia wysłana do baterii (przed konwersją na DC)
min/max/śred SOC (%)	Minimalny, maksymalny i średni SOC baterii

Kolumny — Wartość energii w baterii#

Kolumna	Opis
Pocz. SOC (%)	Początkowy SOC (obliczany z MinSOC i MaxSOC, jeśli instalacja nie podaje)
Koń SOC (%)	Końcowy SOC
Zmiana Baterii (kWh)	>0 ładowanie, <0 rozładowanie — wyliczone z KońSOC - PoczSOC
Ładowanie z sieci (kWh)	Energia użyta do ładowania z sieci (po stronie AC)
Ładowanie z PV (kWh)	Energia użyta do ładowania z PV (po stronie AC)
Straty na ładowaniu (kWh)	Różnica między DC a AC podczas ładowania
Wydajność ładowania (%)	1 - Straty / (Ładowanie z sieci + z PV)
Rozładowanie do sieci (kWh)	Energia z baterii do sieci (AC)
Rozładowanie do zużycia (kWh)	Energia z baterii do domu (AC)
Straty na rozładowaniu (kWh)	Różnica DC/AC podczas rozładowania
Wydajność rozładowania (%)	1 - Straty / (Rozładowanie do sieci + do zużycia)
Pocz / Koń kWh w baterii	Energia w baterii ponad MinSOC
Pocz / Koń Wartość (PLN)	Wartość energii w baterii
Zmiana Wartości baterii (PLN)	Rozładowanie: kWh × Średnia cena (poprzednia godzina). Ładowanie: kWh × Cena Zakupu
Średnia końcowa cena (PLN)	Koń Wartość / Koń kWh w baterii
MinSOC (%)	Zapamiętana wartość „Minimalna SOC baterii %" z parametrów instalacji

Kolumny — Extra Zużycie#

Kolumna	Opis
Cena Extra Zużycia (PLN)	Średnia cena kWh: średnia z 0 (PV), Średniej ceny baterii i Ceny Zakupu (w proporcjach użycia)
Samochód elektryczny (kWh / PLN)	Energia i wartość ładowania EV
Pompa ciepła (kWh / PLN)	Energia i wartość pompy ciepła
Inne1 (kWh / PLN)	Energia i wartość „Inne1"
Inne2 (kWh / PLN)	Energia i wartość „Inne2"