Tesla Energiespeicher (Lokal)
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.
| Endpunkt | Inhalt |
|---|---|
| /meters/aggregates | Momentane Messwerte (Netz, Batterie, Verbrauch, Solar) |
| /meters/site | Details zum Netzzähler |
| /meters/solar | Details zum Solarzähler |
| /site_info | Standort, Netz und Nenndaten der Anlage |
| /system_status | Batterien und Wechselrichter (ohne Netzfehler-Historie) |
| /system_status/soe | Ladezustand in Prozent |
| /system_status/grid_status | Netzstatus (verbunden oder Inselbetrieb) |
| /operation | Betriebsmodus und Backup-Reserve |
| /sitemaster | Zustand 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/TeslaPowerwallodergit://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 …
| Name | Beschreibung |
|---|---|
| Kunden eMail | Registrierte Mail-Adresse (Kunde/Customer) |
| Kunden Kennwort | Hinterlegtes Kennwort |
📡 Geräteinformationen …
| Name | Beschreibung |
|---|---|
| IP-Adresse | Lokale IP-Adresse des Tesla Gateways/Powerwall |
📊 Auswahl der Daten …
| Name | Beschreibung |
|---|---|
| API-Endpunkte | Liste der aktuell auswählbaren und abrufbaren Daten-Endpunkte (Abfrage aktiv, Variablen wiederherstellen) |
| Dokumentation der Endpunkte | Link zur Beschreibung der Endpunkte |
| Aktualisierungsintervall | Zeitspanne in Sekunden für die wiederkehrende Aktualisierung (0 = aus, mindestens 10 Sekunden, maximal 24 Stunden) |
⚙️ Erweiterte Einstellungen …
| Name | Beschreibung |
|---|---|
| Namensformat neuer Variablen | Original (site_instant_power), Großbuchstaben (SITE_INSTANT_POWER), CamelCase (SiteInstantPower) oder Lesbar (Site Instant Power) |
| Neue Energievariablen in kWh statt Wh anlegen | Energiewerte 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 …
| Aktion | Beschreibung |
|---|---|
| Anmelden | Am Gateway anmelden (Login) |
| Abmelden | Vom Gateway abmelden, die Aktualisierung wird angehalten |
| Status | Zeigt einige Statusinformationen des Gateways (kein Login notwendig) |
🛠️ Variablen …
| Aktion | Beschreibung |
|---|---|
| Namensformat | Benennt die Variablen in das gespeicherte Namensformat um. Selbst vergebene Namen bleiben erhalten. |
| Darstellungen | Setzt die Darstellungen aller Variablen nachträglich entsprechend der Regeln (siehe Darstellungen). Eigene Darstellungen an der Variable haben weiterhin Vorrang. |
| In kWh umstellen | Stellt 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:
| Ident | Name | Typ | Beschreibung |
|---|---|---|---|
| site_instant_power | SITE_INSTANT_POWER | Float | Momentane Leistung Netz (/meters/aggregates) |
| battery_instant_power | BATTERY_INSTANT_POWER | Float | Momentane Leistung Batterie (/meters/aggregates) |
| load_instant_power | LOAD_INSTANT_POWER | Float | Momentane Leistung Verbrauch (/meters/aggregates) |
| solar_instant_power | SOLAR_INSTANT_POWER | Float | Momentane Leistung Solar (/meters/aggregates) |
| percentage | PERCENTAGE | Float | Ladezustand in Prozent (/system_status/soe) |
| site_energy_exported | SITE_ENERGY_EXPORTED | Float | Ins Netz eingespeiste Energie (/meters/aggregates) |
| grid_status | GRID_STATUS | String | Netzstatus (/system_status/grid_status) |
| real_mode | REAL_MODE | String | Betriebsmodus (/operation) |
| backup_reserve_percent | BACKUP_RESERVE_PERCENT | Float | Backup-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) | Darstellung | Werte |
|---|---|---|
…_kWh | Wertanzeige | kWh, 2 Nachkommastellen |
…_kW | Wertanzeige | kW, 1 Nachkommastelle |
…reactive_power, q_out | Wertanzeige | var |
…apparent_power | Wertanzeige | VA |
…_power, p_out | Wertanzeige | W |
…energy… | Wertanzeige | Wh bzw. kWh (2 Nachkommastellen), je nach Einstellung |
…voltage, v_out | Wertanzeige | V, 1 Nachkommastelle |
…_current, i_out | Wertanzeige | A, 2 Nachkommastellen |
…frequency, f_out | Wertanzeige | Hz, 2 Nachkommastellen |
percentage, …_percent | Wertanzeige | %, 1 Nachkommastelle |
grid_status | Wertanzeige | Verbunden, Inselbetrieb bereit, Inselbetrieb, Wechsel zum Netz, Wechsel in den Inselbetrieb, Warten auf Benutzer |
real_mode | Wertanzeige | Eigenverbrauch, 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 ;-)
Spenden
Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.
Lizenz
Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International