Skip to main content

Fahrplan für Grau- und Grünstrom

Übersicht

Zielsetzung

Ziel ist es, eine API bereitzustellen damit ein Fahrplan für PV und/oder Batterie importiert und exportiert werden kann. Entweder dient der Fahrplan als Fallback oder als erste Vorgabe.

Begriffsdefinition

  • SLOT = Viertelsundenwert | geringste Auflösung einer Vorgabe im Fahrplan ist gültig von HH:MM:SS z.B.
    • 12:00:00 bis 12:14:59
    • 12:15:00 bis 12:29:59
    • 12:30:00 bis 12:45:59
    • 12:45:00 bis 12:59:59

Funktionale Umsetzung

Einstellungsmöglichkeiten

Es können maximal 2 Instanzen angelegt werden. In der Instanz kann gewählt werden, ob der Fahrlplan für:

  • PV
  • Batterie
  • PV + Batterie

gültig ist. Wurde PV + Batterie gewählt, so kann es keine andere Instanz mit PV oder Batterie geben. Ebenso kann eingestellt werden ob:

  • Führungsgröße
  • Fallback

Bei Führungsgröße wird die Vorgabe vom Fahrplan verwendet und nur wenn keine Fahrplan importiert ist (z.B. für einen Tag, oder auch nur für einen Slot), so kann z.B. über Modbus werte Vorgegeben werden. Der Fallback kommt dann zum Einsatz, wenn die Modbus Verbindung unterbrochen wurde. Das ausfallverhalten der Modbus Verbindung muss dementsprechend angepasst weden, sodass zusätzlich auf "Fahrplan" umgestellt werden kann.

API-Definition

  • URL: https:///shedule/v1/
    • GET: Fahrplan abfragen
    • POST: Neuen Fahrplan setzen
    • DELETE: Fahrplan löschen
  • Format: JSON
    • GET
      • FROM (UTC Timestamp)
      • TO (UTC Timestamp)
    • POST
      • FROM (UTC Timestamp)
      • TO (UTC Timestamp)
      • TYPE (PV o. BATTERY o. PV + BATTERY)
    • DELETE
      • FROM (UTC Timestamp)
      • TO (UTC Timestamp)
      • TYPE (PV o. BATTERY o. PV + BATTERY)

Jeder POST oder DELETE besteht einer einer ObjectList für einen Slot pro type. Sollen also für die Batterie von 00:00:00 bis 23:59:59 daten geschriebe werden, werden also 360 Objecte benötigt. Mit Get werden die Ojecte aller Typen in den geforderten Zeitbereich zurück gegeben.

Back to top