Heizung

Über das heating-Modul können Einstellungen für die Heizungssteuerung vorgenommen werden.

warp1

Auf dieser Hardware nicht unterstützt!

warp2

Auf dieser Hardware nicht unterstützt!

warp3

Auf dieser Hardware nicht unterstützt!

wem

Auf dieser Hardware nicht unterstützt!

wem2

heating/config

Die Konfiguration der Heizungssteuerung.

Beispiel

HTTP (curl)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/heating/config

{
    "sgr_blocking_type": 0,
    "sgr_extended_type": 0,
    "min_hold_time": 15,
    "meter_slot_grid_power": 1,
    "control_period": 0,
    "extended_logging": false,
    "yield_forecast": true,
    "yield_forecast_threshold": 10,
    "extended": true,
    "extended_hours": 3,
    "blocking": true,
    "blocking_hours": 14,
    "pv_excess_control": true,
    "pv_excess_control_threshold": 1400,
    "p14enwg": false,
    "p14enwg_input": 0,
    "p14enwg_type": 0
}

Schreiben

curl http://$HOST/heating/config -d '{
    "sgr_blocking_type": 0,
    "sgr_extended_type": 0,
    "min_hold_time": 15,
    "meter_slot_grid_power": 1,
    "control_period": 0,
    "extended_logging": false,
    "yield_forecast": true,
    "yield_forecast_threshold": 10,
    "extended": true,
    "extended_hours": 3,
    "blocking": true,
    "blocking_hours": 14,
    "pv_excess_control": true,
    "pv_excess_control_threshold": 1400,
    "p14enwg": false,
    "p14enwg_input": 0,
    "p14enwg_type": 0
}'

MQTT (mosquitto)

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

Lesen

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

{
    "sgr_blocking_type": 0,
    "sgr_extended_type": 0,
    "min_hold_time": 15,
    "meter_slot_grid_power": 1,
    "control_period": 0,
    "extended_logging": false,
    "yield_forecast": true,
    "yield_forecast_threshold": 10,
    "extended": true,
    "extended_hours": 3,
    "blocking": true,
    "blocking_hours": 14,
    "pv_excess_control": true,
    "pv_excess_control_threshold": 1400,
    "p14enwg": false,
    "p14enwg_input": 0,
    "p14enwg_type": 0
}

Schreiben

Mit MQTT auf $PREFIX/heating/config_update

mosquitto_pub -h $BROKER -t $PREFIX/heating/config_update -m '{
    "sgr_blocking_type": 0,
    "sgr_extended_type": 0,
    "min_hold_time": 15,
    "meter_slot_grid_power": 1,
    "control_period": 0,
    "extended_logging": false,
    "yield_forecast": true,
    "yield_forecast_threshold": 10,
    "extended": true,
    "extended_hours": 3,
    "blocking": true,
    "blocking_hours": 14,
    "pv_excess_control": true,
    "pv_excess_control_threshold": 1400,
    "p14enwg": false,
    "p14enwg_input": 0,
    "p14enwg_type": 0
}'

Name	Beschreibung
sgr_blocking_type int	SG-Ready Ausgang 1 Konfiguration (wird für den blockierenden Betrieb verwendet). 0 - Aktiv wenn geschlossen 1 - Aktiv wenn geöffnet
sgr_extended_type int	SG-Ready Ausgang 2 Konfiguration (wird für den erweiterten Betrieb verwendet). 0 - Aktiv wenn geschlossen 1 - Aktiv wenn geöffnet
min_hold_time int (min)	Mindesthaltezeit für SG-Ready-Ausgang 1 und SG-Ready-Ausgang 2.
meter_slot_grid_power int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
control_period int	Regelzeitraum, der für die zeitbasierte Steuerung betrachtet wird. 0 - 24 Stunden 1 - 12 Stunden 2 - 8 Stunden 3 - 6 Stunden 4 - 4 Stunden
extended_logging bool	Gibt an, ob weiterführende Informationen zu den Steuerentscheidungen im Ereignis-Log aufgezeichnet werden sollen.
yield_forecast bool	Gibt an, ob die PV-Ertragsprognose für die Heizungssteuerung verwendet werden soll.
yield_forecast_threshold int (kWh)	Grenzwert Für die PV-Ertragsprognose. Wenn die PV-Ertragsprognosen-Steuerung aktiviert ist und die Prognose größer als die eingestellte Energie ausfällt, entfällt die Dynamische-Strom­preis-Steuerung und es wird ausschließlich der PV-Über­schuss genutzt.
extended bool	Gibt an, ob die Steuerung des erweiterten Betriebs aktiviert werden soll.
extended_hours int (h)	Anzahl der (günstigsten) Stunden für die der erweiterte Betrieb genutzt werden soll.
blocking bool	Gibt an, ob die Steuerung des blockierenden Betriebs aktiviert werden soll.
blocking_hours int (h)	Anzahl der (teuersten) Stunden für die der blockierende Betrieb genutzt werden soll.
pv_excess_control bool	Gibt an, ob die PV-Überschusssteuerung aktiviert werden soll.
pv_excess_control_threshold int (W)	Grenzewert für die PV-Überschusssteuerung. Wenn die PV-Überschusssteuerung aktiviert ist und der PV-Überschuss größer als der eingestellte Wert ausfällt, wird die Heizung nur bei PV-Überschuss in den erweiterten Betrieb gebracht.
p14enwg bool	Gibt an, ob die §14a EnWG-Steuerung aktiviert werden soll.
p14enwg_input int	Gibt an, welcher Eingang des Energiemanagers für die Abschaltung per §14a EnWG genutzt werden soll. 0 - Eingang 1 1 - Eingang 2 2 - Eingang 3 3 - Eingang 4
p14enwg_type int	Konfiguration für den Eingang. 0 - Aktiv wenn geschlossen 1 - Aktiv wenn geöffnet

heating/state

Der Zustand der Heizungssteuerung.

Beispiel

HTTP (curl)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/heating/state

MQTT (mosquitto)

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

Lesen

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

{
    "sgr_blocking": true,
    "sgr_extended": false,
    "p14enwg": false,
    "next_update": 28899735
}

Name	Beschreibung
sgr_blocking bool	Gibt an, ob der blockierende Betrieb aktiv ist.
sgr_extended bool	Gibt an, ob der erweiterte Betrieb aktiv ist.
p14enwg bool	Gibt an, ob blockierender Betrieb auf Grund von §14a EnWG aktiv ist.
next_update int	Ein Unix-Timestamp in Minuten, der angibt wann die Heizungssteuerung die nächste Aktualisierung durchführt.

heating/plan

Der aktuelle Heizplan. Enthält für jeden Zeitslot der dynamischen Strompreise, ob dieser als günstig (erweiterter Betrieb) oder teuer (blockierender Betrieb) ausgewählt wurde. Der Plan wird unter Einhaltung der konfigurierten Mindesthaltezeit optimiert.

Beispiel

HTTP (curl)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/heating/plan

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/heating/plan

{
    "cheap": [
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        true, true, true, true, true, true, true, true,
        true, true, true, true, false, false, false, false
    ],
    "expensive": [
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false
    ]
}

Name	Beschreibung
cheap bool[..]	Array von Wahrheitswerten. Jeder Eintrag entspricht einem Zeitslot der dynamischen Strompreise. true bedeutet, dass der Zeitslot für den erweiterten Betrieb ausgewählt wurde.
expensive bool[..]	Array von Wahrheitswerten. Jeder Eintrag entspricht einem Zeitslot der dynamischen Strompreise. true bedeutet, dass der Zeitslot für den blockierenden Betrieb ausgewählt wurde.

any

heating/config

Die Konfiguration der Heizungssteuerung.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/heating/config

{
    "sgr_blocking_type": 0,
    "sgr_extended_type": 0,
    "min_hold_time": 15,
    "meter_slot_grid_power": 1,
    "control_period": 0,
    "extended_logging": false,
    "yield_forecast": true,
    "yield_forecast_threshold": 10,
    "extended": true,
    "extended_hours": 3,
    "blocking": true,
    "blocking_hours": 14,
    "pv_excess_control": true,
    "pv_excess_control_threshold": 1400,
    "p14enwg": false,
    "p14enwg_input": 0,
    "p14enwg_type": 0
}

Schreiben

curl http://$HOST/heating/config -d '{
    "sgr_blocking_type": 0,
    "sgr_extended_type": 0,
    "min_hold_time": 15,
    "meter_slot_grid_power": 1,
    "control_period": 0,
    "extended_logging": false,
    "yield_forecast": true,
    "yield_forecast_threshold": 10,
    "extended": true,
    "extended_hours": 3,
    "blocking": true,
    "blocking_hours": 14,
    "pv_excess_control": true,
    "pv_excess_control_threshold": 1400,
    "p14enwg": false,
    "p14enwg_input": 0,
    "p14enwg_type": 0
}'

MQTT (mosquitto)

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

Lesen

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

{
    "sgr_blocking_type": 0,
    "sgr_extended_type": 0,
    "min_hold_time": 15,
    "meter_slot_grid_power": 1,
    "control_period": 0,
    "extended_logging": false,
    "yield_forecast": true,
    "yield_forecast_threshold": 10,
    "extended": true,
    "extended_hours": 3,
    "blocking": true,
    "blocking_hours": 14,
    "pv_excess_control": true,
    "pv_excess_control_threshold": 1400,
    "p14enwg": false,
    "p14enwg_input": 0,
    "p14enwg_type": 0
}

Schreiben

Mit MQTT auf $PREFIX/heating/config_update

mosquitto_pub -h $BROKER -t $PREFIX/heating/config_update -m '{
    "sgr_blocking_type": 0,
    "sgr_extended_type": 0,
    "min_hold_time": 15,
    "meter_slot_grid_power": 1,
    "control_period": 0,
    "extended_logging": false,
    "yield_forecast": true,
    "yield_forecast_threshold": 10,
    "extended": true,
    "extended_hours": 3,
    "blocking": true,
    "blocking_hours": 14,
    "pv_excess_control": true,
    "pv_excess_control_threshold": 1400,
    "p14enwg": false,
    "p14enwg_input": 0,
    "p14enwg_type": 0
}'

Name	Beschreibung
sgr_blocking_type int	SG-Ready Ausgang 1 Konfiguration (wird für den blockierenden Betrieb verwendet). 0 - Aktiv wenn geschlossen 1 - Aktiv wenn geöffnet
sgr_extended_type int	SG-Ready Ausgang 2 Konfiguration (wird für den erweiterten Betrieb verwendet). 0 - Aktiv wenn geschlossen 1 - Aktiv wenn geöffnet
min_hold_time int (min)	Mindesthaltezeit für SG-Ready-Ausgang 1 und SG-Ready-Ausgang 2.
meter_slot_grid_power int	Gibt an, welcher Stromzähler für die Regelung als Hausanschlusszähler betrachtet wird.
control_period int	Regelzeitraum, der für die zeitbasierte Steuerung betrachtet wird. 0 - 24 Stunden 1 - 12 Stunden 2 - 8 Stunden 3 - 6 Stunden 4 - 4 Stunden
extended_logging bool	Gibt an, ob weiterführende Informationen zu den Steuerentscheidungen im Ereignis-Log aufgezeichnet werden sollen.
yield_forecast bool	Gibt an, ob die PV-Ertragsprognose für die Heizungssteuerung verwendet werden soll.
yield_forecast_threshold int (kWh)	Grenzwert Für die PV-Ertragsprognose. Wenn die PV-Ertragsprognosen-Steuerung aktiviert ist und die Prognose größer als die eingestellte Energie ausfällt, entfällt die Dynamische-Strom­preis-Steuerung und es wird ausschließlich der PV-Über­schuss genutzt.
extended bool	Gibt an, ob die Steuerung des erweiterten Betriebs aktiviert werden soll.
extended_hours int (h)	Anzahl der (günstigsten) Stunden für die der erweiterte Betrieb genutzt werden soll.
blocking bool	Gibt an, ob die Steuerung des blockierenden Betriebs aktiviert werden soll.
blocking_hours int (h)	Anzahl der (teuersten) Stunden für die der blockierende Betrieb genutzt werden soll.
pv_excess_control bool	Gibt an, ob die PV-Überschusssteuerung aktiviert werden soll.
pv_excess_control_threshold int (W)	Grenzewert für die PV-Überschusssteuerung. Wenn die PV-Überschusssteuerung aktiviert ist und der PV-Überschuss größer als der eingestellte Wert ausfällt, wird die Heizung nur bei PV-Überschuss in den erweiterten Betrieb gebracht.
p14enwg bool	Gibt an, ob die §14a EnWG-Steuerung aktiviert werden soll.
p14enwg_input int	Gibt an, welcher Eingang des Energiemanagers für die Abschaltung per §14a EnWG genutzt werden soll. 0 - Eingang 1 1 - Eingang 2 2 - Eingang 3 3 - Eingang 4
p14enwg_type int	Konfiguration für den Eingang. 0 - Aktiv wenn geschlossen 1 - Aktiv wenn geöffnet

heating/state

Der Zustand der Heizungssteuerung.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/heating/state

MQTT (mosquitto)

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

Lesen

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

{
    "sgr_blocking": true,
    "sgr_extended": false,
    "p14enwg": false,
    "next_update": 28899735
}

Name	Beschreibung
sgr_blocking bool	Gibt an, ob der blockierende Betrieb aktiv ist.
sgr_extended bool	Gibt an, ob der erweiterte Betrieb aktiv ist.
p14enwg bool	Gibt an, ob blockierender Betrieb auf Grund von §14a EnWG aktiv ist.
next_update int	Ein Unix-Timestamp in Minuten, der angibt wann die Heizungssteuerung die nächste Aktualisierung durchführt.

heating/plan

Der aktuelle Heizplan. Enthält für jeden Zeitslot der dynamischen Strompreise, ob dieser als günstig (erweiterter Betrieb) oder teuer (blockierender Betrieb) ausgewählt wurde. Der Plan wird unter Einhaltung der konfigurierten Mindesthaltezeit optimiert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/heating/plan

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/heating/plan

{
    "cheap": [
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        true, true, true, true, true, true, true, true,
        true, true, true, true, false, false, false, false
    ],
    "expensive": [
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false,
        false, false, false, false, false, false, false, false
    ]
}

Name	Beschreibung
cheap bool[..]	Array von Wahrheitswerten. Jeder Eintrag entspricht einem Zeitslot der dynamischen Strompreise. true bedeutet, dass der Zeitslot für den erweiterten Betrieb ausgewählt wurde.
expensive bool[..]	Array von Wahrheitswerten. Jeder Eintrag entspricht einem Zeitslot der dynamischen Strompreise. true bedeutet, dass der Zeitslot für den blockierenden Betrieb ausgewählt wurde.