Installation & Setup¶
Install the integration¶
- Download
sg_energy_hub.zipfrom the releases. - Extract it so this path exists:
<HA config>/custom_components/sg_energy_hub/manifest.json
- Restart Home Assistant.
- Go to Settings → Devices & services → Add integration and search for SpeicherGuru Energy Hub.
Demo mode¶
Choose Demo (simulated values) and confirm. The integration creates a device with PV power, PV energy, battery state of charge, battery power, battery temperature, grid power, house load, heat pump power and temperatures.
Demo values are generated locally. The demo entry never contacts a device and never switches to demo values when a real connection fails.
Modbus TCP¶
Choose Modbus TCP device and fill in:
| Field | Meaning |
|---|---|
| Host | IP address or hostname of the gateway or inverter |
| Port | TCP port, normally 502 |
| Unit ID | Modbus slave/unit id, normally 1 |
| Profile | Vendor/model register map |
| Timeout | Seconds to wait for one response |
| Name | Optional device name; defaults to the profile name |
Before creating the entry, the integration opens a TCP connection and reads the
first register of the profile. A connection failure leaves you on the form with
the error cannot_connect; a Modbus exception is reported as
modbus_exception.
Gateways¶
Modbus-to-WiFi/LAN gateways such as the USR-DW60 work when they expose a transparent Modbus TCP endpoint. The integration needs one TCP connection per device; a gateway that only allows one client at a time should be dedicated to Home Assistant.
Multiple devices¶
Each config entry is one device with its own coordinator, entities and licence status. Add the integration again for another inverter, battery or heat pump.
Unique ids are built from host, port, unit id and profile id for Modbus, and
from demo for the simulated entry. The demo entry can only exist once.
Options¶
Open Configure on the entry:
| Option | Default | Meaning |
|---|---|---|
| Polling interval | 60 s | 10–900 seconds |
| Allow write access | off | Required for write_register; also needs Pro |
| Default support session length | 4 h | 1–24 hours |
| Licence server URL | empty | Optional, for support tokens |
Changing options reloads the entry.
Custom profiles¶
Place JSON files in:
<HA config>/sg_energy_hub/profiles/
They are loaded on the next start. See Profile Format for every field.