v2.5.0

What's new

New sensor: Lifetime import from grid (SPH)

Adds a mix_import_from_grid_total sensor for SPH devices (V1 API), reporting the lifetime cumulative energy imported from the grid (etoUserTotal).

• Device class: Energy
• State class: total_increasing (never resets)
• Unit: kWh, precision: 1 decimal
• Translation key: mix_import_from_grid_total ("Lifetime import from grid")

Note: The classic Mix API does not expose a lifetime import-from-grid value, so this sensor is SPH (V1 API) only.

Installation

• Install via HACS using this repository URL
• Remove/disable standard Growatt Server integration first
• Restart Home Assistant after installation

Requirements

• growattServer==1.9.0

v2.4.2: fix SPH features lost in auto-merge

What's Changed

Fixed

• Restore SPH sensor entities — sensor/__init__.py was missing the SPH import and device-type branch, so SPH devices had no sensor entities at all
• Restore SPH AC charge/discharge time services — services.py was missing the refactored get_coordinator(device_id, device_type) helper, all four SPH service handlers, and their service registrations
• Restore SPH service UI definitions in translations/en.json; update "MIN/TLX" references to "MIN/SPH"
• All of the above were silently dropped by git auto-merge when feature/sph-sensors was merged (files had no conflict markers because earlier reverts on master made git treat the deletions as intentional)

Also in this release

• Add CHANGELOG.md following Keep a Changelog format
• Clean up README.md — remove stale version info, link to CHANGELOG.md instead

See CHANGELOG.md for full history.

v2.4.1

What's Changed

Fixed

• SPH (type 5) devices were skipped with "not supported in Open API V1" — V1_DEVICE_TYPES = {5: "sph", 7: "min"} and related device-list logic were lost in auto-merge

Note: v2.4.1 still had incomplete SPH support due to further files lost in auto-merge. Use v2.4.2 instead.

See CHANGELOG.md for full history.

v2.4.0

What's Changed

Added

• SPH (Single Phase Hybrid) inverter support via Open API V1
  • 28 dedicated sensor entities using correct sph_detail / sph_energy field names
  • write_ac_charge_times service — set charge time periods, power %, stop SOC %, mains-enabled
  • write_ac_discharge_times service — set discharge time periods, power %, stop SOC %
  • read_ac_charge_times / read_ac_discharge_times services — read current settings from cache

Changed

• Coordinator cache pattern: reads serve from self.data, writes update cache immediately after success — avoids extra API calls that would breach the per-endpoint 5-minute rate limit

Fixed

• mix_battery_charge sensor for SPH: use pcharge1 (W) instead of bdc1ChargePower (kW)

Note: v2.4.0 had incomplete SPH support due to files lost in auto-merge. Use v2.4.2 instead.

See CHANGELOG.md for full history.

v2.1.1: Automatic session re-login

What's new

Automatic re-login on session expiry — The Growatt Classic API expires session cookies daily. Previously this caused all entities to become unavailable until Home Assistant was restarted manually. This release detects the expiry and automatically re-authenticates, keeping the integration running without intervention.

Details

• Detects session expiry via JSONDecodeError (server returns an HTML login page instead of JSON)
• Re-authenticates using stored credentials and retries the data fetch
• Uses a lock to prevent multiple coordinators (one per device) from logging in simultaneously
• 60-second cooldown avoids redundant re-login attempts

Credits

Thanks to @bobaoapae for the contribution (PR #13).

Installation

• Install via HACS using this repository URL
• Remove/disable standard Growatt Server integration first
• Restart Home Assistant after installation

Requirements

• growattServer==1.9.0

v2.3.0

What's New in v2.3.0

• SPH sensor entities: 28 dedicated sensor entities for SPH devices with correct V1 API field names. Previously SPH was mapped to MIX sensor definitions, causing most sensors to silently return None.

SPH sensors now available

From sph_detail (live readings):

• State of charge (bmsSOC)
• Battery voltage, PV1/PV2 voltage, Grid voltage
• AC frequency
• Battery charging power (kW), Battery discharging power (W)
• Export to grid (kW), Import from grid (kW)
• Temperature 1–5 (°C)

From sph_energy (energy totals):

• Battery charged/discharged today and lifetime (kWh)
• Solar energy today and lifetime (kWh)
• PV1/PV2/all PV wattage (W)
• System production today, self-consumption today, import from grid today (kWh)
• Last data update timestamp

v2.2.0: SPH device support and AC charge/discharge time services

What's New

SPH device support (Open API V1)

SPH inverters (device type 5) are now supported alongside MIN (type 7) in the Open API V1 path:

• Sensors: reuses MIX sensor types (SPH routes through the same device/mix/* API endpoints)
• Switch: AC charge enable/disable (charge_from_grid)
• Numbers: charge power %, charge stop SOC %, discharge power %, discharge stop SOC %

AC charge/discharge time services (SPH)

Four new services for SPH devices allow full schedule control:

• growatt_server.write_ac_charge_times — set charge periods, power %, stop SOC, mains enable
• growatt_server.read_ac_charge_times — read current charge time settings
• growatt_server.write_ac_discharge_times — set discharge periods, power %, stop SOC
• growatt_server.read_ac_discharge_times — read current discharge time settings

Each service accepts 3 configurable time periods with start/end time and enable toggle.

v2.1.0

Installation

• Install via HACS using this repository URL
• Remove/disable standard Growatt Server integration first
• Restart Home Assistant after installation

Requirements

• growattServer==1.7.1

v2.0.0

Installation

• Install via HACS using this repository URL
• Remove/disable standard Growatt Server integration first
• Restart Home Assistant after installation

Requirements

• growattServer==1.7.1

v1.6.0

v1.6.0 - Energy Dashboard Support

🎉 What's New

Energy Dashboard Integration: This release adds full support for Home Assistant's
Energy dashboard by adding state_class attributes to all power and energy sensors.

Key Changes

• ✅ 34 sensors updated with proper state_class attributes:
  • MIX sensors: 9 power sensors (MEASUREMENT) + 10 daily energy sensors
    (TOTAL_INCREASING)
  • TLX sensors: 15 power sensors (MEASUREMENT)

Benefits

With this update, you can now:

• Track solar generation in the Energy dashboard
• Monitor home consumption patterns
• Visualize grid import/export
• Calculate self-consumption rates
• View battery charge/discharge cycles

All power and energy sensors will now be properly recognized and selectable in the
Energy dashboard configuration.

📝 Technical Details

This release implements the same state_class additions as Home Assistant Core PR
#158705:

• Power sensors (W/kW): state_class=MEASUREMENT
• Daily energy sensors (kWh): state_class=TOTAL_INCREASING
• Lifetime energy sensors (kWh): state_class=TOTAL (already implemented)

📦 Installation

Via HACS (Recommended)

1. Open HACS → Integrations
2. Search for "Growatt Server Upstream"
3. Click "Update" (if already installed) or "Download"
4. Restart Home Assistant

Manual Installation

Download the latest release and copy custom_components/growatt_server to your Home
Assistant configuration directory.

🔧 Upgrading from v1.5.x

Simply update the integration - no configuration changes required. Your existing
sensors will automatically gain Energy dashboard support.

📚 Documentation

For full feature list and setup instructions, see the
README.

---

Full Changelog:
v1.5.1...v1.6.0