Skip to content

Load shedding / management

STABLE COMMUNITY

The box protects your supply phase by phase: when the house approaches the limit of a phase, it reduces or cuts the loads it controls, so that the main breaker does not have to. Nor does it buy from the grid beyond what the connection can carry.

The phase limit and the safety margin

The phase limit is the current each phase of the connection can carry, in amperes (for example 25 A on a three-phase supply). It is set by the installer at commissioning. The app does not show it in this version: it is set through the box's API, with an administrator account (see below).

No phase limit, no protection

As long as the limit is not set (value 0), the box still shares the surplus, but the protection does nothing and grid purchases are not bounded by anything. It is an installation setting, to be made at every commissioning.

The safety margin takes a percentage off that limit: the box acts before the limit, not on it. It is 10 % by default and can be set from 0 to 25 %. With 25 A and 10 %, the box keeps each phase below 22.5 A. That threshold is what it enforces everywhere: when it reduces a load, and when it decides to buy from the grid.

Two protections that complement each other

  • Before deciding. At each cycle, the box works out the room left on the most loaded phase and orders no grid purchase beyond it: the grid top-up of a station in Auto, a station in Manuel (manual) at full power, forced heating, full power in off-peak hours. It does not create an overload only to catch it afterwards.
  • After the measurement. What the box does not control (hob, oven, tumble dryer) can push a phase over. As soon as the main meter measures an overshoot, the box reacts:
  • charging stations are lowered on that very measurement, by the overshoot rounded up to the ampere, or cut if the remaining current falls below their minimum;
  • other loads (water heater, modulating loads) are shed at the next cycle (the box runs one per minute), starting with the last one in the list of loads: the one served last by the surplus is shed first.

When room comes back, the loads resume: a cut station restarts at its minimum, then normal sharing takes over again.

What is reduced, and what is not

  • All controlled loads can be shed, whatever their mode. A station in Manuel (manual) too: the protection has the last word over its full power, and the box gives back its current when room comes back. Forced heating too.
  • To hold the connection limit, the box may cut a load before the end of its minimum on time; the reason says so.
  • A single-phase station is counted on the phase it draws from, if it publishes its per-phase currents. Otherwise the box assumes it is on L1: this is the case of the V2C Trydan, to be wired on L1 in single-phase. Wired on another phase, the protection would judge the wrong phase.
  • A three-phase station is judged on the most loaded phase.

What the box does not do

  • It cuts no circuit in the house: it only acts on the loads it controls. If the house overshoots on its own (with no controlled load running), the box has nothing to reduce, and the breaker remains the last protection.
  • It does not replace the breaker or the sizing of the installation, which remain the electrician's responsibility.
  • It receives no limitation order from the grid operator.

What the app shows

  • On the load card: a line saying the load was cut or reduced by the connection protection, and that it resumes when room comes back.
  • On the dashboard: a Connection protection banner per shed load, with the reason (for example "lowered to 10 A: the connection was reaching its limit") and the start time.
  • On returning to the app: a "since your last visit" card summarises what happened, with View the log.
  • The log: in the Énergie (energy) screen, the Connection protection card lists the latest episodes, most recent first: which load, when, for how long, on which phase, and what it received. The box keeps the last 20 in memory; they are lost when it restarts. If episodes come back three days in a row, the app advises talking to the installer.
Going further: the API
  • Limit and margin: NymeaEnergy.GetPhasePowerLimit / SetPhasePowerLimit (phasePowerLimit in A per phase, phaseSafetyMarginPercent from 0 to 25, effectivePhaseLimit = the threshold applied). Writing requires the administrator right.
  • Reasons: OVERLOAD_THROTTLED (station lowered or cut by the protection), DRAW_CAP (load reduced or refused for lack of room on the connection; phase, shed, minOnBypassed), PHASE_LIMIT (the room left is below the station's minimum).
  • Shedding in progress: shedding.open in NymeaEnergy.GetLoadTelemetry; log: NymeaEnergy.GetSheddingLog.
  • See the API reference.