Suche

    Tesla Energiespeicher (Lokal)

    Dokumentation direkt aus GitHub Wilkware/TeslaPowerwall ↗

    Version Product Version License Actions

    Das Modul bietet die Möglichkeit, mit einer Tesla Powerwall (Energiespeicher) über die lokale Netzwerk-API zu kommunizieren.

    1. Funktionsumfang

    • Anmeldung am Tesla Gateway über die lokale API (Kunden-Zugang)
    • Auswahl verschiedener API-Endpunkte, deren gelieferte Daten in Statusvariablen gespeichert werden
    • Automatische Darstellungen (Einheit, Icon) anhand der Datennamen, z.B. Leistung in W, Energie in kWh, Netzstatus als Text
    • Wählbares Namensformat und Einheit der Energiewerte (Wh oder kWh), bestehende Variablen per Knopfdruck anpassbar
    • Zyklische Aktualisierung der Daten in einstellbarem Intervall
    • Automatische Neuanmeldung bei abgelaufener Sitzung oder nach zeitweise nicht erreichbarem Gateway
    • Testfunktionen (Anmelden, Abmelden, Status) im Aktionsbereich der Konfiguration

    Eine Beschreibung der Daten pro Endpunkt kann man hier nachlesen (https://github.com/vloschiavo/powerwall2 ), die Einheiten der Werte sind in https://github.com/jrester/tesla_powerwall dokumentiert.
    Die Anzahl an auswählbaren Endpunkten wird sukzessive erweitert.

    EndpunktInhalt
    /meters/aggregatesMomentane Messwerte (Netz, Batterie, Verbrauch, Solar)
    /meters/siteDetails zum Netzzähler
    /meters/solarDetails zum Solarzähler
    /site_infoStandort, Netz und Nenndaten der Anlage
    /system_statusBatterien und Wechselrichter (ohne Netzfehler-Historie)
    /system_status/soeLadezustand in Prozent
    /system_status/grid_statusNetzstatus (verbunden oder Inselbetrieb)
    /operationBetriebsmodus und Backup-Reserve
    /sitemasterZustand des Site Masters (läuft, mit Tesla verbunden)

    Hinweis: Bei der Powerwall 3 ist die lokale API stark eingeschränkt, viele Endpunkte liefern dort keine Daten.

    2. Voraussetzungen

    • Symcon ab Version 8.1
    • Tesla Powerwall (Gateway) im lokalen Netzwerk erreichbar
    • Zugangsdaten des Kunden-Kontos (Customer) für die lokale Weboberfläche des Gateways

    3. Installation

    • Über den Modul Store das Modul Tesla Energiespeicher (Lokal) installieren.
    • Alternativ über das Modul Control folgende URL hinzufügen.
      https://github.com/Wilkware/TeslaPowerwall oder git://github.com/Wilkware/TeslaPowerwall.git

    4. Einrichtung

    • Unter ‘Instanz hinzufügen’ ist das Tesla Energiespeicher (Lokal)-Modul (Alias: Tesla Powerwall, Powerwall Gateway) unter dem Hersteller ‘Tesla’ aufgeführt.

    Konfigurationsseite:

    Einstellungsbereich:

    🔑 Konto-Informationen …

    NameBeschreibung
    Kunden eMailRegistrierte Mail-Adresse (Kunde/Customer)
    Kunden KennwortHinterlegtes Kennwort

    📡 Geräteinformationen …

    NameBeschreibung
    IP-AdresseLokale IP-Adresse des Tesla Gateways/Powerwall

    📊 Auswahl der Daten …

    NameBeschreibung
    API-EndpunkteListe der aktuell auswählbaren und abrufbaren Daten-Endpunkte (Abfrage aktiv, Variablen wiederherstellen)
    Dokumentation der EndpunkteLink zur Beschreibung der Endpunkte
    AktualisierungsintervallZeitspanne in Sekunden für die wiederkehrende Aktualisierung (0 = aus, mindestens 10 Sekunden, maximal 24 Stunden)

    ⚙️ Erweiterte Einstellungen …

    NameBeschreibung
    Namensformat neuer VariablenOriginal (site_instant_power), Großbuchstaben (SITE_INSTANT_POWER), CamelCase (SiteInstantPower) oder Lesbar (Site Instant Power)
    Neue Energievariablen in kWh statt Wh anlegenEnergiewerte neuer Variablen in kWh umrechnen (Standard bei neuen Instanzen), bestehende Instanzen bleiben bei Wh

    Beide Einstellungen gelten nur für neu angelegte Variablen, bestehende Variablen werden über den Aktionsbereich angepasst.

    Aktionsbereich:

    🧪 Test …

    AktionBeschreibung
    AnmeldenAm Gateway anmelden (Login)
    AbmeldenVom Gateway abmelden, die Aktualisierung wird angehalten
    StatusZeigt einige Statusinformationen des Gateways (kein Login notwendig)

    🛠️ Variablen …

    AktionBeschreibung
    NamensformatBenennt die Variablen in das gespeicherte Namensformat um. Selbst vergebene Namen bleiben erhalten.
    DarstellungenSetzt die Darstellungen aller Variablen nachträglich entsprechend der Regeln (siehe Darstellungen). Eigene Darstellungen an der Variable haben weiterhin Vorrang.
    In kWh umstellenStellt bestehende Energievariablen von Wh auf kWh um. Nur sichtbar bei aktivierter kWh-Einstellung und umstellbaren Variablen (Typ Float, nicht im Archiv geloggt). Im Archiv geloggte Variablen und Variablen vom Typ Integer bleiben in Wh.

    5. Statusvariablen

    Die Statusvariablen werden entsprechend den ausgewählten Endpunkten automatisch angelegt. Die Namen ergeben sich aus dem Präfix des Endpunktes und den Schlüsseln der Antwort (verschachtelte Objekte mit _ verbunden), die Idents sind die gleichen Namen in Kleinbuchstaben.
    Zahlen werden als Float angelegt, Wahrheitswerte als Boolean und alles andere als String. Variablen aus früheren Versionen behalten ihren Typ.
    Die Netzfehler-Historie (grid_faults) wird nicht in Variablen übernommen, da sie als Liste ständig wächst.

    Hinweis: Vorsicht, es werden schnell viele Variablen! Gelöschte Variablen werden nur wieder angelegt, wenn für den Endpunkt Wiederherstellen aktiviert ist.

    Beispiele:

    IdentNameTypBeschreibung
    site_instant_powerSITE_INSTANT_POWERFloatMomentane Leistung Netz (/meters/aggregates)
    battery_instant_powerBATTERY_INSTANT_POWERFloatMomentane Leistung Batterie (/meters/aggregates)
    load_instant_powerLOAD_INSTANT_POWERFloatMomentane Leistung Verbrauch (/meters/aggregates)
    solar_instant_powerSOLAR_INSTANT_POWERFloatMomentane Leistung Solar (/meters/aggregates)
    percentagePERCENTAGEFloatLadezustand in Prozent (/system_status/soe)
    site_energy_exportedSITE_ENERGY_EXPORTEDFloatIns Netz eingespeiste Energie (/meters/aggregates)
    grid_statusGRID_STATUSStringNetzstatus (/system_status/grid_status)
    real_modeREAL_MODEStringBetriebsmodus (/operation)
    backup_reserve_percentBACKUP_RESERVE_PERCENTFloatBackup-Reserve in Prozent (/operation)

    6. Darstellungen

    Beim Anlegen einer Variable wird die Darstellung anhand des Datennamens bestimmt (die erste passende Regel gilt). Variablen ohne passende Regel erhalten eine Wertanzeige mit Info-Icon.

    Variable (Namensmuster)DarstellungWerte
    …_kWhWertanzeigekWh, 2 Nachkommastellen
    …_kWWertanzeigekW, 1 Nachkommastelle
    …reactive_power, q_outWertanzeigevar
    …apparent_powerWertanzeigeVA
    …_power, p_outWertanzeigeW
    …energy…WertanzeigeWh bzw. kWh (2 Nachkommastellen), je nach Einstellung
    …voltage, v_outWertanzeigeV, 1 Nachkommastelle
    …_current, i_outWertanzeigeA, 2 Nachkommastellen
    …frequency, f_outWertanzeigeHz, 2 Nachkommastellen
    percentage, …_percentWertanzeige%, 1 Nachkommastelle
    grid_statusWertanzeigeVerbunden, Inselbetrieb bereit, Inselbetrieb, Wechsel zum Netz, Wechsel in den Inselbetrieb, Warten auf Benutzer
    real_modeWertanzeigeEigenverbrauch, Backup, Zeitbasierte Steuerung, Zeitplan, Standortsteuerung

    7. Visualisierung

    Es ist keine weitere Steuerung oder gesonderte Darstellung integriert.

    8. Befehlsreferenz

    Das Modul stellt keine direkten Funktionsaufrufe zur Verfügung.

    9. Versionshistorie

    v2.0.20261028

    • NEU: Kompatibilität auf Symcon 8.1 hoch gesetzt
    • NEU: Konfigurationsformular auf Standard-Struktur umgestellt, Testfunktionen im Aktionsbereich
    • NEU: Automatische Neuanmeldung bei abgelaufener Sitzung und nach zeitweise nicht erreichbarem Gateway
    • NEU: Neue Status für „Gateway nicht erreichbar“ und „Anmeldung nicht erfolgreich“
    • NEU: Authentifizierung über Token statt Cookie-Datei, Einstellung „Lebensdauer der Cookies“ entfällt
    • NEU: Zahlen werden als Float angelegt (bestehende Variablen behalten ihren Typ)
    • NEU: API-Endpunkte hinzugefügt (/system_status/grid_status, /operation, /sitemaster)
    • NEU: Automatische Darstellungen (Einheit, Icon) für neue Variablen anhand der Datennamen
    • NEU: Namensformat wählbar (Original, Großbuchstaben, CamelCase, Lesbar), ersetzt die Großbuchstaben-Option
    • NEU: Energiewerte wahlweise in kWh, Umstellung bestehender Variablen per Knopfdruck
    • NEU: Umbenennen bestehender Variablen in das gewählte Namensformat per Knopfdruck
    • NEU: Darstellungen nachträglich auf bestehende Variablen anwenden per Knopfdruck
    • NEU: Aktualisierungsintervall in Sekunden (bestehende Einstellung wird automatisch umgerechnet)
    • NEU: Netzfehler-Historie (grid_faults) wird nicht mehr als Variablen angelegt
    • NEU: Timeouts für die Anfragen an das Gateway
    • NEU: Anmeldung erst nach vollständigem Systemstart
    • FIX: Statusabfrage führte zu einem Fehler
    • FIX: Fehlermeldungen des Gateways wurden als Statusvariablen angelegt
    • FIX: Kennwort wurde im Debug ausgegeben
    • FIX: Öffnen der Konfiguration überschrieb den Instanzstatus
    • FIX: Kennwortvalidierung im Formular entfernt
    • FIX: Fehlende Übersetzungen ergänzt
    • FIX: Dokumentation überarbeitet
    • FIX: Interne Bibliotheken aktualisiert

    v1.4.20240528

    • FIX: Kennwortvalidierung entfernt, keine klare Vorschrift in Abhängigkeit der eingespielten Firmware

    v1.3.20240318

    • NEU: API-Endpunkt hinzugefügt (/system_status)
    • FIX: Dokumentation überarbeitet
    • FIX: Interne Bibliotheken überarbeitet
    • FIX: Internes Deployment überarbeitet

    v1.2.20240128

    • NEU: API-Endpunkt hinzugefügt (/meters/site und /meters/solar)
    • NEU: Liste wird jetzt sortiert nach Endpunkt-Spalte
    • NEU: Interne Präfix-Einstellung pro Endpunkt

    v1.1.20240126

    • FIX: Kennwörter können jetzt aus Großbuchstaben, Kleinbuchstaben und Zahlen bestehen
    • NEU: API-Endpunkt hinzugefügt (/system_status/soe)
    • NEU: Wiedeherstellungsoption für Variablen (Reregister) pro Endpunkt
    • NEU: Button/Link zu Endpunkte-Dokumentation hinzugefügt

    v1.0.20240121

    • NEU: Initialversion

    Entwickler

    Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti ;-)

    GitHub

    Spenden

    Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.

    PayPal

    Lizenz

    Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International

    Licence