Entities

Entities

Every entity the integration can create, with where its value comes from. The tables list 169 entities - 107 on the inverter, 40 on the battery storage and 22 on the smart meter - for a three-phase inverter with a battery, one PV string, one three-phase smart meter, a Web API login with the technician role and every value the inverter's web interface can report. Each further PV string adds the four MPPT module N sensors again, and no inverter reports every component value, so a real installation has a different count. The tables are generated from the integration's own entity tables, so they match the code of the release they were built from.

Which entities your inverter gets

An entity whose source the inverter does not have is not created:

• Battery storage entities need the SunSpec storage model 124; the battery device appears only with it. So do the Storage … sensors on the inverter (the model 160 channels and Storage connection).
• L2 and L3 values need a three-phase inverter or meter; a single-phase meter also has no AC voltage Line to Line.
• MPPT module N sensors come once per PV string (model 160). N counts from 0 in the order of model 160: the first string is MPPT module 0. A string that is dark at the first setup gets its sensors once it sends a value.
• Smart meter entities come once per meter the inverter reports, each meter its own device. The inverter's Load and Grid status need a smart meter. The per-phase energy counters (Exported L1 and the like) come only for a meter that counts them, since some meters report 0, SunSpec's "not implemented"; a counter that starts counting later gets its entity at the next restart.
• Web API entities need a login with a role (see Web API); an entry Without the web API has none of them. Web API (technician role) rows need the technician role; with the customer role they are created but stay unavailable.
• Web interface (no login) entities - the component sensors and the inverter's events - need no login, so an entry without the web API has them too. A component value the inverter does not report creates no entity: module temperatures, fans beyond the first two, a second ambient temperature, Surplus power available, and the output power and battery limit fields older firmware lacks. Firmware without the component endpoints gets none of them. One reported before keeps its entity, as unknown. A value that appears later gets its entity at the next reload of the entry.

Entities marked disabled by default are created but disabled; enable them on the device page under the disabled entities. diagnostic entities are listed under the device's diagnostics.

Reading the tables

• Name and German name are the names Home Assistant shows in English and German. The entity ID follows from the device name and the English name on a new installation, for example sensor.fronius_symo_gen24_10_0_ac_power; an entry migrated from an earlier integration keeps the entity IDs it had. Take yours from Settings → Devices & services → Entities.
• Source is the SunSpec model a Modbus value is read from (Modbus 124 is the storage model, Modbus 201-204 the meter models), or the web side: Web interface (no login) for the inverter's component and event endpoints, Web API for the values that need a login.
• Unit is the unit Home Assistant shows.
• Values gives a number's range and step. WChaMax is the battery's charge/discharge reference power (model 124), WMax the inverter's rated power (model 121); the number's range follows them. A select, a sensor with fixed states and an event list their states below the table: the key, which is the entity state and the value an action takes, and the English text the interface shows, such as charge_from_grid Charge from Grid.
• What each entity means, with the registers behind it, is under What the entities mean below the tables; the battery controls are explained in Battery Control, the inverter controls in Battery Control.

Inverter

Sensors

Name	German name	Type	Unit	Source	Values	Notes
Modbus ID	Modbus-ID	sensor	-	Modbus 1		diagnostic
AC current	AC-Strom	sensor	A	Modbus 101/103
AC current L1	AC-Strom L1	sensor	A	Modbus 101/103
AC current L2	AC-Strom L2	sensor	A	Modbus 101/103
AC current L3	AC-Strom L3	sensor	A	Modbus 101/103
AC energy	AC-Energie	sensor	Wh	Modbus 101/103
AC power	AC-Wirkleistung	sensor	W	Modbus 101/103
AC voltage L1-L2	AC-Spannung L1-L2	sensor	V	Modbus 101/103
AC voltage L1-N	AC-Spannung L1-N	sensor	V	Modbus 101/103
AC voltage L2-L3	AC-Spannung L2-L3	sensor	V	Modbus 101/103
AC voltage L2-N	AC-Spannung L2-N	sensor	V	Modbus 101/103
AC voltage L3-L1	AC-Spannung L3-L1	sensor	V	Modbus 101/103
AC voltage L3-N	AC-Spannung L3-N	sensor	V	Modbus 101/103
Event severity	Ereignisstufe	sensor	-	Modbus 101/103		diagnostic
Line frequency	Netzfrequenz	sensor	Hz	Modbus 101/103
Reactive power	Blindleistung	sensor	var	Modbus 101/103
Status	Status	sensor	-	Modbus 101/103	see below	diagnostic
Vendor status	Herstellerstatus	sensor	-	Modbus 101/103	see below	diagnostic
Maximum power	Maximale Leistung	sensor	W	Modbus 121
Reference voltage	Referenzspannung	sensor	V	Modbus 121		diagnostic
Reference voltage offset	Referenzspannungs-Offset	sensor	V	Modbus 121		diagnostic
Control mode	Steuermodus	sensor	-	Modbus 122	see below	diagnostic
Electrical connection	Netzverbindung	sensor	-	Modbus 122	see below	diagnostic
Isolation Resistance	Isolationswiderstand	sensor	MΩ	Modbus 122
PV connection	PV-Verbindung	sensor	-	Modbus 122	see below	diagnostic
Storage connection	Speicherverbindung	sensor	-	Modbus 122	see below	diagnostic
AC limit enabled	AC-Leistungsbegrenzung aktiv	sensor	-	Modbus 123	see below	diagnostic
AC limit rate	AC-Leistungsbegrenzung	sensor	W	Modbus 123
Connection control	Verbindungssteuerung	sensor	-	Modbus 123	see below	diagnostic
Fixed power factor status	Fester Leistungsfaktor aktiv	sensor	-	Modbus 123	see below	diagnostic
Limit VAr control	Blindleistungsbegrenzung aktiv	sensor	-	Modbus 123	see below	diagnostic
Throttle control	Leistungsbegrenzung aktiv	sensor	-	Modbus 123	see below	disabled by default, diagnostic
MPPT module N DC current	MPPT-Modul N DC-Strom	sensor	A	Modbus 160
MPPT module N DC power	MPPT-Modul N DC-Leistung	sensor	W	Modbus 160
MPPT module N DC voltage	MPPT-Modul N DC-Spannung	sensor	V	Modbus 160
MPPT module N Lifetime energy	MPPT-Modul N Energie gesamt	sensor	Wh	Modbus 160
PV power	PV-Leistung	sensor	W	Modbus 160
Storage charging current	Speicher-Ladestrom	sensor	A	Modbus 160
Storage charging lifetime energy	Speicher-Ladeenergie gesamt	sensor	Wh	Modbus 160
Storage charging power	Speicher-Ladeleistung	sensor	W	Modbus 160
Storage charging voltage	Speicher-Ladespannung	sensor	V	Modbus 160
Storage discharging current	Speicher-Entladestrom	sensor	A	Modbus 160
Storage discharging lifetime energy	Speicher-Entladeenergie gesamt	sensor	Wh	Modbus 160
Storage discharging power	Speicher-Entladeleistung	sensor	W	Modbus 160
Storage discharging voltage	Speicher-Entladespannung	sensor	V	Modbus 160
Grid status	Netzstatus	sensor	-	calculated: primary meter and Modbus 101/103	see below	diagnostic
Load	Hauslast	sensor	W	calculated: primary meter and Modbus 101/103
Energy management output 1 to 4	Energiemanagement-Ausgang 1 bis 4	sensor	-	Web interface (no login)	see below	diagnostic, disabled by default
Energy management output 1 to 4 reason	Energiemanagement-Ausgang 1 bis 4 Grund	sensor	-	Web interface (no login)	see below	diagnostic, disabled by default
Throttle reason	Drosselungsgrund	sensor	-	calculated: web interface flags and Modbus 101/103	see below	diagnostic
Web API Modbus control	Web-API-Modbus aktiv	sensor	-	Web API (any role)	see below	diagnostic
Web API Modbus mode	Web-API-Modbus-Modus	sensor	-	Web API (any role)		diagnostic
Web API Modbus restriction	Web-API-Modbus-IP-Beschränkung	sensor	-	Web API (any role)	see below	diagnostic
Web API Modbus restriction IP	Web-API-Modbus-Beschränkungs-IP	sensor	-	Web API (any role)		diagnostic
Web API SunSpec mode	Web-API-SunSpec-Modus	sensor	-	Web API (any role)		diagnostic
Export soft limit	Weiche Einspeisebegrenzung	sensor	W	Web API (technician role)
AC module 1 temperature	Temperatur AC-Modul 1	sensor	°C	Web interface (no login)
AC module 2 temperature	Temperatur AC-Modul 2	sensor	°C	Web interface (no login)
AC module 3 temperature	Temperatur AC-Modul 3	sensor	°C	Web interface (no login)
AC module 4 temperature	Temperatur AC-Modul 4	sensor	°C	Web interface (no login)
AC module 5 temperature	Temperatur AC-Modul 5	sensor	°C	Web interface (no login)
AC module 6 temperature	Temperatur AC-Modul 6	sensor	°C	Web interface (no login)
AC power L1	AC-Wirkleistung L1	sensor	W	Web interface (no login)
AC power L2	AC-Wirkleistung L2	sensor	W	Web interface (no login)
AC power L3	AC-Wirkleistung L3	sensor	W	Web interface (no login)
Active event	Aktives Ereignis	sensor	-	Web interface (no login)		diagnostic
Active events	Aktive Ereignisse	sensor	-	Web interface (no login)		diagnostic
Active service event	Aktives Service-Ereignis	sensor	-	Web interface (no login)		disabled by default, diagnostic
Active service events	Aktive Service-Ereignisse	sensor	-	Web interface (no login)		disabled by default, diagnostic
Ambient temperature 2	Umgebungstemperatur 2	sensor	°C	Web interface (no login)
Battery max charge power (DC-DC)	Speicher max. Ladeleistung (DC-Wandler)	sensor	W	Web interface (no login)
Battery max discharge power (DC-DC)	Speicher max. Entladeleistung (DC-Wandler)	sensor	W	Web interface (no login)
DC link voltage	Zwischenkreisspannung	sensor	V	Web interface (no login)		disabled by default, diagnostic
DC module temperature (10)	Temperatur DC-Modul (10)	sensor	°C	Web interface (no login)
DC module temperature (3)	Temperatur DC-Modul (3)	sensor	°C	Web interface (no login)
DC module temperature (9)	Temperatur DC-Modul (9)	sensor	°C	Web interface (no login)
DC or battery module temperature	Temperatur DC- oder Batteriemodul	sensor	°C	Web interface (no login)
Fan 1	Lüfter 1	sensor	%	Web interface (no login)
Fan 2	Lüfter 2	sensor	%	Web interface (no login)
Fan 3	Lüfter 3	sensor	%	Web interface (no login)
Fan 4	Lüfter 4	sensor	%	Web interface (no login)
Fan 5	Lüfter 5	sensor	%	Web interface (no login)
Feed-in point frequency	Frequenz Einspeisepunkt	sensor	Hz	Web interface (no login)		disabled by default
Feed-in point voltage L1	Spannung Einspeisepunkt L1	sensor	V	Web interface (no login)		disabled by default
Feed-in point voltage L1-L2	Spannung Einspeisepunkt L1-L2	sensor	V	Web interface (no login)		disabled by default
Feed-in point voltage L2	Spannung Einspeisepunkt L2	sensor	V	Web interface (no login)		disabled by default
Feed-in point voltage L2-L3	Spannung Einspeisepunkt L2-L3	sensor	V	Web interface (no login)		disabled by default
Feed-in point voltage L3	Spannung Einspeisepunkt L3	sensor	V	Web interface (no login)		disabled by default
Feed-in point voltage L3-L1	Spannung Einspeisepunkt L3-L1	sensor	V	Web interface (no login)		disabled by default
Grid valid	Netz gültig	sensor	-	Web interface (no login)	see below
Internal temperature	Innentemperatur	sensor	°C	Web interface (no login)
Operating time	Betriebsdauer	sensor	h	Web interface (no login)		disabled by default, diagnostic
Output limited	Ausgangsleistung begrenzt	sensor	-	Web interface (no login)	see below
Output power limit	Zulässige Ausgangsleistung	sensor	W	Web interface (no login)
Power stage 1 firmware	Firmware Leistungsteil 1	sensor	-	Web interface (no login)		diagnostic
Power stage 2 firmware	Firmware Leistungsteil 2	sensor	-	Web interface (no login)		diagnostic
Power stage hardware	Hardware Leistungsteil	sensor	-	Web interface (no login)		disabled by default, diagnostic
Surplus power available	Überschuss verfügbar	sensor	-	Web interface (no login)	see below	disabled by default
Time in backup mode	Zeit im Notstrombetrieb	sensor	h	Web interface (no login)		disabled by default

States (key and English text):

• Status (sensor): off Off, sleeping Sleeping, starting Starting, normal Normal, throttled Throttled, shutdown Shutdown, fault Fault, standby Standby
• Vendor status (sensor): off Off, sleeping Sleeping, starting Starting, normal Normal, throttled Throttled, shutdown Shutdown, fault Fault, standby Standby, no_solarnet No solarnet, no_inverter_communication No inverter communication, overcurrent_solarnet Overcurrent solarnet, firmware_updating Firmware updating, acfi_event ACFI event
• Control mode (sensor): normal Normal, power_reduction Power reduction, constant_reactive_power Constant reactive power, constant_power_factor Constant power factor, power_reduction_constant_reactive_power Power reduction,Constant reactive power, power_reduction_constant_power_factor Power reduction,Constant power factor, constant_reactive_power_constant_power_factor Constant reactive power,Constant power factor, power_reduction_constant_reactive_power_constant_power_factor Power reduction,Constant reactive power,Constant power factor
• Electrical connection (sensor): disconnected Disconnected, connected Connected
• PV connection (sensor): disconnected Disconnected, connected Connected, available Available, operating Operating
• Storage connection (sensor): disconnected Disconnected, connected Connected, available Available, operating Operating
• AC limit enabled (sensor): disabled Disabled, enabled Enabled
• Connection control (sensor): disabled Disabled, enabled Enabled
• Fixed power factor status (sensor): disabled Disabled, enabled Enabled
• Limit VAr control (sensor): disabled Disabled, enabled Enabled
• Throttle control (sensor): disabled Disabled, enabled Enabled
• Grid status (sensor): off_grid Off grid, off_grid_operating Off grid operating, on_grid On grid, on_grid_operating On grid operating
• Throttle reason (sensor): none Not throttled, inverter_state Inverter reports throttling, ac_limit AC limit, feed_in_limit Export limit, several Several reasons; no longer reported, kept for older history: active_power_control Active power control, export_limit AC limit
• Energy management output 1 to 4 (sensor): on On, off Off
• Energy management output 1 to 4 reason (sensor): not_configured Not configured, power_invalid Power value invalid, maximum_runtime_exceeded Daily maximum runtime exceeded, minimum_runtime_running Minimum on-time still running, power_below_threshold Power below the threshold, power_above_threshold Power above the threshold, target_runtime_not_reached Target runtime not reached, unknown Unknown
• Web API Modbus control (sensor): disabled Disabled, enabled Enabled
• Web API Modbus restriction (sensor): disabled Disabled, enabled Enabled
• Grid valid (sensor): yes Yes, no No
• Output limited (sensor): yes Yes, no No
• Surplus power available (sensor): yes Yes, no No

Controls and events

Name	German name	Type	Unit	Source	Values	Notes
AC limit rate	AC-Leistungsbegrenzung	number	W	Modbus 123	0 to WMax, step 10
Power factor	Leistungsfaktor	number	-	Modbus 123	-1 to 1, step 0.001
Export soft limit	Weiche Einspeisebegrenzung	number	W	Web API (technician role)	0 to WMax, step 10
AC limit enable	AC-Leistungsbegrenzung aktivieren	select	-	Modbus 123	see below
Inverter connection	Wechselrichterverbindung	select	-	Modbus 123	see below
Power factor control	Leistungsfaktor-Steuerung	select	-	Modbus 123	see below
Solar API	Solar-API	switch	-	Web API (any role)		diagnostic
Reset Modbus Control	Modbus-Steuerung zurücksetzen	button	-	Web API (any role)		diagnostic
Inverter event	Wechselrichter-Ereignis	event	-	Web interface (no login)	see below
Service event	Service-Ereignis	event	-	Web interface (no login)	see below	disabled by default

States (key and English text):

• AC limit enable (select): disabled Disabled, enabled Enabled
• Inverter connection (select): disabled Disabled, enabled Enabled
• Power factor control (select): disabled Disabled, enabled Enabled
• Inverter event (event): error Error, warning Warning, info Info, unclassified Unclassified
• Service event (event): error Error, warning Warning, info Info, unclassified Unclassified

Battery storage

Sensors

Name	German name	Type	Unit	Source	Values	Notes
Capacity	Nennkapazität	sensor	Wh	Modbus 120		diagnostic
Maximum charge rate	Maximale Ladeleistung	sensor	W	Modbus 120		diagnostic
Maximum discharge rate	Maximale Entladeleistung	sensor	W	Modbus 120		diagnostic
Charge status	Ladestatus	sensor	-	Modbus 124	see below
Charge/discharge reference power	Lade-/Entlade-Referenzleistung	sensor	W	Modbus 124		diagnostic
Charging power	Ladeleistung	sensor	%	Modbus 124		diagnostic
Core storage control mode	Interner Speicher-Steuermodus	sensor	-	Modbus 124	see below	diagnostic
Discharging power	Entladeleistung	sensor	%	Modbus 124		diagnostic
Grid charging	Netzladen	sensor	-	Modbus 124	see below	diagnostic
Modbus storage reserve	Modbus-Speicherreserve	sensor	%	Modbus 124
State of charge	Ladezustand	sensor	%	Modbus 124
BMS ambient temperature	Umgebungstemperatur BMS	sensor	°C	Web interface (no login)		disabled by default
Cell temperature	Zelltemperatur	sensor	°C	Web interface (no login)
Cell temperature max	Zelltemperatur max	sensor	°C	Web interface (no login)		disabled by default
Cell temperature min	Zelltemperatur min	sensor	°C	Web interface (no login)		disabled by default
Connection	Anbindung	sensor	-	Web interface (no login)		disabled by default, diagnostic
Current charge limit	Aktuelle Ladegrenze	sensor	W	Web interface (no login)		disabled by default
Current discharge limit	Aktuelle Entladegrenze	sensor	W	Web interface (no login)		disabled by default
Manufacturer SoC max	Hersteller-SoC max	sensor	%	Web interface (no login)		disabled by default, diagnostic
Manufacturer SoC min	Hersteller-SoC min	sensor	%	Web interface (no login)		disabled by default, diagnostic
Modules	Anzahl Module	sensor	-	Web interface (no login)		disabled by default, diagnostic
Peak charge power (10 s)	Spitzenleistung Laden (10 s)	sensor	W	Web interface (no login)		disabled by default, diagnostic
Peak discharge power (10 s)	Spitzenleistung Entladen (10 s)	sensor	W	Web interface (no login)		disabled by default, diagnostic
State of health	Gesundheitszustand (SoH)	sensor	%	Web interface (no login)
Voltage range max	Spannungsbereich max	sensor	V	Web interface (no login)		disabled by default, diagnostic
Voltage range min	Spannungsbereich min	sensor	V	Web interface (no login)		disabled by default, diagnostic

States (key and English text):

• Charge status (sensor): off Off, empty Empty, discharging Discharging, charging Charging, full Full, holding Holding, testing Testing
• Core storage control mode (sensor): auto Auto, charge Charge, discharge Discharge, charge_and_discharge Charge and Discharge
• Grid charging (sensor): disabled Disabled, enabled Enabled

Controls and events

Name	German name	Type	Unit	Source	Values	Notes
Discharge limit	Entladebegrenzung	number	W	Modbus 124	0 to WChaMax, step 10
Grid charge power	Netz-Ladeleistung	number	W	Modbus 124	0 to WChaMax, step 10
Grid discharge power	Netz-Entladeleistung	number	W	Modbus 124	0 to WChaMax, step 10
Modbus storage reserve	Modbus-Speicherreserve	number	%	Modbus 124	5 to 100, step 1
PV charge limit	PV-Ladebegrenzung	number	W	Modbus 124	0 to WChaMax, step 10
Backup reserve	Notstromreserve	number	%	Web API (any role)	5 to 100, step 1
SoC Maximum	Maximaler SoC	number	%	Web API (any role)	0 to 100, step 1
SoC Minimum (Web API)	SoC-Minimum (Web-API)	number	%	Web API (any role)	5 to 100, step 1
Target feed in	Ziel-Einspeisung	number	W	Web API (any role)	-WMax to WMax, step 10
Storage Control Mode	Speicher-Steuermodus	select	-	Modbus 124	see below
Self-consumption optimisation	Eigenverbrauchs-Optimierung	select	-	Web API (any role)	see below
Web API SoC mode	Web-API-SoC-Modus	select	-	Web API (any role)	see below
Charge from AC	Aus AC laden	switch	-	Web API (any role)
Charge from grid	Aus dem Netz laden	switch	-	Web API (any role)

States (key and English text):

• Storage Control Mode (select): auto Auto, pv_charge_limit PV Charge Limit, discharge_limit Discharge Limit, pv_charge_and_discharge_limit PV Charge and Discharge Limit, charge_from_grid Charge from Grid, discharge_to_grid Discharge to Grid, block_discharging Block Discharging, block_charging Block Charging
• Self-consumption optimisation (select): auto Automatic, manual Manual
• Web API SoC mode (select): automatic Automatic, manual Manual

Smart meter (one device per meter)

Sensors

Name	German name	Type	Unit	Source	Values	Notes
AC current	AC-Strom	sensor	A	Modbus 201-204
AC current L1	AC-Strom L1	sensor	A	Modbus 201-204
AC current L2	AC-Strom L2	sensor	A	Modbus 201-204
AC current L3	AC-Strom L3	sensor	A	Modbus 201-204
AC voltage L1-N	AC-Spannung L1-N	sensor	V	Modbus 201-204
AC voltage L2-N	AC-Spannung L2-N	sensor	V	Modbus 201-204
AC voltage L3-N	AC-Spannung L3-N	sensor	V	Modbus 201-204
AC voltage Line to Line	AC-Spannung Leiter-Leiter	sensor	V	Modbus 201-204
Exported	Eingespeist	sensor	Wh	Modbus 201-204
Exported L1	Eingespeist L1	sensor	Wh	Modbus 201-204		disabled by default
Exported L2	Eingespeist L2	sensor	Wh	Modbus 201-204		disabled by default
Exported L3	Eingespeist L3	sensor	Wh	Modbus 201-204		disabled by default
Imported	Bezogen	sensor	Wh	Modbus 201-204
Imported L1	Bezogen L1	sensor	Wh	Modbus 201-204		disabled by default
Imported L2	Bezogen L2	sensor	Wh	Modbus 201-204		disabled by default
Imported L3	Bezogen L3	sensor	Wh	Modbus 201-204		disabled by default
Line frequency	Netzfrequenz	sensor	Hz	Modbus 201-204
Power	Wirkleistung	sensor	W	Modbus 201-204
Power L1	Wirkleistung L1	sensor	W	Modbus 201-204
Power L2	Wirkleistung L2	sensor	W	Modbus 201-204
Power L3	Wirkleistung L3	sensor	W	Modbus 201-204
Modbus ID	Modbus-ID	sensor	-	the Modbus unit the meter answers on		diagnostic

What the entities mean

The meaning of each entity, with the register or field behind it. The controls are explained in Battery Control, the events and the throttle reason in Events and Throttling.

Inverter sensors

Entity	Description
AC power	Active power the inverter puts out (model 101/103 W).
AC current AC current L1 AC current L2 AC current L3	Total and per-phase AC current.
AC voltage L1-N AC voltage L2-N AC voltage L3-N AC voltage L1-L2 AC voltage L2-L3 AC voltage L3-L1	Phase and line-to-line AC voltage.
Reactive power	Reactive power in var.
Line frequency	AC frequency.
AC energy	The inverter's lifetime AC energy (WH).
PV power	The DC power of all PV strings together, from model 160.
MPPT module N DC current MPPT module N DC voltage MPPT module N DC power MPPT module N Lifetime energy	One set per PV string (model 160). A string that is dark at the first setup gets its sensors once it sends a value.
Storage charging current Storage charging voltage Storage charging power Storage charging lifetime energy Storage discharging current Storage discharging voltage Storage discharging power Storage discharging lifetime energy	The battery's charge and discharge channels of model 160, on the inverter's device.
Maximum power	The inverter's WMax (model 121), the reference of the AC limit.
AC limit rate	The AC limit in watts as the inverter holds it; the control of the same name sets it.
Isolation Resistance	The DC isolation resistance in MΩ.
Export soft limit	The soft export limit in watts as the inverter holds it, over the Web API; unknown while it is off. Requires the technician role; set it with the control of the same name.
Load	The household's net demand, derived from the primary smart meter. For a meter at the feed-in point it is the meter's power plus the inverter's AC power, read right after each other; for a meter in the consumption path it is that meter's power. Generation behind the meter that the inverter does not see (a balcony inverter, an AC-coupled battery) is not in it, so it is the consumption minus that generation and negative while that generation exports. It needs the meter's location from the inverter's PowerMeter endpoint and is unknown without it, and for an update in which the inverter and meter reads lie more than half a second apart.

Inverter diagnostics

Entity	Description
Grid status	From the meter and the inverter frequency: on_grid_operating with both within 50 ± 0.2 Hz; off_grid_operating with the meter outside that band while the inverter runs at 45 to 55 Hz (in backup operation about 53 Hz was observed); on_grid while the inverter stands still (below 1 Hz) and the meter sees the grid; off_grid with both below 1 Hz. Any other combination is unknown.
Energy management output 1 to 4 Energy management output 1 to 4 reason	From 1.4.0b3. Whether the relay the inverter's energy management switches is on, and why (/api/status/emrs). Off by default; enable the ones you use.
Throttle reason	Why the inverter holds its output back right now; see Events and Throttling.
Status Vendor status	The SunSpec operating state (St) and the Fronius vendor state code (StVnd).
Event severity	The Modbus event bits (EvtVnd2); the events themselves come from the web interface, see Events and Throttling.
Control mode	The active inverter controls (model 122 StActCtl): power reduction, constant reactive power, constant power factor.
PV connection Storage connection Electrical connection	The connection states of model 122 (PVConn, StorConn, ECPConn).
Connection control AC limit enabled Fixed power factor status Limit VAr control	Whether the grid connection (Conn), the AC limit (WMaxLim_Ena), the fixed power factor (OutPFSet_Ena) and the reactive power limit (VArPct_Ena) are switched on.
Throttle control	The AC limit flag once more, kept from upstream. disabled
Reference voltage Reference voltage offset	SunSpec model 121 PCC voltage reference values exposed by the inverter.
Modbus ID	The inverter's Modbus unit id.
Web API Modbus mode Web API Modbus control Web API SunSpec mode	The Modbus service settings from /api/config/modbus. A value the inverter answers in an unexpected shape shows as unknown.
Web API Modbus restriction Web API Modbus restriction IP	Whether the inverter restricts which hosts may control it over Modbus (Restrict Control in its web interface), and the allowed addresses.

Battery storage sensors

Entity	Description
State of charge	The current battery level (ChaState).
Charge status	holding / charging / discharging (plus off, empty, full, testing).
Modbus storage reserve	Model 124 MinRsvPct. Not the SoC minimum of the inverter's own UI; see Battery Control.
Core storage control mode	The storage control register (StorCtl_Mod) as the direction the battery is driven: in Charge from Grid it shows charge, in Discharge to Grid discharge; diagnostic. Storage Control Mode is the one to set.
Charging power Discharging power	The charge and discharge rates (InWRte, OutWRte) as the registers hold them, in percent of WChaMax; a negative rate is a grid mode's power. A rate StorCtl_Mod keeps off is ignored by the inverter and may hold what another controller left; diagnostic.
Charge/discharge reference power	WChaMax, the power the rates are a percentage of; diagnostic.
Grid charging	Whether the storage may charge from the grid (ChaGriSet); diagnostic.
Capacity Maximum charge rate Maximum discharge rate	The battery's nameplate (model 120); diagnostic.

Smart meter sensors

Entity	Description
Power Power L1 Power L2 Power L3	Total and per-phase real power measured by the meter (W, WphA-C); the sign follows the meter's power direction.
AC current AC current L1 AC current L2 AC current L3	Total and per-phase current.
AC voltage L1-N AC voltage L2-N AC voltage L3-N AC voltage Line to Line	Phase and line-to-line voltage.
Line frequency	Frequency.
Exported Imported	Total exported and imported energy.
Exported L1 Exported L2 Exported L3 Imported L1 Imported L2 Imported L3	Per-phase energy counters (TotWhExpPhA-C, TotWhImpPhA-C). Created only for a meter that counts them, since some meters report 0, SunSpec's "not implemented"; a counter that starts counting later gets its entity at the next restart. disabled
Modbus ID	The meter's Modbus unit id; diagnostic.

Component sensors (web interface, no login)

The inverter's component endpoints (/api/components/inverter/readable and /api/components/BatteryManagementSystem/readable) add values Modbus does not carry.

• A value the inverter does not report shows as unknown.
• A module temperature, a fan beyond the first two or a second temperature the inverter does not report creates no entity; one it has reported before keeps its entity, as unknown. A module that appears later gets its entity at the next reload.
• Output power limit, Output limited, Battery max charge power (DC-DC) and Battery max discharge power (DC-DC) follow the same rule, since older firmware lacks these fields. Such sensors an entry already has from an earlier version stay; if they only ever show unknown, disable them.
• Firmware without these endpoints (HTTP 404) gets none of these sensors; a sensor registered before stays, as unknown, since one 404 from an endpoint that answered before proves nothing.
• No sensor takes their serial numbers, part serials or device ids; the battery's serial number shows on its device page, as before, and is redacted in diagnostics.

On the inverter:

Entity	Description
AC module 1 temperature AC module 2 temperature AC module 3 temperature AC module 4 temperature AC module 5 temperature AC module 6 temperature DC module temperature (3) DC or battery module temperature DC module temperature (9) DC module temperature (10)	The module temperatures the inverter reports, named as its web interface names them; channels 1, 2 and 5–8 are the AC modules 1–6. A GEN24 10.0 reports 1, 3 and 4, a Verto 30.0 Plus 1–5 and 9.
Internal temperature Ambient temperature 2	The inverter's internal temperature, and a second ambient temperature on inverters that report one.
Fan 1 Fan 2 Fan 3 Fan 4 Fan 5	Fan speed in percent. Fans 3–5 exist only where the inverter reports them.
AC power L1 AC power L2 AC power L3	Per-phase active power of the inverter.
Output power limit Output limited	The power limit in effect (the nameplate power, or the AC limit while it is set; an export limit does not lower it), and whether a limit set on the inverter holds the output, in percent or in watts.
Battery max charge power (DC-DC) Battery max discharge power (DC-DC)	What the battery converter can take or give right now.
Grid valid	The inverter's own verdict on the grid at its feed-in point.
Surplus power available	Observed, not documented by Fronius: yes while an export limit curtailed PV, no otherwise, also while the AC limit held the output. Seen on two inverters. disabled
Power stage 1 firmware Power stage 2 firmware	Diagnostic.
Feed-in point voltage L1 Feed-in point voltage L2 Feed-in point voltage L3 Feed-in point voltage L1-L2 Feed-in point voltage L2-L3 Feed-in point voltage L3-L1 Feed-in point frequency	Grid side of the inverter's relays; differs from the AC output only while they are open. disabled
DC link voltage Operating time Power stage hardware	Diagnostic. The operating time counts in seconds but is no exact clock. disabled
Time in backup mode	Total time the inverter ran in backup mode. disabled

On the battery:

Entity	Description
State of health	The battery's own estimate, in percent.
Cell temperature	The battery's cell temperature.
Cell temperature min Cell temperature max BMS ambient temperature	disabled
Current discharge limit Current charge limit	What the battery management system allows right now. Observed, not documented by Fronius: the charge limit fell to 0 W near a full battery while discharging stayed allowed. disabled
Peak charge power (10 s) Peak discharge power (10 s) Manufacturer SoC min Manufacturer SoC max Voltage range min Voltage range max Modules Connection	Diagnostic, from the battery's nameplate and attributes. disabled

The battery's own firmware and hardware version appear on its device page.