Ihre Solarprognose steuert das Smart Home

1. 1

   Solariance berechnet die Prognose

   Für Ihre Anlage, aus Standort, Größe, Ausrichtung und Wetterprognosen – mehrmals am Tag neu.

2. 2

   Home Assistant fragt sie ab

   In der Voreinstellung alle 30 Minuten, von sich aus und mit Ihrem Token – über die Solariance-Integration oder die RESTful-Integration. Die Verbindung geht von Ihrem Zuhause nach außen.

   GET https://api.solariance.de/v1/forecast/power

3. 3

   Ihre Automationen schalten Ihre Geräte

   Sie legen fest, was bei welcher Prognose passiert – mit den Geräten, die Ihr Home Assistant schon steuert.

Die Schritte 1 bis 3 der Anleitung gelten auch hier; außerdem brauchen Sie Zugriff auf die Konfigurationsdateien von Home Assistant. Eine Kurve im Energie-Dashboard und die Aktion für die beste Startzeit gibt es auf diesem Weg nicht.

1. A

   Schritt A: System-ID finden

   Die System-ID Ihrer Anlage steht in der Web-App:

   1. Systeme
   2. Ihre Anlage
   3. Basisinformationen
   4. System-ID

   Sie hat zwölf Zeichen aus Großbuchstaben und Ziffern, etwa PV1A2B3C4D5E – ein erfundenes Beispiel.

   Oder fragen Sie die API mit dem neuen Token in einem Terminal. In der Antwort steht die ID bei system_id.

   Terminal

   ShellKopieren Terminal

   # Listet Ihre Anlagen samt system_id. Token nur kurz einsetzen.
   curl -H "Authorization: Bearer IHR_TOKEN" https://api.solariance.de/v1/system/list
   

   Der Befehl steht danach samt Token im Verlauf Ihres Terminals – nutzen Sie ihn nur auf Ihrem eigenen Rechner. Unter Windows schreiben Sie in der PowerShell „curl.exe“ statt „curl“.

2. B

   Schritt B: Token in Home Assistant hinterlegen

   Zum Bearbeiten der Dateien eignet sich die App „File editor“:

   1. Einstellungen
   2. Apps
   3. App installieren
   4. File editor
   5. Installieren
   6. Starten
   7. Benutzeroberfläche öffnen

   Apps hießen früher Add-ons. Mit Home Assistant Container gibt es keine Apps – dort bearbeiten Sie die Dateien direkt im Konfigurationsordner.

   Öffnen Sie im File editor über das Ordner-Symbol oben links die Datei secrets.yaml. Sie liegt im selben Ordner wie configuration.yaml; gibt es sie noch nicht, legen Sie sie dort an. Fügen Sie diese Zeilen ein und ersetzen Sie dann den Platzhalter durch Ihren Token aus Schritt 3:

   secrets.yaml

   YAMLKopieren secrets.yaml

   # secrets.yaml – im selben Ordner wie configuration.yaml
   # Das Wort Bearer und ein Leerzeichen gehören vor den Token.
   solariance_auth: "Bearer HIER_IHREN_TOKEN_EINFUEGEN"
   

   Speichern Sie die Datei – mit dem Disketten-Symbol oben im File editor.

   Das Wort „Bearer“ und ein Leerzeichen bleiben vor dem Token stehen. Der Token gehört nur hierher – nicht in configuration.yaml und nicht in Automationen. Geben Sie secrets.yaml nie weiter, auch nicht als Screenshot.

3. C

   Schritt C: Sensoren anlegen

   Tragen Sie Ihre System-ID ein und passen Sie bei Bedarf die beiden Werte an. Die Vorlage darunter ändert sich sofort mit. Fügen Sie sie am Ende von configuration.yaml ein.

   Die Vorlage legt diese 7 Entitäten an:

   • sensor.solariance_prognose_heute
   • sensor.solariance_prognose_morgen
   • sensor.solariance_spitze_heute
   • sensor.solariance_beste_startzeit
   • sensor.solariance_pv_fenster_beginn
   • sensor.solariance_pv_fenster_ende
   • binary_sensor.solariance_pv_fenster

   Ihre System-ID

   Zwölf Zeichen aus Großbuchstaben und Ziffern. Die Eingabe bleibt in Ihrem Browser; diese Seite sendet sie nirgendwohin.

   Schwelle fürs PV-Fenster (Watt)

   Das PV-Fenster reicht von der ersten bis zur letzten Viertelstunde heute mit mindestens dieser erwarteten Leistung. Möglich sind 100 bis 100.000 W in Schritten von 100 W. Wählen Sie einen Wert, den Ihre Anlage an einem guten Tag sicher erreicht, also deutlich unter ihrer Spitzenleistung – bei einem Balkonkraftwerk weit unter der Voreinstellung von 1.500 W.

   Laufzeit des Geräts0,5 Stunden1 Stunde1,5 Stunden2 Stunden2,5 Stunden3 Stunden3,5 Stunden4 Stunden4,5 Stunden5 Stunden5,5 Stunden6 Stunden

   Für „Beste Startzeit“: der Beginn des Zeitraums dieser Länge mit dem höchsten erwarteten Ertrag, ab jetzt gerechnet.

   Vorlage für: noch ohne System-ID · Schwelle 1.500 W · Laufzeit 2 Stunden

   configuration.yaml

   YAMLKopieren configuration.yaml

   # Solariance-PV-Prognose in Home Assistant (RESTful-Integration)
   # Eine Abfrage alle 30 Minuten; der Token steht in secrets.yaml.
   rest:
     - resource: https://api.solariance.de/v1/forecast/power
       params:
         system_id: IHRE_SYSTEM_ID
       headers:
         Authorization: !secret solariance_auth
       scan_interval: 1800
       timeout: 30
       sensor:
         # Erwarteter Ertrag heute (kWh)
         - name: Solariance Prognose heute
           unique_id: solariance_prognose_heute
           device_class: energy
           unit_of_measurement: kWh
           availability: >-
             {% set d = value_json.data if value_json is defined and value_json.data is mapping else {} %}
             {{ d.forecast is defined and d.now_local is defined and d.forecast | sum(start=[]) | selectattr('local_time', 'match', d.now_local[:10]) | list | count > 0 }}
           value_template: >-
             {% set d = value_json.data %}
             {{ d.forecast | sum(start=[]) | selectattr('local_time', 'match', d.now_local[:10]) | map(attribute='energy_aggregated_sum_intraday') | max | round(1) }}
   
         # Erwarteter Ertrag morgen (kWh)
         - name: Solariance Prognose morgen
           unique_id: solariance_prognose_morgen
           device_class: energy
           unit_of_measurement: kWh
           availability: >-
             {% set d = value_json.data if value_json is defined and value_json.data is mapping else {} %}
             {% set tomorrow = (as_datetime(d.now_local) + timedelta(days=1)).strftime('%Y-%m-%d') if d.now_local is defined else '' %}
             {{ d.forecast is defined and d.now_local is defined and d.forecast | sum(start=[]) | selectattr('local_time', 'match', tomorrow) | list | count > 0 }}
           value_template: >-
             {% set d = value_json.data %}
             {% set tomorrow = (as_datetime(d.now_local) + timedelta(days=1)).strftime('%Y-%m-%d') %}
             {{ d.forecast | sum(start=[]) | selectattr('local_time', 'match', tomorrow) | map(attribute='energy_aggregated_sum_intraday') | max | round(1) }}
   
         # Beginn der ertragreichsten Viertelstunde heute
         - name: Solariance Spitze heute
           unique_id: solariance_spitze_heute
           device_class: timestamp
           availability: >-
             {% set d = value_json.data if value_json is defined and value_json.data is mapping else {} %}
             {{ d.forecast is defined and d.now_local is defined and d.forecast | sum(start=[]) | selectattr('local_time', 'match', d.now_local[:10]) | selectattr('ac_output_of_system', '>', 0) | list | count > 0 }}
           value_template: >-
             {% set d = value_json.data %}
             {% set top = d.forecast | sum(start=[]) | selectattr('local_time', 'match', d.now_local[:10]) | sort(attribute='ac_output_of_system', reverse=true) | first %}
             {{ top.utc_time ~ '+00:00' }}
   
         # Beste Startzeit ab jetzt für ein Gerät mit 2 h Laufzeit
         - name: Solariance Beste Startzeit
           unique_id: solariance_beste_startzeit
           device_class: timestamp
           availability: >-
             {% set d = value_json.data if value_json is defined and value_json.data is mapping else {} %}
             {{ d.forecast is defined and d.now_local is defined and d.forecast | sum(start=[]) | selectattr('local_time', 'match', d.now_local[:10]) | selectattr('local_time', '>=', d.now_local) | selectattr('ac_output_of_system', '>', 0) | list | count > 0 }}
           value_template: >-
             {% set d = value_json.data %}
             {% set rows = d.forecast | sum(start=[]) | selectattr('local_time', 'match', d.now_local[:10]) | list %}
             {% set n = 8 %}
             {% set ns = namespace(best=0, start=none) %}
             {% for i in range(rows | count) if rows[i].local_time >= d.now_local %}
             {% set j = [i + n - 1, (rows | count) - 1] | min %}
             {% set e = rows[j].energy_aggregated_sum_intraday - rows[i].energy_aggregated_sum_intraday + rows[i].energy_in_time_interval %}
             {% if e > ns.best %}{% set ns.best = e %}{% set ns.start = rows[i].utc_time %}{% endif %}
             {% endfor %}
             {{ ns.start ~ '+00:00' }}
   
         # Erste Viertelstunde heute mit mindestens 1500 W Prognose
         - name: Solariance PV-Fenster Beginn
           unique_id: solariance_pv_fenster_beginn
           device_class: timestamp
           availability: >-
             {% set d = value_json.data if value_json is defined and value_json.data is mapping else {} %}
             {{ d.forecast is defined and d.now_local is defined and d.forecast | sum(start=[]) | selectattr('local_time', 'match', d.now_local[:10]) | selectattr('ac_output_of_system', '>=', 1500) | list | count > 0 }}
           value_template: >-
             {% set d = value_json.data %}
             {% set hits = d.forecast | sum(start=[]) | selectattr('local_time', 'match', d.now_local[:10]) | selectattr('ac_output_of_system', '>=', 1500) | list %}
             {{ hits[0].utc_time ~ '+00:00' }}
   
         # Ende der letzten Viertelstunde heute mit mindestens 1500 W
         - name: Solariance PV-Fenster Ende
           unique_id: solariance_pv_fenster_ende
           device_class: timestamp
           availability: >-
             {% set d = value_json.data if value_json is defined and value_json.data is mapping else {} %}
             {{ d.forecast is defined and d.now_local is defined and d.forecast | sum(start=[]) | selectattr('local_time', 'match', d.now_local[:10]) | selectattr('ac_output_of_system', '>=', 1500) | list | count > 0 }}
           value_template: >-
             {% set d = value_json.data %}
             {% set last = d.forecast | sum(start=[]) | selectattr('local_time', 'match', d.now_local[:10]) | selectattr('ac_output_of_system', '>=', 1500) | list | last %}
             {{ (as_datetime(last.utc_time ~ '+00:00') + timedelta(minutes=last.step)).isoformat() }}
   
   template:
     - binary_sensor:
         # An zwischen Beginn und Ende des PV-Fensters
         - name: Solariance PV-Fenster
           unique_id: solariance_pv_fenster
           state: >-
             {{ has_value('sensor.solariance_pv_fenster_beginn') and has_value('sensor.solariance_pv_fenster_ende')
                and states('sensor.solariance_pv_fenster_beginn') | as_datetime <= now()
                and now() < states('sensor.solariance_pv_fenster_ende') | as_datetime }}
   

   Speichern Sie danach auch configuration.yaml.

   Steht in Ihrer configuration.yaml schon rest: oder template:? Dann hängen Sie nur die Einträge darunter an, die mit einem Bindestrich beginnen, statt den Schlüssel ein zweites Mal anzulegen – sonst gilt nur der letzte.

   Die Namen der Sensoren folgen der Sprache dieser Seite. Übernehmen Sie Vorlage und Automationen deshalb in derselben Sprache – sonst finden die Automationen ihre Sensoren nicht.

   Werte später ändern? Erzeugen Sie die Vorlage hier neu und ersetzen Sie damit die früher eingefügten Solariance-Einträge, statt sie ein zweites Mal anzuhängen. Danach laden Sie neu wie in Schritt D.

4. D

   Schritt D: Prüfen und laden

   Prüfen Sie zuerst die Konfiguration:

   1. Einstellungen
   2. Werkzeuge
   3. YAML
   4. Konfiguration prüfen

   Beim ersten Mal ist ein vollständiger Neustart nötig – nicht „Schnelles Neuladen“, das legt die REST-Sensoren beim ersten Mal nicht an:

   1. Einstellungen
   2. ⋮Menü
   3. Home Assistant neu starten
   4. Home Assistant neu starten
   5. Neu starten

   Bei späteren Änderungen ist kein Neustart nötig. Laden Sie die Sensoren und das PV-Fenster neu:

   1. Einstellungen
   2. Werkzeuge
   3. YAML
   4. REST-Entitäten und -Benachrichtigungsdienste

   1. Einstellungen
   2. Werkzeuge
   3. YAML
   4. Template-Entitäten

   Kontrollieren Sie das Ergebnis:

   1. Einstellungen
   2. Werkzeuge
   3. Zustände

   Filtern Sie nach „solariance“. Die Werte erscheinen nach der ersten Abfrage; die Prognosen für heute und morgen zeigen dann Zahlen. „Nicht verfügbar“ ist bei zwei Arten von Sensoren normal: bei der besten Startzeit nach der letzten Sonnen-Viertelstunde des Tages, bei Beginn und Ende des PV-Fensters an Tagen, an denen Ihre Schwelle nicht erreicht wird. Zeitpunkte zeigt die Zustände-Seite in UTC (Endung +00:00), nicht in Ihrer Ortszeit; Dashboards und Automationen rechnen in Ortszeit.

   Direkt in Ihrem Home Assistant (über my.home-assistant.io):

   • YAML-Werkzeuge
   • Zustände
   • Protokolle

   Fehlersuche

   Kein Solariance-Sensor zu sehen?

   • Sind secrets.yaml und configuration.yaml gespeichert?
   • Haben Sie beim ersten Mal vollständig neu gestartet – nicht nur „Schnelles Neuladen“?
   • Meldet „Konfiguration prüfen“ einen Fehler? Meist ist es die Einrückung: Die Vorlage nutzt Leerzeichen, keine Tabs, und „rest:“ steht ganz links.

   Alle Sensoren „Nicht verfügbar“?

   Prüfen Sie die System-ID und die Zeile in secrets.yaml („Bearer“ und ein Leerzeichen vor dem Token). Den genauen Fehler zeigt Home Assistant erst, wenn Sie diese Aktion ausführen:

   1. Einstellungen
   2. Werkzeuge
   3. Aktionen
   4. YAML-Modus
   5. Aktion ausführen

   Aktion

   YAMLKopieren Aktion

   # Werkzeuge › Aktionen, YAML-Modus: zeigt den Status jeder Abfrage im Protokoll
   action: logger.set_level
   data:
     homeassistant.components.rest: debug
   

   Laden Sie dann die REST-Entitäten neu (siehe oben). Unter Einstellungen › System › Protokolle › „Unveränderte Protokolle anzeigen“ steht danach eine Zeile „REST response from … status=…“. Die Einstellung gilt bis zum nächsten Neustart.

   • 401: Token falsch oder abgelaufen, „Bearer “ fehlt, oder die System-ID gehört nicht zu Ihrem Konto.
   • 403: Adresse verändert, etwa ein Schrägstrich am Ende, oder die Anlage ist in Ihrem Tarif pausiert.
   • 429: zu viele Abrufe – eine Stunde warten und nie öfter abfragen als die Vorlage.
   • 204: noch keine Prognose – bei einer neuen Anlage dauert die erste einen Moment.
5. E

   Schritt E: Automation anlegen

   Öffnen Sie den YAML-Editor einer neuen Automation:

   1. Einstellungen
   2. Automationen & Szenen
   3. Automation erstellen
   4. Neue Automation erstellen
   5. ⋮Menü
   6. In YAML bearbeiten

   Ersetzen Sie den Inhalt durch eine der Vorlagen unten, tragen Sie die Entitäten Ihrer Geräte ein und klicken Sie auf „Speichern“.

   Zu den Vorlagen→

• Abrufe

  Free und Plus: 30 Abrufe pro Stunde für die Leistungsprognose (forecast/power), geteilt mit allem, was Ihr Konto sonst an Prognosen abruft – Ihrer Solariance-App, dem Chat und weiteren API-Tokens. Die Integration braucht in der Voreinstellung 2 davon pro Stunde und Anlage, die Vorlage der RESTful-Variante 2; Premium hat 500. Auch abgelehnte Abrufe zählen mit. Ist das Limit aufgebraucht, wartet die Integration bis zur nächsten regulären Abfrage, statt früher nachzufragen.

• Aktualität

  Die Prognose wird mehrmals am Tag neu berechnet; eine Abfrage alle 30 Minuten genügt. Messwerte Ihrer Anlage liefert die Schnittstelle nicht – es bleibt eine Prognose.

• Horizont

  Free: heute und morgen in 15-Minuten-Auflösung. Plus und Premium: bis zu fünf Tage, ab dem dritten Tag stündlich, danach in 3-Stunden-Schritten. Die Integration zeigt Tag 3 bis 5 als eigene, anfangs deaktivierte Sensoren; die Vorlage der RESTful-Variante nutzt nur heute und morgen.

• Energie-Dashboard

  Die Integration zeigt die Prognose als Kurve im Energie-Dashboard (Schritt 6), sobald dort eine gemessene PV-Erzeugung eingerichtet ist. Die RESTful-Variante kann das nicht: REST-Sensoren erreichen das Energie-Dashboard nicht. Nutzen Sie sie in normalen Dashboard-Karten und in Automationen.

• Zuverlässigkeit

  Prognosen können danebenliegen oder zeitweise ausfallen (AGB § 11). Geben Sie jeder Automation eine Rückfallebene und steuern Sie damit nichts Sicherheitskritisches.

• Token-Ablauf

  Läuft der Token ab oder löschen Sie ihn, fragt Home Assistant bei der Integration selbst nach einem neuen. Bei der RESTful-Variante werden die Sensoren „Nicht verfügbar“: Erstellen Sie einen neuen Token, ersetzen Sie ihn in secrets.yaml und laden Sie die REST-Entitäten neu.

• Mehrere Anlagen

  Premium erlaubt bis zu drei Anlagen. Integration: Fügen Sie sie für jede Anlage noch einmal hinzu. RESTful-Variante: Kopieren Sie den Eintrag unter rest: (und den Template-Sensor) je Anlage, tragen Sie unter params die system_id der jeweiligen Anlage ein und geben Sie allen Sensoren eigene Namen und eine eigene unique_id; im kopierten Template-Sensor ändern Sie außerdem die beiden Sensor-IDs, auf die er sich bezieht. Jede Anlage braucht 2 weitere Abrufe pro Stunde.

• Zeitzone

  Nichts einzustellen: Integration und Vorlage nehmen „heute“ aus der Prognose selbst, in der Zeitzone Ihrer Anlage.