Umstellung auf pvnode

Diese Anleitung beschreibt die Umstellung des Forecast-Collectors von einem anderen Anbieter (Forecast.Solar oder Solcast) auf pvnode.

Schritt 1: Registrierung bei pvnode

Kostenlosen Account bei pvnode.com anlegen
Nach der Anmeldung zu API Keys navigieren
Neuen API-Key erstellen und kopieren

Schritt 2: Site bei pvnode anlegen

In der pvnode-Web-App eine Site anlegen. Sie enthält den Standort der Anlage und ihre PV-Strings. Die Site bekommt eine ID, die im nächsten Schritt gebraucht wird.

Das ist der empfohlene Weg, denn er nutzt die API v2. Die klassische v1-API schaltet pvnode zum 31.12.2026 ab.

Schritt 3: Umstellung in HELIOS

In HELIOS unter Konfiguration → Datenquellen → Forecast-Collector den Anbieter pvnode wählen. Danach folgen der API-Key und der pvnode-Tarif (Free, Light oder Plus), auf der nächsten Seite die Site-ID.

Damit ist die Anlage beschrieben. Ausrichtung, Neigung und Leistung der Dachflächen fragt HELIOS dann nicht mehr ab, denn diese Angaben stehen auf der Site.

Zum Schluss den Forecast-Collector unter Dienste aktualisieren.

Schritt 4: Sensoren aktivieren

pvnode liefert zwei Werte, die es bei anderen Anbietern nicht gibt: die Prognose bei wolkenlosem Himmel und die Außentemperatur. Dafür unter Konfiguration → Sensoren die Sensoren PV-Prognose (klarer Himmel) und Außentemperatur-Prognose aktivieren. Measurement und Field trägt HELIOS dabei selbst ein.

Ausrichtung ohne Site-ID

pvnode zählt die Grad von Nord (0 bis 360), Forecast.Solar dagegen von Süd (-180 bis 180). Süden ist also nicht mehr 0, sondern 180. Die Werte je Himmelsrichtung stehen in der Referenz.

HELIOS blendet für jeden Anbieter das passende Feld ein und schreibt die Konvention daneben. Eine Umrechnung entfällt damit. Eine Kontrolle des Werts bleibt sinnvoll.

Koordinaten nicht mehr ändern

Geänderte Koordinaten legen bei pvnode einen neuen Standort an. Im kostenlosen Tarif führt das zur Fehlermeldung Site limit has been exceeded. Die Koordinaten müssen also schon vor dem ersten Abruf stimmen und danach unverändert bleiben. Näheres zum Standort-Limit steht in der Referenz.

Wenn keine Prognose erscheint

Manchmal ruft der Forecast-Collector die Daten laut Protokoll erfolgreich ab, im Dashboard erscheint aber nichts. Meist liegt es dann an der Groß- und Kleinschreibung: InfluxDB unterscheidet Forecast und forecast. Schreibt der Collector nach Forecast, das Dashboard fragt aber forecast ab, kommt nichts an.

Die Zuordnung steht unter Konfiguration → Sensoren. HELIOS zeigt dort zu jedem Sensor den aktuellen Messwert. Bleibt er leer, stimmt die Zuordnung nicht.

Weiter hilft das Protokoll des Forecast-Collectors.