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 VoltagePower Sensor Phase C VoltagePower Sensor Phase B CurrentPower Sensor Phase C CurrentPower Sensor Phase A Active PowerPower Sensor Phase B Active PowerPower 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:
importingwhen the signed power meter value indicates grid import / consumptionexportingwhen the signed power meter value indicates grid export / injectionidlewhen 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 Totalnow represents imported energy from the gridPower Sensor Grid Injection Totalnow 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 NameInverter ModelInverter FirmwareInverter SerialInverter Device IDInverter StationInverter Station DNInverter 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 SOHglobal is only created when FusionSolar returns a valid value greater than zeroInverter MPPT Total Input Poweris 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