Zum Hauptinhalt springen

Victron VRM Smart-Home-Integration, kostenlos und Open Source

Victron VRM-Integration für Gladys Assistant

Victron-Energy-Anlagen über VRM: Batterie, Solar, Netz, Alarme und Prognosen.

Auf GitHub ansehenAlle Integrationen

Überblick​

Diese Integration bringt die Victron-Energy-Anlagen deines VRM-Kontos (vrm.victronenergy.com) in Gladys, über die offizielle VRM-API und ein persönliches Zugriffstoken. Sie liest nur: Sie ändert nie eine Einstellung deiner Anlage. Sie ist nicht mit Victron Energy verbunden.

  • Ein Gerät pro Anlage: Batteriestand, Lade- und Entladeleistung der Batterie, Batteriespannung, Solarleistung und Solarerzeugung des Tages, Netzleistung (Bezug +, Einspeisung −), AC-Verbrauch und Verbrauch des Tages, Generatorleistung.
  • Vier Dashboard-Widgets: Energiefluss jetzt, heute (mit Stundendiagramm), die VRM-Prognose, die VRM-Alarme.
  • Szenenauslöser: VRM-Alarm ausgelöst oder beendet, Batterie schwach oder voll, Netzausfall oder Netz zurück, Anlage offline oder wieder online, Zugriff verweigert.
  • Szenenaktionen: die Energien von heute, die Solar- und Verbrauchsprognose für heute und morgen.

Transport: Cloud. Das Zugriffstoken geht an VRM (vrmapi.victronenergy.com), und die Daten deiner Anlagen kommen aus der Victron-Cloud, die sie vom GX-Gerät (Cerbo GX, Venus GX, Ekrano…) jeder Anlage erhält.

Voraussetzungen​

  • Gladys Assistant 5.1.0 oder neuer.
  • Eine Victron-Anlage mit einem GX-Gerät, das seine Daten an VRM sendet (sie erscheint auf vrm.victronenergy.com).
  • Ein VRM-Zugriffstoken: Öffne in VRM Preferences → Integrations → Access tokens (direkter Link), erstelle ein Token und kopiere es. Ein Token öffnet das ganze Konto (halte es geheim); die Integration liest damit nur.
  • Für die Prognosen: Solarmodule, der Standort der Anlage in VRM und etwa 30 Tage Verlauf (eine Regel von VRM).

Wie aktuell die Daten sind: VRM erhält die Daten einer Anlage im Log-Intervall ihres GX-Geräts (Einstellungen → VRM-Online-Portal → Log-Intervall; oft 15 Minuten, bestenfalls 1 Minute). VRM häufiger abzufragen bringt nichts Neues.

Konfiguration​

FeldBedeutung
ZugriffstokenDas in VRM erstellte Token (ein Geheimnis, nie wieder angezeigt und nie in die Logs geschrieben)
Abfrage der AnlagenAlle 1, 2, 5 (Standard), 10 oder 15 Minuten: eine Anfrage liest alle Anlagen des Kontos
Stand des Auslösers „Batterie schwach“10 bis 50 % (Standard 20 %)
Anlage offline nach30 Min., 1 Std. (Standard), 2 Std. oder 4 Std. ohne neue Daten in VRM
Sprache der TexteNamen der Funktionen, Szenentexte und Fehler; automatisch folgt der Sprache des letzten Widgets

Schaltflächen:

  • Verbindung testen prüft das Token und listet die Anlagen des Kontos mit der Zeit ihrer letzten Daten.
  • Diagnose schreibt den Zustand der Integration in ihre Logs, ohne das Token.

Nutzung​

Geräte​

Öffne Entdecken und füge deine Anlagen hinzu. Ein Anlagen-Gerät hat:

  • Batteriestand (%), Ladeleistung der Batterie und Entladeleistung der Batterie (W, beide positiv: VRM liefert Spannung und Strom, die Leistung ist ihr Produkt), Batteriespannung (V);
  • Solarerzeugung (W) und Solarerzeugung heute (kWh), wenn die Anlage Solar hat;
  • Netzleistung (W, positiv bei Bezug, negativ bei Einspeisung), wenn sie einen Netz- oder Landstromeingang hat;
  • AC-Verbrauch (W) und Verbrauch heute (kWh);
  • Generatorleistung (W), wenn VRM einen Generator angibt.

Keine dieser Funktionen wird als Verbrauch deines Hauses gezählt: Ein Linky oder ein anderer Zähler speist das Energie-Dashboard weiterhin allein, ohne doppelte Zählung. Erhält VRM während der Frist der Konfiguration nichts von einer Anlage, werden ihre Werte nicht mehr veröffentlicht (sie behalten in Gladys ihren letzten Wert und ihre Zeit).

Dashboard-Widgets​

Die vier Widgets: Energiefluss jetzt, heute mit Stundendiagramm, die VRM-Prognose, die VRM-Alarme (generierte Illustration, kein Screenshot)

  • Victron jetzt: Batteriestand, Solar, AC-Verbrauch, Netz (ins Netz oder aus dem Netz), Batterie (lädt oder entlädt), Generator, wenn er läuft; der Zustand des Systems, die Batteriespannung, die aktiven Alarme und wann VRM zuletzt Daten erhalten hat.
  • Victron heute: Solar, Verbrauch, Netzbezug und Einspeisung des Tages, Autarkie, ein Stundendiagramm von Solarertrag und Verbrauch, die geladene und entladene Batterieenergie.
  • Victron-Prognose: der heute erwartete Solarertrag, was noch kommt, morgen, der morgen erwartete Verbrauch und ihr Stundendiagramm.
  • Victron-Alarme: das VRM-Alarmprotokoll, aktive Alarme zuerst, dann die zuletzt beendeten.

Wähle die Anlage in den Einstellungen des Widgets (leer: die erste).

Szenen​

Auslöser (einmal pro Änderung, nie bei der ersten Abfrage):

  • Victron VRM: Alarm ausgelöst / Alarm beendet: ein Eintrag des VRM-Alarmprotokolls (Batterie schwach, Netzausfall, Überlast, hohe Temperatur, Wechselrichterfehler…). Variablen: der Alarmtext, das Victron-Gerät, Beginn und Ende, die Dauer.
  • Victron VRM: Batterie schwach: Die Batterie erreicht den Stand der Konfiguration (erneut nach 5 Punkten mehr). Batterie voll: 100 % (erneut nach unter 95 %).
  • Victron VRM: Netzausfall / Netz zurück: der Netzalarm des Systems (Netz- oder Landstrom).
  • Victron VRM: Anlage offline / wieder online: keine neuen Daten in VRM während der Frist der Konfiguration.
  • Victron VRM: Zugriff verweigert: VRM lehnt das Token ab (widerrufen, abgelaufen oder falsch).

Aktionen:

  • Victron VRM: Energien von heute: Solar, Verbrauch, Bezug, Einspeisung, Batterie geladen und entladen, Generator, Autarkie, Batteriestand und ein Satz, aus den letzten Abfragen (ohne Anfrage).
  • Victron VRM: Solarprognose: Solar heute, heute noch erwartet, morgen, Verbrauch heute und morgen (kWh), und ein Satz.

Beispiele:

  • Wenn Victron VRM: Netzausfall → eine Benachrichtigung „Stromausfall, Batterie bei {{triggerEvent.data.battery_level}} %“ senden und die Heizungen am Wechselrichter ausschalten.
  • Jeden Abend um 21:00 → Victron VRM: Solarprognose; wenn Solar morgen unter 5 kWh liegt → den Warmwasserbereiter heute Nacht im Niedertarif einschalten.
  • Wenn Victron VRM: Alarm ausgelöst → eine Benachrichtigung mit {{triggerEvent.data.description}} senden.

Fehlerbehebung​

  • „VRM lehnt das Zugriffstoken ab“: Das Token wurde gelöscht oder falsch kopiert. Erstelle in VRM ein neues und füge es erneut ein (mit oder ohne das Präfix Token ).
  • Keine Anlage: Das Token gehört zu einem Konto, das keine Anlage sieht; prüfe es auf vrm.victronenergy.com mit demselben Konto.
  • Werte, die sich nur alle 15 Minuten ändern: VRM selbst erhält die Daten im Log-Intervall des GX-Geräts; senke es bei Bedarf am GX-Gerät (1 Minute).
  • „Keine Prognose“: VRM braucht Solarmodule, den Standort der Anlage und etwa 30 Tage Verlauf.
  • Kein Alarmprotokoll: Manchen Konten (geteilte Anlagen, niedrige Zugriffsstufe) kann das Protokoll verweigert werden; das Widget zeigt es an, und es wird einmal pro Tag erneut angefragt.
  • „VRM bittet um weniger Anfragen“: VRM hat 429 geantwortet; die Integration wartet die von VRM genannte Zeit (Retry-After) ab und macht dann von selbst weiter.
  • Drücke Diagnose und sieh dir die Logs der Integration an (ohne Token). Melde einen Fehler auf GitHub mit den Versionen von Gladys und der Integration und den Logs mit DEBUG=gladys-integration-sdk.

Konfigurationseinstellungen​

Diese Einstellungen fragt Victron VRM in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
VRM-ZugriffstokensectionNeinMelde dich bei vrm.victronenergy.com an, öffne Preferences → Integrations → Access tokens, erstelle ein Token und füge es unten ein. Ein Token öffnet das ganze Konto (halte es geheim); diese Integration liest nur. Die Daten laufen über die Victron-Cloud. Diese Integration ist nicht mit Victron Energy verbunden.
ZugriffstokensecretJa
Abfragen und AuslösersectionNeinVRM erhält die Daten einer Anlage im Log-Intervall ihres GX-Geräts (Einstellungen → VRM-Online-Portal → Log-Intervall, oft 15 Minuten): Häufiger abzufragen bringt nichts Neues.
Abfrage der AnlagenselectNeinWie oft die letzten Werte aller Anlagen gelesen werden (eine Anfrage für alle).
Stand des Auslösers „Batterie schwach“selectNein
Anlage offline nachselectNeinOhne neue Daten in VRM so lange ist die Anlage offline (Auslöser, Widgets) und ihre Werte werden nicht mehr veröffentlicht.
Sprache der TexteselectNeinNamen der Funktionen, Szenentexte und Fehler. Automatisch: die Sprache des zuletzt angezeigten Widgets.

So installierst du Victron VRM in Gladys​

  1. Öffne in Gladys Integrationen: Victron VRM erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/william-de71/gladys-victron-vrm:0.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-victron-vrm.

Victron VRM benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Victron VRM ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am