4. Telemetry Variable Dictionary

The table presented below offers a comprehensive overview of the variables that can be accessed through the API. It is important to note that the availability of these variables may differ depending on the specific device being utilized. Therefore, the variables listed in the table are subject to change based on the device in use.

5.1 Photovoltaic (PV)

Metrics related to solar panel input and string-level diagnostics.

Variable Key	Unit	Business Meaning	ESU	Grid-Tied
`pvPower`	kW	Total PV input power	✓	✓
`todayYield`	kW	Energy generated today	✓	✓
`PVEnergyTotal`	kWh	Total lifetime PV generation (DC side)	✓	✓
`pv1Volt` - `pv24Volt`	V	Voltage of individual PV string	✓	✓
`pv1Current` - `pv24Current`	A	Current of individual PV string	✓	✓
`pv1Power` - `pv24Power`	kW	Power of individual PV string	✓	✓

5.2 Grid Interaction & Utility

Data points for monitoring grid connection, power exchange, and quality.

Variable Key	Unit	Business Meaning	ESU	Grid-Tied
`RVolt` - `TVolt`	V	Grid phase voltage (R/S/T)	✓	✓
`RCurrent` - `TCurrent`	A	Grid phase current (R/S/T)	✓	✓
`RFreq` - `TFreq`	Hz	Grid phase frequency (R/S/T)	✓	✓
`RPower` - `TPower`	kW	Grid phase active power (R/S/T)	✓	✓
`feedinPower`	kW	Active power exported to the grid	✓	✓
`gridConsumptionPower`	kW	Active power drawn from the grid	✓	✓
`generation`	kWh	Cumulative AC output energy (inverter side)	✓	✓
`gridConsumption` - `gridConsumption3`	kWh	Cumulative grid electricity consumption (Meter 1-3)	✓	✓
`feedin` - `feedin2`	kWh	Cumulative feed-in energy (Meter 1-2)	✓	✓
`meter3Export`	kWh	Cumulative feed-in energy (Meter 3)	✓	✓
`meter3Import`	kWh	Cumulative grid import energy (Meter 3)	✓	✓
`ReactivePower`	kVar	Reactive power	✓	✓
`PowerFactor`	-	Power factor	✓	✓

5.3 Local Loads & Consumption

Metrics for monitoring internal power consumption within the household or site.

Variable Key	Unit	Business Meaning	ESU	Grid-Tied
`loadsPower`	kW	Total load power consumption	✓	✓
`loadsPowerR` - `loadsPowerT`	kW	Load power per phase (R/S/T)	✓	✓
`loads`	kWh	Cumulative load energy consumption	✓	✓

5.4 Inverter Status & Health

System-level metrics for monitoring inverter operation state and thermal conditions.

Variable Key	Unit	Business Meaning	ESU	Grid-Tied
`invTemperation`	℃	Inverter internal temperature	✓	✓
`ambientTemperation`	℃	Ambient temperature	✓	✓
`boostTemperation`	℃	Boost circuit temperature	✓	✓
`chargeTemperature`	℃	Charging module temperature	✓	✓
`dspTemperature`	℃	DSP chip temperature	✓	✓
`generationPower`	kW	Total AC output power	✓	✓
`runningState`	-	Operational state code (e.g., on-grid, fault)	✓	✓
`currentFault`	-	Current active fault code	✓	✓
`currentFaultCount`	-	Count of current faults	✓	✓

Enum Reference: runningState

160: Self-test

161: Waiting

162: Checking

163: On-grid (Normal operation)

164: Off-grid

165: Fault

166: Permanent Fault

167: Standby

168: Upgrading

169: FCT (Factory Test)

170: Illegal

5.5 Battery Management System (BMS)

Critical variables for monitoring energy storage status, health, and power flow.

Variable Key	Unit	Business Meaning	ESU	Grid-Tied
`SoC`	%	State of Charge (Current battery level)	✓	✗
`SOH`	%	State of Health (Battery degradation)	✓	✗
`batVolt`	V	Battery voltage	✓	✗
`batCurrent`	A	Battery current	✓	✗
`invBatVolt`	V	Inverter-side battery voltage	✓	✓
`invBatCurrent`	A	Inverter-side battery current	✓	✗
`invBatPower`	kW	Inverter-side battery power (±)	✓	✗
`batChargePower`	kW	Battery charge power	✓	✗
`batDischargePower`	kW	Battery discharge power	✓	✗
`batTemperature`	℃	Battery temperature	✓	✗
`maxChargeCurrent`	A	Maximum allowed charge current	✓	✗
`maxDischargeCurrent`	A	Maximum allowed discharge current	✓	✗
`remainCapacity`	Ah	Remaining capacity	✓	✗
`ResidualEnergy`	kWh	Remaining energy in battery	✓	✗
`batCycleCount`	-	Number of charge/discharge cycles	✓	✗
`totalDischargeKW`	kWh	Total discharge energy (lifetime)	✓	✗
`chargeEnergyToTal`	kWh	Total charge energy (lifetime)	✓	✗
`dischargeEnergyToTal`	kWh	Total discharge energy (lifetime)	✓	✗
`batChargeEnergyToTal`	kWh	Total charge energy (Battery Side) (lifetime)	✓	✗
`batDischargeEnergyToTal`	kWh	Total discharge energy (Battery Side) (lifetime)	✓	✗
`energyThroughput`	kWh	Total energy cycled (lifetime)	✓	✗
`EventNumber`	-	Adverse event count	✓	✗

5.6 External Meters

Data from external CT meters for granular energy flow monitoring.

Variable Key	Unit	Business Meaning	ESU	Grid-Tied
`meterPower` - `meterPower2`	kW	Total active power (Meter 1/2)	✓	✓
`meterPowerR` - `meterPowerT`	kW	Phase-specific active power (Meter 1)	✓	✓
`meter3Status`	-	Operational status of Meter 3	✓	✓

5.7 EPS (Emergency Power Supply)

Metrics for monitoring backup power circuits during grid outages.

Variable Key	Unit	Business Meaning	ESU	Grid-Tied
`epsPower`	kW	EPS total output power	✓	✗
`epsVoltR` - `epsVoltT`	V	EPS phase voltage	✓	✗
`epsCurrentR` - `epsCurrentT`	A	EPS phase current	✓	✗
`epsPowerR` - `epsPowerT`	kW	EPS phase power	✓	✗

5.8 Heat Pump (Kafka Only)

Hardware, status, and operational metrics specific to Heat Pump systems.

Variable Key	Business Meaning	Category
indoorDeviceType	Model Name	Heat PumpHardware Identification (Static Data)
capacity	Power Class	Heat PumpHardware Identification (Static Data)
sn	Outdoor Unit S/N	Heat PumpHardware Identification (Static Data)
indoorSN	Indoor Unit S/N & Gateway S/N	Heat PumpHardware Identification (Static Data)
systemFunction	Domestic Hot Water installed	Device Details(Semi Static Data)
Z1ZoneSwitch	Heating Circuits	Device Details(Semi Static Data)
Z2ZoneSwitch	Heating Circuits	Device Details(Semi Static Data)
Z3ZoneSwitch	Heating Circuits	Device Details(Semi Static Data)
Z1ZoneEmitterType	Heating Circuit Type	Device Details(Semi Static Data)
Z1ZoneMaxWaterTemp	Heating Circuit Type	Device Details(Semi Static Data)
Z2ZoneEmitterType	Heating Circuit Type	Device Details(Semi Static Data)
Z2ZoneMaxWaterTemp	Heating Circuit Type	Device Details(Semi Static Data)
Z3ZoneEmitterType	Heating Circuit Type	Device Details(Semi Static Data)
Z3ZoneMaxWaterTemp	Heating Circuit Type	Device Details(Semi Static Data)
currentRunMode	System Status	Status (Dynamicon Change)
heatPumpConnectivityStatus	Connectivity Status	Status (Dynamicon Change)
sgReadyEnable	Smart Grid Status	Status (Dynamicon Change)
sgReadyMode	§14a status	Status (Dynamicon Change)
sgTclmin	§14a dimming target	Status (Dynamicon Change)
sgThtmax	§14a dimming target	Status (Dynamicon Change)
sgTwmax	§14a dimming target	Status (Dynamicon Change)
outdoorAirTemp	Outdoor temperatureused for weather curve?	Metrics(Dynamic Time series)
dcWaterPumpOFFFlowRate	Hydraulics station flow speed	Metrics(Dynamic Time series)
outletWaterTemp	Hydraulic station flow temperature	Metrics(Dynamic Time series)
returnWaterTemp	Hydraulic station return temperature	Metrics(Dynamic Time series)
Z1ZoneTemp	Flow temperature of each heating circuit	Metrics(Dynamic Time series)
Z2ZoneTemp	Flow temperature of each heating circuit	Metrics(Dynamic Time series)
Z3ZoneTemp	Flow temperature of each heating circuit	Metrics(Dynamic Time series)
dcFanOFFSpeed	Ventilator RPM	Metrics(Dynamic Time series)
dcFanMaxSpeed	Ventilator max RPM	Metrics(Dynamic Time series)
bufferTankTemp	Buffer tank temperature	Metrics(Dynamic Time series)
SolenoidThree-wayValveStatus	3-way-valve position	Metrics(Dynamic Time series)
flowPressure	Technical Water Pressure	Metrics(Dynamic Time series)
waterTankTemp	Domestic hot water actual temperature	Metrics(Dynamic Time series)
heatingSetTemp	Domestic hot water target temperature	Metrics(Dynamic Time series)
heatingRealTimeConsumption	Power consumption heating	Metrics(Dynamic Time series)
dhwRealTimeConsumption	Power consumption heating domestic hot water	Metrics(Dynamic Time series)
totalIndoorConsumption	Power consumption heating rod heating	Metrics(Dynamic Time series)
heatingRealTimeProduction	Generated heat heating	Metrics(Dynamic Time series)
dhwRealTimeProduction	Generated heat domestic hot water	Metrics(Dynamic Time series)
currentFault	Error Code	Errors & Warnings

4. Telemetry Variable Dictionary

5.1 Photovoltaic (PV)#

5.2 Grid Interaction & Utility#

5.3 Local Loads & Consumption#

5.4 Inverter Status & Health#

5.5 Battery Management System (BMS)#

5.6 External Meters#

5.7 EPS (Emergency Power Supply)#

5.8 Heat Pump (Kafka Only)#