Prüfung Pulse-Funktionalität mittels Tibber API-Explorer

Einleitung

Diese kurze Anleitung beschreibt, wie man ohne Nutzung der Tibber-App prüfen kann, ob und welche Daten des Stromzählers der Tibber Pulse (Auslesegerät für den digitale Stromzähler) an die Tibber-Server übermittelt.

Dies kann aus mehreren Gründen vorteilhaft sein:

Die Tibber-App hat zeitweise Probleme in der Darstellung der Echtzeitdaten. Somit lässt in solchen Fällen nicht erkennen, ob das Problem in der App oder am heimischen Zähler bzw. Pulse liegt.
Während einer eventuell erforderlichen Feinjustierung des Pulse sieht man über die Echtzeitdaten im API schneller die Wirkung der Justierung.
Da über das API alle von Tibber unterstützten Werte abgerufen werden, kann man sehen ob und welche Daten vom jeweiligen Zähler unterstützt werden (z.b. Strom/Spannung pro Phase nicht bei jedem Zähler).

Ich übernehme keine Garantie für die Korrektheit aller Angaben und Beispiele.

Vorausetzungen

Aktiver Tibber-Zugang (Vertrag muss noch nicht aktiv sein)
Ein Tibber-Pulse-Gerät und ein kompatibler Zähler (siehe Tibber-Whitelist)
Ein wenig (aber nicht viel) technisches Verständnis
Der Tibber-Pulse sollte (potentiell..das wollen wir hier ja testen) bereits über die Bridge gemäß Anleitung verbunden sein

Vorgehen

Tibber Entwickler-Portal aufrufen

Öffne das Tibber Entwickler-Portal und melde dich dort mit deinen Tibber-Zugangsdaten an.
Gehe nach erfolgreicher Anmeldung in den Bereich Authorization - Access Token (evtl. öffnet sich die Seite nach der Anmeldung bereits dort).
Dort wird dir unter Access Token eine lange Zeichenfolge angezeigt. Es handelt sich um deinen persönlichen "Schlüssel" zum Zugriff auf deine Daten. Kopiere diesen Schlüssel und speichere ihn an einer sicheren Stelle.
ACHTUNG: Der Token ist vertraulich und sollte wie ein Passwort behandelt und niemals weitergegeben werden!
Wechsele oben im Seitenmenü auf den API Explorer.

Abrufen deiner Echtzeit-Zählerdaten (Basisdaten)

Im ersten Schritt beschreibe ich den Abruf der wichtigsten Zählerdaten (u.a. aktueller Verbrauch), welche sehr einfach mittels API-Explorer möglich ist.

Füge in das Feld Access Token deinen vorher erhaltenen persönlichen Token ein (bzw. klick auf die Schaltfläche Load personal token um diesen einzufügen).
Wähle rechts auf der Schaltfläche Load an example query die Abfrage Real Time Subscription. Es erscheint nun im linken großen Feld die gewählte Beispielabfrage.
Diese Beispielabfrage kannst du direkt für die Datenabfrage nutzen, indem du links auf den grahischen Play-Knopf drückst.
Es sollte im rechten Fenster für kurze Zeit "Your subscription data will appear here after server publication" angezeigt werden. Dies wird nach kurzer Zeit durch die kontinuierliche Ausgabe der aktuellen Echtzeitdaten ersetzt.

Abrufen deiner Echtzeit-Zählerdaten (kompletter Datensatz)

Alternativ kannst du die Abfrage anpassen, um alle im API verfügbaren Echtzeitdaten abzurufen. Es hängt dabei vom Modell deines Stromzählers ab, welche Werte konkret unterstützt werden und wie oft diese aktualisiert werden.

Kopiere dir die HomeID aus der im linken Fenster angezeigten Beispielabfrage und speichere sie zwischen.
Kopiere nun die unten dargestellte Abfrage in das linke Feld des API-Explorer und setze statt Deine Home-ID deine individuelle, im letzten Schritt gespeicherte HomeID ein (mit Anführungszeichen an Anfang und Ende).

subscription{
  liveMeasurement(homeId:"Deine Home-ID"){
    timestamp
    power
    powerProduction
    minPower
    averagePower
    maxPower
    maxPowerProduction
    currentL1
    currentL2
    currentL3
    voltagePhase1
    voltagePhase2
    voltagePhase3
    accumulatedConsumption
    accumulatedProduction
    lastMeterConsumption
    lastMeterProduction 
  }
}

Starte die Abfrage über den graphischen Play-Knopf.
Es sollte im rechten Fenster für kurze Zeit "Your subscription data will appear here after server publication" angezeigt werden. Dies wird nach kurzer Zeit durch die kontinuierliche Ausgabe der aktuellen Echtzeitdaten ersetzt.

Erklärung der Ausgabewerte

Bezeichnung API	Erklärung	Beispiel
timestamp	Datum und Uhrzeit des angezeigten Datensatzes	2023-06-21T19:40:31.000+02:00
power	Aktuelle Verbrauchsleistung (Watt) Hinweis: Bei Einspeisung ist dieser Wert 0, da die Einspeiseleistung getrennt ausgegeben wird (siehe nächster Eintrag)	250.6
powerProduction	Aktuelle Einspeiseleistung, z.B. PV-Produktion (Watt)	125.9
minPower	Minimale gemessene Verbrauchsseistung des aktuellen Tages (Watt)	25
averagePower	Durchschnitt der gemessenen Leistung des aktuellen Tages (Watt)	567.5
maxPower	Maximal gemessene Verbrauchsleistung des aktuellen Tages (Watt)	2799.43
maxPowerProduction	Maximal gemessene Verbrauchsleistung des aktuellen Tages (Watt)	682.5
currentL1	Aktueller Strom auf Phase L1 (nicht von allen Zählern unterstützt) (Ampere)	3.4
currentL2	Aktueller Strom auf Phase L2 (nicht von allen Zählern unterstützt) (Ampere)	2.6
currentL3	Aktueller Strom auf Phase L3 (nicht von allen Zählern unterstützt) (Ampere)	-2.5
voltagePhase1	Aktuelle Spannung auf Phase L1 (nicht von allen Zählen unterstützt) (Volt)	234.5
voltagePhase2	Aktuelle Spannung auf Phase L2 (nicht von allen Zählen unterstützt) (Volt)	236.1
voltagePhase3	Aktuelle Spannung auf Phase L3 (nicht von allen Zählen unterstützt) (Volt)	233.9
accumulatedConsumption	Summe des Energieverbrauchs des aktuellen Tages (kWh)	7.658
accumulatedProduction	Summe der eingespeisten Energie des aktuellen Tages (kWh)	1.5147
lastMeterConsumption	Zuletzt vom Zähler gemeldeter Zählerstand der verbrauchten Energie (OBIS: 1.8.0) (kWh)	234.321
lastMeterProduction	Zuletzt vom Zähler gemeldeter Zählerstand der eingespeisten Engerie (OBIS: 2.8.0) (kWh)	120.30245

Lineflyer/tibber_API_pulse_verify.md