versatile_thermostat/documentation/en/over-valve.md

thermostat_over_valve Type Thermostat

Notes

1. The over_valve type is often confused with the over_climate type equipped with auto-regulation and direct valve control.
2. You should only choose this type when you do not have an associated climate entity for your TRV in Home Assistant, and if you only have a number type entity to control the valve's opening percentage. The over_climate with auto-regulation on the valve is much more powerful than the over_valve type.

Prerequisites

The installation should be similar to the over_switch VTherm setup, except that the controlled equipment is directly the valve of a TRV:

1. The user or automation, or the Scheduler, sets a setpoint via a preset or directly using a temperature.
2. Periodically, the internal thermometer (2) or external thermometer (2b) or internal thermometer of the equipment (2c) sends the measured temperature. The internal thermometer should be placed in a relevant spot for the user's comfort: ideally in the middle of the living space. Avoid placing it too close to a window or too near the equipment.
3. Based on the setpoint values, the different temperatures, and the TPI algorithm parameters (see TPI), VTherm will calculate the valve's opening percentage.
4. It will then modify the value of the underlying number entities.
5. These underlying number entities will control the valve opening rate on the TRV.
6. This will regulate the radiator's heating.

The opening rate is recalculated each cycle, which allows regulating the room temperature.

Configuration

First, configure the main settings common to all VTherms (see main settings). Then, click on the "Underlying Entities" option from the menu, and you will see this configuration page, you should add the number entities that will be controlled by VTherm. Only number or input_number entities are accepted.

The algorithm currently available is TPI. See algorithm.

It is possible to choose a thermostat_over_valve to control an air conditioner by checking the "AC Mode" box. In this case, only the cooling mode will be visible.