Growatt for Home Assistant (built-in integration)

About

Growatt is a built-in integration that connects Home Assistant to Growatt solar plants through the vendor's cloud. It reads data from the selected plant as sensors, including output power, energy today, lifetime energy output and AC frequency. Number entities cover battery charge and discharge power limits and state of charge limits, and a switch controls charging from the grid. Actions read and write AC charge and discharge time periods on SPH devices, and read or update time segments on supported inverters. Sign-in works with a username, password and server region, or with an API token, and it is set up in the UI. New devices are added automatically and devices that are gone are removed.

Automatic summary of Home Assistant's source code. Something wrong? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
Set up in the UI Add it in Settings, Devices and services. Nothing to download.
Adds new devices New devices show up without setting it up again.
Cleans up devices Devices that are gone are removed by themselves.
Change settings later Its connection settings can change without removing it.
Gold quality Home Assistant's own rating of its code and setup experience.
Updated with Home Assistant Ships and updates with every Home Assistant release.

Provides

Switches

Setting it up

It is added under Settings, Devices and services, with Add integration.

Enter your Growatt login credentials

PasswordThe password for your Growatt account.
Server regionThe server region that matches your Growatt account location.
UsernameThe email address or username for your Growatt account.

Select your plant

PlantThe Growatt plant (solar installation) to integrate.

Enter your API token

Server regionThe server region that matches your Growatt account location.
API tokenThe API token for your Growatt account. You can generate one via the Growatt web portal or ShinePhone app.

Re-authenticate with Growatt

PasswordThe password for your Growatt account.
Server regionThe server region that matches your Growatt account location.
API tokenThe API token for your Growatt account. You can generate one via the Growatt web portal or ShinePhone app.
UsernameThe email address or username for your Growatt account.

Also asked when changing the connection.

Texts from Home Assistant's source code, Apache License 2.0.

Entities

NumbersBattery charge power limit, Battery charge SOC limit, Battery discharge power limit, Battery discharge SOC limit (off-grid), Battery discharge SOC limit (on-grid)
SensorsInput 1 amperage, Input 2 amperage, Input 3 amperage, Reactive wattage, Output power, Energy today, Lifetime energy output, AC frequency, Internal wattage, Intelligent Power Management temperature, Reactive amperage, Reactive voltage, and 114 more
SwitchesCharge from grid

Actions

Read AC charge timesReads AC charge time periods from an SPH device.Fields: Device
Read AC discharge timesReads AC discharge time periods from an SPH device.Fields: Device
Read time segmentsReads all time segments from a supported inverter.Fields: Device
Update time segmentUpdates a time segment for supported inverters.Fields: Battery mode, Device, Enabled, End time, Segment ID, Start time
Write AC charge timesWrites AC charge time periods to an SPH device.Fields: Charge power, Charge stop SOC, Device, Mains charging enabled, Period 1 enabled, Period 1 end, Period 1 start, Period 2 enabled, Period 2 end, Period 2 start
Write AC discharge timesWrites AC discharge time periods to an SPH device.Fields: Device, Discharge power, Discharge stop SOC, Period 1 enabled, Period 1 end, Period 1 start, Period 2 enabled, Period 2 end, Period 2 start, Period 3 enabled