Fan Coil (AC)

Keeps one room at a temperature. It reads the room, compares it with the setpoint, and decides whether the unit should heat, cool or sit still — then how hard the fan should work.

1.What it does

This block is the room's thermostat logic. It does not talk to the fan coil itself — its outputs are wired to device actions, exactly like every other block, which is what lets it drive a KNX fan coil, a Modbus unit or a Wi-Fi relay with the same wiring.

  • A hysteresis band around the setpoint, so the unit does not chatter on and off around the target.
  • Heat, cool, or automatic — picking the direction from which side of the setpoint the room is on.
  • Fan speed either fixed or staged automatically by how far the room has drifted.
  • A window-contact input that holds the unit off while a window is open.
Add it from the HVAC group on the Flows page. Picking a device on the block and ticking Show in UI also puts that unit on the panel in the room you choose.

2.Inputs

Only the room temperature is really required — everything else has a sensible behaviour when left unwired.

PinLabelDescriptionRange
TcRoom TempThe measured room temperature, from a sensor or from the unit's own reading. Until a value arrives the block enables the unit but holds the fan at 0 — it will not guess a direction without knowing the room.°C
TsSetpointTarget temperature. While wired it overrides the Setpoint parameter, which is how a panel dial, a schedule or a room controller feeds the block.°C
OnOnEnables the unit. If you leave it unwired the block treats it as on — a block with only a temperature wired still regulates.0/1
OffOffDominating. While 1 the unit is off and the fan is 0, whatever the temperature is doing.0/1
WinWindowWindow or door contact — 1 means open. Holds the unit off exactly like Off does, and releases it when the window closes.0/1
PausePauseHolds the unit off while high. Drive it from a Delayed on/off block for a timed pause, or from anything else that should suspend the room without disabling it.0/1
LsLoad shedHolds the unit off while high — for a grid-peak or generator signal. Identical in effect to Pause; two pins so the reason stays readable on the canvas.0/1
SmSilentCaps the fan at the configured silent percentage while high. It never speeds a slower fan up, and an idle unit stays idle.0/1
Wire On only when something really switches the room's heating on and off — a holiday flag, a booking system, an occupancy schedule. For a normal room, leaving it unwired is the simpler design.

3.Outputs

Wire each one to a device action on the fan coil. Outputs are only re-sent when their value actually changes, so a quiet room produces no bus traffic.

PinLabelDescriptionRange
OnOffOn/OffTrue while the unit is enabled — including when it is idling inside the comfort band. It goes false only for Off, Win, or an On input that is wired and low.0/1
FanFan %0 while idle, otherwise 33, 66 or 100 — see fan staging. Wire it to the unit's fan-speed property.0…100
ModeHeat/CoolTrue for heating, false for cooling. It holds its last value while the room idles, so the unit is not flipped between heat and cool every time the room settles.0/1
TsSetpointThe setpoint actually in use — the Ts input if wired, otherwise the parameter. Pass it to the unit's own setpoint object so its display agrees with the system.°C
Mode is a single heat/cool bit, which suits a 1-bit KNX mode object. A unit with coded modes — dry, fan-only, auto — needs its mode list configured on the device and driven separately; this block cannot select those. See the limitations below.

4.Parameters

ParameterSummaryDescriptionRangeDefault
SetpointDefault targetUsed whenever the Ts input is not wired.°C21
DeadbandHysteresis half-bandHow far the room may drift before the unit reacts. The band is this value on each side of the setpoint.°C0.5
ModeDirectionAuto picks heating or cooling from which side of the setpoint the room is on. Heat only and Cool only restrict it to one direction — the right choice for a two-pipe system that is on the heating circuit in winter.auto / heat / coolauto
FanFan behaviourAuto stages the fan by demand. Low, Medium and High hold a fixed speed whenever the unit is working.auto / low / medium / highauto
Fan step 1Low → medium thresholdDegrees past the band at which the automatic fan leaves low.°C1.0
Fan step 2Medium → high thresholdDegrees past the band at which the automatic fan goes to high.°C2.0
Min setpointLowest allowed targetThe effective setpoint is clamped to this wherever it came from — the Ts input or the default — so a dial or a schedule cannot ask for a temperature the unit refuses.°C5
Max setpointHighest allowed targetThe upper bound of the same clamp.°C35
Silent fanFan cap for silent modeThe percentage the fan is capped at while the Sm input is high.%33
RemRemanenceWhen on, the block returns after a reboot with the same mode and setpoint. When off it starts from its configured defaults.0/10

5.How the control works

One comparison, every time an input changes.

The block compares the room against the setpoint and takes the difference — above zero means the room is too warm, below means too cold. What it does with that depends on the Mode parameter:

ModeCools whenHeats whenOtherwise
AutoRoom is above setpoint + deadbandRoom is below setpoint − deadbandIdles
Cool onlyRoom is above setpoint + deadbandNeverIdles
Heat onlyNeverRoom is below setpoint − deadbandIdles

A worked example

Setpoint 21 °C, deadband 0.5, mode auto:

  • Room at 22.0 °C — above 21.5, so the unit cools.
  • Room falls to 21.3 °C — inside the band, so the unit idles: fan 0, On/Off still true, mode still cool.
  • Room falls to 20.2 °C — below 20.5, so the unit heats and the mode output flips.
Idle does not mean off. OnOff stays true so the unit remains enabled and ready; only the fan drops to 0. If your unit should actually switch off inside the band, drive its power from the Fan output through a Comparison block instead.
A deadband that is too small is the classic fault: the unit starts and stops every couple of minutes, which is noisy and hard on the compressor. 0.5 °C is a good default and 1.0 °C is kinder to a room that swings.

6.Fan staging

With Fan set to auto, the speed follows how far past the band the room has drifted.

How far past the bandFan outputWith default steps
Less than Fan step 133 %Up to 1 °C past the band — a room gently off target.
Between step 1 and step 266 %1 °C to 2 °C past the band.
Beyond step 2100 %More than 2 °C past the band.

With a fixed Fan setting the output is simply 33, 66 or 100 whenever the unit is working, and 0 when it idles.

Bedrooms are the reason automatic staging exists: the room reaches target on a low, quiet fan and only winds up when somebody has left a door open on a hot afternoon.

7.Window contact and forcing off

Three ways to hold the unit off, with the same result.

  • Win — a window or door contact. The usual reason, and the one that pays for itself: no cooling an open room.
  • Off — anything else that must stop the unit: a central off, a holiday flag, a fault.
  • Pause — a timed suspension, usually a Delayed on/off block so it releases itself.
  • Ls — load shedding, from whatever signals a grid peak.
  • On low, when it is wired — the positive form of the same thing.

In all three cases OnOff goes false and Fan goes to 0, while the setpoint output keeps its value so the unit's display does not jump. When the condition clears, regulation resumes from the current room temperature.

Where several windows serve one room, feed them through a Logic OR into Win so any open window stops the unit.

8.Wiring it to a unit

Which output goes to which property on the fan coil device.

OutputDevice propertyNotes
OnOffon_offThe unit's power object.
Fanfan_speedA percentage. On a unit with named speeds the platform maps it onto the step — low at 33, medium at 66, high at 100.
ModemodeTrue is heat and false is cool, which matches a 1-bit KNX mode object directly.
Tssetpoint_tempOptional, but it keeps the unit's own display honest.

The matching properties are described in the fan coil device type.

9.Programming example

A bedroom with a fan coil, a room sensor, a window contact and a setpoint the customer can change.

  1. Add the block and pick the fan coil device on it.
  2. Wire a Device trigger on the room sensor's temperature into Tc.
  3. Wire a Device trigger on the unit's setpoint property into Ts, so changing it on the panel moves the target.
  4. Wire the window contact into Win.
  5. Set Deadband to 0.5 and leave Mode and Fan on auto.
  6. Wire the four outputs to device actions on the fan coil: OnOff, Fan, Mode and Ts.
  7. Turn Rem on — after a power cut the room should return to the setpoint the customer chose, not to the commissioning default.
  8. Deploy, then confirm by moving the setpoint well below room temperature and watching the mode and fan outputs change on the canvas.

10.Not available in this version

Stated plainly, since other systems' AC blocks have these and an installer may be looking for them.

  • Only heat and cool. There is no dry, fan-only or unit-auto mode on the Mode output — it is one bit. A unit with coded modes can still reach them: give the device its own mode list and drive mode from a separate Device action, or from the panel.
  • No airflow or vane direction, no swing control.
  • No toggle input. Use On and Off; to toggle from one button, put a flip-flop in front.
  • No Eco / Comfort room-controller integration, no setpoint offset and no reset-to-default input.
Most of these are a small amount of wiring away using blocks that already exist, which is why they are not in the block. If something here is blocking a project, tell us and we will look at building it in.
See it in context in the examples library, or go back to all function blocks.