Hybrid Heating Mode
Details
  • 2026.11.22
Share

Hybrid Heating Mode

Hybrid is the self-learning heating algorithm of the DIYLESS OpenTherm Thermostat. This guide explains what it does, how it differs from the classic PID algorithm, how to set it up, what the settings mean, and how to read its status. Hybrid is available starting with firmware version 3.0; if your thermostat runs an older version, update its firmware first.

What it is

Hybrid computes the boiler water temperature (the OpenTherm flow setpoint) and decides when the boiler may run, from three cooperating ideas:

  1. a weather curve decides what water temperature the house needs right now, from the outside temperature,
  2. a room correction nudges that value by a limited amount to close the remaining room-temperature error,
  3. a cycling protection layer decides whether the burner may run at all, and protects the appliance from short-cycling, from running hotter than it needs to, and from damaging temperatures.

On top, a slow learning layer tunes the curve, the warm-up time of your home and the boiler's minimum-output level, so the system improves by itself over the first weeks.

You select it on the Heating page ("Hybrid — Recommended, self-learning"). It is opt-in: a firmware update never switches an existing thermostat to it, and the other algorithms (PID, Heating curve, Constant temperature) work exactly as before. If you switch away and back, what Hybrid learned is kept.

Hybrid compared with PID and the other classic algorithms
Classic algorithms Hybrid
PID reacts to room error only. With its default gain, even a moderate error drives the boiler to maximum temperature. Example — room 3 K too cold: an instant 78 °C request, return water at 72 °C (no condensing), burner running 91 % of the time requests what the weather actually calls for (about 46 °C in the same situation), raises it gradually, and steers the return temperature back into the condensing range
PID has to re-discover the right water temperature through its integral after every weather change — drift on cold fronts, overshoot on mild days the weather curve supplies the right temperature immediately; the room correction only handles the remainder
PID uses the same fixed gains for radiators, underfloor heating and heat pumps profiles per heat source and emitter type; the correction adapts to the weather
Heating curve / Constant temperature switch a modulating boiler fully on and off around the room setpoint continuous modulation around the curve
no protection when the house needs less heat than the boiler's minimum output — the burner short-cycles minimum burn and off times, controlled restarts, low-load pulsing
return temperature is ignored condensing boilers are kept in the condensing range whenever comfort allows
a scheduled 07:00 setpoint starts heating at 07:00 optimum start: the room is ready by 07:00
thermostat mode Off means no frost protection frost protection works in every mode
all tuning is manual and static curve, warm-up model and minimum-output level are learned

Two guarantees frame the design:

  • Works with any OpenTherm boiler. Only the mandatory OpenTherm data (status, flow setpoint, boiler water temperature) is assumed. Everything else — return temperature, modulation, outside sensor, counters — is probed, checked for plausibility, and used only when trustworthy.
  • Degrades gracefully, never silently. Every part checks its own preconditions and steps aside when they fail. With nothing optional available, Hybrid still behaves like a gentle PID plus cycling protection and frost safety — and the status page tells you so.

How it works

Capability check
which data the boiler provides, and whether it can be trustedfrom: boiler data
Weather curve
base water temperaturefrom: outside temperature
Room correction
base ± limited correctionfrom: room temperature and setpoint
Cycling protection
final water temperature + heating on/offfrom: flame, water temperature
Learning
curve · optimum start · open window · statistics

Capability check. Optional boiler data is probed at start-up and continuously checked for plausibility, because some boilers acknowledge data they do not really provide — a return sensor stuck at zero, an outside sensor that isn't fitted, a modulation limit that is accepted but ignored. Untrustworthy data is set aside and re-tested later, and the features that depend on it switch off individually. The result is remembered per boiler; after a boiler replacement everything is probed again.

Weather curve. A heating curve anchored at your room setpoint, with one main parameter — Flow at −10 °C: the water temperature your home needs on a −10 °C day. The curve shape matches your emitters (radiators, underfloor, fan-coils). Example for radiators with setpoint 21 °C and flow at −10 °C = 60: about 60 °C at −10 °C outside, 44 °C at +5 °C, 36 °C at +12 °C. The outside temperature is smoothed so that short fluctuations and coarse weather-service updates don't disturb the boiler, while real weather trends are followed promptly.

30 °C 40 °C 50 °C 60 °C 70 °C −10 °C 0 °C +10 °C +20 °C outside temperature 60 °C 44 °C 36 °C
The example above as a curve: boiler water temperature against the outside temperature (radiators, room setpoint 21 °C, flow at −10 °C = 60).

Room correction. The room temperature shifts the curve up or down, strictly within the trim authority you allow (0 = pure weather compensation). The correction is gentle in mild weather and firmer in the cold, is designed not to overshoot after long warm-ups, stays calm when the room is close to the setpoint, and survives restarts and firmware updates. Setpoint changes and the loss or return of the outside temperature do not cause jumps in the requested water temperature.

Cycling protection. Every burner start wastes energy and wears the appliance, so Hybrid:

  • keeps each burn alive for a minimum time, rests the burner after a burn that ended early, and limits starts per hour;
  • allows the next start only when a real heat deficit has built up, not merely because a timer expired;
  • pulses at low load: in mild weather most homes need less heat than the boiler's minimum output. Instead of letting the boiler short-cycle on its own, Hybrid runs few, long, controlled burns at the boiler's minimum level, which it learns by itself (or measures once with the optional calibration). If the boiler declares that it manages low load itself, pulsing is switched off automatically, as the OpenTherm specification requires.
Seasonal and comfort logic.
  • Heating limit (automatic summer mode): no heating while it has been warm enough outside for long enough — a cool summer evening does not fire the boiler. A sudden cold snap or frost risk overrides it.
  • Quick setback: when the setpoint drops (e.g. the night schedule), heating stops and the house coasts down to the new setpoint.
  • Open-window detection: a sudden, sustained drop in room temperature while heating suspends the heating for a while. A single faulty sensor reading cannot trigger it.
Protection.
Mechanism Behaviour
Flow ramp limit the requested temperature rises gradually — extra gently during the first days after enabling. Boilers may skip the limit when the room is clearly cold; heat pumps never skip it
Condensing guard condensing boilers with a trustworthy return sensor: once the room is comfortable, the flow is lowered step by step to bring the return below the target. Never active while the room is still warming up
Non-condensing burn floor non-condensing boilers: the flow is kept above a minimum while burning, to protect the heat exchanger from corrosion
Emitter safety cap underfloor heating: a hard flow ceiling that no other function can exceed — protects the screed
Heat pumps an appliance that looks like a heat pump is automatically treated gently, and the page suggests the heat-pump profile. Defrost cycles are recognised and not mistaken for a control problem
Frost protection in every mode, including Off: a room below the frost threshold is heated. In Cool mode it also stops cooling
Communication loss if the boiler cannot be reached for more than a minute, the heating request is switched off and learning pauses
Learning.
  • Self-learning curve: at night the curve is adjusted in small steps, based on how much room correction was needed — using only clean data (no sun, no recent setpoint changes, steady heating). Typical convergence: 2–4 weeks. If you edit the curve by hand, learning pauses and the page says so.
  • Catch-up boost: if the curve is set far too low and the room stalls well below the setpoint, the curve is raised slowly until the room starts climbing again; normal learning then takes over. Example — a home with undersized radiators reaches its 21 °C setpoint instead of stalling at 18 °C.
  • Optimum start: with a schedule, setpoints are applied early so the room is ready by the scheduled time. The warm-up speed of your home is learned from every morning warm-up and takes the outside temperature into account; the preheat is capped by a limit you set. Changing the setpoint yourself during a preheat cancels it. Inactive during a Boost / Away / Vacation hold.
  • Anti-legionella boost (off by default): a weekly hot-water boost to 60 °C on systems with a cylinder. If the boiler cannot reach 60 °C or does not allow the setpoint to be changed, the function reports itself as unsupported rather than pretending to work.
  • Statistics: burner starts, burning time and average burn length for the last 24 h, room-temperature error, share of time in the condensing range.

Everything learned is stored in the thermostat and survives restarts and updates. Reset learned state in the service section clears it.

Setup

  1. Heating page → Hybrid → Save. If you previously configured the classic heating curve, the page shows what it corresponds to at −10 °C, to use as the starting Flow at −10 °C.
  2. Give it an outside temperature (Heating page → Weather · outside temperature): the boiler's own outdoor sensor (Auto or OpenTherm), a wired sensor, a web weather service (requires your location) or MQTT. Auto uses the boiler's own sensor — if your boiler has none, choose one of the other sources. Without any outside temperature Hybrid still works, in its room-only fallback.
  3. Hybrid algorithm page → Quick setup: choose heat source, emitters and building weight, press Apply profile, review the highlighted fields, then Save changes. Nothing reaches the thermostat until you save. Changing only the appliance type does not change the other values — use Apply profile.
Profiles
Setting Universal (default) Radiators + boiler Underfloor + boiler Heat pump Hybrid appliance
Flow at −10 °C 55 60 40 45 50
Trim authority (±K) 8 10 5 5 6
Min burn / min off (s) 180 / 300 180 / 300 300 / 300 600 / 600 600 / 600
Max starts per hour 6 6 6 3 3
Flow ramp limit (K/min) 1.5 2.0 1.0 0.5 0.5
Condensing-guard target (°C) 52 52 50 — 52
Preheat cap (min) 180 180 300 300 240
Recommended night setback any any shallow (≤ 2 K) none or ≤ 1 K shallow

Profiles also adjust the advanced settings. Underfloor profiles set the emitter safety cap to 50 °C; the non-condensing heat source sets the burn floor to 50 °C. The Universal values are safe for every system: cautious where they must guess, corrected by learning where they can.

What to expect after enabling
When What happens
First minutes boiler capabilities are probed; heating starts with a gentle ramp
First days the boiler's steady-burn level is learned and low-load pulsing becomes available
Weeks 1–3 the curve converges; the 24-hour statistics show fewer, longer burns
First schedule optimum start learns from the first few morning warm-ups

When something is missing

Situation What Hybrid does
No outside temperature for several hours room-only fallback: control continues on room temperature alone, without a jump; cycling protection, frost protection and statistics stay active; the heating limit is inactive. Returns to the curve automatically
Clock not set (no internet time) heating control works fully; curve learning, optimum start, schedules and the legionella boost wait for the time
Room sensor fails the thermostat's general "sensor failure" setting applies, as with the other algorithms
Boiler lacks return temperature, modulation, capacity or counters the features that need them switch off individually; cycling protection keeps working from the flame signal alone
Boiler ignores the modulation limit pulsing still works; calibration is unavailable
Boiler manages low load itself pulsing off
Boiler replaced capabilities re-probed, minimum-output level re-learned; curve and warm-up model kept (they describe the house)
Boiler communication lost fail-safe: heating request off; learning frozen
Manual boiler override bypasses Hybrid completely, including cycling protection
Cool mode Hybrid does not heat, but frost protection stays armed

Good to know: one room sensor controls one heating circuit (no per-room balancing), and the 24-hour statistics restart after a reboot.

Settings reference

All settings are on the Hybrid algorithm page. Names in code are the field names used by configuration export/import and the local API. Most users only need Quick setup and the first two settings below.

Comfort & heating curve
Setting Default Range Meaning
Flow at −10 °C flowAtDesign 55 °C 28–85 the main curve parameter; tuned automatically when self-learning is on. Raise it if the house is too cold in cold weather, lower it if it overheats
Trim authority trimAuth 8 K 0–15 how far the room temperature may move the curve; 0 = pure weather compensation
Self-learning curve adaptCurve on nightly curve tuning and catch-up boost
Quick setback quickSetback on coast down after a setpoint drop
Optimum start optStart on apply scheduled setpoints early ("ready by")
Preheat cap maxPreheatMin 180 min 30–360 longest allowed preheat
Emitter exponent emitExp 1.25 1.0–1.4 curve shape: radiators 1.3 / underfloor 1.1
Outside filter outFilterH 2 h 0.5–6 smoothing of the outside temperature used by the curve
Building time constant bldTimeConstH 25 h 5–60 light 15 / medium 25 / heavy 40; used by the heating limit
Heating-limit delta heatLimitD 3 K 0–8 how much colder than the setpoint it must be outside before heating is allowed; 0 = off
Gain base kpBase 2.5 strength of the room correction
Cycling protection
Setting Default Range Meaning
Minimum burn minBurnSec 180 s 60–900 burns are kept alive at least this long
Minimum off minOffSec 300 s 60–900 rest after a burn that ended early
Max starts per hour maxCyclesH 6 2–12 upper limit of burner starts
Low-load pulsing pwmLowLoad on controlled long burns when the house needs less than the boiler's minimum
Degree-minutes release dmRelease 30 K·min 0–120 heat deficit required before the next start; higher = fewer starts
Flow ramp limit rampLimit 1.5 K/min 0.3–3 how fast the requested temperature may rise
Appliance & safety
Setting Default Range Meaning
Appliance type applType condensing gas condensing gas / non-condensing / heat pump / hybrid
Frost protection frostProt on works in every thermostat mode
Frost threshold frostTemp 6 °C 2–10
Condensing-guard target condTarget 52 °C 0 / 45–58 desired maximum return temperature; 0 = off
Non-condensing burn floor boilerFloor 0 (off) 0 / 45–60 minimum flow while burning; 50 for non-condensing boilers
Emitter safety cap emitterCap 0 (off) 0 / 35–60 hard flow ceiling; 50 for underfloor heating
Hot water
Setting Default Meaning
Anti-legionella boost legionellaEn off weekly 60 °C boost, cylinder systems only
Boost day legionellaDay Sunday runs at night

Reading the status

The Hybrid algorithm page refreshes every few seconds.

  • Banner: a warning when Hybrid is not in control (another algorithm selected, or manual boiler override); an information note when no outside temperature is available (room-only fallback); a hint when the appliance looks like a heat pump but a boiler profile is selected.
  • Right now: whether Hybrid is active, the boiler water target, room temperature → setpoint, the current room correction, the outside temperature used by the curve, and a plain-language status:
Status Meaning
Normal modulating heating, or idle
Low-load pulsing controlled long burns in mild weather
Coasting down quick setback after a setpoint drop
Paused — warm enough outside heating limit active
Condensing guard flow being lowered to keep the return cool
Open window detected heating temporarily suspended
Catch-up boost curve being raised because the room is stuck below setpoint
Calibrating minimum-output calibration in progress
Hot-water boost anti-legionella run in progress
  • Diagnostics (expandable): curve value before correction, smoothed outside temperature, pulsing duty, lifetime burner starts and hours, boiler-reported capacity and minimum modulation, the capability map, and the raw controller state.
  • Last 24 h: burner starts, burning time, average burn length, room error, condensing share. Healthy direction: fewer and longer burns, room error under ±0.3 K, a high condensing share.
  • Curve preview: the curve drawn from the values in the form, with the design point (−10 °C) and the live operating point.
  • Service: Start calibration / Cancel, Run the boost now, Reset learned state. Calibration takes up to about 20 minutes and may end without a result on a mild day — the boiler's minimum output is then more than the house can absorb. Run it in colder weather.

The Heating page additionally shows a live Flow demand now row for every algorithm.

For integrators
Interface Use
GET /algo-state live state, status flags, 24-hour statistics and the current settings as JSON
POST /algo-action { "action": "calibrate" | "cancel" | "reset" | "legionella" }
Serial console algo without arguments prints the live state; sub-commands cap, kpi, calibrate, cancel, reset, legionella