Skip to content

v1.6.1

Latest

Choose a tag to compare

@hcraveiro hcraveiro released this 06 May 11:00
d04e0fc

What's changed

This release expands FusionSolar power meter, inverter and battery diagnostics using additional frontend-derived device data.

It also fixes the power meter import/export interpretation and corrects the mapping of power meter total import/export energy sensors.

Power sensor / power meter improvements

The FusionSolar Power Sensor device now exposes additional technical metering data when available.

New sensor:

  • Power Sensor Reactive Power

The integration also adds dynamic support for three-phase power meter signals. These entities are only created when the FusionSolar frontend endpoint actually returns the corresponding signal IDs.

Possible additional three-phase sensors include:

  • Power Sensor Phase B Voltage
  • Power Sensor Phase C Voltage
  • Power Sensor Phase B Current
  • Power Sensor Phase C Current
  • Power Sensor Phase A Active Power
  • Power Sensor Phase B Active Power
  • Power Sensor Phase C Active Power

Single-phase installations will usually not expose these additional entities.

Fixed power meter import/export direction

The power meter direction logic has been corrected.

Power Sensor Direction now reports:

  • importing when the signed power meter value indicates grid import / consumption
  • exporting when the signed power meter value indicates grid export / injection
  • idle when no meaningful import/export is detected

This aligns the power meter state with the installation-wide grid import/export sensors.

Fixed power meter total energy mapping

The power meter total energy mapping has been corrected:

  • Power Sensor Grid Consumption Total now represents imported energy from the grid
  • Power Sensor Grid Injection Total now represents exported energy to the grid

This fixes the previous inverted mapping between the two total energy sensors.

Inverter real-time improvements

The FusionSolar Inverter device now exposes additional inverter metrics when available.

New sensor:

  • Inverter Efficiency

This value is fetched from the FusionSolar frontend KPI endpoint when the backend exposes it.

New derived MPPT total input power sensor

A new derived sensor has been added:

  • Inverter MPPT Total Input Power

This sensor is calculated from the visible PV string voltage/current pairs exposed by FusionSolar:

sum(PVn voltage * PVn current) / 1000

This provides a useful total PV input power value even when the FusionSolar App frontend does not expose a dedicated raw MPPT total input power signal.

New inverter metadata sensors

The inverter device now exposes frontend-derived metadata as diagnostic sensors when available.

New metadata sensors include:

  • Inverter Name
  • Inverter Model
  • Inverter Firmware
  • Inverter Serial
  • Inverter Device ID
  • Inverter Station
  • Inverter Station DN
  • Inverter DN

Some of this information may already exist in the Home Assistant device information panel, but exposing it as sensors makes it easier to use in dashboards, diagnostics, automations and issue reports.

Battery SOH global support

The battery device now supports a global raw SOH sensor:

  • Battery SOH

This sensor is only created when FusionSolar returns a valid non-zero global SOH value.

Some FusionSolar systems expose SOH only at battery pack level. In those cases, the existing battery pack SOH sensors remain available, but the global Battery SOH sensor will not be created if the frontend returns an empty, invalid or zero value.

README updates

The README has been updated with:

  • new power meter reactive power sensor
  • dynamic three-phase power meter sensor documentation
  • corrected power meter direction explanation
  • corrected consumption/injection total descriptions
  • inverter efficiency documentation
  • derived MPPT total input power documentation
  • inverter metadata sensor documentation
  • conditional global battery SOH documentation
  • updated diagnostic sensor list
  • updated credits for inverter metadata and power meter coverage

Notes

  • Existing entities continue to work
  • Some new sensors are only created when FusionSolar actually returns the corresponding data
  • Three-phase power meter sensors are dynamic and may not appear on single-phase systems
  • Battery SOH global is only created when FusionSolar returns a valid value greater than zero
  • Inverter MPPT Total Input Power is derived from visible PV string voltage/current data
  • Users affected by inverted power meter totals or direction should see corrected values after updating and restarting Home Assistant