SG-Ready heat pump¶
STABLE COMMUNITY
A heat pump with the SG-Ready label has two input contacts. The box drives them through two relays, and the heat pump reads their combination as a hint: run normally, use more, or pause for a while. The box sets neither the temperature nor the power of the heat pump: the heat pump interprets the state according to its own logic.
The four states¶
| State | Name in the app | What the box asks of the heat pump | When the box chooses it |
|---|---|---|---|
| 1 | Block | Pause (at most for a set duration). | At the peak price, instead of normal operation (see below). Never for the surplus. |
| 2 | Normal | Nothing: the heat pump decides on its own. | By default, without enough surplus. It is also the safe position. |
| 3 | Recommendation | Use more if it can. | When the solar surplus pays for the power of state 3. |
| 4 | Forced | Use more, more strongly. | When the solar surplus pays for the power of state 4. |
Wiring. In the app, the installer chooses the relays for SG1 and SG2; the standard encoding is set automatically: state 1 = SG1 closed, state 2 = no contact, state 3 = SG2 closed, state 4 = both. Other wiring remains possible, but state 2 must always be expressible: it is the safe fallback, and the box refuses a configuration without it.
Solar surplus¶
The heat pump is served at its rank, like the other loads (Solar surplus). The installer declares the estimated power of states 3 and 4; the box moves to the highest state the surplus pays for, and goes back to state 2 below it.
- A minimum time in each state protects the compressor against frequent starts: the box does not change state before that time.
- Learned power: if a meter measures the heat pump, the box learns the real power of each state as a moving average, and uses it instead of the estimate for states 3 and 4 once it has enough measurements.
- The surplus handed out never exceeds the measured solar production: an estimated heat pump that draws nothing does not create a fictitious surplus.
Block at the peak price¶
With a tariff that has a peak price (a slot costing at least twice the lowest price, see Tariffs), the box blocks the heat pump during the peak price, on its own, without an optimizer and without asking you:
- it switches to state 1 instead of state 2: a solar surplus that pays for state 3 or 4 comes first, and a heat pump under override is not blocked;
- at most 2 hours per expensive period (adjustable from 10 minutes to 24 hours); after that, the heat pump goes back to state 2 until the end of that period;
- if a compressor contact is wired, it carries the block: only the compressor stops, the controller and the circulation pump keep running; otherwise, SG state 1 does;
- without a tariff, or without a peak price in the tariff, the heat pump is never blocked. With an ordinary peak/off-peak tariff, peak hours are not at the peak price.
The block at the peak price is on by default. It can be switched off load by load; the maximum duration and the compressor contact are also set in the load's configuration. These three settings are not in the app yet.
When something goes wrong¶
- Main meter silent or load removed: the box puts the heat pump back to state 2, never to the block.
- Load shedding: when the limit of a phase of the connection is at stake, the box sets the heat pump back to normal operation (Load shedding).
What the app shows¶
On the heat pump's card, the app shows the requested state ("SG-Ready state 3 — estimated 1,500 W") and, below it, the reason for the decision, for instance "Heat pump in state 3 (recommendation) — estimated 1,500 W from a 2,000 W budget" or "No surplus (0 W) — heat pump in state 2 (normal, no setpoint)". Load shedding reads "Set back to normal operation".
The block at the peak price is new: this version of the app has no sentence for it yet and shows "Reason this version of the app cannot describe yet". The state shown (state 1) is correct.
Going further: settings and codes
Load configuration (NymeaEnergy.SetLoadConfig, sg-ready entry): sgReady.states (relays of
each state, estimatedPowerW power), sgReady.minStateHoldS, sgReady.blockAtExpensivePrice
(absent = true), sgReady.maxBlockS (600 to 86,400 s, 7,200 by default),
sgReady.compressorBlockRelay (compressor contact), meterThingId (meter used to learn the
power, mechanism.learnedPowerW in the telemetry). Refusal: SG_READY_STATE_2 (no state 2).
Reasons: SG_RECOMMENDED, SG_FORCED, SG_NORMAL, BELOW_MIN_POWER, LOCK_MIN_STATE_HOLD
(minimum time in the state), HEAT_PUMP_PEAK_BLOCK (blocked at the peak price by the box on its
own), HEAT_PUMP_BLOCK_LIMIT (maximum duration reached, back to state 2),
HEAT_PUMP_PEAK_BLOCK_REFUSED (block at the peak price switched off: a state 1 requested by an
optimizer at the peak price is refused), SAFE_STATE_SG_READY.