Home Assistant on GbbOptimizer — Manual

Mosquitto Bridge

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

Mosquitto Bridge#

For GbbOptimizer to communicate with Home Assistant, you need to configure a bridge between the local Mosquitto broker in HA and the GbbOptimizer MQTT server.

Requirements#

Home Assistant with the Mosquitto broker add-on installed
An active installation in GbbOptimizer with an assigned PlantId and PlantToken
MQTT server address — see MQTT Servers

Step-by-Step Configuration#

1. Enable the configuration folder in Mosquitto#

In Home Assistant go to Settings -> Add-ons -> Mosquitto broker -> Configuration.

GbbConnect2 Addon

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

GbbConnect2 — Home Assistant Addon#

GbbConnect2 is available as a Home Assistant addon, allowing you to run it directly in HA without a separate Windows PC or Docker container.

The addon runs the GbbConnect2Console application and connects the inverter to GbbOptimizer via ModbusInMqtt.

Requirements#

Home Assistant OS or Home Assistant Supervised (Supervisor required)
An active GbbOptimizer account with a GbbConnect2 type installation
A hybrid inverter with a datalogger (WiFi or Ethernet)
A fixed IP address for the datalogger on the local network

Installation#

1. Add the repository#

Click the button below to automatically add the repository to Home Assistant:

SolarAssistant

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

SolarAssistant#

deye-only

GbbOptimizer integration with the Deye inverter via SolarAssistant and Home Assistant.

Supported Configurations#

Home Assistant (HA) with SolarAssistant (SA) connected to a hybrid Deye inverter as inverter_1

Requirements#

Home Assistant with Mosquitto broker
SolarAssistant installed and connected to the Deye inverter
Configured Mosquitto Bridge with a topic for SolarAssistant

SolarAssistant Configuration#

In the SolarAssistant settings go to Configuration -> Advanced MQTT and change:

Automation

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

Home Assistant Automation#

After configuring the Mosquitto Bridge you can create automations in Home Assistant that:

Send data from HA sensors to GbbOptimizer
React to commands received from GbbOptimizer

Sending Data to GbbOptimizer#

GbbOptimizer expects data on the topic ha_gbb/sensor (locally in HA; via bridge it arrives as <PlantId>/ha_gbb/sensor).

Required Fields#

Field	Description
`soc_perc`	Battery SOC in percent (or `V` if voltage-based control is selected)
`loads_total_kWh`	Consumption meter (kWh, cumulative)
`fromgrid_total_kWh`	Energy drawn from grid meter (kWh)
`togrid_total_kWh`	Energy sent to grid meter (kWh)
`pv_total_kWh`	PV production meter (kWh)

Optional Fields#

Field	Description
`ev_charge_total_kWh`	EV charging meter
`hp_total_kWh`	Heat pump meter
`other1_total_kWh` … `other6_total_kWh`	Additional meters

Multiple PV Arrays#

To send data from multiple PV arrays, use the more field:

Charts

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

Charts in Home Assistant#

GbbOptimizer provides interactive charts (PV production, consumption, SOC, energy prices, etc.) via its web interface. These can be embedded in a Home Assistant dashboard.

Embedding Charts#

Use the Webpage (or iFrame) card in the HA dashboard:

Go to the HA dashboard -> Edit -> Add card
Select the Webpage card (or a manual card of type iframe)
In the URL field paste the chart address from GbbOptimizer

1
2
3


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

Replace <server> and <PlantId> with the appropriate values for your installation.