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:

1
2
3
4
5
{
  "Data": [
    {"Date": "2024-04-20", "StartHour": 20, "PurchasePrice": 0.23}
  ]
}

SetExtraLoads Ustaw Extra Zużycie

{PlantId}/ha_gbb/api/setextraloads

Pole		Typ	Wymagane	Opis
`OrderId`		string	nie	Tekst skopiowany do odpowiedzi
`Data`		tablica	tak
	`Date`	date	tak	Data (dzisiaj lub jutro)
	`StartHour`	int (0-23)	tak	Godzina
	`StartMinute`	int (0-59)	nie	Minuta (domyślnie 0)
	`TypeNo`	int	tak	0=EV, 1=Pompa ciepła, 2=Inne1, 3=Inne2, …, 7=Inne6
	`ExtraLoads_kWh`	decimal	tak	kWh

Przykład:

1
2
3
4
5
{
  "Data": [
    {"Date": "2024-04-20", "StartHour": 20, "TypeNo": 1, "ExtraLoads_kWh": 1.23}
  ]
}

SetRealTemperature Ustaw rzeczywistą temperaturę

{PlantId}/ha_gbb/api/setrealtemperature

Pole		Typ	Wymagane	Opis
`OrderId`		string	nie	Tekst skopiowany do odpowiedzi
`Data`		tablica	tak
	`Date`	date	tak	Data (wczoraj, dzisiaj lub jutro). Jeśli brak `Hour` — godzina z daty
	`Hour`	int (0-23)	nie	Godzina temperatury
	`RealTemperature`	decimal	tak	Temperatura (°C)

Przykład:

1
2
3
4
5
{
  "Data": [
    {"Date": "2024-04-20", "Hour": 20, "RealTemperature": 1.23}
  ]
}

SetOptimizer Ustaw parametry optymalizatora

{PlantId}/ha_gbb/api/setoptimizer

Pole		Typ	Wymagane	Opis
`OrderId`		string	nie	Tekst skopiowany do odpowiedzi
`Data`		obiekt	tak
	`Opt2_3x100Request`	int	nie	0 lub 1 — wymuszenie 3h×100%
	`CurrentLoadProfileId`	int	nie	ID Profilu Zużycia
	`CurrentLoadProfileName`	string	nie	Nazwa Profilu Zużycia (wielkość liter nieistotna)

Przykład:

1
{"Data": {"Opt2_3x100Request": 1}}

SetCar Ustaw parametry samochodu EV

{PlantId}/ha_gbb/api/setcar

Samochód „HomeAssistant EV Car" musi być najpierw dodany w programie. Zmieniane są tylko podane parametry — ale program wymaga aktualnych: SOC, SOC_ChargeLimit, IsConnected, IsCharging, Position_Longitude, Position_Latitude.

Pole		Typ	Wymagane	Opis
`OrderId`		string	nie	Tekst skopiowany do odpowiedzi
`Data`		tablica	tak	Można aktualizować wiele samochodów
	`VIN`	string	tak	Klucz identyfikacyjny. Nowy VIN = nowy samochód (max 10)
	`BatteryKWh`	decimal	nie	Pojemność baterii samochodu
	`ChargeA`	decimal	nie	Domyślny prąd ładowania (A)
	`Phases`	int	nie	1 lub 3 fazy
	`SOC`	int	nie	Aktualny SOC
	`SOC_ChargeLimit`	int	nie	Docelowy SOC
	`InService`	bool	nie	Czy samochód jest w serwisie
	`IsConnected`	bool	nie	Czy podłączony do ładowarki
	`IsCharging`	bool	nie	Czy aktualnie się ładuje
	`Position_Longitude`	double	nie	Długość geograficzna
	`Position_Latitude`	double	nie	Szerokość geograficzna

Przykład:

1
2
3
4
5
{
  "Data": [
    {"VIN": "vin1234", "SOC": 40, "SOC_ChargeLimit": 90}
  ]
}

SetAutoCharging Ustaw parametry automatycznego ładowania EV

{PlantId}/ha_gbb/api/setautocharging

Pole		Typ	Wymagane	Opis
`OrderId`		string	nie	Tekst skopiowany do odpowiedzi
`Data`		tablica	tak	Można aktualizować wiele wpisów
	`Name`	string	tak	Nazwa harmonogramu ładowania
	`On`	int	nie	0 — wyłącz, 1 — włącz

Przykład:

1
2
3
4
5
{
  "Data": [
    {"Name": "Codziennie", "On": 1}
  ]
}

SetHP Ustaw parametry pompy ciepła

{PlantId}/ha_gbb/api/sethp

Pole		Typ	Wymagane	Opis
`OrderId`		string	nie	Tekst skopiowany do odpowiedzi
`Data`		obiekt	tak	Zmieniane tylko podane parametry
	`HPForecast_Break_On`	bool	nie	Przerwa w pracy PC: włącz/wyłącz
	`HPForecast_BreakFromDate`	date	nie	Data rozpoczęcia przerwy
	`HPForecast_BreakFromHour`	int (0-23)	nie	Godzina rozpoczęcia
	`HPForecast_BreakToDate`	date	nie	Data zakończenia (włączńie)
	`HPForecast_BreakToHour`	int (0-23)	nie	Godzina zakończenia (włączńie)

Przykład:

1
2
3
4
5
6
7
{
  "Data": {
    "HPForecast_Break_On": true,
    "HPForecast_BreakToDate": "2026-01-30",
    "HPForecast_BreakToHour": 23
  }
}

SetPVForecast Ustaw prognozę produkcji PV

{PlantId}/ha_gbb/api/setpvforecast

Pole		Typ	Wymagane	Opis
`OrderId`		string	nie	Tekst skopiowany do odpowiedzi
`Data`		tablica	tak	Tablica prognoz po dniach
	`Date`	date	tak	Data prognozy (dziś, jutro, do 7 dni)
	`Number`	int	nie	Numer płaszczyzny PV (domyślnie 1)
	`Hours`	tablica	tak	Wartości godzinowe (patrz niżej)

Pola elementu Hours:

Pole	Typ	Wymagane	Opis
`Hour`	decimal (0-23)	tak	Godzina prognozy
`kWh`	decimal	tak	Prognoza produkcji PV

Ta komenda pozwala na przesyłanie prognozy PV z zewnętrznych źródeł, np. z Home Assistant. Ustaw źródło prognozy PV na „HomeAssistant" w parametrach instalacji.

Przykład:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
{
  "Data": [
    {
      "Date": "2024-04-20",
      "Hours": [
        {"Hour": 6, "kWh": 0.5},
        {"Hour": 7, "kWh": 1.23},
        {"Hour": 8, "kWh": 2.45},
        {"Hour": 12, "kWh": 5.67},
        {"Hour": 18, "kWh": 1.10}
      ]
    }
  ]
}