# Zigbee pilot wire modules

The NodOn SIN-4-FP-21 (also sold as Equation SIN-4-FP-21_EQU) and the Legrand Céliane with Netatmo cable outlet control an electric heater through its pilot wire. With Zigbee2MQTT, they expose a `select` entity for the pilot wire mode, with the same options: `comfort`, `eco`, `frost_protection`, `off`, `comfort_-1` and `comfort_-2`.

## Configuration

1. Use Zigbee2MQTT: with ZHA, these modules only expose an on/off switch.
2. In the _VTherm_ `over_switch`, select the pilot wire mode entity (`select.*_pilot_wire_mode`), not the `switch` entity of the module.
3. In the [command customization](https://www.versatile-thermostat.org/en/docs/over-switch/), set the on command to `select_option/option:comfort` and the off command to `select_option/option:frost_protection`.

Avoid `eco` as the off command: the internal thermostat of the heater keeps heating in this mode.

## Recommendations

- Set the comfort temperature of the heater above the _VTherm_ setpoint, so that its internal thermostat does not cut the heating.
- All the modules of a single _VTherm_ start at the same time: take it into account for the power management.

## Compatibility status

- **Supported**: This device is used directly by the Versatile Thermostat maintainer or a contributor, or has been extensively tested. Devices: NodOn - SIN-4-FP-20 / SIN-4-FP-21
- **Community**: This device has been reported as fully functional by the community. Devices: Equation pilot wire module (NodOn), Legrand Celiane with Netatmo cable outlet

## VTherm configuration

### Initialization

Go to your settings, then integrations, then click on add a new integration. Search for Versatile Thermostat.

Click on Thermostat over a switch.

### Basic attributes

Go to the "Main attributes" section.

1. Choose a name for your thermostat
2. Set the temperature sensor for your room
3. If you are using the Zigbee protocol and you have a "last_seen" entity for your temperature sensor, fill it in.

You can validate and return to the configuration menu.

### Underlying entities

Go to the underlying entities section.

1. Add the switches that will be controlled

You can validate and return to the configuration menu.

## Community references

Additional references may be old. A bug reported on an old version of VTherm may have been corrected on a more recent version.

- NodOn SIN-4-FP-21 / Equation
  - [Discussion #613 Using select from NodOn SIN-4-FP-21 (or other)](https://github.com/jmcollin78/versatile_thermostat/discussions/613)
  - [Discussion #950 NoDon SIN-4-FP-21 Versatile don't change status mode](https://github.com/jmcollin78/versatile_thermostat/discussions/950)
  - [Discussion #431 Adaptation du code switch pour les modules NodOn SIN-4-FP-21](https://github.com/jmcollin78/versatile_thermostat/discussions/431)
  - [Discussion #1834 Problème régulation puissance 1 Vtherm pour 2 Switch Nodon](https://github.com/jmcollin78/versatile_thermostat/discussions/1834)
  - [#872 \[Feature request\] - Add native support of virtual switch in `over_switch` VTherm](https://github.com/jmcollin78/versatile_thermostat/issues/872)
  - [#1487 Température dépassée et chauffe en continue ?](https://github.com/jmcollin78/versatile_thermostat/issues/1487)
  - [#1783 v9.0.0 could not convert string to float: 'Jaune'](https://github.com/jmcollin78/versatile_thermostat/issues/1783)
  - [Discussion #1539 Electric radiator with internal thermostat vs TPI (noise & power behavior)](https://github.com/jmcollin78/versatile_thermostat/discussions/1539)
- Legrand Celiane with Netatmo
  - [#214 Gestion mode fils pilote](https://github.com/jmcollin78/versatile_thermostat/issues/214)
  - [Discussion #1688 Energy calculation for over_switch becomes wrong ?](https://github.com/jmcollin78/versatile_thermostat/discussions/1688)
  - [Discussion #996 Custom start/top commands cannot be modified? What am I doing wrong?](https://github.com/jmcollin78/versatile_thermostat/discussions/996)
  - [Discussion #636 TPI first day of heating](https://github.com/jmcollin78/versatile_thermostat/discussions/636)