References on GbbOptimizer — Manual

Glossary

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

Glossary#

Battery Full Date

Specific days of the month when the optimizer aims to charge the battery to 100% SOC. Provided as comma-separated values (e.g., '1, 15'). Enables periodic full charge cycles for battery health.

Correction Factor

A multiplier calculated over approximately one week of operation that corrects PV forecast values to match actual production, improving prediction accuracy.

DongleDirect

A connection method where the inverter's WiFi dongle is reconfigured to communicate directly with the GbbOptimizer server instead of the manufacturer's cloud.

Inverter Modes

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

Inverter Modes#

GbbOptimizer controls the inverter using four basic modes (protocol operations). Each inverter implements them differently — see the Mode Mappings section for detailed mappings.

Required Data from the Inverter#

The inverter must provide the following data:

Field	Description
`soc_perc`	Battery SOC in percent (or `V` if controlling via voltage)
`loads_total_kWh`	Consumption counter (kWh, cumulative)
`fromgrid_total_kWh`	Grid import energy counter (kWh)
`togrid_total_kWh`	Grid export energy counter (kWh)
`pv_total_kWh`	PV production counter (kWh)

Optionally:

MQTT Servers

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

MQTT Servers#

GbbOptimizer uses multiple MQTT servers to communicate with inverters and integrations. The server assigned to your installation depends on the PlantId prefix.

Server Table#

Application Server	MQTT Server	PlantId Prefix
gbboptimizer.gbbsoft.pl	gbboptimizer-mqtt.gbbsoft.pl	(none)
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

How to Determine Your Server from PlantId#

The PlantId prefix (first letter) indicates which server your installation uses:

Common Errors

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

Common Errors#

A list of the most frequently encountered error messages in GbbOptimizer, their causes, and possible solutions.

Solarman#

Message	Description
`SolarmanError: Solarman timeout!`	Solarman cannot send data to the inverter. Check the local network.
`Solarman error: 2101040-device not found`	The inverter is not sending data to Solarman. Check the inverter’s network connection.
`Response status code: 503 / 500 / 504`	The Solarman API is not working correctly. Problem on Solarman’s side — wait and try again.

DeyeCloud#

Message	Description
`DeyeCloud error: timeout`	DeyeCloud cannot send data to the inverter. Check the local network.
`DeyeCloud error: 2104006-device offline`	The inverter is not sending data to DeyeCloud. Check the inverter’s network connection.
`DeyeCloud error: 2101042-auth no operation permission`	Insufficient permissions for the DeyeCloud account (e.g. account granted by an installer). Contact the installer to obtain full permissions.

GbbConnect2#

Message	Description
`Mqtt to GbbConnect2: timeout!`	GbbOptimizer cannot connect to the local GbbConnect2. Check whether GbbConnect2 is running.
`GbbConnect2Error: Connection timed out 192.168.x.xx:8899`	GbbConnect2 cannot connect to the Deye dongle. Check whether the dongle is on the network.

Victron#

Message	Description
`Victron Mqtt: timeout! (15 sec)`	GbbOptimizer cannot connect to Cerbo through Victron’s MQTT servers. Check the local network and remote access in VRM.
`Error during checking whether Schedules reached Cerbo successfully`	ESS schedules did not reach Cerbo. Check Cerbo’s internet connection.

Energy Prices#

Message	Source	Description
`Get Prices: The SSL connection could not be established`	ENTSO-E	The ENTSO-E price API is not working. Problem on the provider’s side.
`Get Prices: Proba polaczenia nie powiodla sie`	ENTSO-E	ENTSO-E API unavailable.
`Get Prices: HTTP POST ... Gateway timeout / 502 Bad Gateway`	Tibber	The Tibber price API is not working.
`Get Prices: Response status code: 502 (Bad Gateway)`	AU Amber	The Amber price API is not working.

Other#

Message	Source	Description
`Solcast.com: Too many requests`	Solcast	The 10 daily request limit for Solcast.com has been reached. Wait until midnight.
`ERROR from Cache: Response status code: 500`	Pstryk	Error on the Pstryk API side.
`B0220-System function downgrade`	Hinen	The Hinen API is being updated. Wait for the update to finish.

Error messages are sent by email from the program. Most “timeout” and “device offline” errors are related to local network issues — check the inverter and router connection.