Was ist der SENEC-Collector?

Der SENEC-Collector sammelt die Messwerte, die von einem SENEC Stromspeicher gemeldet werden und schreibt diese in die InfluxDB.

Der Collector ist kompatibel mit folgenden Stromspeichern:

SENEC.Home V2.1
SENEC.Home V3
SENEC.Home P4

Betriebsmodi

Grundsätzlich kann der Collector in zwei verschiedenen Betriebsmodi eingesetzt werden:

Lokal: Direkter Zugriff auf den SENEC-Stromspeicher über dessen lokale IP-Adresse. Die Daten werden über die lala.cgi-Schnittstelle ausgelesen. Möglich ist das beim V2.1 und V3, nicht aber beim Home P4, denn dieser hat keine lokale Schnittstelle. Ein Auslesen der Messwerte ist in einem kurzen Intervall möglich, standardmäßig sind es 5 Sekunden.
Cloud: Abholen der Messwerte aus der SENEC-Cloud aus unter Verwendung der Schnittstelle, die von SENEC für die Mobil-Apps bereitgestellt wird. Für den Zugriff sind SENEC-Zugangsdaten anzugeben (E-Mail und Passwort). Möglich ist das auch für den Home P4. Das Auslesen der Messwerte ist nur einem einem längeren Intervall erlaubt, das vom Gerät abhängt. Beim Home P4 ist eine Abfrage im 1-Minuten-Takt möglich, beim V2.1 und V3 im 5-Minuten-Takt.

Vergleich der Betriebsmodi

	Lokal	Cloud
SENEC.Home V2.1	Ja (5sec)	Ja (5min)
SENEC.Home V3	Ja (5sec)	Ja (5min)
SENEC.Home P4	Nein	Ja (1min)

Beim V2.1 und V3 ist es also möglich, sich für einen der beiden Adapter zu entscheiden. Dies eröffnet die Möglichkeit, SOLECTRUS vollständig auf einem Cloud-Server zu betreiben, also ohne einen Raspberry o.ä. im lokalen Netzwerk. Diesem Vorteil steht der Nachteil gegenüber, dass die Daten nicht so häufig aktualisiert werden (nur alle 5 Minuten, statt alle 5 Sekunden).

Erfasste Messwerte

Der Collector schreibt die folgenden Messwerte als Field in das angegebene Measurement der InfluxDB. Einige Messwerte sind nur im lokalen Betrieb verfügbar (also nicht beim P4).

Field	Beschreibung	Lokal	Cloud
`application_version`	Version der Firmware	Ja	Ja
`bat_charge_current`	Batterie-Ladestrom, in A	Ja	Ja
`bat_fuel_charge`	Batterie-Ladestand, in %	Ja	Ja
`bat_power_minus`	Batterie-Entladeleistung, in W	Ja	Ja
`bat_power_plus`	Batterie-Ladeleistung, in W	Ja	Ja
`bat_voltage`	Batterie-Spannung, in V	Ja	Ja
`case_temp`	Gehäuse-Temperatur, in °C	Ja	Ja
`current_state_code`	Aktueller Betriebszustand, als Zahl	Ja	Nein
`current_state`	Aktueller Betriebszustand, als Text	Ja	Nein
`current_state_ok`	Aktueller Betriebszustand ist Ok (Boolean)	Ja	Nein
`ev_connected`	Elektroauto verbunden, Ja/Nein	Ja	Ja
`grid_power_minus`	Netzeinspeisung, in W	Ja	Ja
`grid_power_plus`	Netzbezug, in W	Ja	Ja
`house_power`	Hausverbrauch, in W	Ja	Ja
`inverter_power`	Erzeugte Leistung des Wechselrichters, in W	Ja	Ja
`mpp1_power`	Leistung von Strang 1, in W	Ja	Nein
`mpp2_power`	Leistung von Strang 2, in W	Ja	Nein
`mpp3_power`	Leistung von Strang 3, in W	Ja	Nein
`power_ratio`	Leistungsbegrenzung, in %	Ja	Nein
`response_duration`	Dauer der Antwort, in ms	Ja	Nein
`wallbox_charge_power`	Wallbox-Ladeleistung, in W	Ja	Ja
`wallbox_charge_power0`	Wallbox-Ladeleistung für erste Wallbox, in W	Ja	Nein
`wallbox_charge_power1`	Wallbox-Ladeleistung für zweite Wallbox, in W	Ja	Nein
`wallbox_charge_power2`	Wallbox-Ladeleistung für dritte Wallbox, in W	Ja	Nein
`wallbox_charge_power3`	Wallbox-Ladeleistung für vierte Wallbox, in W	Ja	Nein

Logging

Der Collector schreibt ein Protokoll ins Docker-Log, das im Normalfall so aussieht:

SENEC collector for SOLECTRUS, Version 0.19.2, built at 2025-11-11T06:03:32.524Z
https://github.com/solectrus/senec-collector
Copyright (c) 2020-2025 Georg Ledermann, released under the MIT License

Using Ruby 3.4.7 on platform aarch64-linux-musl
Pushing to InfluxDB at http://influxdb:8086, bucket solectrus, measurement SENEC

Wait until InfluxDB is ready ... OK

Pulling from your local SENEC at https://192.168.178.29 every 5 seconds
Getting state names (language: de) from SENEC by parsing source code...
OK, got 99 state names

Got record #1 at 2025-11-23 07:42:42 +0100 within 14 ms, AKKU LEER, Inverter 0 W, House 894 W, Wallbox 0 W
Successfully pushed record #1 to InfluxDB
...

Das Protokoll kann über folgenden Befehl abgerufen werden:

docker compose logs senec-collector

Bei Problemen oder Fehlern (z.B. wenn der Stromspeicher oder die InfluxDB nicht erreichbar ist) wird dies ebenfalls protokolliert. Es empfiehlt sich daher, im Zweifelsfall zuerst das Protokoll zu prüfen.

Quelltext

Der SENEC-Collector ist in Ruby implementiert, der Quelltext ist auf GitHub verfügbar:
github.com/solectrus/senec-collector