Mode Mappings on GbbOptimizer — Manual

Deye

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

Mode Mapping — Deye#

deye-only

How GbbOptimizer modes translate to Deye inverter settings depending on the connection method.

Solarman / DeyeCloud (new connection method)#

recommended

Operation	Work Mode	GridCharge (TimeOfUse)	Time (TimeOfUse)	SOC (TimeOfUse)	Power (TimeOfUse)	Charge A	MaxSellPower
Normal	—	no	yes	5%*	Max Battery Discharge, if absent: Max Inverter Discharge	no change	—
Charge	—	yes	yes	SOC%	ChargeLimitW, if absent: Max Battery Charge, if absent: Max Inverter Charge	ChargeLimitW, if absent: Max Battery Charge, if absent: Max Inverter Charge	—
Discharge	SellingFirst (on completion: restore previous value)	no	yes	SOC%	Max Battery Discharge, if absent: Max Inverter Discharge	no change; KeepSOC: 0W	Max GridSetpoint / Discharge (W); if discharge must be slower the program calculates a value; on completion: restore previous value
DisableCharge	—	no	yes	5%*	Max GridSetpoint / Discharge (W)	changed to 0 (on completion: restore previous value)	—

* 5% can be changed with the “Default MinSOC after discharge” parameter in discharge plan settings.

GoodWe

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

Mode Mapping — GoodWe#

How GbbOptimizer modes translate to GoodWe protocol settings.

Battery Charge-Discharge#

Operation	BatteryCDEnable	BatteryCDMode	BatteryCDPW
Normal	no	—	—
Charge	yes	2	ChargeLimitW
Discharge	yes	3	DischargeLimitW: Max GridSetpoint / Discharge (W). If discharge must be slower to last the full hour — the program calculates the appropriate value. On completion: restore previous value.
DisableCharge	yes	2	0

Missing Options#

The GoodWe protocol does not support:

Hinen

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

Mode Mapping — Hinen#

How GbbOptimizer modes translate to Hinen protocol settings.

Mapping Table#

Operation	Work Mode	Charge/Discharge Enable	Charge/Discharge Start/End	Charge/Discharge SOC	Charge/Discharge Rate	AntiBackflow Enable	AntiBackflow Limit Rate
Normal	Self-consumption	no	—	100%	—	—	—
Charge	Time period control	yes	yes	SOC%	= ChargeLimit / (MaxInverterChargeDC_kW or MaxBatteryChargeDC_kW) * 100%	no	—
Discharge	Time period control	yes	yes	SOC%	= -abs(DischargeLimit) / (MaxInverterChargeDC_kW or MaxBatteryChargeDC_kW) * 100%. DischargeLimit = Max GridSetpoint / Discharge (W). If discharge must be slower — the program calculates the value.	yes	same as Charge/Discharge Rate but > 0
DisableCharge	Time period control	yes	yes	current SOC	1%	no	—

Notes#

Rate is expressed as a percentage of the maximum inverter (or battery) power, not in watts
In Normal mode the system returns to Self-consumption mode with SOC = 100% and Charge/Discharge disabled
In DisableCharge mode SOC is set to the current level and Rate to a minimum of 1%

Sofar

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

Mode Mapping — Sofar#

How GbbOptimizer modes translate to Sofar inverter settings in Passive Mode.

Passive Mode#

Operation	Gdes (Grid setpoint)	Blo (Battery high)	Bup (Battery low)	Gdzup (Grid high)	Gdzlo (Grid low)
Normal	Default GridSetpoint (Discharge menu)	ChargeLimit or MaxBatteryChargePower or MaxInverterChargePower	-(DischargeLimit or MaxBatteryDischargePower or MaxInverterDischargeLimit)	MaxBuyPower or MaxInverterChargePower	-(MaxSellPower or MaxInverterDischargePower)
Charge	= Gdzup	ChargeLimit or MaxBatteryChargePower or MaxInverterChargePower (adjusted to reach target SOC in the full hour)	0	InputLimit or MaxBuyPower or MaxInverterChargePower	0
Discharge	= Gdzlo	= Bup	-(DischargeLimit or MaxBatteryDischargePower or MaxInverterDischargeLimit) (adjusted to reach target SOC in the full hour)	0	-(MaxSellPower or MaxInverterDischargePower)
DisableCharge	0	0	0	MaxBuyPower or MaxInverterChargePower	-(MaxSellPower or MaxInverterDischargePower)

Parameters#

Gdes — Grid setpoint: target grid energy exchange value
Blo — Battery high: maximum battery charging power
Bup — Battery low: maximum battery discharge power (negative value)
Gdzup — Grid high: maximum grid import power
Gdzlo — Grid low: maximum grid export power (negative value)

Notes#

If the option “SofarSolar: Support for 5 parameters (not 3) in PassiveMode” is unchecked, the Gdzup and Gdzlo parameters are not changed (because they are not available in 3-parameter mode).

Victron

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

Mode Mapping — Victron#

victron-only

Victron inverters are controlled through ESS (Energy Storage System) via VRM and MQTT.

ESS Mode#

GbbOptimizer controls the Victron system through ESS Schedules on the Cerbo GX. Schedules define:

Operating mode — charging, discharging, normal operation
Target SOC — the level to charge/discharge to
Power limit — maximum charging/discharging power
Time window — hours during which the schedule is active

Prerequisites#

In the VRM portal, enable remote access to Cerbo
In ESS, set the mode to “Optimized (without BatteryLife)”
Ensure GbbOptimizer has correct VRM data (PlantId, PlantToken)

If Battery Life is enabled in ESS, GbbOptimizer will not be able to fully control the battery. Disable it and set to “Optimized (without BatteryLife)”.