Konfiguration des PV-Überschussladens

`power_manager/config`

Konfiguration des Power Managers

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/power_manager/config

{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}

Schreiben

curl http://$HOST/power_manager/config -d '{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/config

{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}

Schreiben

Mit MQTT auf $PREFIX/power_manager/config_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/config_update -m '{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}'

Name	Bedeutung
`enabled` bool	Obsolet. Gibt an, ob der Power Manager aktiviert ist. Dieser Wert wird automatisch überschrieben, abhängig davon, ob PV-Überschussladen oder dynamisches Lastmanagement aktiviert sind.
`default_mode` int	Der nach einem Neustart des Power Managers verwendete Lademodus 0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist. 1 - Aus. Fahrzeuge werden nicht geladen. 2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist. 3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.
`excess_charging_enable` bool	Wenn aktiviert, regelt der Power Manager die von ihm kontrollierten Verbraucher abhängig vom Überschuss einer vorhandenen Photovoltaikanlage. Wenn deaktiviert, wird die maximale Leistung unter Einhaltung der maximale Strombelastbarkeit der Zuleitungen erlaubt.
`phase_switching_mode` int	0 - Automatischer Wechsel zwischen drei- und einphasigem Laden. Nur möglich, wenn contactor_installed true ist. 1 - Immer einphasig 2 - Immer dreiphasig 4 - Einphasiger PV-Modus, dreiphasiger Schnell-Modus
`target_power_from_grid` int (W)	Soll-Netzbezug für Überschussregelung. Gibt den gewünschten Netzbezug (positive Werte) bzw. Netzeinspeisung (negative Werte) im PV-Lademodus vor. Damit kann auch die Priorität gegenüber einem Batteriespeicher beeinflusst werden.
`guaranteed_power` int (W)	Mindest-Ladeleistung, die für den Min + PV-Lademodus verwendet wird. Diese Leistung wird bei unzureichendem PV-Überschuss (teilweise) aus dem Netz bezogen.
`cloud_filter_mode` int	Modus des Wolkenfilters, um im PV-Lademodus Überreaktionen bei kurzzeitiger Änderung der Bewölkung zu vermeiden. 0 - Kein Wolkenfilter. 1 - Schwacher Wolkenfilter. 2 - Mittlerer Wolkenfilter. 3 - Starker Wolkenfilter.
`meter_slot_grid_power` int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
`meter_slot_battery_power` int	Gibt an, welcher Stromzähler für die Regelung als Batteriespeicher-Stromzähler betrachtet wird.
`battery_mode` int	Speicherpriorität im Verhältnis zu Wallboxen 0 - Wallboxen bevorzugen, überschüssige Leistung für Speicher 1 - Speicher bevorzugen, überschüssige Leistung für Wallboxen
`battery_inverted` bool	Invertiert das Vorzeichen der Speicherleistung für Batteriespeicher, die beim Laden negative und beim Entladen positive Leistungswerte melden.
`battery_deadzone` int	Bezugs- und Einspeise-Toleranz am Netzanschluss, während der Speicher aktiv ist. Für Batteriespeicher, die einen gewissen Bezug und Einspeisung beim Entladen bzw. Laden erlauben. Die Toleranz sollte auf das 1,5-fache des erwarteten Bezugs und Einspeisung gestellt werden.

`power_manager/dynamic_load_config`

Konfiguration des dynamischen Lastmanagements

Name	Bedeutung
`enabled` bool	Aktiviert dynamisches Lastmanagement.
`meter_slot_grid_currents` int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
`current_limit` int	Maximal gewünschter Strom am Netzanschluss in Milliampere. Dies ist üblicherweise der Nennwert der Absicherung.
`largest_consumer_current` int	Strombedarf des größten Einzelverbrauchers pro Phase in Milliampere, ausgenommen gesteuerter Wallboxen.
`safety_margin_pct` int	Zusätzliche Sicherheitsmarge in Prozent, relativ zum maximalen Strom am Netzanschluss.

`power_manager/state`

Zustand des Power Managers

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/power_manager/state

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/state

{ "config_error_flags": 0, "external_control": 1 }

Name Bedeutung

Name	Bedeutung
`config_error_flags` int	Aktive Konfigurationsfehler des Power Managers. Es handelt sich hierbei um eine Bitmaske, sodass sämtliche Kombinationen aus Konfigurationsfehlern auftreten können. 0 - Kein Fehler 0x00000001 - Phasenumschaltung oder Schütz nicht konfiguriert 0x00000002 - Maximaler Gesamtstrom der Wallboxen nicht konfiguriert 0x00000004 - Keine Wallboxen konfiguriert 0x00000008 - Überschussladen aktiviert aber kein Stromzähler eingerichtet
`external_control` int	Status der externen Steuerung zur Phasenumschaltung. 0 - Externe Steuerung bereit für Kommandos. 1 - Externe Steuerung über die Einstellungen deaktiviert. 2 - Externe Steuerung ist aktiviert aber aktuell nicht verfügbar. Gründe sind unter anderem: ausgelöste Schützüberwachung, eine oder mehrere Wallboxen nicht erreichbar oder unterstützen keine CP-Trennung, Ladevorgang blockiert durch Eingang 3. 3 - Phasenumschaltung wird gerade durchgeführt; ankommende Kommandos werden ignoriert.

config_error_flags
int

Aktive Konfigurationsfehler des Power Managers. Es handelt sich hierbei um eine Bitmaske, sodass sämtliche Kombinationen aus Konfigurationsfehlern auftreten können.

0 - Kein Fehler
0x00000001 - Phasenumschaltung oder Schütz nicht konfiguriert
0x00000002 - Maximaler Gesamtstrom der Wallboxen nicht konfiguriert
0x00000004 - Keine Wallboxen konfiguriert
0x00000008 - Überschussladen aktiviert aber kein Stromzähler eingerichtet

external_control
int

Status der externen Steuerung zur Phasenumschaltung.

0 - Externe Steuerung bereit für Kommandos.
1 - Externe Steuerung über die Einstellungen deaktiviert.
2 - Externe Steuerung ist aktiviert aber aktuell nicht verfügbar. Gründe sind unter anderem: ausgelöste Schützüberwachung, eine oder mehrere Wallboxen nicht erreichbar oder unterstützen keine CP-Trennung, Ladevorgang blockiert durch Eingang 3.
3 - Phasenumschaltung wird gerade durchgeführt; ankommende Kommandos werden ignoriert.

`power_manager/low_level_state`

Der interne Zustand des Power Managers. Wird zum Anzeigen von Debug-Informationen verwendet. Änderungen an diesem Objekt werden nicht als API-Bruch betrachtet!

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/power_manager/low_level_state

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/low_level_state

{
  "power_at_meter": -4067.817383,
  "power_at_meter_filtered": -4909,
  "power_available": 3680,
  "power_available_filtered": 3680,
  "overall_min_power": 1380,
  "threshold_3to1": 3795,
  "threshold_1to3": 4025,
  "charge_manager_available_current": 16000,
  "charge_manager_allocated_current": 16000,
  "max_current_limited": 16000,
  "uptime_past_hysteresis": true,
  "is_3phase": false,
  "wants_3phase": false,
  "wants_3phase_last": false,
  "is_on_last": true,
  "wants_on_last": true,
  "phase_state_change_blocked": false,
  "phase_state_change_delay": 0,
  "on_state_change_blocked": true,
  "on_state_change_delay": 194264,
  "charging_blocked": 0,
  "switching_state": 0
}

`power_manager/charge_mode`

Aktuell verwendeter Lademodus.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/power_manager/charge_mode

{ "mode": 2 }

Schreiben

curl http://$HOST/power_manager/charge_mode -d '{ "mode": 2 }'

oder abgekürzt:

curl http://$HOST/power_manager/charge_mode -d '2'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/charge_mode

{ "mode": 2 }

Schreiben

Mit MQTT auf $PREFIX/power_manager/charge_mode_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/charge_mode_update -m '{ "mode": 2 }'

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/charge_mode_update -m '2'

Name Bedeutung

Name	Bedeutung
`mode` int	0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist. 1 - Aus. Fahrzeuge werden nicht geladen. 2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist. 3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.

mode
int

0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist.
1 - Aus. Fahrzeuge werden nicht geladen.
2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist.
3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.

`power_manager/external_control`

Phasenanforderung für externe Steuerung. Kann geschrieben werden, wenn external_control in power_manager/state 0 ist.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/power_manager/external_control

{ "phases_wanted": 1 }

Schreiben

curl http://$HOST/power_manager/external_control -d '{ "phases_wanted": 1 }'

oder abgekürzt:

curl http://$HOST/power_manager/external_control -d '1'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/external_control

{ "phases_wanted": 1 }

Schreiben

Mit MQTT auf $PREFIX/power_manager/external_control_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/external_control_update -m '{ "phases_wanted": 1 }'

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/external_control_update -m '1'

Name	Bedeutung
`phases_wanted` int	0 - Keine Phasen angefordert, keine Stromfreigabe. 1 - Eine Phase angefordert. 3 - Drei Phasen angefordert.

`power_manager/config`

Konfiguration des Power Managers

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/power_manager/config

{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}

Schreiben

curl http://$HOST/power_manager/config -d '{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/config

{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}

Schreiben

Mit MQTT auf $PREFIX/power_manager/config_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/config_update -m '{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}'

Name	Bedeutung
`enabled` bool	Obsolet. Gibt an, ob der Power Manager aktiviert ist. Dieser Wert wird automatisch überschrieben, abhängig davon, ob PV-Überschussladen oder dynamisches Lastmanagement aktiviert sind.
`default_mode` int	Der nach einem Neustart des Power Managers verwendete Lademodus 0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist. 1 - Aus. Fahrzeuge werden nicht geladen. 2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist. 3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.
`excess_charging_enable` bool	Wenn aktiviert, regelt der Power Manager die von ihm kontrollierten Verbraucher abhängig vom Überschuss einer vorhandenen Photovoltaikanlage. Wenn deaktiviert, wird die maximale Leistung unter Einhaltung der maximale Strombelastbarkeit der Zuleitungen erlaubt.
`phase_switching_mode` int	0 - Automatischer Wechsel zwischen drei- und einphasigem Laden. Nur möglich, wenn contactor_installed true ist. 1 - Immer einphasig 2 - Immer dreiphasig 4 - Einphasiger PV-Modus, dreiphasiger Schnell-Modus
`target_power_from_grid` int (W)	Soll-Netzbezug für Überschussregelung. Gibt den gewünschten Netzbezug (positive Werte) bzw. Netzeinspeisung (negative Werte) im PV-Lademodus vor. Damit kann auch die Priorität gegenüber einem Batteriespeicher beeinflusst werden.
`guaranteed_power` int (W)	Mindest-Ladeleistung, die für den Min + PV-Lademodus verwendet wird. Diese Leistung wird bei unzureichendem PV-Überschuss (teilweise) aus dem Netz bezogen.
`cloud_filter_mode` int	Modus des Wolkenfilters, um im PV-Lademodus Überreaktionen bei kurzzeitiger Änderung der Bewölkung zu vermeiden. 0 - Kein Wolkenfilter. 1 - Schwacher Wolkenfilter. 2 - Mittlerer Wolkenfilter. 3 - Starker Wolkenfilter.
`meter_slot_grid_power` int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
`meter_slot_battery_power` int	Gibt an, welcher Stromzähler für die Regelung als Batteriespeicher-Stromzähler betrachtet wird.
`battery_mode` int	Speicherpriorität im Verhältnis zu Wallboxen 0 - Wallboxen bevorzugen, überschüssige Leistung für Speicher 1 - Speicher bevorzugen, überschüssige Leistung für Wallboxen
`battery_inverted` bool	Invertiert das Vorzeichen der Speicherleistung für Batteriespeicher, die beim Laden negative und beim Entladen positive Leistungswerte melden.
`battery_deadzone` int	Bezugs- und Einspeise-Toleranz am Netzanschluss, während der Speicher aktiv ist. Für Batteriespeicher, die einen gewissen Bezug und Einspeisung beim Entladen bzw. Laden erlauben. Die Toleranz sollte auf das 1,5-fache des erwarteten Bezugs und Einspeisung gestellt werden.

`power_manager/dynamic_load_config`

Konfiguration des dynamischen Lastmanagements

Name	Bedeutung
`enabled` bool	Aktiviert dynamisches Lastmanagement.
`meter_slot_grid_currents` int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
`current_limit` int	Maximal gewünschter Strom am Netzanschluss in Milliampere. Dies ist üblicherweise der Nennwert der Absicherung.
`largest_consumer_current` int	Strombedarf des größten Einzelverbrauchers pro Phase in Milliampere, ausgenommen gesteuerter Wallboxen.
`safety_margin_pct` int	Zusätzliche Sicherheitsmarge in Prozent, relativ zum maximalen Strom am Netzanschluss.

`power_manager/state`

Zustand des Power Managers

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/power_manager/state

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/state

{ "config_error_flags": 0, "external_control": 1 }

Name Bedeutung

Name	Bedeutung
`config_error_flags` int	Aktive Konfigurationsfehler des Power Managers. Es handelt sich hierbei um eine Bitmaske, sodass sämtliche Kombinationen aus Konfigurationsfehlern auftreten können. 0 - Kein Fehler 0x00000001 - Phasenumschaltung oder Schütz nicht konfiguriert 0x00000002 - Maximaler Gesamtstrom der Wallboxen nicht konfiguriert 0x00000004 - Keine Wallboxen konfiguriert 0x00000008 - Überschussladen aktiviert aber kein Stromzähler eingerichtet
`external_control` int	Status der externen Steuerung zur Phasenumschaltung. 0 - Externe Steuerung bereit für Kommandos. 1 - Externe Steuerung über die Einstellungen deaktiviert. 2 - Externe Steuerung ist aktiviert aber aktuell nicht verfügbar. Gründe sind unter anderem: ausgelöste Schützüberwachung, eine oder mehrere Wallboxen nicht erreichbar oder unterstützen keine CP-Trennung, Ladevorgang blockiert durch Eingang 3. 3 - Phasenumschaltung wird gerade durchgeführt; ankommende Kommandos werden ignoriert.

config_error_flags
int

Aktive Konfigurationsfehler des Power Managers. Es handelt sich hierbei um eine Bitmaske, sodass sämtliche Kombinationen aus Konfigurationsfehlern auftreten können.

0 - Kein Fehler
0x00000001 - Phasenumschaltung oder Schütz nicht konfiguriert
0x00000002 - Maximaler Gesamtstrom der Wallboxen nicht konfiguriert
0x00000004 - Keine Wallboxen konfiguriert
0x00000008 - Überschussladen aktiviert aber kein Stromzähler eingerichtet

external_control
int

Status der externen Steuerung zur Phasenumschaltung.

0 - Externe Steuerung bereit für Kommandos.
1 - Externe Steuerung über die Einstellungen deaktiviert.
2 - Externe Steuerung ist aktiviert aber aktuell nicht verfügbar. Gründe sind unter anderem: ausgelöste Schützüberwachung, eine oder mehrere Wallboxen nicht erreichbar oder unterstützen keine CP-Trennung, Ladevorgang blockiert durch Eingang 3.
3 - Phasenumschaltung wird gerade durchgeführt; ankommende Kommandos werden ignoriert.

`power_manager/low_level_state`

Der interne Zustand des Power Managers. Wird zum Anzeigen von Debug-Informationen verwendet. Änderungen an diesem Objekt werden nicht als API-Bruch betrachtet!

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/power_manager/low_level_state

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/low_level_state

{
  "power_at_meter": -4067.817383,
  "power_at_meter_filtered": -4909,
  "power_available": 3680,
  "power_available_filtered": 3680,
  "overall_min_power": 1380,
  "threshold_3to1": 3795,
  "threshold_1to3": 4025,
  "charge_manager_available_current": 16000,
  "charge_manager_allocated_current": 16000,
  "max_current_limited": 16000,
  "uptime_past_hysteresis": true,
  "is_3phase": false,
  "wants_3phase": false,
  "wants_3phase_last": false,
  "is_on_last": true,
  "wants_on_last": true,
  "phase_state_change_blocked": false,
  "phase_state_change_delay": 0,
  "on_state_change_blocked": true,
  "on_state_change_delay": 194264,
  "charging_blocked": 0,
  "switching_state": 0
}

`power_manager/charge_mode`

Aktuell verwendeter Lademodus.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/power_manager/charge_mode

{ "mode": 2 }

Schreiben

curl http://$HOST/power_manager/charge_mode -d '{ "mode": 2 }'

oder abgekürzt:

curl http://$HOST/power_manager/charge_mode -d '2'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/charge_mode

{ "mode": 2 }

Schreiben

Mit MQTT auf $PREFIX/power_manager/charge_mode_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/charge_mode_update -m '{ "mode": 2 }'

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/charge_mode_update -m '2'

Name Bedeutung

Name	Bedeutung
`mode` int	0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist. 1 - Aus. Fahrzeuge werden nicht geladen. 2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist. 3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.

mode
int

0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist.
1 - Aus. Fahrzeuge werden nicht geladen.
2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist.
3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.

`power_manager/external_control`

Phasenanforderung für externe Steuerung. Kann geschrieben werden, wenn external_control in power_manager/state 0 ist.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/power_manager/external_control

{ "phases_wanted": 1 }

Schreiben

curl http://$HOST/power_manager/external_control -d '{ "phases_wanted": 1 }'

oder abgekürzt:

curl http://$HOST/power_manager/external_control -d '1'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/external_control

{ "phases_wanted": 1 }

Schreiben

Mit MQTT auf $PREFIX/power_manager/external_control_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/external_control_update -m '{ "phases_wanted": 1 }'

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/external_control_update -m '1'

Name	Bedeutung
`phases_wanted` int	0 - Keine Phasen angefordert, keine Stromfreigabe. 1 - Eine Phase angefordert. 3 - Drei Phasen angefordert.

`power_manager/config`

Konfiguration des Power Managers

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/power_manager/config

{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}

Schreiben

curl http://$HOST/power_manager/config -d '{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/config

{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}

Schreiben

Mit MQTT auf $PREFIX/power_manager/config_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/config_update -m '{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}'

Name	Bedeutung
`enabled` bool	Obsolet. Gibt an, ob der Power Manager aktiviert ist. Dieser Wert wird automatisch überschrieben, abhängig davon, ob PV-Überschussladen oder dynamisches Lastmanagement aktiviert sind.
`default_mode` int	Der nach einem Neustart des Power Managers verwendete Lademodus 0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist. 1 - Aus. Fahrzeuge werden nicht geladen. 2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist. 3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.
`excess_charging_enable` bool	Wenn aktiviert, regelt der Power Manager die von ihm kontrollierten Verbraucher abhängig vom Überschuss einer vorhandenen Photovoltaikanlage. Wenn deaktiviert, wird die maximale Leistung unter Einhaltung der maximale Strombelastbarkeit der Zuleitungen erlaubt.
`phase_switching_mode` int	0 - Automatischer Wechsel zwischen drei- und einphasigem Laden. Nur möglich, wenn contactor_installed true ist. 1 - Immer einphasig 2 - Immer dreiphasig 4 - Einphasiger PV-Modus, dreiphasiger Schnell-Modus
`target_power_from_grid` int (W)	Soll-Netzbezug für Überschussregelung. Gibt den gewünschten Netzbezug (positive Werte) bzw. Netzeinspeisung (negative Werte) im PV-Lademodus vor. Damit kann auch die Priorität gegenüber einem Batteriespeicher beeinflusst werden.
`guaranteed_power` int (W)	Mindest-Ladeleistung, die für den Min + PV-Lademodus verwendet wird. Diese Leistung wird bei unzureichendem PV-Überschuss (teilweise) aus dem Netz bezogen.
`cloud_filter_mode` int	Modus des Wolkenfilters, um im PV-Lademodus Überreaktionen bei kurzzeitiger Änderung der Bewölkung zu vermeiden. 0 - Kein Wolkenfilter. 1 - Schwacher Wolkenfilter. 2 - Mittlerer Wolkenfilter. 3 - Starker Wolkenfilter.
`meter_slot_grid_power` int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
`meter_slot_battery_power` int	Gibt an, welcher Stromzähler für die Regelung als Batteriespeicher-Stromzähler betrachtet wird.
`battery_mode` int	Speicherpriorität im Verhältnis zu Wallboxen 0 - Wallboxen bevorzugen, überschüssige Leistung für Speicher 1 - Speicher bevorzugen, überschüssige Leistung für Wallboxen
`battery_inverted` bool	Invertiert das Vorzeichen der Speicherleistung für Batteriespeicher, die beim Laden negative und beim Entladen positive Leistungswerte melden.
`battery_deadzone` int	Bezugs- und Einspeise-Toleranz am Netzanschluss, während der Speicher aktiv ist. Für Batteriespeicher, die einen gewissen Bezug und Einspeisung beim Entladen bzw. Laden erlauben. Die Toleranz sollte auf das 1,5-fache des erwarteten Bezugs und Einspeisung gestellt werden.

`power_manager/dynamic_load_config`

Konfiguration des dynamischen Lastmanagements

Name	Bedeutung
`enabled` bool	Aktiviert dynamisches Lastmanagement.
`meter_slot_grid_currents` int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
`current_limit` int	Maximal gewünschter Strom am Netzanschluss in Milliampere. Dies ist üblicherweise der Nennwert der Absicherung.
`largest_consumer_current` int	Strombedarf des größten Einzelverbrauchers pro Phase in Milliampere, ausgenommen gesteuerter Wallboxen.
`safety_margin_pct` int	Zusätzliche Sicherheitsmarge in Prozent, relativ zum maximalen Strom am Netzanschluss.

`power_manager/state`

Zustand des Power Managers

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/power_manager/state

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/state

{ "config_error_flags": 0, "external_control": 1 }

Name Bedeutung

Name	Bedeutung
`config_error_flags` int	Aktive Konfigurationsfehler des Power Managers. Es handelt sich hierbei um eine Bitmaske, sodass sämtliche Kombinationen aus Konfigurationsfehlern auftreten können. 0 - Kein Fehler 0x00000001 - Phasenumschaltung oder Schütz nicht konfiguriert 0x00000002 - Maximaler Gesamtstrom der Wallboxen nicht konfiguriert 0x00000004 - Keine Wallboxen konfiguriert 0x00000008 - Überschussladen aktiviert aber kein Stromzähler eingerichtet
`external_control` int	Status der externen Steuerung zur Phasenumschaltung. 0 - Externe Steuerung bereit für Kommandos. 1 - Externe Steuerung über die Einstellungen deaktiviert. 2 - Externe Steuerung ist aktiviert aber aktuell nicht verfügbar. Gründe sind unter anderem: ausgelöste Schützüberwachung, eine oder mehrere Wallboxen nicht erreichbar oder unterstützen keine CP-Trennung, Ladevorgang blockiert durch Eingang 3. 3 - Phasenumschaltung wird gerade durchgeführt; ankommende Kommandos werden ignoriert.

config_error_flags
int

Aktive Konfigurationsfehler des Power Managers. Es handelt sich hierbei um eine Bitmaske, sodass sämtliche Kombinationen aus Konfigurationsfehlern auftreten können.

0 - Kein Fehler
0x00000001 - Phasenumschaltung oder Schütz nicht konfiguriert
0x00000002 - Maximaler Gesamtstrom der Wallboxen nicht konfiguriert
0x00000004 - Keine Wallboxen konfiguriert
0x00000008 - Überschussladen aktiviert aber kein Stromzähler eingerichtet

external_control
int

Status der externen Steuerung zur Phasenumschaltung.

0 - Externe Steuerung bereit für Kommandos.
1 - Externe Steuerung über die Einstellungen deaktiviert.
2 - Externe Steuerung ist aktiviert aber aktuell nicht verfügbar. Gründe sind unter anderem: ausgelöste Schützüberwachung, eine oder mehrere Wallboxen nicht erreichbar oder unterstützen keine CP-Trennung, Ladevorgang blockiert durch Eingang 3.
3 - Phasenumschaltung wird gerade durchgeführt; ankommende Kommandos werden ignoriert.

`power_manager/low_level_state`

Der interne Zustand des Power Managers. Wird zum Anzeigen von Debug-Informationen verwendet. Änderungen an diesem Objekt werden nicht als API-Bruch betrachtet!

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/power_manager/low_level_state

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/low_level_state

{
  "power_at_meter": -4067.817383,
  "power_at_meter_filtered": -4909,
  "power_available": 3680,
  "power_available_filtered": 3680,
  "overall_min_power": 1380,
  "threshold_3to1": 3795,
  "threshold_1to3": 4025,
  "charge_manager_available_current": 16000,
  "charge_manager_allocated_current": 16000,
  "max_current_limited": 16000,
  "uptime_past_hysteresis": true,
  "is_3phase": false,
  "wants_3phase": false,
  "wants_3phase_last": false,
  "is_on_last": true,
  "wants_on_last": true,
  "phase_state_change_blocked": false,
  "phase_state_change_delay": 0,
  "on_state_change_blocked": true,
  "on_state_change_delay": 194264,
  "charging_blocked": 0,
  "switching_state": 0
}

`power_manager/charge_mode`

Aktuell verwendeter Lademodus.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/power_manager/charge_mode

{ "mode": 2 }

Schreiben

curl http://$HOST/power_manager/charge_mode -d '{ "mode": 2 }'

oder abgekürzt:

curl http://$HOST/power_manager/charge_mode -d '2'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/charge_mode

{ "mode": 2 }

Schreiben

Mit MQTT auf $PREFIX/power_manager/charge_mode_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/charge_mode_update -m '{ "mode": 2 }'

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/charge_mode_update -m '2'

Name Bedeutung

Name	Bedeutung
`mode` int	0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist. 1 - Aus. Fahrzeuge werden nicht geladen. 2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist. 3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.

mode
int

0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist.
1 - Aus. Fahrzeuge werden nicht geladen.
2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist.
3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.

`power_manager/external_control`

Phasenanforderung für externe Steuerung. Kann geschrieben werden, wenn external_control in power_manager/state 0 ist.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/power_manager/external_control

{ "phases_wanted": 1 }

Schreiben

curl http://$HOST/power_manager/external_control -d '{ "phases_wanted": 1 }'

oder abgekürzt:

curl http://$HOST/power_manager/external_control -d '1'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/external_control

{ "phases_wanted": 1 }

Schreiben

Mit MQTT auf $PREFIX/power_manager/external_control_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/external_control_update -m '{ "phases_wanted": 1 }'

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/external_control_update -m '1'

Name	Bedeutung
`phases_wanted` int	0 - Keine Phasen angefordert, keine Stromfreigabe. 1 - Eine Phase angefordert. 3 - Drei Phasen angefordert.

`power_manager/config`

Konfiguration des Power Managers

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/power_manager/config

{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}

Schreiben

curl http://$HOST/power_manager/config -d '{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/config

{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}

Schreiben

Mit MQTT auf $PREFIX/power_manager/config_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/config_update -m '{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}'

Name	Bedeutung
`enabled` bool	Obsolet. Gibt an, ob der Power Manager aktiviert ist. Dieser Wert wird automatisch überschrieben, abhängig davon, ob PV-Überschussladen oder dynamisches Lastmanagement aktiviert sind.
`default_mode` int	Der nach einem Neustart des Power Managers verwendete Lademodus 0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist. 1 - Aus. Fahrzeuge werden nicht geladen. 2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist. 3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.
`excess_charging_enable` bool	Wenn aktiviert, regelt der Power Manager die von ihm kontrollierten Verbraucher abhängig vom Überschuss einer vorhandenen Photovoltaikanlage. Wenn deaktiviert, wird die maximale Leistung unter Einhaltung der maximale Strombelastbarkeit der Zuleitungen erlaubt.
`phase_switching_mode` int	0 - Automatischer Wechsel zwischen drei- und einphasigem Laden. Nur möglich, wenn contactor_installed true ist. 1 - Immer einphasig 2 - Immer dreiphasig 4 - Einphasiger PV-Modus, dreiphasiger Schnell-Modus
`target_power_from_grid` int (W)	Soll-Netzbezug für Überschussregelung. Gibt den gewünschten Netzbezug (positive Werte) bzw. Netzeinspeisung (negative Werte) im PV-Lademodus vor. Damit kann auch die Priorität gegenüber einem Batteriespeicher beeinflusst werden.
`guaranteed_power` int (W)	Mindest-Ladeleistung, die für den Min + PV-Lademodus verwendet wird. Diese Leistung wird bei unzureichendem PV-Überschuss (teilweise) aus dem Netz bezogen.
`cloud_filter_mode` int	Modus des Wolkenfilters, um im PV-Lademodus Überreaktionen bei kurzzeitiger Änderung der Bewölkung zu vermeiden. 0 - Kein Wolkenfilter. 1 - Schwacher Wolkenfilter. 2 - Mittlerer Wolkenfilter. 3 - Starker Wolkenfilter.
`meter_slot_grid_power` int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
`meter_slot_battery_power` int	Gibt an, welcher Stromzähler für die Regelung als Batteriespeicher-Stromzähler betrachtet wird.
`battery_mode` int	Speicherpriorität im Verhältnis zu Wallboxen 0 - Wallboxen bevorzugen, überschüssige Leistung für Speicher 1 - Speicher bevorzugen, überschüssige Leistung für Wallboxen
`battery_inverted` bool	Invertiert das Vorzeichen der Speicherleistung für Batteriespeicher, die beim Laden negative und beim Entladen positive Leistungswerte melden.
`battery_deadzone` int	Bezugs- und Einspeise-Toleranz am Netzanschluss, während der Speicher aktiv ist. Für Batteriespeicher, die einen gewissen Bezug und Einspeisung beim Entladen bzw. Laden erlauben. Die Toleranz sollte auf das 1,5-fache des erwarteten Bezugs und Einspeisung gestellt werden.

`power_manager/dynamic_load_config`

Konfiguration des dynamischen Lastmanagements

Name	Bedeutung
`enabled` bool	Aktiviert dynamisches Lastmanagement.
`meter_slot_grid_currents` int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
`current_limit` int	Maximal gewünschter Strom am Netzanschluss in Milliampere. Dies ist üblicherweise der Nennwert der Absicherung.
`largest_consumer_current` int	Strombedarf des größten Einzelverbrauchers pro Phase in Milliampere, ausgenommen gesteuerter Wallboxen.
`safety_margin_pct` int	Zusätzliche Sicherheitsmarge in Prozent, relativ zum maximalen Strom am Netzanschluss.

`power_manager/state`

Zustand des Power Managers

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/power_manager/state

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/state

{ "config_error_flags": 0, "external_control": 1 }

Name Bedeutung

Name	Bedeutung
`config_error_flags` int	Aktive Konfigurationsfehler des Power Managers. Es handelt sich hierbei um eine Bitmaske, sodass sämtliche Kombinationen aus Konfigurationsfehlern auftreten können. 0 - Kein Fehler 0x00000001 - Phasenumschaltung oder Schütz nicht konfiguriert 0x00000002 - Maximaler Gesamtstrom der Wallboxen nicht konfiguriert 0x00000004 - Keine Wallboxen konfiguriert 0x00000008 - Überschussladen aktiviert aber kein Stromzähler eingerichtet
`external_control` int	Status der externen Steuerung zur Phasenumschaltung. 0 - Externe Steuerung bereit für Kommandos. 1 - Externe Steuerung über die Einstellungen deaktiviert. 2 - Externe Steuerung ist aktiviert aber aktuell nicht verfügbar. Gründe sind unter anderem: ausgelöste Schützüberwachung, eine oder mehrere Wallboxen nicht erreichbar oder unterstützen keine CP-Trennung, Ladevorgang blockiert durch Eingang 3. 3 - Phasenumschaltung wird gerade durchgeführt; ankommende Kommandos werden ignoriert.

config_error_flags
int

Aktive Konfigurationsfehler des Power Managers. Es handelt sich hierbei um eine Bitmaske, sodass sämtliche Kombinationen aus Konfigurationsfehlern auftreten können.

0 - Kein Fehler
0x00000001 - Phasenumschaltung oder Schütz nicht konfiguriert
0x00000002 - Maximaler Gesamtstrom der Wallboxen nicht konfiguriert
0x00000004 - Keine Wallboxen konfiguriert
0x00000008 - Überschussladen aktiviert aber kein Stromzähler eingerichtet

external_control
int

Status der externen Steuerung zur Phasenumschaltung.

0 - Externe Steuerung bereit für Kommandos.
1 - Externe Steuerung über die Einstellungen deaktiviert.
2 - Externe Steuerung ist aktiviert aber aktuell nicht verfügbar. Gründe sind unter anderem: ausgelöste Schützüberwachung, eine oder mehrere Wallboxen nicht erreichbar oder unterstützen keine CP-Trennung, Ladevorgang blockiert durch Eingang 3.
3 - Phasenumschaltung wird gerade durchgeführt; ankommende Kommandos werden ignoriert.

`power_manager/low_level_state`

Der interne Zustand des Power Managers. Wird zum Anzeigen von Debug-Informationen verwendet. Änderungen an diesem Objekt werden nicht als API-Bruch betrachtet!

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/power_manager/low_level_state

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/low_level_state

{
  "power_at_meter": -4067.817383,
  "power_at_meter_filtered": -4909,
  "power_available": 3680,
  "power_available_filtered": 3680,
  "overall_min_power": 1380,
  "threshold_3to1": 3795,
  "threshold_1to3": 4025,
  "charge_manager_available_current": 16000,
  "charge_manager_allocated_current": 16000,
  "max_current_limited": 16000,
  "uptime_past_hysteresis": true,
  "is_3phase": false,
  "wants_3phase": false,
  "wants_3phase_last": false,
  "is_on_last": true,
  "wants_on_last": true,
  "phase_state_change_blocked": false,
  "phase_state_change_delay": 0,
  "on_state_change_blocked": true,
  "on_state_change_delay": 194264,
  "charging_blocked": 0,
  "switching_state": 0
}

`power_manager/charge_mode`

Aktuell verwendeter Lademodus.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/power_manager/charge_mode

{ "mode": 2 }

Schreiben

curl http://$HOST/power_manager/charge_mode -d '{ "mode": 2 }'

oder abgekürzt:

curl http://$HOST/power_manager/charge_mode -d '2'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/charge_mode

{ "mode": 2 }

Schreiben

Mit MQTT auf $PREFIX/power_manager/charge_mode_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/charge_mode_update -m '{ "mode": 2 }'

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/charge_mode_update -m '2'

Name Bedeutung

Name	Bedeutung
`mode` int	0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist. 1 - Aus. Fahrzeuge werden nicht geladen. 2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist. 3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.

mode
int

0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist.
1 - Aus. Fahrzeuge werden nicht geladen.
2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist.
3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.

`power_manager/external_control`

Phasenanforderung für externe Steuerung. Kann geschrieben werden, wenn external_control in power_manager/state 0 ist.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/power_manager/external_control

{ "phases_wanted": 1 }

Schreiben

curl http://$HOST/power_manager/external_control -d '{ "phases_wanted": 1 }'

oder abgekürzt:

curl http://$HOST/power_manager/external_control -d '1'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/external_control

{ "phases_wanted": 1 }

Schreiben

Mit MQTT auf $PREFIX/power_manager/external_control_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/external_control_update -m '{ "phases_wanted": 1 }'

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/external_control_update -m '1'

Name	Bedeutung
`phases_wanted` int	0 - Keine Phasen angefordert, keine Stromfreigabe. 1 - Eine Phase angefordert. 3 - Drei Phasen angefordert.

`power_manager/config`

Konfiguration des Power Managers

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/power_manager/config

{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}

Schreiben

curl http://$HOST/power_manager/config -d '{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/config

{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}

Schreiben

Mit MQTT auf $PREFIX/power_manager/config_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/config_update -m '{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}'

Name	Bedeutung
`enabled` bool	Obsolet. Gibt an, ob der Power Manager aktiviert ist. Dieser Wert wird automatisch überschrieben, abhängig davon, ob PV-Überschussladen oder dynamisches Lastmanagement aktiviert sind.
`default_mode` int	Der nach einem Neustart des Power Managers verwendete Lademodus 0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist. 1 - Aus. Fahrzeuge werden nicht geladen. 2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist. 3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.
`excess_charging_enable` bool	Wenn aktiviert, regelt der Power Manager die von ihm kontrollierten Verbraucher abhängig vom Überschuss einer vorhandenen Photovoltaikanlage. Wenn deaktiviert, wird die maximale Leistung unter Einhaltung der maximale Strombelastbarkeit der Zuleitungen erlaubt.
`phase_switching_mode` int	0 - Automatischer Wechsel zwischen drei- und einphasigem Laden. Nur möglich, wenn contactor_installed true ist. 1 - Immer einphasig 2 - Immer dreiphasig 4 - Einphasiger PV-Modus, dreiphasiger Schnell-Modus
`target_power_from_grid` int (W)	Soll-Netzbezug für Überschussregelung. Gibt den gewünschten Netzbezug (positive Werte) bzw. Netzeinspeisung (negative Werte) im PV-Lademodus vor. Damit kann auch die Priorität gegenüber einem Batteriespeicher beeinflusst werden.
`guaranteed_power` int (W)	Mindest-Ladeleistung, die für den Min + PV-Lademodus verwendet wird. Diese Leistung wird bei unzureichendem PV-Überschuss (teilweise) aus dem Netz bezogen.
`cloud_filter_mode` int	Modus des Wolkenfilters, um im PV-Lademodus Überreaktionen bei kurzzeitiger Änderung der Bewölkung zu vermeiden. 0 - Kein Wolkenfilter. 1 - Schwacher Wolkenfilter. 2 - Mittlerer Wolkenfilter. 3 - Starker Wolkenfilter.
`meter_slot_grid_power` int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
`meter_slot_battery_power` int	Gibt an, welcher Stromzähler für die Regelung als Batteriespeicher-Stromzähler betrachtet wird.
`battery_mode` int	Speicherpriorität im Verhältnis zu Wallboxen 0 - Wallboxen bevorzugen, überschüssige Leistung für Speicher 1 - Speicher bevorzugen, überschüssige Leistung für Wallboxen
`battery_inverted` bool	Invertiert das Vorzeichen der Speicherleistung für Batteriespeicher, die beim Laden negative und beim Entladen positive Leistungswerte melden.
`battery_deadzone` int	Bezugs- und Einspeise-Toleranz am Netzanschluss, während der Speicher aktiv ist. Für Batteriespeicher, die einen gewissen Bezug und Einspeisung beim Entladen bzw. Laden erlauben. Die Toleranz sollte auf das 1,5-fache des erwarteten Bezugs und Einspeisung gestellt werden.

`power_manager/dynamic_load_config`

Konfiguration des dynamischen Lastmanagements

Name	Bedeutung
`enabled` bool	Aktiviert dynamisches Lastmanagement.
`meter_slot_grid_currents` int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
`current_limit` int	Maximal gewünschter Strom am Netzanschluss in Milliampere. Dies ist üblicherweise der Nennwert der Absicherung.
`largest_consumer_current` int	Strombedarf des größten Einzelverbrauchers pro Phase in Milliampere, ausgenommen gesteuerter Wallboxen.
`safety_margin_pct` int	Zusätzliche Sicherheitsmarge in Prozent, relativ zum maximalen Strom am Netzanschluss.

`power_manager/state`

Zustand des Power Managers

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/power_manager/state

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/state

{ "config_error_flags": 0, "external_control": 1 }

Name Bedeutung

Name	Bedeutung
`config_error_flags` int	Aktive Konfigurationsfehler des Power Managers. Es handelt sich hierbei um eine Bitmaske, sodass sämtliche Kombinationen aus Konfigurationsfehlern auftreten können. 0 - Kein Fehler 0x00000001 - Phasenumschaltung oder Schütz nicht konfiguriert 0x00000002 - Maximaler Gesamtstrom der Wallboxen nicht konfiguriert 0x00000004 - Keine Wallboxen konfiguriert 0x00000008 - Überschussladen aktiviert aber kein Stromzähler eingerichtet
`external_control` int	Status der externen Steuerung zur Phasenumschaltung. 0 - Externe Steuerung bereit für Kommandos. 1 - Externe Steuerung über die Einstellungen deaktiviert. 2 - Externe Steuerung ist aktiviert aber aktuell nicht verfügbar. Gründe sind unter anderem: ausgelöste Schützüberwachung, eine oder mehrere Wallboxen nicht erreichbar oder unterstützen keine CP-Trennung, Ladevorgang blockiert durch Eingang 3. 3 - Phasenumschaltung wird gerade durchgeführt; ankommende Kommandos werden ignoriert.

config_error_flags
int

Aktive Konfigurationsfehler des Power Managers. Es handelt sich hierbei um eine Bitmaske, sodass sämtliche Kombinationen aus Konfigurationsfehlern auftreten können.

0 - Kein Fehler
0x00000001 - Phasenumschaltung oder Schütz nicht konfiguriert
0x00000002 - Maximaler Gesamtstrom der Wallboxen nicht konfiguriert
0x00000004 - Keine Wallboxen konfiguriert
0x00000008 - Überschussladen aktiviert aber kein Stromzähler eingerichtet

external_control
int

Status der externen Steuerung zur Phasenumschaltung.

0 - Externe Steuerung bereit für Kommandos.
1 - Externe Steuerung über die Einstellungen deaktiviert.
2 - Externe Steuerung ist aktiviert aber aktuell nicht verfügbar. Gründe sind unter anderem: ausgelöste Schützüberwachung, eine oder mehrere Wallboxen nicht erreichbar oder unterstützen keine CP-Trennung, Ladevorgang blockiert durch Eingang 3.
3 - Phasenumschaltung wird gerade durchgeführt; ankommende Kommandos werden ignoriert.

`power_manager/low_level_state`

Der interne Zustand des Power Managers. Wird zum Anzeigen von Debug-Informationen verwendet. Änderungen an diesem Objekt werden nicht als API-Bruch betrachtet!

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/power_manager/low_level_state

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/low_level_state

{
  "power_at_meter": -4067.817383,
  "power_at_meter_filtered": -4909,
  "power_available": 3680,
  "power_available_filtered": 3680,
  "overall_min_power": 1380,
  "threshold_3to1": 3795,
  "threshold_1to3": 4025,
  "charge_manager_available_current": 16000,
  "charge_manager_allocated_current": 16000,
  "max_current_limited": 16000,
  "uptime_past_hysteresis": true,
  "is_3phase": false,
  "wants_3phase": false,
  "wants_3phase_last": false,
  "is_on_last": true,
  "wants_on_last": true,
  "phase_state_change_blocked": false,
  "phase_state_change_delay": 0,
  "on_state_change_blocked": true,
  "on_state_change_delay": 194264,
  "charging_blocked": 0,
  "switching_state": 0
}

`power_manager/charge_mode`

Aktuell verwendeter Lademodus.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/power_manager/charge_mode

{ "mode": 2 }

Schreiben

curl http://$HOST/power_manager/charge_mode -d '{ "mode": 2 }'

oder abgekürzt:

curl http://$HOST/power_manager/charge_mode -d '2'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/charge_mode

{ "mode": 2 }

Schreiben

Mit MQTT auf $PREFIX/power_manager/charge_mode_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/charge_mode_update -m '{ "mode": 2 }'

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/charge_mode_update -m '2'

Name Bedeutung

Name	Bedeutung
`mode` int	0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist. 1 - Aus. Fahrzeuge werden nicht geladen. 2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist. 3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.

mode
int

0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist.
1 - Aus. Fahrzeuge werden nicht geladen.
2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist.
3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.

`power_manager/external_control`

Phasenanforderung für externe Steuerung. Kann geschrieben werden, wenn external_control in power_manager/state 0 ist.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/power_manager/external_control

{ "phases_wanted": 1 }

Schreiben

curl http://$HOST/power_manager/external_control -d '{ "phases_wanted": 1 }'

oder abgekürzt:

curl http://$HOST/power_manager/external_control -d '1'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/external_control

{ "phases_wanted": 1 }

Schreiben

Mit MQTT auf $PREFIX/power_manager/external_control_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/external_control_update -m '{ "phases_wanted": 1 }'

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/external_control_update -m '1'

Name	Bedeutung
`phases_wanted` int	0 - Keine Phasen angefordert, keine Stromfreigabe. 1 - Eine Phase angefordert. 3 - Drei Phasen angefordert.

`power_manager/config`

Konfiguration des Power Managers

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/power_manager/config

{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}

Schreiben

curl http://$HOST/power_manager/config -d '{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/config

{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}

Schreiben

Mit MQTT auf $PREFIX/power_manager/config_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/config_update -m '{
  "enabled": true,
  "phase_switching_mode": 1,
  "excess_charging_enable": true,
  "default_mode": 0,
  "meter_slot_grid_power": 3,
  "target_power_from_grid": 0,
  "guaranteed_power": 1380,
  "cloud_filter_mode": 2
}'

Name	Bedeutung
`enabled` bool	Obsolet. Gibt an, ob der Power Manager aktiviert ist. Dieser Wert wird automatisch überschrieben, abhängig davon, ob PV-Überschussladen oder dynamisches Lastmanagement aktiviert sind.
`default_mode` int	Der nach einem Neustart des Power Managers verwendete Lademodus 0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist. 1 - Aus. Fahrzeuge werden nicht geladen. 2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist. 3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.
`excess_charging_enable` bool	Wenn aktiviert, regelt der Power Manager die von ihm kontrollierten Verbraucher abhängig vom Überschuss einer vorhandenen Photovoltaikanlage. Wenn deaktiviert, wird die maximale Leistung unter Einhaltung der maximale Strombelastbarkeit der Zuleitungen erlaubt.
`phase_switching_mode` int	0 - Automatischer Wechsel zwischen drei- und einphasigem Laden. Nur möglich, wenn contactor_installed true ist. 1 - Immer einphasig 2 - Immer dreiphasig 4 - Einphasiger PV-Modus, dreiphasiger Schnell-Modus
`target_power_from_grid` int (W)	Soll-Netzbezug für Überschussregelung. Gibt den gewünschten Netzbezug (positive Werte) bzw. Netzeinspeisung (negative Werte) im PV-Lademodus vor. Damit kann auch die Priorität gegenüber einem Batteriespeicher beeinflusst werden.
`guaranteed_power` int (W)	Mindest-Ladeleistung, die für den Min + PV-Lademodus verwendet wird. Diese Leistung wird bei unzureichendem PV-Überschuss (teilweise) aus dem Netz bezogen.
`cloud_filter_mode` int	Modus des Wolkenfilters, um im PV-Lademodus Überreaktionen bei kurzzeitiger Änderung der Bewölkung zu vermeiden. 0 - Kein Wolkenfilter. 1 - Schwacher Wolkenfilter. 2 - Mittlerer Wolkenfilter. 3 - Starker Wolkenfilter.
`meter_slot_grid_power` int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
`meter_slot_battery_power` int	Gibt an, welcher Stromzähler für die Regelung als Batteriespeicher-Stromzähler betrachtet wird.
`battery_mode` int	Speicherpriorität im Verhältnis zu Wallboxen 0 - Wallboxen bevorzugen, überschüssige Leistung für Speicher 1 - Speicher bevorzugen, überschüssige Leistung für Wallboxen
`battery_inverted` bool	Invertiert das Vorzeichen der Speicherleistung für Batteriespeicher, die beim Laden negative und beim Entladen positive Leistungswerte melden.
`battery_deadzone` int	Bezugs- und Einspeise-Toleranz am Netzanschluss, während der Speicher aktiv ist. Für Batteriespeicher, die einen gewissen Bezug und Einspeisung beim Entladen bzw. Laden erlauben. Die Toleranz sollte auf das 1,5-fache des erwarteten Bezugs und Einspeisung gestellt werden.

`power_manager/dynamic_load_config`

Konfiguration des dynamischen Lastmanagements

Name	Bedeutung
`enabled` bool	Aktiviert dynamisches Lastmanagement.
`meter_slot_grid_currents` int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
`current_limit` int	Maximal gewünschter Strom am Netzanschluss in Milliampere. Dies ist üblicherweise der Nennwert der Absicherung.
`largest_consumer_current` int	Strombedarf des größten Einzelverbrauchers pro Phase in Milliampere, ausgenommen gesteuerter Wallboxen.
`safety_margin_pct` int	Zusätzliche Sicherheitsmarge in Prozent, relativ zum maximalen Strom am Netzanschluss.

`power_manager/state`

Zustand des Power Managers

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/power_manager/state

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/state

{ "config_error_flags": 0, "external_control": 1 }

Name Bedeutung

Name	Bedeutung
`config_error_flags` int	Aktive Konfigurationsfehler des Power Managers. Es handelt sich hierbei um eine Bitmaske, sodass sämtliche Kombinationen aus Konfigurationsfehlern auftreten können. 0 - Kein Fehler 0x00000001 - Phasenumschaltung oder Schütz nicht konfiguriert 0x00000002 - Maximaler Gesamtstrom der Wallboxen nicht konfiguriert 0x00000004 - Keine Wallboxen konfiguriert 0x00000008 - Überschussladen aktiviert aber kein Stromzähler eingerichtet
`external_control` int	Status der externen Steuerung zur Phasenumschaltung. 0 - Externe Steuerung bereit für Kommandos. 1 - Externe Steuerung über die Einstellungen deaktiviert. 2 - Externe Steuerung ist aktiviert aber aktuell nicht verfügbar. Gründe sind unter anderem: ausgelöste Schützüberwachung, eine oder mehrere Wallboxen nicht erreichbar oder unterstützen keine CP-Trennung, Ladevorgang blockiert durch Eingang 3. 3 - Phasenumschaltung wird gerade durchgeführt; ankommende Kommandos werden ignoriert.

config_error_flags
int

Aktive Konfigurationsfehler des Power Managers. Es handelt sich hierbei um eine Bitmaske, sodass sämtliche Kombinationen aus Konfigurationsfehlern auftreten können.

0 - Kein Fehler
0x00000001 - Phasenumschaltung oder Schütz nicht konfiguriert
0x00000002 - Maximaler Gesamtstrom der Wallboxen nicht konfiguriert
0x00000004 - Keine Wallboxen konfiguriert
0x00000008 - Überschussladen aktiviert aber kein Stromzähler eingerichtet

external_control
int

Status der externen Steuerung zur Phasenumschaltung.

0 - Externe Steuerung bereit für Kommandos.
1 - Externe Steuerung über die Einstellungen deaktiviert.
2 - Externe Steuerung ist aktiviert aber aktuell nicht verfügbar. Gründe sind unter anderem: ausgelöste Schützüberwachung, eine oder mehrere Wallboxen nicht erreichbar oder unterstützen keine CP-Trennung, Ladevorgang blockiert durch Eingang 3.
3 - Phasenumschaltung wird gerade durchgeführt; ankommende Kommandos werden ignoriert.

`power_manager/low_level_state`

Der interne Zustand des Power Managers. Wird zum Anzeigen von Debug-Informationen verwendet. Änderungen an diesem Objekt werden nicht als API-Bruch betrachtet!

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/power_manager/low_level_state

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/low_level_state

{
  "power_at_meter": -4067.817383,
  "power_at_meter_filtered": -4909,
  "power_available": 3680,
  "power_available_filtered": 3680,
  "overall_min_power": 1380,
  "threshold_3to1": 3795,
  "threshold_1to3": 4025,
  "charge_manager_available_current": 16000,
  "charge_manager_allocated_current": 16000,
  "max_current_limited": 16000,
  "uptime_past_hysteresis": true,
  "is_3phase": false,
  "wants_3phase": false,
  "wants_3phase_last": false,
  "is_on_last": true,
  "wants_on_last": true,
  "phase_state_change_blocked": false,
  "phase_state_change_delay": 0,
  "on_state_change_blocked": true,
  "on_state_change_delay": 194264,
  "charging_blocked": 0,
  "switching_state": 0
}

`power_manager/charge_mode`

Aktuell verwendeter Lademodus.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/power_manager/charge_mode

{ "mode": 2 }

Schreiben

curl http://$HOST/power_manager/charge_mode -d '{ "mode": 2 }'

oder abgekürzt:

curl http://$HOST/power_manager/charge_mode -d '2'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/charge_mode

{ "mode": 2 }

Schreiben

Mit MQTT auf $PREFIX/power_manager/charge_mode_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/charge_mode_update -m '{ "mode": 2 }'

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/charge_mode_update -m '2'

Name Bedeutung

Name	Bedeutung
`mode` int	0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist. 1 - Aus. Fahrzeuge werden nicht geladen. 2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist. 3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.

mode
int

0 - Schnell. Lädt Fahrzeuge so schnell wie möglich, selbst wenn dafür Netzbezug notwendig ist.
1 - Aus. Fahrzeuge werden nicht geladen.
2 - PV. Fahrzeuge werden nur vom PV-Überschuss geladen. Steht nur zur Verfügung, wenn excess_charging_enable true ist.
3 - Min + PV. Erlaubt die konfigurierte Mindest-Ladeleistung (guaranteed_power), auch wenn diese (teilweise) aus dem Netz bezogen werden muss. Wenn ein größerer PV-Überschuss zur Verfügung steht, wird dieser verwendet. Steht nur zur Verfügung, wenn excess_charging_enable true ist.

`power_manager/external_control`

Phasenanforderung für externe Steuerung. Kann geschrieben werden, wenn external_control in power_manager/state 0 ist.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/power_manager/external_control

{ "phases_wanted": 1 }

Schreiben

curl http://$HOST/power_manager/external_control -d '{ "phases_wanted": 1 }'

oder abgekürzt:

curl http://$HOST/power_manager/external_control -d '1'

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/power_manager/external_control

{ "phases_wanted": 1 }

Schreiben

Mit MQTT auf $PREFIX/power_manager/external_control_update

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/external_control_update -m '{ "phases_wanted": 1 }'

oder abgekürzt:

mosquitto_pub -h $BROKER -t $PREFIX/power_manager/external_control_update -m '1'

Name	Bedeutung
`phases_wanted` int	0 - Keine Phasen angefordert, keine Stromfreigabe. 1 - Eine Phase angefordert. 3 - Drei Phasen angefordert.

power_manager/config​

Lesen​

Schreiben​

Lesen​

Schreiben​

power_manager/dynamic_load_config​

power_manager/state​

Lesen​

Lesen​

power_manager/low_level_state​

Lesen​

Lesen​

power_manager/charge_mode​

Lesen​

Schreiben​

Lesen​

Schreiben​

power_manager/external_control​

Lesen​

Schreiben​

Lesen​

Schreiben​

power_manager/config​

Lesen​

Schreiben​

Lesen​

Schreiben​

power_manager/dynamic_load_config​

power_manager/state​

Lesen​

Lesen​

power_manager/low_level_state​

Lesen​

Lesen​

power_manager/charge_mode​

Lesen​

Schreiben​

Lesen​

Schreiben​

power_manager/external_control​

Lesen​

Schreiben​

Lesen​

Schreiben​

power_manager/config​

Lesen​

Schreiben​

Lesen​

Schreiben​

power_manager/dynamic_load_config​

power_manager/state​

Lesen​

Lesen​

power_manager/low_level_state​

Lesen​

Lesen​

power_manager/charge_mode​

Lesen​

Schreiben​

Lesen​

Schreiben​

power_manager/external_control​

Lesen​

Schreiben​

Lesen​

Schreiben​

power_manager/config​

Lesen​

Schreiben​

Lesen​

Schreiben​

power_manager/dynamic_load_config​

power_manager/state​

Lesen​

Lesen​

power_manager/low_level_state​

Lesen​

Lesen​

power_manager/charge_mode​

Lesen​

`power_manager/config`

Lesen

Schreiben

Lesen

Schreiben

`power_manager/dynamic_load_config`

`power_manager/state`

Lesen

Lesen

`power_manager/low_level_state`

Lesen

Lesen

`power_manager/charge_mode`

Lesen

Schreiben

Lesen

Schreiben

`power_manager/external_control`

Lesen

Schreiben

Lesen

Schreiben

`power_manager/config`

Lesen

Schreiben

Lesen

Schreiben

`power_manager/dynamic_load_config`

`power_manager/state`

Lesen

Lesen

`power_manager/low_level_state`

Lesen

Lesen

`power_manager/charge_mode`

Lesen

Schreiben

Lesen

Schreiben

`power_manager/external_control`

Lesen

Schreiben

Lesen

Schreiben

`power_manager/config`

Lesen

Schreiben

Lesen

Schreiben

`power_manager/dynamic_load_config`

`power_manager/state`

Lesen

Lesen

`power_manager/low_level_state`

Lesen

Lesen

`power_manager/charge_mode`

Lesen

Schreiben

Lesen

Schreiben

`power_manager/external_control`

Lesen

Schreiben

Lesen

Schreiben

`power_manager/config`

Lesen

Schreiben

Lesen

Schreiben

`power_manager/dynamic_load_config`

`power_manager/state`

Lesen

Lesen

`power_manager/low_level_state`

Lesen

Lesen

`power_manager/charge_mode`

Lesen