Wie rechnet der Adapter?

Wird SourceAnalytix noch weiterentwickelt?

Kurz: Ja. Nach einer langen Pause zwischen v0.4.14 (Februar 2022) und v0.5.0 (Juli 2026) erscheinen wieder regelmäßig neue Versionen, zuletzt v0.6.0 am 26.09.2026 und v0.6.1 am 07.11.2026. v0.6.2 bringt Fehlerbehebungen, v0.7.0 die neue Einstellungsseite mit Aktionen zum Korrigieren.

SourceAnalytix steht derzeit im Repository „latest" (Beta). In „stable" kommt es erst nach einer Testphase. Wie du auf eine neue Version kommst, steht unter Wie aktualisiere ich SourceAnalytix?.

Wohin mit Fragen und Fehlern

1. Schau ab v0.7.0 zuerst in den Tab „Probleme" der Instanz-Einstellungen. Er prüft alle Quellen und schlägt eine Lösung vor.
2. Lies die Seiten zur Fehlerbehebung.
3. Einen Fehler oder einen Wunsch meldest du als Issue im GitHub-Repository. Prüfe vorher, ob es schon ein Issue dazu gibt. Gib die Versionen von SourceAnalytix, js-controller und Node.js an und hänge das Log der betroffenen Quelle an.

Funktionen, die viele sich wünschen, etwa „Datenpunkt wechseln" (#1271) oder eine „Summe über alle Quellen", sind als geplant gekennzeichnet. Auf der Einstellungsseite tragen sie den Hinweis „geplant".

Warum weichen die Werte von Zähler, Portal oder evcc ab?

Kurz: Meist hat es einen von vier Gründen: Die Quelle ist eine Leistung in W, die nur selten sendet; Portal oder Wallbox ordnen den Verbrauch einem anderen Zeitpunkt zu; das Gerät misst anders als dein Zähler; oder Startwerte, Einheit oder Gesamtstand passen nicht. Die Tabelle hilft dir, die Ursache zu finden.

Ursache	Woran du sie erkennst	Was hilft
Quelle ist eine Leistung (W), die nur alle paar Minuten sendet	Die Werte weichen stark ab, oft um ein Vielfaches	Den Gesamtzähler des Geräts in kWh nehmen oder das Gerät öfter senden lassen, z. B. alle 10 Sekunden
Leistungsquelle hatte eine Pause	Nach einem Ausfall fehlt Verbrauch oder ist viel zu hoch	Siehe Pausen, ab v0.7.0 „Maximale Lücke zwischen Leistungswerten (Minuten)"
Anderer Zeitpunkt der Zuordnung	Tageswerte weichen ab, die Summe über mehrere Tage stimmt	Nichts, beide Werte stimmen. Vergleiche längere Zeiträume
Gerät misst anders als der Zähler des Netzbetreibers	Bezug und Einspeisung passen nicht zum Zähler im Keller	Den Zähler selbst auslesen, z. B. mit einem Lesekopf
Startwerte, Einheit oder Gesamtstand falsch	Werte sind negativ, viel zu hoch oder um einen festen Betrag versetzt	Siehe Falsche Werte korrigieren

Leistung statt Zählerstand

Aus einer Leistung kann SourceAnalytix den Verbrauch nur schätzen. Jeder Wert gilt bis zum nächsten. Sendet ein Gerät nur alle 5 Minuten, rechnet SourceAnalytix jede kurze Spitze für die ganzen 5 Minuten. Bietet das Gerät einen Zählerstand in kWh, ist der genauer. Wie die Umrechnung arbeitet, steht unter Wie rechnet SourceAnalytix Watt in kWh um?.

Anderer Zeitpunkt der Zuordnung

SourceAnalytix bucht Verbrauch auf den Tag, an dem er gemessen wurde: Der Tageswert ist der Gesamtstand jetzt minus der Gesamtstand um 0:00 Uhr. Eine Wallbox oder evcc bucht dagegen oft einen ganzen Ladevorgang auf den Tag, an dem er endet. Hersteller-Portale rechnen teils mit 15-Minuten-Werten. Über Tage oder Monate gleicht sich das aus.

Gerät misst anders

Ein Shelly 3EM zählt Bezug und Einspeisung je Phase. Der Zähler des Netzbetreibers verrechnet die Phasen miteinander. Bei Einspeisung auf einer Phase und Bezug auf einer anderen weichen beide deshalb ab, auch wenn SourceAnalytix richtig rechnet.

Siehe auch: Zähler (kWh) oder Leistung (W)? · Was trage ich bei den Startwerten ein?

Wie rechnet SourceAnalytix Watt in kWh um?

Kurz: Mit jedem neuen Leistungswert rechnet SourceAnalytix die Energie seit dem vorigen Wert aus: vorige Leistung × Zeit seit dem vorigen Wert. Das ist eine linke Riemann-Summe. Mit „Mittelwert bei Leistung" nimmt es stattdessen den Mittelwert aus vorigem und neuem Wert. Die Energie wird in die Zieleinheit umgerechnet und zum Gesamtstand addiert.

Die Formel

Energie in Wh = Leistung in W × Zeit in Stunden. Ein Beispiel mit drei Werten:

Zeit	Wert	ohne Mittelwert	mit Mittelwert
10:00	0 W	Ausgangspunkt	Ausgangspunkt
10:30	1.000 W	0 W × 0,5 h = 0 Wh	500 W × 0,5 h = 250 Wh
11:00	1.000 W	1.000 W × 0,5 h = 500 Wh	1.000 W × 0,5 h = 500 Wh
Summe		500 Wh = 0,5 kWh	750 Wh = 0,75 kWh

Ohne Mittelwert passt die Rechnung zu Geräten, die abrupt schalten und nur bei einer Änderung senden. Mit Mittelwert passt sie zu Sensoren, deren Leistung gleichmäßig steigt und fällt und die regelmäßig senden.

Gerechnet wird nur bei einem neuen Wert

SourceAnalytix rechnet, sobald die Quelle einen Wert schreibt, auch wenn er gleich bleibt. Maßgeblich ist der Zeitstempel des Werts. Ein Gerät, das nur bei einer Änderung sendet, wird trotzdem richtig gerechnet: Der letzte Wert gilt, bis ein neuer kommt.

Pausen

• Erster Wert: Nach der Aktivierung, nach einem Neustart von SourceAnalytix und nach einer Änderung der Einstellungen ist der erste Wert nur der Ausgangspunkt. Die Energie der Pause davor fehlt.
• Lange Stille bei laufender Instanz: Kommt lange kein neuer Wert, rechnet SourceAnalytix den letzten Wert über die ganze Pause hoch. Ab v0.7.0 begrenzt „Maximale Lücke zwischen Leistungswerten (Minuten)" das. Längere Pausen zählen dann als 0 (#1266).
• Mitternacht: Ab v0.6.2 bucht SourceAnalytix die Energie bis 0:00 Uhr dem alten Tag zu und rechnet im neuen Tag mit demselben Wert weiter. Ein Wert, der älter ist als der Vortag, wird nicht hochgerechnet (#1254).
• Negative Werte: Mit „Negative Werte ignorieren" zählen sie als 0 W.

Für Leistungsquellen gibt es keine Reset-Erkennung und keine Startwerte zum Eintragen. Ihr Gesamtstand beginnt mit der Aktivierung bei 0.

Siehe auch: Zähler (kWh) oder Leistung (W)? · Kann SourceAnalytix aus Leistung Verbrauch berechnen?

Wie wird der Verbrauch berechnet – und warum ist currentYear niedriger als mein Zählerstand?

Kurz: Das ist so gewollt. currentYear.consumed.05_currentYear ist der Verbrauch dieses Jahres, nicht der Zählerstand: Gesamtstand minus Startwert „Jahr". Den Zählerstand selbst findest du in sourceanalytix.0.<Gerät>.cumulativeReading.

Für jede Periode gilt dieselbe Formel: Verbrauch = Gesamtstand − Startwert der Periode. Der Startwert ist der Gesamtstand zu Beginn der Periode. SourceAnalytix setzt ihn bei jedem Periodenwechsel selbst, zum Beispiel am 1. Januar um 0:00 Uhr für „Jahr".

	Wert
Gesamtstand (cumulativeReading)	12.480 kWh
Startwert „Jahr" (Gesamtstand am 1. Januar)	11.900 kWh
05_currentYear	580 kWh

Hast du SourceAnalytix erst im Laufe des Jahres aktiviert, ist der Startwert „Jahr" der Gesamtstand bei der Aktivierung. Das Jahr zählt dann ab diesem Tag. Soll es ab dem 1. Januar zählen, trägst du den Zählerstand vom 1. Januar als Startwert ein, siehe Was trage ich bei den Startwerten ein?.

Den Zählerstand am Ende jeder Periode speichert SourceAnalytix unter currentYear.meterReadings, wenn „Zählerstände speichern" an ist.

Siehe auch: Zählerstände je Periode (meterReadings) · Wo finde ich meine Werte?