#802.Growatt v4

[Brors94 118]

802.Growatt Open API v4 monitor & control for Fibaro HC3

Download v1.0.0:

Please login or register to see this attachment.

Marketplace link:

Please login or register to see this link.

I'd like to share 802.Growatt v4, a QuickApp for Fibaro HC3 that discovers and monitors every Growatt inverter in a plant through the official Growatt Open API v4, and optionally lets you control them.

What it does:

- Discovers every inverter serial and exact device type in your Growatt plant/account (optionally filtered to one Plant ID).
- Polls production data per inverter: current power, today/month/year/lifetime energy, PV1/PV2 input details when supplied by the API.
- Creates stable standard meter child devices per inverter: <serial> Power, <serial> Energy Today, <serial> Total Energy, and PV1/PV2 power meters when available.
- Parent device totals sum current power and energy across all discovered inverters, so the parent's Power/Energy properties represent the whole plant, not a single inverter.
- Guarded write controls: Inverter On/Off, active-power limit (0-100%), and VPP charge/discharge target (-100% to +100%). All of these require a continuous 3-second hold on Apply before anything is sent, and every command is verified by reading the setting back afterwards.
- Adaptive polling: uses your configured PollSeconds during daylight and automatically switches to a slower night interval between HC3's sunset/sunrise, capped so it changes exactly at the boundary.
- Daily production stats: peak power with timestamp, first/last production time, duration, and a rolling history of completed days.
- Highest combined AC output record since installation or last Factory Reset.
- Optional fire-alarm safety action (Force ON/Force OFF) triggered by an HC3 custom event via EventLib.
- Supports both Classic (HTML card) and New (physical label row) HC3 view layouts; switching is a 5-second hold on Change View.
- Reinstall-safe configuration: on first install or reinstall, the QA restores BaseUrl/PlantId/DeviceSn/PollSeconds/AutoUpdateTime/debug (and the API token) from a same-plugin HC3 global-variable backup, written automatically once per day. On restore, the API token is written to the QA's own internal storage only, never back into the visible ApiToken QuickApp variable, so it doesn't show up in QuickApp-variable exports. Note the HC3 global variable used for the backup itself is still plain system-wide storage - see the README for the full caveat.

 

Requirements:

- Fibaro HC3 with internet access to the Growatt Open API.
- A Growatt-issued Open API token (Growatt Cloud / OpenAPI access), entered once in the ApiToken QuickApp variable.
- PollSeconds between 60 and 3600 seconds (default 300).
- Growatt inverter (only tested with Neo 800) (

Please login or register to see this link.

)

 

Setup is just: install the QA, fill in ApiToken, optionally PlantId/DeviceSn, and enable it. Everything else (child creation, discovery, view layout) is automatic.

 

Keeping it up to date:

This QA updates itself through jgab's QA Dist Manager -

Please login or register to see this link.

Install that QA once (any of jgab's or my other QA Dist Manager-enabled apps will detect it automatically, no configuration needed). After that, this QA's Updates section gives you:

- Check Update: only checks whether a newer release is available, never installs anything.
- Auto Update: installs the available release automatically at the time set in AutoUpdateTime (default 03:33).
- Update Now: asks QA Dist Manager to install the available release immediately.

 

If QA Dist Manager isn't installed, the Updates section shows "QA Dist Manager is unavailable" and update checks are simply skipped; everything else keeps working normally.

Full technical documentation, API endpoints used, and behavior details are in the bundled README. Feedback, bug reports, and feature suggestions are very welcome here.

Source code:

Please login or register to see this link.

 

Support continued development:

If you find this QuickApp useful, donations would be greatly appreciated. Contributions will help cover more AI token usage while developing, testing and improving this and future QuickApps.

Donate through PayPal:

Please login or register to see this link.

 

Disclaimer:

this is an independent, community-made QuickApp.

It is not affiliated with, endorsed by, or supported by Growatt, Shine, or any of their subsidiaries.

"Growatt" and related names/trademarks belong to their respective owners.

Use of the Growatt Open API is subject to Growatt's own terms and account permissions.

Thanks for reading!