EnergyNode¶

This module is part of the Energy Tree and represents a simple current fuse on AC side.

Handwritten Documentation¶

The EnergyNode module is usually used in conjunction with the EnergyManager module. See the documentation of the latter for a detailed explanation of energy management.

Phase rotation¶

The phase_rotation configuration option corrects for a physical L1/L2/L3 wiring rotation at this node’s powermeter. When set, the per-phase voltage/current/power/energy/VAR values of a powermeter reading are remapped before they are used in the energy flow request, so that the reported phases align with the actual grid phases.

We use the OCPP phase rotation notation for this: R can be identified as phase 1 (L1), S as phase 2 (L2), T as phase 3 (L3).

Allowed values:

RST (default) – no rotation; reported L1/L2/L3 already matches grid L1/L2/L3.
STR – reported L1 is grid L2, reported L2 is grid L3, reported L3 is grid L1.
TRS – reported L1 is grid L3, reported L2 is grid L1, reported L3 is grid L2.

Auto-Generated Reference¶

Module Configuration¶

fuse_limit_A: number <required>

Fuse limit in ampere for all phases. Note: this always applies in addition to limits set by external_limits interface.

phase_count: integer <optional>

default: 3

phase count of this fuse

nominal_voltage_V: number <optional>

default: 230.0

Nominal AC voltage between a single phase and neutral in volt. Used for e.g. power to current calculations when enhance_external_schedule is enabled. This allows configuration for different regions (e.g., 120V, 230V, 400V).

enhance_external_schedule: boolean <optional>

default: False

When enabled, calculates per-phase current limits from total_power_W and adds them to ac_max_current_A when processing external schedules. ac_max_current_A is only enhanced in case it was not specified as part of the external schedules. Uses nominal_voltage_V for calculations.

phase_rotation: string <optional>

default: “RST”

Corrects for a physical L1/L2/L3 wiring rotation at this node’s powermeter by remapping its per-phase voltage/current/power/energy/VAR values before they are used in the energy flow request. RST means no rotation, i.e. reported L1/L2/L3 already matches grid L1/L2/L3. STR means reported L1 is grid L2, reported L2 is grid L3, reported L3 is grid L1. TRS means reported L1 is grid L3, reported L2 is grid L1, reported L3 is grid L2.

enum:

- RST
- STR
- TRS

Provides¶

energy_grid: energy

This is the chain interface to build the energy supply tree

external_limits: external_energy_limits

Additional external limits can be set via this interface.

Requirements¶

energy_consumer: energy 1..128
powermeter: powermeter 0..1
price_information: energy_price_information 0..1