Quick Start

This page sums up the steps to get a working VTherm, whatever the controlled equipment. Each step links to the page that details it. For a tutorial by heating type (pilot wire, thermostatic valve, heat pump, pellet stove), see the quick start guides of the website. For the settings specific to a device, see its page in the device catalog.

• Quick Start
  • Before You Start
  • Create the VTherm
  • Set Up and Check
  • Next Step

Before You Start

• Versatile Thermostat is installed (see Installation).
• The equipment to control is available in Home Assistant, as well as a room temperature sensor and an outdoor temperature sensor.
• You know which entity the equipment exposes (climate, switch, select or number): it determines the VTherm type (see Making the right choice).

Create the VTherm

1. Add the integration Versatile Thermostat from the integrations page and choose the VTherm type that fits the equipment (see Choosing a VTherm). The central configuration is optional: without it, leave the "Use central configuration" boxes unchecked.

2. Main attributes: give the VTherm a name and choose the room temperature sensor, then the outdoor temperature sensor. Keep the default cycle duration (see Choosing Basic Attributes).

3. Features: do not enable any for now. You will add them once the VTherm works.

4. Underlyings: select the entity of the equipment. The settings depend on the type:

   • over_climate: keep self-regulation disabled to start with. If the valve opening of a TRV can be controlled, choose direct valve control instead.
   • over_switch: a switch is enough. For a pilot wire module (select) or a climate entity, fill in the custom commands.
   • over_valve: select the number entity of the valve.

   The settings specific to a device (entities to use, commands, known pitfalls) are on its page in the device catalog.

5. TPI parameters, if this menu is offered: keep the default values (see the TPI coefficients).

6. Presets: validate the menu (see Presets).

7. Advanced parameters: keep the default values of the safety mode (see Safety Parameters).

8. All done: the VTherm is created.

Set Up and Check

1. Set the temperature of each preset with the entities of the VTherm (see Presets).
2. Put the VTherm in Heat mode and choose the Comfort preset, with a setpoint above the room temperature.
3. Check that the equipment reacts: the device receives the setpoint, the radiator turns on or the valve opens.

If nothing happens, see Troubleshooting, then download the logs and open them in the log analyzer of the website.

Next Step

Once this basic VTherm works:

• install the UI card and a scheduler, presented in Some Essential Add-Ons,
• enable the useful features one at a time, checking each time that the VTherm reacts correctly: automatic start/stop, window detection, presence management...
• then, if needed: central configuration, centralized control, central boiler, self-regulation tuning and tuning examples.