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.
2.Inputs
Only the room temperature is really required — everything else has a sensible behaviour when left unwired.
| Pin | Label | Description | Range |
|---|---|---|---|
| Tc | Room Temp | The 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 |
| Ts | Setpoint | Target temperature. While wired it overrides the Setpoint parameter, which is how a panel dial, a schedule or a room controller feeds the block. | °C |
| On | On | Enables the unit. If you leave it unwired the block treats it as on — a block with only a temperature wired still regulates. | 0/1 |
| Off | Off | Dominating. While 1 the unit is off and the fan is 0, whatever the temperature is doing. | 0/1 |
| Win | Window | Window or door contact — 1 means open. Holds the unit off exactly like Off does, and releases it when the window closes. | 0/1 |
| Pause | Pause | Holds 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 |
| Ls | Load shed | Holds 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 |
| Sm | Silent | Caps the fan at the configured silent percentage while high. It never speeds a slower fan up, and an idle unit stays idle. | 0/1 |
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.
| Pin | Label | Description | Range |
|---|---|---|---|
| OnOff | On/Off | True 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 |
| Fan | Fan % | 0 while idle, otherwise 33, 66 or 100 — see fan staging. Wire it to the unit's fan-speed property. | 0…100 |
| Mode | Heat/Cool | True 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 |
| Ts | Setpoint | The 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
| Parameter | Summary | Description | Range | Default |
|---|---|---|---|---|
| Setpoint | Default target | Used whenever the Ts input is not wired. | °C | 21 |
| Deadband | Hysteresis half-band | How far the room may drift before the unit reacts. The band is this value on each side of the setpoint. | °C | 0.5 |
| Mode | Direction | Auto 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 / cool | auto |
| Fan | Fan behaviour | Auto stages the fan by demand. Low, Medium and High hold a fixed speed whenever the unit is working. | auto / low / medium / high | auto |
| Fan step 1 | Low → medium threshold | Degrees past the band at which the automatic fan leaves low. | °C | 1.0 |
| Fan step 2 | Medium → high threshold | Degrees past the band at which the automatic fan goes to high. | °C | 2.0 |
| Min setpoint | Lowest allowed target | The 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. | °C | 5 |
| Max setpoint | Highest allowed target | The upper bound of the same clamp. | °C | 35 |
| Silent fan | Fan cap for silent mode | The percentage the fan is capped at while the Sm input is high. | % | 33 |
| Rem | Remanence | When on, the block returns after a reboot with the same mode and setpoint. When off it starts from its configured defaults. | 0/1 | 0 |
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:
| Mode | Cools when | Heats when | Otherwise |
|---|---|---|---|
| Auto | Room is above setpoint + deadband | Room is below setpoint − deadband | Idles |
| Cool only | Room is above setpoint + deadband | Never | Idles |
| Heat only | Never | Room is below setpoint − deadband | Idles |
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.
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.6.Fan staging
With Fan set to auto, the speed follows how far past the band the room has drifted.
| How far past the band | Fan output | With default steps |
|---|---|---|
| Less than Fan step 1 | 33 % | Up to 1 °C past the band — a room gently off target. |
| Between step 1 and step 2 | 66 % | 1 °C to 2 °C past the band. |
| Beyond step 2 | 100 % | 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.
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.
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.
| Output | Device property | Notes |
|---|---|---|
| OnOff | on_off | The unit's power object. |
| Fan | fan_speed | A percentage. On a unit with named speeds the platform maps it onto the step — low at 33, medium at 66, high at 100. |
| Mode | mode | True is heat and false is cool, which matches a 1-bit KNX mode object directly. |
| Ts | setpoint_temp | Optional, 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.
- Add the block and pick the fan coil device on it.
- Wire a Device trigger on the room sensor's temperature into
Tc. - Wire a Device trigger on the unit's setpoint property into
Ts, so changing it on the panel moves the target. - Wire the window contact into
Win. - Set Deadband to 0.5 and leave Mode and Fan on auto.
- Wire the four outputs to device actions on the fan coil:
OnOff,Fan,ModeandTs. - Turn Rem on — after a power cut the room should return to the setpoint the customer chose, not to the commissioning default.
- 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
Modeoutput — it is one bit. A unit with coded modes can still reach them: give the device its own mode list and drivemodefrom a separate Device action, or from the panel. - No airflow or vane direction, no swing control.
- No toggle input. Use
OnandOff; 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.