Copy page

Integrationen

pvnode mit Home Assistant verbinden

Für pvnode gibt es eine offizielle Home-Assistant-Integration. Sie nutzt die V2-API, legt je Anlage und je Dachfläche ein Gerät an, versorgt das Energy-Dashboard und steuert ihre Abfragen selbst gemäß Ihrem Plan.

Die Einrichtung hat zwei Schritte: API-Schlüssel einfügen, Anlage aus einer Liste wählen.

Installation

Die Integration ist (noch) nicht Teil des HACS-Standardkatalogs und wird deshalb als benutzerdefiniertes Repository hinzugefügt.

1. HACS installieren, falls noch nicht vorhanden.
2. HACS → Integrationen → ⋮ → Benutzerdefinierte Repositories
3. https://github.com/darwindaume/ha-pvnode mit der Kategorie Integration hinzufügen.
4. pvnode installieren, danach Home Assistant neu starten.

Der Knopf öffnet das Repository direkt in Ihrer eigenen Home-Assistant-Instanz. Er funktioniert von dem Gerät aus, auf dem Sie das gerade lesen, sofern My Home Assistant in Ihrer Instanz eingerichtet ist.

Einrichtung

1. Einstellungen → Geräte & Dienste → Integration hinzufügen → pvnode
2. API-Schlüssel einfügen (hier erzeugen).
3. Anlage aus der Liste wählen. Bei nur einer Anlage entfällt der Schritt.

Es gibt nichts weiter einzustellen. Prognosehorizont und Abrufintervall ergeben sich aus Ihrem pvnode-Plan und werden von der API selbst gesteuert — die Integration fragt genau dann ab, wenn eine neue Berechnung vorliegt, und übersteht einen Neustart ohne einen einzigen zusätzlichen Abruf.

Für jede weitere Anlage fügen Sie die Integration erneut hinzu.

Plan gewechselt

Prognosehorizont und Unsicherheitsband stellen sich beim nächsten Abruf von selbst um — ein Neuladen ist nicht nötig. Die Bandsensoren erscheinen nach dem ersten Prognose-Update, nicht sofort nach der Einrichtung.

Wer darauf nicht warten will, drückt „Prognose jetzt aktualisieren" am pvnode-Gerät. Home Assistants eigenes Neu laden hilft hier nicht: Es greift auf die gespeicherte Prognose zurück und vermeidet bewusst einen Abruf, solange die noch aktuell ist.

Jeder Druck zählt gegen Ihr Abrufkontingent — auch dann, wenn der Server dieselbe Berechnung zurückgibt. Nach einem Plan-Wechsel ist das anders: Dabei wird der serverseitige Cache ungültig, es wird also wirklich neu gerechnet.

Sensoren

Jede Anlage wird ein Gerät, jede Dachfläche ein eigenes Untergerät.

Anlage

Sensor	Einheit	Bedeutung
Leistungsprognose aktuell	W	Prognose für den laufenden 15-Minuten-Slot
Leistungsprognose in 30 Minuten / 1 Stunde	W	für kurzfristige Automationen
Spitzenleistung heute / morgen	W	Tagesmaximum
Zeitpunkt der Spitzenleistung heute / morgen	Zeit	wann das Maximum eintritt
Clearsky-Leistung aktuell	W	Referenz ohne Bewölkung
Energieprognose heute / morgen / in N Tagen	kWh	Tagessumme, direkt von pvnode
Clearsky-Energie heute	kWh	Tagessumme ohne Bewölkung
Restertrag heute	kWh	was ab jetzt noch kommt
Energie diese / nächste Stunde	Wh	Kurzfristfenster
Temperaturprognose, Wettercode	°C, WMO	standortweit

Die Anzahl der Tagessensoren richtet sich nach Ihrem Plan.

Standardmäßig deaktiviert, im Entity-Register einzeln aktivierbar: Windgeschwindigkeit, relative Luftfeuchte, Niederschlag, Schneewasseräquivalent sowie Global-, Diffus- und Direktstrahlung.

Nur mit passendem Plan: Leistungs- und Energieprognose als (min)/(max)-Paar.

Dachfläche

Leistungsprognose aktuell, Energieprognose heute und morgen, dazu Einstrahlung in Modulebene vor und nach Verschattung (deaktiviert).

Die Tagesenergie pro Dachfläche ist abgeleitet — pvnode liefert Tagessummen nur für die Anlage als Ganzes. Für Abrechnungen ist der Wert auf Anlagenebene der maßgebliche.

Diagnose

Prognose berechnet am, Nächste Prognose-Aktualisierung (mit included und available als Attribut), Verbleibende Abrufe. Der Abrufzähler gilt kontoweit, nicht pro Anlage.

Energy-Dashboard

pvnode kann die Prognosekurve für ein Solarpanel im Energy-Dashboard liefern.

Voraussetzung ist ein echter Erzeugungszähler. Das Energy-Dashboard verlangt für „Solarproduktion" einen aufsummierenden Energiesensor (state_class: total oder total_increasing) — typischerweise von Ihrem Wechselrichter. Eine Prognose ist kein Zähler und kann dieses Feld nicht füllen.

1. Einstellungen → Dashboards → Energie
2. Unter Solarpaneele Ihren Erzeugungssensor hinzufügen.
3. Bei Prognose pvnode auswählen.

Danach erscheint die Prognose als Kurve über der tatsächlichen Erzeugung. Sie wird bei jedem Seitenaufruf live geholt und nicht historisiert — im Rückblick sehen Sie also immer die aktuelle Prognose, nicht die von damals.

Diagramme

Home Assistant bringt keine eingebaute Karte für Prognosekurven mit. Der übliche Weg dafür ist die ApexCharts-Karte aus HACS.

Jeder Leistungssensor trägt seine vollständige Zeitreihe im Attribut forecast:

Code
forecast:
  - datetime: "2026-08-12T05:00:00+00:00"
    watts: 0
  - datetime: "2026-08-12T05:15:00+00:00"
    watts: 12

Ersetzen Sie im folgenden Beispiel sensor.meine_anlage_... durch Ihre Entity-IDs (zu finden unter Entwicklerwerkzeuge → Zustände, Filter pvnode). Der Abstand zwischen beiden Linien ist der Verlust durch Bewölkung.

Code
type: custom:apexcharts-card
graph_span: 2d
span:
  start: day
now:
  show: true
  label: Jetzt
header:
  show: true
  title: PV-Prognose
series:
  - entity: sensor.meine_anlage_clearsky_leistung_aktuell
    name: Clearsky
    type: area
    opacity: 0.15
    stroke_width: 1
    color: "#cccccc"
    data_generator: |
      return entity.attributes.forecast.map((e) => {
        return [new Date(e.datetime).getTime(), e.watts_clearsky];
      });
  - entity: sensor.meine_anlage_leistungsprognose_aktuell
    name: Prognose
    type: area
    opacity: 0.4
    stroke_width: 2
    data_generator: |
      return entity.attributes.forecast.map((e) => {
        return [new Date(e.datetime).getTime(), e.watts];
      });

Umstieg von Forecast.Solar

Entfernen Sie Forecast.Solar zuerst, richten Sie dann pvnode ein und passen Sie Ihre Automationen an.

Die linke Spalte zeigt die Entity-ID, die Forecast.Solar fest vergibt — die ist bei jeder Installation identisch, Sie können also im YAML danach suchen. Die rechte Spalte zeigt den Sensornamen bei pvnode. Eine feste Entity-ID kann dort nicht stehen: Sie wird aus Ihrem Anlagennamen gebildet, bei „Haus Nord" also etwa sensor.haus_nord_energieprognose_heute.

Forecast.Solar — Entity-ID	pvnode — Sensorname
sensor.energy_production_today	Energieprognose heute
sensor.energy_production_tomorrow	Energieprognose morgen
sensor.energy_production_today_remaining	Restertrag heute
sensor.power_production_now	Leistungsprognose aktuell
sensor.power_production_next_hour	Leistungsprognose in 1 Stunde
sensor.power_highest_peak_time_today	Zeitpunkt der Spitzenleistung heute
sensor.power_highest_peak_time_tomorrow	Zeitpunkt der Spitzenleistung morgen
sensor.energy_current_hour	Energie diese Stunde
sensor.energy_next_hour	Energie nächste Stunde

Zusätzlich bekommen Sie Werte, für die es vorher keine Entsprechung gab: Clearsky-Leistung und -Energie als Referenz ohne Bewölkung, Wetter- und Einstrahlungsdaten, eigene Sensoren je Dachfläche und — je nach Plan — das Unsicherheitsband.

Die Prognosequelle im Energy-Dashboard müssen Sie einmal neu auswählen: Sie hängt am Config-Entry, nicht an den Entitäten.