Sensor-Konfiguration des Dashboards

InfluxDB speichert die Messwerte als Zeitreihen. Jeder Messwert gehört zu einem Measurement und einem Field. SOLECTRUS abstrahiert davon und kennt stattdessen Sensoren, jeder mit einem eindeutigen Namen. Eine Umgebungsvariable je Sensor legt fest, wo in der InfluxDB seine Messwerte liegen.

Die Zuordnung folgt einer festen Schreibweise: Measurement und Field, getrennt durch einen Doppelpunkt. Steht die PV-Erzeugung im Measurement SENEC und dort im Field inverter_power, sieht der Eintrag so aus:

INFLUX_SENSOR_INVERTER_POWER=SENEC:inverter_power

Measurement und Field sind case-sensitive: InfluxDB unterscheidet Groß- und Kleinschreibung. Zeigen zwei Sensoren auf dieselbe Stelle in der InfluxDB, setzt das Dashboard eine Warnung ins Protokoll.

Pflicht und Standardwerte

Keine dieser Variablen ist Pflicht, und keine hat einen Standardwert. Sensoren, für die keine Messwerte vorliegen (etwa mangels Wärmepumpe), bleiben einfach weg. Eine leere Zuordnung wie INFLUX_SENSOR_HEATPUMP_POWER= hat dieselbe Wirkung, nötig ist sie aber nicht.

Was fehlt, zeigt das Dashboard nicht an. Ohne INFLUX_SENSOR_BATTERY_SOC gibt es keinen Ladestand, ohne INFLUX_SENSOR_HOUSE_POWER keinen Hausverbrauch.

Alte Konfiguration

Bis zur Einführung der Sensoren im Sommer 2024 wurde das Dashboard über feste SENEC-Messwerte konfiguriert. Solche Installationen laufen unverändert weiter. HELIOS stellt die alte Konfiguration beim Import automatisch auf Sensoren um.

Verfügbare Sensoren

Die von SOLECTRUS unterstützten Sensoren lassen sich in verschiedene Kategorien einteilen. Jeder Sensor ist mit seiner Umgebungsvariablen verlinkt.

Wechselrichter

Sensor-Name	Einheit
INVERTER_POWER	Watt
INVERTER_POWER_1	Watt
INVERTER_POWER_2	Watt
INVERTER_POWER_3	Watt
INVERTER_POWER_4	Watt
INVERTER_POWER_5	Watt
GRID_IMPORT_POWER	Watt
GRID_EXPORT_POWER	Watt
GRID_EXPORT_LIMIT	Prozent
CASE_TEMP	°C
SYSTEM_STATUS	Text
SYSTEM_STATUS_OK	Logisch (True/False)

Stromspeicher

Sensor-Name	Einheit
BATTERY_SOC	Prozent
BATTERY_CHARGING_POWER	Watt
BATTERY_DISCHARGING_POWER	Watt

Verbraucher

Sensor-Name	Einheit
HOUSE_POWER	Watt
HEATPUMP_POWER	Watt
CUSTOM_POWER_01	Watt
CUSTOM_POWER_02	Watt
CUSTOM_POWER_03	Watt
CUSTOM_POWER_04	Watt
CUSTOM_POWER_05	Watt
CUSTOM_POWER_06	Watt
CUSTOM_POWER_07	Watt
CUSTOM_POWER_08	Watt
CUSTOM_POWER_09	Watt
CUSTOM_POWER_10	Watt
CUSTOM_POWER_11	Watt
CUSTOM_POWER_12	Watt
CUSTOM_POWER_13	Watt
CUSTOM_POWER_14	Watt
CUSTOM_POWER_15	Watt
CUSTOM_POWER_16	Watt
CUSTOM_POWER_17	Watt
CUSTOM_POWER_18	Watt
CUSTOM_POWER_19	Watt
CUSTOM_POWER_20	Watt

Wallbox und E-Auto

Sensor-Name	Einheit
WALLBOX_POWER	Watt
WALLBOX_CAR_CONNECTED	Logisch (True/False)
CAR_BATTERY_SOC	Prozent

Wärmepumpe

Sensor-Name	Einheit
HEATPUMP_HEATING_POWER	Watt
HEATPUMP_TANK_TEMP	°C
HEATPUMP_TANK_TEMP_SETPOINT	°C
HEATPUMP_STATUS	Text
OUTDOOR_TEMP	°C

Prognosen

Sensor-Name	Einheit
INVERTER_POWER_FORECAST	Watt
INVERTER_POWER_FORECAST_CLEARSKY	Watt
OUTDOOR_TEMP_FORECAST	°C

Umgebungsvariablen

Die Variablen beginnen alle mit dem Präfix INFLUX_SENSOR_, gefolgt vom eindeutigen Sensor-Namen.

HELIOS schreibt die Zuordnungen selbst. Unter Konfiguration → Sensoren wird ein Sensor aktiviert und ihm eine Quelle zugewiesen, etwa der SENEC- oder der MQTT-Collector. Measurement und Field ergeben sich daraus. Nur bei der Quelle „Externe Quelle“ fragt HELIOS beides ab, denn dann schreibt ein Programm außerhalb von SOLECTRUS in die InfluxDB.

INFLUX_SENSOR_INVERTER_POWER

PV-Erzeugung als Leistung des Wechselrichters, in Watt. Gemeint ist die Gesamterzeugung, also inklusive etwaiger Steckersolargeräte oder separat betriebener Wechselrichter.

Gibt es keinen solchen Gesamtwert, bleibt die Variable weg. Das Dashboard addiert dann die Werte der einzelnen Wechselrichter (INFLUX_SENSOR_INVERTER_POWER_X) selbst.

Beispiel

INFLUX_SENSOR_INVERTER_POWER=SENEC:inverter_power

HELIOS

Als Quelle stehen der SENEC-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_INVERTER_POWER_X

Leistung eines einzelnen Erzeugers in Watt, wobei X für eine Zahl zwischen 1 und 5 steht. Nötig sind diese Variablen nur, wenn Messwerte für einzelne Wechselrichter oder Strings vorliegen.

Beispiel

INFLUX_SENSOR_INVERTER_POWER_1=SENEC:mpp1_power
INFLUX_SENSOR_INVERTER_POWER_2=SENEC:mpp2_power
INFLUX_SENSOR_INVERTER_POWER_3=SENEC:mpp3_power
INFLUX_SENSOR_INVERTER_POWER_4=balcony:power
INFLUX_SENSOR_INVERTER_POWER_5=

HELIOS

Als Quelle stehen der Shelly-, der MQTT-Collector und eine externe Quelle zur Wahl, für die ersten drei Erzeuger zusätzlich der SENEC-Collector. Wer einen der Erzeuger als Steckersolargerät markiert, bekommt von HELIOS zusätzlich den Ingest-Dienst, der den Hausverbrauch korrigiert.

INFLUX_SENSOR_HOUSE_POWER

Hausverbrauch in Watt.

Beispiel

INFLUX_SENSOR_HOUSE_POWER=SENEC:house_power

HELIOS

Als Quelle stehen der SENEC-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_GRID_IMPORT_POWER

Strombezug aus dem Netz in Watt.

Beispiel

INFLUX_SENSOR_GRID_IMPORT_POWER=SENEC:grid_power_plus

HELIOS

Als Quelle stehen der SENEC-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_GRID_EXPORT_POWER

Stromabgabe ins Netz (Einspeisung) in Watt.

Beispiel

INFLUX_SENSOR_GRID_EXPORT_POWER=SENEC:grid_power_minus

HELIOS

Als Quelle stehen der SENEC-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_BATTERY_CHARGING_POWER

Ladeleistung des Stromspeichers in Watt.

Beispiel

INFLUX_SENSOR_BATTERY_CHARGING_POWER=SENEC:bat_power_plus

HELIOS

Als Quelle stehen der SENEC-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_BATTERY_DISCHARGING_POWER

Entladeleistung des Stromspeichers in Watt.

Beispiel

INFLUX_SENSOR_BATTERY_DISCHARGING_POWER=SENEC:bat_power_minus

HELIOS

Als Quelle stehen der SENEC-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_BATTERY_SOC

Ladestand des Stromspeichers in Prozent.

Beispiel

INFLUX_SENSOR_BATTERY_SOC=SENEC:bat_fuel_charge

HELIOS

Als Quelle stehen der SENEC-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_WALLBOX_POWER

Ladeleistung der Wallbox in Watt.

Beispiel

INFLUX_SENSOR_WALLBOX_POWER=SENEC:wallbox_charge_power

HELIOS

Als Quelle stehen der SENEC-, der Shelly-, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_CASE_TEMP

Gehäusetemperatur des Wechselrichters oder Stromspeichers in °C.

Beispiel

INFLUX_SENSOR_CASE_TEMP=SENEC:case_temp

HELIOS

Als Quelle stehen der SENEC-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_INVERTER_POWER_FORECAST

Prognostizierte PV-Erzeugung in Watt.

Beispiel

INFLUX_SENSOR_INVERTER_POWER_FORECAST=Forecast:watt

HELIOS

Als Quelle stehen der Forecast-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_INVERTER_POWER_FORECAST_CLEARSKY

Höchstmögliche PV-Erzeugung bei wolkenlosem Himmel, in Watt. Verfügbar ab Dashboard-Version 1.0.

Beispiel

INFLUX_SENSOR_INVERTER_POWER_FORECAST_CLEARSKY=Forecast:watt_clearsky

HELIOS

Als Quelle stehen der Forecast-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_OUTDOOR_TEMP_FORECAST

Prognostizierte Außentemperatur in °C. Verfügbar ab Dashboard-Version 1.0.

Beispiel

INFLUX_SENSOR_OUTDOOR_TEMP_FORECAST=Forecast:temp

HELIOS

Als Quelle stehen der Forecast-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_SYSTEM_STATUS

Systemstatus als Text, etwa eine Fehlermeldung des Wechselrichters.

Beispiel

INFLUX_SENSOR_SYSTEM_STATUS=SENEC:current_state

HELIOS

Als Quelle stehen der SENEC-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_SYSTEM_STATUS_OK

Kennzeichnung, ob der Systemstatus als „in Ordnung“ gilt. Der Wert ist logisch: true zeigt einen grünen Punkt, false einen orangefarbenen.

Beispiel

INFLUX_SENSOR_SYSTEM_STATUS_OK=SENEC:current_state_ok

HELIOS

Als Quelle stehen der SENEC-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_GRID_EXPORT_LIMIT

Einspeiseleistungsbegrenzung in Prozent. Gemeint ist nicht die Obergrenze, sondern die in einem einzelnen Moment gerade wirksame Begrenzung. Manche Wechselrichter liefern diesen Wert.

Beispiel

INFLUX_SENSOR_GRID_EXPORT_LIMIT=SENEC:power_ratio

HELIOS

Als Quelle stehen der SENEC-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_HEATPUMP_POWER

Stromverbrauch der Wärmepumpe in Watt.

Beispiel

INFLUX_SENSOR_HEATPUMP_POWER=heatpump:power

HELIOS

Als Quelle stehen der Shelly-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_HEATPUMP_HEATING_POWER

Erzeugte Wärmeleistung der Wärmepumpe in Watt. Das ist die thermische Leistung, die die Wärmepumpe abgibt, nicht ihr Stromverbrauch. Verfügbar ab Dashboard-Version 1.0.

Zusammen mit INFLUX_SENSOR_HEATPUMP_POWER berechnet das Dashboard daraus die Arbeitszahl.

Beispiel

INFLUX_SENSOR_HEATPUMP_HEATING_POWER=heatpump:heating_power

HELIOS

Als Quelle stehen der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_HEATPUMP_STATUS

Status der Wärmepumpe als Text, etwa „Heizen“ oder „Warmwasser“. Verfügbar ab Dashboard-Version 1.0.

Beispiel

INFLUX_SENSOR_HEATPUMP_STATUS=heatpump:status

HELIOS

Als Quelle stehen der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_OUTDOOR_TEMP

Außentemperatur in °C, gemessen von der Wärmepumpe. Verfügbar ab Dashboard-Version 1.0.

Beispiel

INFLUX_SENSOR_OUTDOOR_TEMP=heatpump:outdoor_temp

HELIOS

Als Quelle stehen der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_HEATPUMP_TANK_TEMP

Temperatur des Warmwasserspeichers der Wärmepumpe in °C. Verfügbar ab Dashboard-Version 1.0.

Beispiel

INFLUX_SENSOR_HEATPUMP_TANK_TEMP=heatpump:tank_temp

HELIOS

Als Quelle stehen der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_HEATPUMP_TANK_TEMP_SETPOINT

Solltemperatur des Warmwasserspeichers der Wärmepumpe in °C. Verfügbar ab Dashboard-Version 1.2.

Beispiel

INFLUX_SENSOR_HEATPUMP_TANK_TEMP_SETPOINT=heatpump:tank_temp_setpoint

HELIOS

Als Quelle stehen der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_WALLBOX_CAR_CONNECTED

Kennzeichnung, ob das E-Auto an der Wallbox steckt. Der Wert ist logisch, also true oder false.

Beispiel

INFLUX_SENSOR_WALLBOX_CAR_CONNECTED=Wallbox:car_connected

HELIOS

Als Quelle stehen der SENEC-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_CAR_BATTERY_SOC

Ladestand des E-Autos in Prozent.

Beispiel

INFLUX_SENSOR_CAR_BATTERY_SOC=Trabant:soc

HELIOS

Als Quelle stehen der MQTT-Collector und eine externe Quelle zur Wahl.

INFLUX_SENSOR_CUSTOM_POWER_XX

Stromverbrauch eines benutzerdefinierten Sensors in Watt, wobei XX für eine Zahl zwischen 01 und 20 steht. Damit lassen sich einzelne Verbraucher im Haushalt erfassen, etwa Waschmaschine oder Kühlschrank.

Ein benutzerdefinierter Sensor bekommt ein eigenes Segment in der Strombilanz.

Beispiel

INFLUX_SENSOR_CUSTOM_POWER_01=Fridge:power
INFLUX_SENSOR_CUSTOM_POWER_02=Dishwasher:power
INFLUX_SENSOR_CUSTOM_POWER_03=Washer:power
# ...

HELIOS

Als Quelle stehen der Shelly-Collector, der MQTT-Collector und eine externe Quelle zur Wahl.

Hausverbrauch korrigieren

INFLUX_EXCLUDE_FROM_HOUSE_POWER

Sensoren, deren Leistung aus dem Hausverbrauch herausgerechnet wird, als komma-getrennte Liste von Sensor-Namen. Die Namen stehen dort ohne das Präfix INFLUX_SENSOR_.

Nötig ist das, wenn der Hausverbrauch die Leistung der Wärmepumpe, der Wallbox oder anderer Verbraucher bereits enthält. Ohne die Korrektur zählt ihre Leistung doppelt.

Beispiel

INFLUX_EXCLUDE_FROM_HOUSE_POWER=HEATPUMP_POWER,WALLBOX_POWER

Auch benutzerdefinierte Sensoren gehören hierher:

Beispiel

INFLUX_EXCLUDE_FROM_HOUSE_POWER=WALLBOX_POWER,CUSTOM_POWER_02,CUSTOM_POWER_08

Ein Name, den SOLECTRUS nicht kennt, lässt das Dashboard beim Start abbrechen. Ist INFLUX_SENSOR_HOUSE_POWER nicht konfiguriert, bleibt die Variable wirkungslos.

HELIOS

HELIOS setzt die Variable selbst zusammen. Bei Wärmepumpe, Wallbox und benutzerdefinierten Sensoren gibt es unter Konfiguration → Sensoren den Schalter Aus Hausverbrauch herausrechnen, standardmäßig aus.