Zum Hauptinhalt springen

Lastmanager

Das charge_manager-Modul implementiert einen Lastmanager, der eine verfügbare Menge Strom auf ein oder mehrere WARP Charger (jeder Generation) verteilen kann. Der Lastmanager stellt sicher, dass der konfigurierte Verbund an WARP Chargern niemals mehr als den verfügbaren Strom beziehen und versucht diesen möglichst fair zu verteilen. Ein WARP Energy Manager verwendet den Lastmanager außerdem um die Phasenumschaltung eines Verbunds an WARP Chargern über ein externes Schütz sicher umzusetzen.

charge_manager/available_current​

Der derzeit zur Verfügung stehende Strom. Dieser Strom wird unter den konfigurierten Wallboxen aufgeteilt.

Beispiel
# $HOST z.B. warp-AbCd

Lesen​

curl http://$HOST/charge_manager/available_current
{ "current": 16000 }

Schreiben​

curl http://$HOST/charge_manager/available_current -d '{ "current": 16000 }'

oder abgekürzt:

curl http://$HOST/charge_manager/available_current -d '16000'
NameBedeutung
current
int (mA)

Der zur Verfügung stehende Strom. Es werden nur Ströme akzeptiert, die kleiner als der konfigurierte Maximalstrom maximum_available_current aus charge_manager/config sind.




charge_manager/state​

Der Zustand des Lastmanagers und aller konfigurierten Wallboxen. Wird vom Webinterface zur Anzeige verwendet. Änderungen an diesem Objekt werden nicht als API-Bruch betrachtet!




charge_manager/low_level_state​

Der Low-Level-Zustand des Lastmanagers und aller konfigurierten Wallboxen. Wird vom Webinterface zur Anzeige verwendet. Änderungen an diesem Objekt werden nicht als API-Bruch betrachtet!




charge_manager/low_level_config​

Die Low-Level-Konfiguration des Lastmanagers. Wird zum Fine-Tuning des Verteilungsalgorithmus verwendet. Änderungen an diesem Objekt werden nicht als API-Bruch betrachtet!




charge_manager/config​

Die Lastmanager-Konfiguration.

Beispiel
# $HOST z.B. warp-AbCd

Lesen​

curl http://$HOST/charge_manager/config
{
  "enable_charge_manager": true,
  "enable_watchdog": false,
  "default_available_current": 16000,
  "maximum_available_current": 32000,
  "minimum_current_auto": true,
  "minimum_current": 9200,
  "minimum_current_1p": 6000,
  "minimum_current_vehicle_type": 1,
  "verbose": true,
  "requested_current_threshold": 60,
  "requested_current_margin": 3000,
  "chargers": [
    { "host": "127.0.0.1", "name": "warp-AbCd" },
    { "host": "warp2-22oH.local", "name": "warp2-22oH" }
  ]
}

Schreiben​

curl http://$HOST/charge_manager/config -d '{
  "enable_charge_manager": true,
  "enable_watchdog": false,
  "default_available_current": 16000,
  "maximum_available_current": 32000,
  "minimum_current_auto": true,
  "minimum_current": 9200,
  "minimum_current_1p": 6000,
  "minimum_current_vehicle_type": 1,
  "verbose": true,
  "requested_current_threshold": 60,
  "requested_current_margin": 3000,
  "chargers": [
    { "host": "127.0.0.1", "name": "warp-AbCd" },
    { "host": "warp2-22oH.local", "name": "warp2-22oH" }
  ]
}'
NameBedeutung
enable_charge_manager
bool

Gibt an, ob der Lastmanager aktiviert sein soll.

  • true - Wenn der Lastmanager aktiviert ist.
  • false - Wenn der Lastmanager nicht aktiviert ist.
enable_watchdog
bool

Gibt an, ob der Watchdog aktiviert sein soll. Der Watchdog setzt, wenn 30 Sekunden lang keine Nachricht auf charge_manager/available_current einging, den verfügbaren Strom auf die Default-Einstellung (default_available_current). Damit kann die Robustheit gegen Ausfall einer externen Steuerung, z.B. bei PV-Überschussladung erhöht werden.

  • true - Wenn der Watchdog aktiviert ist.
  • false - Wenn der Watchdog nicht aktiviert ist.
verbose
bool

Gibt an, ob jeder Stromverteilung im Ereignis-Log vermerkt werden soll.

  • true - Wenn Stromverteilungen geloggt werden sollen.
  • false - Wenn Stromverteilungen nicht geloggt werden sollen.
default_available_current
int (mA)

Strom der nach Neustart des Lastmanagers zur Verfügung stehen soll. Beim Auslösen setzt der Watchdog den verfügbaren Strom auf diesen Strom zurück.

maximum_available_current
int (mA)

Maximum, das über die API und das Webinterface jeweils als verfügbarer Strom gesetzt werden darf. Sollte auf den maximal erlaubten Strom der Anbindung des Wallbox-Verbunds konfiguriert werden, der z.b. durch Hausanschlusses, die Absicherung oder die Zuleitung begrenzt ist.

minimum_current_auto
bool

Gibt an, ob der Minimal-Ladestrom anhand des gewählten Fahrzeugtypes (minimum_current_vehicle_type) gesetzt wird.

  • true - Minimal-Ladestrom wird anhand des gewählten Fahrzeugtypes gesetzt. minimum_current und minimum_current_1p werden ignoriert, bzw. überschrieben.
  • false - minimum_current und minimum_current_1p bestimmen den Minimal-Ladestrom.
minimum_current_vehicle_type
int

Fahrzeugtyp für den der Minimal-Ladestrom gewählt wird.

  • 0 - Kein spezifischer Fahrzeugtyp gewählt.
  • 1 - Renault Twingo Z.E., Renault ZOE R110 oder R135
minimum_current
int (mA)

Kleinste Strommenge, die einer Wallbox im dreiphasigen Betrieb zugeteilt werden soll, damit diese einen Ladevorgang beginnt. Hiermit kann beeinflusst werden wie viele Wallboxen gleichzeitig laden.

minimum_current_1p
int (mA)

Kleinste Strommenge, die einer Wallbox im einphasigen Betrieb zugeteilt werden soll, damit diese einen Ladevorgang beginnt. Hiermit kann beeinflusst werden wie viele Wallboxen gleichzeitig laden.

requested_current_threshold
int (s)

Wallboxen mit einem Stromzähler, der Phasenströme misst, werden requested_current_threshold Sekunden nach dem Ladestart auf den größten Phasenstrom plus den konfigurierten Spielraum limitiert. Damit kann der verfügbare Strom effizienter auf mehrere Wallboxen verteilt werden.

requested_current_margin
int (mA)

Spielraum, der auf den größten gemessenen Phasenstrom aufgeschlagen wird.

chargers
object[10]

Wallboxen, die vom Lastmanager gesteuert werden sollen.

  • [0..9] - Eine zu steuernde Wallbox
NameBedeutung
host
string

IP-Adresse der zu steuernden Wallbox

name
string

Anzeigename der zu steuernden Wallbox

rot
int

Phasenrotation der zu steuernden Wallbox

  • 0 - Unbekannt
  • 1 - L123
  • 2 - L132
  • 3 - L231
  • 4 - L213
  • 5 - L321
  • 6 - L312