# Umstellung auf pvnode

> Ablauf der Umstellung des Forecast-Collectors von Forecast.Solar oder Solcast auf pvnode, von der Registrierung bis zu den Sensoren.

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

## Schritt 1: Registrierung bei pvnode

1. Kostenlosen Account bei [pvnode.com](https://pvnode.com) anlegen
2. Nach der Anmeldung zu [API Keys](https://pvnode.com/settings/api-keys) navigieren
3. Neuen API-Key erstellen und kopieren

> **Tipp**
>
>
> Die drei Tarife **Free**, **Light** und **Plus** unterscheiden sich im Kontingent der API-Anfragen und in der Reichweite der Prognose. Was sie im Einzelnen leisten, steht in der [Referenz](/docs/referenz/forecast-collector/konfiguration-pvnode/#pvnode_paid).
>

## 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](/docs/referenz/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.

> **Nur ohne Site-ID**
>
>
> Die beiden folgenden Abschnitte betreffen nur Installationen ohne **Site-ID**, die also weiterhin die v1-API nutzen.
>

## 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](/docs/referenz/forecast-collector/konfiguration-pvnode/#forecast_azimuth).

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](/docs/referenz/forecast-collector/konfiguration-pvnode/#standort).

## 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](/docs/anleitungen/logging/) des Forecast-Collectors.

## Weiterführende Links

- [pvnode Referenz-Dokumentation](/docs/referenz/forecast-collector/konfiguration-pvnode/)
- [Allgemeine Forecast-Collector Konfiguration](/docs/referenz/forecast-collector/allgemeine-konfiguration/)
- [Dashboard Sensor-Konfiguration](/docs/referenz/dashboard/sensor-konfiguration/)