§14a EnWG

The p14a_enwg module allows configuration of settings for control according to §14a of the German Energy Industry Act (EnWG). §14a EnWG allows grid operators to temporarily reduce the power consumption of controllable consumer devices (wallboxes, heat pumps, battery storage, air conditioning) to prevent local grid overload. The devices are never fully shut off. A minimum of 4200 W always remains available.

warp1

Not supported on this hardware!

warp2

p14a_enwg/config

The §14a EnWG control configuration.

Example

HTTP (curl)

# $HOST e.g. warp2-AbCd

Read

curl http://$HOST/p14a_enwg/config

{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200}],
    "limit_charger": true,
    "limit_charge_manager": false
}

Write

curl http://$HOST/p14a_enwg/config -d '{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200}],
    "limit_charger": true,
    "limit_charge_manager": false
}'

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp2/AbCd

Read

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

{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200}],
    "limit_charger": true,
    "limit_charge_manager": false
}

Write

With MQTT on $PREFIX/p14a_enwg/config_update

mosquitto_pub -h $BROKER -t $PREFIX/p14a_enwg/config_update -m '{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200}],
    "limit_charger": true,
    "limit_charge_manager": false
}'

Name	Description
enable bool	Specifies whether §14a EnWG control should be enabled.
source Union	Signal source for §14a EnWG control. 0 - Input Name Description limit_on_close bool Specifies whether §14a control is active when the input is closed or open. true - Active when closed false - Active when open limit_w int (W) Power limit in watts applied when triggered via the input. 1 - EEBUS null: EEBUS 2 - API null: API
limit_charger bool	(Only WARP 2 and WARP 3) Specifies whether the §14a power limit should be applied to this charger.
limit_charge_manager bool	Specifies whether the §14a power limit should be applied to managed chargers.

p14a_enwg/state

The state of the §14a EnWG control.

Example

HTTP (curl)

# $HOST e.g. warp2-AbCd

Read

curl http://$HOST/p14a_enwg/state

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp2/AbCd

Read

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

{
    "active": true,
    "limit_w": 4200
}

Name	Description
active bool	Indicates whether §14a control is currently active, i.e. whether a power limitation is in effect.
limit_w int (W)	The current effective power limit. Is 0 when §14a control is not active.

p14a_enwg/control

The control state for the API source. Resets to inactive on reboot. Values are only considered when the signal source is set to API (2).

Example

HTTP (curl)

# $HOST e.g. warp2-AbCd

Read

curl http://$HOST/p14a_enwg/control

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp2/AbCd

Read

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/p14a_enwg/control

{
    "active": false,
    "limit_w": 0
}

Name	Description
active bool	Indicates whether §14a control is active via the API.
limit_w int (W)	Power limit in watts set via the API.

p14a_enwg/control_update

Sets the §14a control state via the API. Only works when the signal source is set to API (2). The state is volatile and resets to inactive on reboot.

Example

HTTP (curl)

# $HOST e.g. warp2-AbCd

Write

curl http://$HOST/p14a_enwg/control_update -d '{
    "active": true,
    "limit_w": 4200
}'

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp2/AbCd

Write

mosquitto_pub -h $BROKER -t $PREFIX/p14a_enwg/control_update -m '{
    "active": true,
    "limit_w": 4200
}'

Name	Description
active bool	Activates or deactivates §14a control via the API.
limit_w int (W)	Power limit in watts.

warp3

p14a_enwg/config

The §14a EnWG control configuration.

Example

HTTP (curl)

# $HOST e.g. warp3-AbCd

Read

curl http://$HOST/p14a_enwg/config

{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200}],
    "limit_charger": true,
    "limit_charge_manager": false
}

Write

curl http://$HOST/p14a_enwg/config -d '{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200}],
    "limit_charger": true,
    "limit_charge_manager": false
}'

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp3/AbCd

Read

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

{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200}],
    "limit_charger": true,
    "limit_charge_manager": false
}

Write

With MQTT on $PREFIX/p14a_enwg/config_update

mosquitto_pub -h $BROKER -t $PREFIX/p14a_enwg/config_update -m '{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200}],
    "limit_charger": true,
    "limit_charge_manager": false
}'

Name	Description
enable bool	Specifies whether §14a EnWG control should be enabled.
source Union	Signal source for §14a EnWG control. 0 - Input Name Description limit_on_close bool Specifies whether §14a control is active when the input is closed or open. true - Active when closed false - Active when open limit_w int (W) Power limit in watts applied when triggered via the input. 1 - EEBUS null: EEBUS 2 - API null: API
limit_charger bool	(Only WARP 2 and WARP 3) Specifies whether the §14a power limit should be applied to this charger.
limit_charge_manager bool	Specifies whether the §14a power limit should be applied to managed chargers.

p14a_enwg/state

The state of the §14a EnWG control.

Example

HTTP (curl)

# $HOST e.g. warp3-AbCd

Read

curl http://$HOST/p14a_enwg/state

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp3/AbCd

Read

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

{
    "active": true,
    "limit_w": 4200
}

Name	Description
active bool	Indicates whether §14a control is currently active, i.e. whether a power limitation is in effect.
limit_w int (W)	The current effective power limit. Is 0 when §14a control is not active.

p14a_enwg/control

The control state for the API source. Resets to inactive on reboot. Values are only considered when the signal source is set to API (2).

Example

HTTP (curl)

# $HOST e.g. warp3-AbCd

Read

curl http://$HOST/p14a_enwg/control

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp3/AbCd

Read

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/p14a_enwg/control

{
    "active": false,
    "limit_w": 0
}

Name	Description
active bool	Indicates whether §14a control is active via the API.
limit_w int (W)	Power limit in watts set via the API.

p14a_enwg/control_update

Sets the §14a control state via the API. Only works when the signal source is set to API (2). The state is volatile and resets to inactive on reboot.

Example

HTTP (curl)

# $HOST e.g. warp3-AbCd

Write

curl http://$HOST/p14a_enwg/control_update -d '{
    "active": true,
    "limit_w": 4200
}'

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp3/AbCd

Write

mosquitto_pub -h $BROKER -t $PREFIX/p14a_enwg/control_update -m '{
    "active": true,
    "limit_w": 4200
}'

Name	Description
active bool	Activates or deactivates §14a control via the API.
limit_w int (W)	Power limit in watts.

wem

p14a_enwg/config

The §14a EnWG control configuration.

Example

HTTP (curl)

# $HOST e.g. wem-AbCd

Read

curl http://$HOST/p14a_enwg/config

{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200, "input_index": 0}],
    "limit_charge_manager": false
}

Write

curl http://$HOST/p14a_enwg/config -d '{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200, "input_index": 0}],
    "limit_charge_manager": false
}'

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem/AbCd

Read

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

{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200, "input_index": 0}],
    "limit_charge_manager": false
}

Write

With MQTT on $PREFIX/p14a_enwg/config_update

mosquitto_pub -h $BROKER -t $PREFIX/p14a_enwg/config_update -m '{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200, "input_index": 0}],
    "limit_charge_manager": false
}'

Name	Description
enable bool	Specifies whether §14a EnWG control should be enabled.
source Union	Signal source for §14a EnWG control. 0 - Input Name Description limit_on_close bool Specifies whether §14a control is active when the input is closed or open. true - Active when closed false - Active when open limit_w int (W) Power limit in watts applied when triggered via the input. input_index int (Only Energy Manager and Energy Manager 2.0) Specifies which Energy Manager input is used for §14a control. 0 - Input 1 1 - Input 2 1 - EEBUS null: EEBUS 2 - API null: API
limit_charge_manager bool	Specifies whether the §14a power limit should be applied to managed chargers.

p14a_enwg/state

The state of the §14a EnWG control.

Example

HTTP (curl)

# $HOST e.g. wem-AbCd

Read

curl http://$HOST/p14a_enwg/state

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem/AbCd

Read

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

{
    "active": true,
    "limit_w": 4200
}

Name	Description
active bool	Indicates whether §14a control is currently active, i.e. whether a power limitation is in effect.
limit_w int (W)	The current effective power limit. Is 0 when §14a control is not active.

p14a_enwg/control

The control state for the API source. Resets to inactive on reboot. Values are only considered when the signal source is set to API (2).

Example

HTTP (curl)

# $HOST e.g. wem-AbCd

Read

curl http://$HOST/p14a_enwg/control

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem/AbCd

Read

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/p14a_enwg/control

{
    "active": false,
    "limit_w": 0
}

Name	Description
active bool	Indicates whether §14a control is active via the API.
limit_w int (W)	Power limit in watts set via the API.

p14a_enwg/control_update

Sets the §14a control state via the API. Only works when the signal source is set to API (2). The state is volatile and resets to inactive on reboot.

Example

HTTP (curl)

# $HOST e.g. wem-AbCd

Write

curl http://$HOST/p14a_enwg/control_update -d '{
    "active": true,
    "limit_w": 4200
}'

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem/AbCd

Write

mosquitto_pub -h $BROKER -t $PREFIX/p14a_enwg/control_update -m '{
    "active": true,
    "limit_w": 4200
}'

Name	Description
active bool	Activates or deactivates §14a control via the API.
limit_w int (W)	Power limit in watts.

wem2

p14a_enwg/config

The §14a EnWG control configuration.

Example

HTTP (curl)

# $HOST e.g. wem2-AbCd

Read

curl http://$HOST/p14a_enwg/config

{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200, "input_index": 0}],
    "limit_charge_manager": false,
    "limit_heating": false,
    "heating_max_power": 0
}

Write

curl http://$HOST/p14a_enwg/config -d '{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200, "input_index": 0}],
    "limit_charge_manager": false,
    "limit_heating": false,
    "heating_max_power": 0
}'

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem2/AbCd

Read

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

{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200, "input_index": 0}],
    "limit_charge_manager": false,
    "limit_heating": false,
    "heating_max_power": 0
}

Write

With MQTT on $PREFIX/p14a_enwg/config_update

mosquitto_pub -h $BROKER -t $PREFIX/p14a_enwg/config_update -m '{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200, "input_index": 0}],
    "limit_charge_manager": false,
    "limit_heating": false,
    "heating_max_power": 0
}'

Name	Description
enable bool	Specifies whether §14a EnWG control should be enabled.
source Union	Signal source for §14a EnWG control. 0 - Input Name Description limit_on_close bool Specifies whether §14a control is active when the input is closed or open. true - Active when closed false - Active when open limit_w int (W) Power limit in watts applied when triggered via the input. input_index int (Only Energy Manager and Energy Manager 2.0) Specifies which Energy Manager input is used for §14a control. 2 - Input 3 3 - Input 4 0 - Input 1 1 - Input 2 1 - EEBUS null: EEBUS 2 - API null: API
limit_charge_manager bool	Specifies whether the §14a power limit should be applied to managed chargers.
limit_heating bool	(Only Energy Manager 2.0) Specifies whether the §14a power limit should be applied to heating control.
heating_max_power int (W)	(Only Energy Manager 2.0) Maximum power draw of the heating system.

p14a_enwg/state

The state of the §14a EnWG control.

Example

HTTP (curl)

# $HOST e.g. wem2-AbCd

Read

curl http://$HOST/p14a_enwg/state

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem2/AbCd

Read

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

{
    "active": true,
    "limit_w": 4200
}

Name	Description
active bool	Indicates whether §14a control is currently active, i.e. whether a power limitation is in effect.
limit_w int (W)	The current effective power limit. Is 0 when §14a control is not active.

p14a_enwg/control

The control state for the API source. Resets to inactive on reboot. Values are only considered when the signal source is set to API (2).

Example

HTTP (curl)

# $HOST e.g. wem2-AbCd

Read

curl http://$HOST/p14a_enwg/control

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem2/AbCd

Read

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/p14a_enwg/control

{
    "active": false,
    "limit_w": 0
}

Name	Description
active bool	Indicates whether §14a control is active via the API.
limit_w int (W)	Power limit in watts set via the API.

p14a_enwg/control_update

Sets the §14a control state via the API. Only works when the signal source is set to API (2). The state is volatile and resets to inactive on reboot.

Example

HTTP (curl)

# $HOST e.g. wem2-AbCd

Write

curl http://$HOST/p14a_enwg/control_update -d '{
    "active": true,
    "limit_w": 4200
}'

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem2/AbCd

Write

mosquitto_pub -h $BROKER -t $PREFIX/p14a_enwg/control_update -m '{
    "active": true,
    "limit_w": 4200
}'

Name	Description
active bool	Activates or deactivates §14a control via the API.
limit_w int (W)	Power limit in watts.

any

p14a_enwg/config

The §14a EnWG control configuration.

Example

HTTP (curl)

# $HOST e.g. warp-AbCd

Read

curl http://$HOST/p14a_enwg/config

{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200, "input_index": 0}],
    "limit_charger": true,
    "limit_charge_manager": false,
    "limit_heating": false,
    "heating_max_power": 0
}

Write

curl http://$HOST/p14a_enwg/config -d '{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200, "input_index": 0}],
    "limit_charger": true,
    "limit_charge_manager": false,
    "limit_heating": false,
    "heating_max_power": 0
}'

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd

Read

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

{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200, "input_index": 0}],
    "limit_charger": true,
    "limit_charge_manager": false,
    "limit_heating": false,
    "heating_max_power": 0
}

Write

With MQTT on $PREFIX/p14a_enwg/config_update

mosquitto_pub -h $BROKER -t $PREFIX/p14a_enwg/config_update -m '{
    "enable": true,
    "source": [0, {"limit_on_close": true, "limit_w": 4200, "input_index": 0}],
    "limit_charger": true,
    "limit_charge_manager": false,
    "limit_heating": false,
    "heating_max_power": 0
}'

Name	Description
enable bool	Specifies whether §14a EnWG control should be enabled.
source Union	Signal source for §14a EnWG control. 0 - Input Name Description limit_on_close bool Specifies whether §14a control is active when the input is closed or open. true - Active when closed false - Active when open limit_w int (W) Power limit in watts applied when triggered via the input. input_index int (Only Energy Manager and Energy Manager 2.0) Specifies which Energy Manager input is used for §14a control. (Only Energy Manager 2.0) 2 - Input 3 3 - Input 4 (Only Energy Manager and Energy Manager 2.0) 0 - Input 1 1 - Input 2 1 - EEBUS null: EEBUS 2 - API null: API
limit_charger bool	(Only WARP 2 and WARP 3) Specifies whether the §14a power limit should be applied to this charger.
limit_charge_manager bool	Specifies whether the §14a power limit should be applied to managed chargers.
limit_heating bool	(Only Energy Manager 2.0) Specifies whether the §14a power limit should be applied to heating control.
heating_max_power int (W)	(Only Energy Manager 2.0) Maximum power draw of the heating system.

p14a_enwg/state

The state of the §14a EnWG control.

Example

HTTP (curl)

# $HOST e.g. warp-AbCd

Read

curl http://$HOST/p14a_enwg/state

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd

Read

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

{
    "active": true,
    "limit_w": 4200
}

Name	Description
active bool	Indicates whether §14a control is currently active, i.e. whether a power limitation is in effect.
limit_w int (W)	The current effective power limit. Is 0 when §14a control is not active.

p14a_enwg/control

The control state for the API source. Resets to inactive on reboot. Values are only considered when the signal source is set to API (2).

Example

HTTP (curl)

# $HOST e.g. warp-AbCd

Read

curl http://$HOST/p14a_enwg/control

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd

Read

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/p14a_enwg/control

{
    "active": false,
    "limit_w": 0
}

Name	Description
active bool	Indicates whether §14a control is active via the API.
limit_w int (W)	Power limit in watts set via the API.

p14a_enwg/control_update

Sets the §14a control state via the API. Only works when the signal source is set to API (2). The state is volatile and resets to inactive on reboot.

Example

HTTP (curl)

# $HOST e.g. warp-AbCd

Write

curl http://$HOST/p14a_enwg/control_update -d '{
    "active": true,
    "limit_w": 4200
}'

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd

Write

mosquitto_pub -h $BROKER -t $PREFIX/p14a_enwg/control_update -m '{
    "active": true,
    "limit_w": 4200
}'

Name	Description
active bool	Activates or deactivates §14a control via the API.
limit_w int (W)	Power limit in watts.