Zum Hauptinhalt springen Zur Suche springen Zum Menü springen

Andere Victron-Anlage in IoBroker einbinden

#1

Hallo,

weiß jemand wie es Möglich ist eine andere Victron-Anlage in IoBroker einzubinden, die an einem anderen Standort steht?

Kann man die Daten aus dem VRM-Portal an IoBoker senden? Das wäre natürlich dann einfach.

Ich möchte eigentlich kein VPN dafür nutzen. Ich schalte mich Gelegentlich mit dem Handy über Wireguard auf meinen IoBroker. Aber wie würde es über VPN funktionieren? Wäre es eine VPN-Verbindung zwischen zwei IoBroker. Läuft dafür eine VPN-Instanz auf dem IoBroker.

Wäre über Ideen dankbar. Vielleicht kennst sich damit jemand aus.

#2

Hallo,
ja, du kannst eine Victron-Anlage an einem anderen Standort problemlos in ioBroker einbinden. Je nachdem, ob du nur Daten lesen oder auch Werte setzen möchtest, gibt es unterschiedliche Wege.

Wenn du nur die Werte brauchst, ist das VRM-Portal am einfachsten. Über die VRM-API kannst du die kompletten Daten der Anlage abfragen, ganz ohne VPN oder Portfreigaben. Du musst dir im VRM einfach einen API-Token erstellen und die Daten dann in ioBroker abrufen.

Wenn du zusätzlich Geräte steuern möchtest, solltest du MQTT verwenden. Mit einem WireGuard-VPN funktioniert das sehr gut. Die entfernte Victron-Anlage verbindet sich dann über VPN auf deinen MQTT-Broker im ioBroker. Damit bekommst du alle Live-Daten und kannst auch Werte setzen.

Kurzfassung
VRM-API → einfach, aber nur lesen
MQTT über VPN → volle Kontrolle und Live-Daten

#3

Jo, dann wurde ich erstmal die VRM API nehmen. Geht mir erstmal nur darum die Anlage von meinen Vater dann zu "überwachen" zu können, außerhalb der HandyApp.

#4

Dann reicht ja erstmal die VRM API. Wenn du fragen hast dazu, gerne melden. Manchmal ist da nicht immer alles schlüssig ☺

· bearbeitet #5

Hallo Dennis, wollte mich jetzt mal mit der VRM API beschäftigen. Für den IoBroker brauche ich den Adapter "simple-api"? Ich denke ein andere passt nicht.

Habe jetzt das

github.com/ioBroker/AdapterRequests/issues/168

dazu gefunden. Werde ich mir mal die kommenden Tage anschauen.

#6

Der Adapter simple-api stellt ioBroker States per REST zur Verfügung, damit man von außen auf ioBroker zugreifen kann. Er ist also ein Server.
Für die VRM API brauchst du aber einen Client, der Daten von Victron abruft.

Für die VRM API hast du diese Möglichkeiten:

  1. Javascript Adapter Dort kannst du per http request oder z.B. mit axios direkt die VRM REST API aufrufen. Das ist flexibel und für dein Vorhaben meist die beste Lösung.
  2. HTTP Request über Blockly Falls du nicht programmieren möchtest, kannst du im Javascript Adapter auch Blockly mit HTTP Requests nutzen.
  3. Externer Service Alternativ kannst du die Daten extern abrufen und per MQTT oder REST nach ioBroker schieben. Das macht aber nur Sinn, wenn du ohnehin eine externe Logik betreibst.

Du brauchst keinen simple api Adapter.
Du brauchst einen Weg, HTTP Requests an die VRM API zu senden, typischerweise über den Javascript Adapter.

Beispiel:

// ============================
// Einstellungen
// ============================

const VRM_PORTAL_ID = 'DEIN_PORTAL_ID';       // z.B. c123456789ab
const VRM_TOKEN     = 'DEIN_API_TOKEN';       // Personal Access Token

// Zeitraum: letzte 15 Minuten
const end   = Math.floor(Date.now() / 1000);
const start = end - (15 * 60);

// ============================
// HTTP Request
// ============================

const axios = require('axios');

const url = `https://vrmapi.victronenergy.com/v2/installations/${VRM_PORTAL_ID}/stats?type=live_feed`;

axios.get(url, {
    headers: {
        'X-Authorization': 'Bearer ' + VRM_TOKEN
    }
})
.then(response => {

    // Beispiel: AC Last
    const acLoad = response.data.records?.ac_consumption?.power;

    // Beispiel: PV Leistung
    const pvPower = response.data.records?.solar_yield?.power;

    log('PV Leistung: ' + pvPower + ' W');
    log('AC Last: ' + acLoad + ' W');

    // Optional: in States schreiben
    setState('0_userdata.0.VRM.PV_Power', pvPower, true);
    setState('0_userdata.0.VRM.AC_Load', acLoad, true);

})
.catch(error => {
    log('VRM Fehler: ' + error, 'error');
});

Optional: States vorher anlegen

Einmalig im Script ergänzen:

createState('0_userdata.0.VRM.PV_Power', 0, {type: 'number'});
createState('0_userdata.0.VRM.AC_Load', 0, {type: 'number'});

Automatisch alle 60 Sekunden abrufen

schedule('*/1 * * * *', function () {
    // hier die axios Abfrage rein
});

• Portal ID ist nicht die Seriennummer, sondern die VRM Installation ID
• Der Token wird nur einmal erzeugt und danach sicher speichern
• VRM API ist rate-limitiert, also nicht sekündlich pollen
• Für Live Werte funktioniert type=live_feed gut

#7

Vielen Dank Dennis,

Javascript bin ich raus. Dann kommt für mich die 2. Lösung (HTTP Request über Blockly) in Frage.

Also für die andere PV-Anlage habe ich schon einen Mini-PC aufgesetzt, mit IoBroker, InfluxDB, Grafana und Wireguard kommt noch.

Mir geht es primär darum Alarme zu bekommen und etwas die Leistung der einzelnen Strings zu sehen.

#8

Falls du noch weitere Probleme hast, gerne melden. Das ist genau meine Spielwiese 😆

#9

Kannst du mir ein Beispiel erstellen, wie ich mich mit Blockly bei der Victron VRM Api anmelde und Daten auslese z.B. den Akkustand SoC?

Ich bekomme das nicht hin.

Grüße Christian

#10

Hi Christian

hier ist die Version, die du wirklich 1 zu 1 kopieren kannst. Das ist als kompletter Premium Post geschrieben, also inklusive sauberem Ablauf, Tests, Beispielcode und am Ende ein Gesamtbeispiel, das direkt läuft.

Wichtig vorab
Für langfristige Integrationen nimm bitte immer ein Personal Access Token aus dem VRM Portal. Dann musst du nicht mit Benutzername Passwort arbeiten und nichts läuft nach kurzer Zeit ab. Victron beschreibt dafür den Header x authorization. (vrm-api-docs.victronenergy.com)

Ziel
Du willst am Ende den Akku SoC aus VRM lesen und in Blockly weiterverwenden.

Teil A
Token und Installation ID sauber holen

Schritt 1
Personal Access Token erstellen

1 Log dich im VRM Portal ein
2 Geh auf Settings
3 Dann Integrations
4 Dann Access Tokens
5 Create token
6 Name vergeben zum Beispiel blockly
7 Speichern
8 Token kopieren und sicher ablegen

Den Token bitte niemals öffentlich posten.

Schritt 2
Installation ID finden

1 Öffne im VRM Portal deine Anlage
2 Schau in die URL im Browser

Die sieht ungefähr so aus

https://vrm.victronenergy.com/installation/123456/dashboard

Die Zahl 123456 ist deine Installation ID.

Teil B
Erster Test ohne Blockly
damit du sofort weißt ob Token und Installation ID stimmen

Schritt 3
API Call testen mit curl

Ersetze DEIN_TOKEN und DEINE_INSTALLATION_ID und führe das aus

curl -s \
  -H "X-Authorization: Token DEIN_TOKEN" \
  "https://vrmapi.victronenergy.com/v2/installations/DEINE_INSTALLATION_ID/system-overview"

Wenn alles passt, kommt JSON zurück.

Wenn 401 kommt
Token ist falsch oder Header ist falsch

Wenn 404 kommt
Installation ID ist falsch

Hinweis zu Bearer vs Token
Für Personal Access Tokens ist es Token im Header. Das ist ein Klassiker, weil viele Beispiele im Netz noch Bearer zeigen. (communityarchive.victronenergy.com)

Teil C
SoC in der Antwort finden
und was du tust, wenn du ihn nicht siehst

Schritt 4
SoC Pfad

Im system overview sitzt der SoC in der Regel hier

records.battery.soc

Das heißt in JSON ungefähr so

{
  "records": {
    "battery": {
      "soc": 78.4
    }
  }
}

Wichtig
Je nach System kann es sein, dass battery oder soc fehlt, wenn VRM in deinem Setup gerade keinen SoC bekommt. Das ist kein API Fehler, sondern Datenlage. In dem Fall musst du einmal die komplette Antwort prüfen. Es gibt auch Fälle, wo SoC eher über Diagnostics bzw Diagnostic data kommt. (Victron Community)

Teil D
Blockly Prinzip
so baust du das in jeder Blockly Umgebung nach

Du brauchst immer diese Logik

1 HTTP GET auf system overview
2 Header setzen X Authorization Token
3 Antwort als JSON parsen
4 Pfad records.battery.soc auslesen
5 In Variable speichern

Wenn deine Blockly Umgebung einen fertigen HTTP Block hat, dann ist es meistens genau das.

Teil E
Beispielcode
damit du es sofort laufen siehst

1 JavaScript Beispiel
läuft zum Beispiel in Node RED Function Node oder in einer eigenen kleinen App

const VRM_TOKEN = "DEIN_TOKEN";
const INSTALLATION_ID = "DEINE_INSTALLATION_ID";

async function getSoc() {
  const url = `https://vrmapi.victronenergy.com/v2/installations/${INSTALLATION_ID}/system-overview`;

  const res = await fetch(url, {
    method: "GET",
    headers: {
      "X-Authorization": `Token ${VRM_TOKEN}`,
      "Accept": "application/json"
    }
  });

  if (!res.ok) {
    const body = await res.text();
    throw new Error(`VRM API Fehler ${res.status} ${res.statusText} Antwort ${body}`);
  }

  const data = await res.json();

  const soc = data?.records?.battery?.soc;

  if (soc === undefined || soc === null) {
    throw new Error("SoC nicht gefunden. Prüfe ob data.records.battery.soc existiert und ob VRM in deinem Setup überhaupt SoC liefert.");
  }

  return soc;
}

getSoc()
  .then(soc => console.log("Batterie SoC", soc, "%"))
  .catch(err => console.error(err.message));

2 Python Beispiel
läuft auf jedem Raspberry oder PC

import requests

VRM_TOKEN = "DEIN_TOKEN"
INSTALLATION_ID = "DEINE_INSTALLATION_ID"

url = f"https://vrmapi.victronenergy.com/v2/installations/{INSTALLATION_ID}/system-overview"

headers = {
    "X-Authorization": f"Token {VRM_TOKEN}",
    "Accept": "application/json"
}

res = requests.get(url, headers=headers, timeout=20)

if res.status_code != 200:
    raise SystemExit(f"VRM API Fehler {res.status_code} {res.text}")

data = res.json()

soc = None
try:
    soc = data["records"]["battery"]["soc"]
except Exception:
    pass

if soc is None:
    raise SystemExit("SoC nicht gefunden. Prüfe die JSON Antwort und ob VRM SoC liefert.")

print(f"SoC {soc} %")

Teil F
Node RED Komplettbeispiel
inklusive Polling und sauberes Ergebnis im msg

Wenn du Node RED nutzt, ist das die schnellste Variante.

1 Inject Node alle 30 Sekunden
2 HTTP Request Node
Method GET
URL
https://vrmapi.victronenergy.com/v2/installations/DEINE_INSTALLATION_ID/system-overview

3 Im HTTP Request Node Header setzen
X Authorization
Token DEIN_TOKEN

4 JSON Node zum Parsen
5 Function Node zum Herausziehen vom SoC

Function Node Code

const soc = msg.payload?.records?.battery?.soc;

if (soc === undefined || soc === null) {
  node.error("SoC nicht gefunden. Prüfe msg.payload.records.battery.soc oder ob VRM SoC liefert.", msg);
  return null;
}

msg.soc = soc;
msg.payload = soc;
return msg;

Damit hast du am Ende msg.payload gleich als Zahl und kannst es in Blockly Logik weiterverwenden.

Teil G
Gesamtcode
ein komplettes Beispiel als fertiges Mini Script
das dauerhaft läuft, SoC holt und bei Fehlern sauber reagiert

Das hier ist für Leute, die es einfach als Dienst laufen lassen wollen. Pollt alle 30 Sekunden.

const VRM_TOKEN = process.env.VRM_TOKEN || "DEIN_TOKEN";
const INSTALLATION_ID = process.env.VRM_INSTALLATION_ID || "DEINE_INSTALLATION_ID";

async function fetchSystemOverview() {
  const url = `https://vrmapi.victronenergy.com/v2/installations/${INSTALLATION_ID}/system-overview`;

  const res = await fetch(url, {
    method: "GET",
    headers: {
      "X-Authorization": `Token ${VRM_TOKEN}`,
      "Accept": "application/json"
    }
  });

  if (!res.ok) {
    const body = await res.text();
    throw new Error(`VRM API Fehler ${res.status} ${res.statusText} Antwort ${body}`);
  }

  return res.json();
}

function extractSoc(data) {
  const soc = data?.records?.battery?.soc;
  if (soc === undefined || soc === null) {
    throw new Error("SoC nicht gefunden in records.battery.soc. Prüfe ob VRM in deinem Setup SoC liefert oder ob du stattdessen über Diagnostics gehen musst.");
  }
  return soc;
}

async function loop() {
  try {
    const data = await fetchSystemOverview();
    const soc = extractSoc(data);
    const ts = new Date().toISOString();
    console.log(`${ts} SoC ${soc} %`);
  } catch (e) {
    const ts = new Date().toISOString();
    console.error(`${ts} ${e.message}`);
  }
}

setInterval(loop, 30000);
loop();

Teil H
Wenn es trotzdem klemmt
die drei Checks, die fast immer die Lösung sind

1 Header wirklich X Authorization und wirklich Token
Viele verwechseln Bearer mit Token. Für Personal Access Token muss Token rein. (communityarchive.victronenergy.com)

2 Installation ID stimmt wirklich
Nicht irgendeine Geräte ID, nicht die Portal User ID, sondern die Installation Nummer aus der URL

3 SoC wird in VRM überhaupt geliefert
Es gibt Setups, da ist im Portal keine SoC Quelle sauber vorhanden. Dann taucht soc entweder nicht auf oder du musst über andere Endpunkte wie Diagnostics gehen. (Victron Community)

Wenn du magst, mach es ganz einfach
post hier einmal den anonymisierten JSON Ausschnitt aus system overview, also nur den Teil rund um records und battery, ohne IDs ohne Namen. Dann sag ich dir exakt, welchen Pfad du bei dir nehmen musst und ob du im Zweifel besser Diagnostics abfragst.

Und ja, Premium Bereich Hinweis für alle Mitleser
Wenn du Premium machst, helfe ich dir auch beim Umsetzen als fertigen Blockly Flow, inklusive Variablen, Triggern und Alarmen, sodass du das direkt produktiv laufen lassen kannst.

Hilfreich 1
#11

okay, danke ist sehr ausführlich. Aber ich scheitere bei Schritt 3 "API Call testen mit curl". Wo gebe ich das ein? In IoB Javascript ein neus Javasript scheint falsch zu sein.

#12

Okay, da fehlt wohl noch etwas "linux" Erfahrung. Der Befehl wird direkt in der CLI ausgeführt vom host.

#13

Also das man das in die Shell eingeben muss war mir so nicht ersichtlich aus deiner Beschreibung. Aber es funktioniert, es kommt ein recht langer JSON zurück. Nur scheitere ich jetzt wieder bei dem Punkt "1 JavaScript Beispiel" da wird ein Fehler ausgeben. Ich habe bisher nur ein bisschen Html, PHP, CSS gelernt an Programmiersprachen.

Geht das nicht einfacher über Node Red? Oder Blockly als Baustein-Prinzip?

#14

Bitte screenshots von den Problemen ☺ und deinen befehlen. Ich bin das gerade noch mal durchgegangen und bei mir funktioniert es. Node-RED geht natürlich auch. Es gibt mehrere wege nach Rom. Wir nutzen meist eigene, die update sicher sind, solange es geht.

Hilfreich 1
· bearbeitet #15

Also im Node Red kann ich eine Verbindung zum Ekrano meiner Eltern aufbauen und auch den SoC auslesen. Allerdings kommt bei debug 3 nichts raus. Was muss ich machen damit ich diesen Wert in meinen IoBroker anzeigen lassen kann?

Also den Wert an IoB senden ist ja ganz einfach

#16

Ich löse den Fernzugriff über Wireguard und der Fritzbox. So habe ich eine hoffentlich sichere VPN Verbindung ohne Cloud oder Anmeldezwag und von der Bedienung als wenn ich im Netzwerk bin.

#17

Also wenn ich eine VPN-Verbindung zu der Fritzbox meiner Eltern aufbaue bin ich aus meinem Netzwerk komplett raus und komme da nirgendwo mehr drauf.

Außerdem möchte ich keine dauerhafte VPN-Verbindung haben.

#18

Eine dauerhafte VPN Verbindung möchte ich auch nicht haben, aber in Wireguard ist es nur ein click für an oder aus. Und ich meine nicht mein Netzwerk sondern das von meinen Eltern, Lokal macht das kein Sinn

#19

Ja, das sieht schon mal richtig aus. Die Verbindung zum Ekrano steht ja, und der SoC wird auch sauber gelesen. Man sieht ja am Node selbst schon s: 88.2.

Das Problem ist wahrscheinlich nur, dass du aktuell nicht den reinen Zahlenwert an ioBroker übergibst, sondern ein komplettes Objekt.

Der ioBroker Node möchte am Ende meistens einfach nur sowas bekommen:

msg.payload = 88.2
return msg;

Nicht:

msg.payload = {
  success: true,
  records: ...
}

Ich würde zwischen dem Victron Node und dem ioBroker Node einen Function Node setzen und dort den Wert sauber herausziehen.

Zum Beispiel so:

let value = null;

if (typeof msg.payload === "number") {
    value = msg.payload;
}

if (msg.payload && typeof msg.payload === "object") {
    value =
        msg.payload.value ??
        msg.payload.Value ??
        msg.payload.soc ??
        msg.payload.SoC ??
        msg.payload.stateOfCharge ??
        msg.payload.records?.value ??
        msg.payload.records?.Value;
}

if (value === null || value === undefined) {
    node.warn("Kein SoC Wert im Payload gefunden");
    return null;
}

msg.payload = Number(value);
return msg;

Danach sollte beim Debug nicht mehr das komplette Objekt kommen, sondern nur noch zum Beispiel:

88.2

Diesen Wert kannst du dann an deinen ioBroker Datenpunkt senden.

Ich würde im ioBroker dafür einen eigenen State anlegen, zum Beispiel:

victron.hausakku.soc

Typ:

number

Einheit:

%

Wichtig ist auch beim Debug Node:

Stell den Debug mal auf complete msg object, nicht nur auf msg.payload. Dann sieht man genau, wo der SoC Wert im Objekt liegt. Danach kann man den Function Node exakt darauf anpassen.

Vom Prinzip her ist es also:

Victron / Ekrano Node
→ SoC Wert aus Payload filtern
→ msg.payload als reine Zahl ausgeben
→ ioBroker Out Node
→ Datenpunkt anzeigen

Sobald an deinem Debug nur noch 88.2 oder 87.2 steht, ist der Rest Richtung ioBroker eigentlich nur noch Mapping auf den richtigen Datenpunkt.

#20

Ja Dennis, vielen Dank für deine Hilfe.

Ich habe deinen Code in Zeile 9-15 noch angepasst auf

msg.payload.totals.bs

und in deiner Code-Zeile 23 noch auf

msg.payload = Number(value).toFixed(1);

geändert. Mit ein bisschen ggole habe ich das heraus gefunden.

Also am Ende sieht mein Code so aus und funktioniert super

let value = null;
if (typeof msg.payload === "number") {
   value = msg.payload;
}
if (msg.payload && typeof msg.payload === "object") {
   value =
       msg.payload.totals.bs
}
if (value === null || value === undefined) {
   node.warn("Kein SoC Wert im Payload gefunden");
   return null;
}
msg.payload = Number(value).toFixed(1);
return msg;

Zum Antworten mit dem Kundenkonto anmelden.