Known limitations
The following devices work with Versatile Thermostat, but with limitations. Some features will not work, or the regulation will not be as good as with a fully compatible device.
All these devices are installed with the over_climate type: the installation steps are given below on this page.
Air conditioners and heat pumps
- Sensibo: after an
offcommand, a fan mode command can switch the air conditioner back on. Some units also turn off on their own. - LG ThinQ: the cloud integration rejects some commands (
target_temperature_low), and regulation cycles are lost when the cloud is unavailable. - Gree: with auto-start/stop, the auto-stop does not send
offto the air conditioner. - Airzone Aidoo: the eco mode of the Airzone app forces 18 °C or off: disable it. After an auto-stop, a heating request can turn the unit on without VTherm sending
offafterwards. - Panasonic Comfort Cloud: the fan modes use capital letters, so the automatic fan mode of VTherm does not work. The internal sensor of the unit is unstable: use a room sensor.
- Mitsubishi Heavy Industries WF-RAC: keep the integration up to date, older versions turned the unit off right after start. The Wi-Fi module restarts regularly and is unavailable for about 30 seconds.
- Atlantic Naviclim (GW003-AS-IN-TE-FC): auto-start works in heating mode, but cooling regulation is slow.
Thermostats and heating systems
- Homematic thermostats (and possibly Homematic IP) are known to have issues with Versatile Thermostat due to the limitations of the underlying RF protocol. This problem particularly arises when trying to control multiple Homematic thermostats at once in a single VTherm instance. To reduce service cycle load, you can, for example, group thermostats using Homematic-specific procedures (e.g., using a wall-mounted thermostat) and let Versatile Thermostat control only the wall-mounted thermostat directly. Another option is to control a single thermostat and propagate mode and temperature changes via automation.
- Rointe type thermostats tend to wake up on their own. The rest works normally.
- Heating systems based on Netatmo perform poorly. Netatmo schedules conflict with VTherm programming. Netatmo devices constantly revert to
Automode, which is poorly managed with VTherm. In this mode, VTherm cannot determine whether the system is heating or cooling, making it impossible to select the correct algorithm. Some users have managed to make it work using a virtual switch between VTherm and the underlying system, but stability is not guaranteed. An example is provided in the troubleshooting section. - ecobee: check the temperature unit. A mix between °F and °C can pin the setpoint to the minimum value of the thermostat.
Device configuration
Initialization
Go to your settings, then integrations, then click on add a new integration. Search for Versatile Thermostat.
Click on Thermostat over another thermostat.
Basic attributes
Go to the "Main attributes" section.
- Choose a name for your thermostat
- Set the temperature sensor for your room
- 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.
- Add the thermostats that will be controlled
You can validate and return to the configuration menu.
Community references
- Homematic
- Netatmo
- #2092 [BUG] Central Boiler Manager stays is_on: false with custom service calls despite active devices > 0
- #386 "nb device active for boiler" remains zero. My boiler won't turn on when vtherm ask for heat.
- #1520 When underlying temperature stops reporting, trv switched off
- #2055 [Issue] climate.turn_on do not restore the last active hvac_mode instead it forces COOL (ac_mode)
- #2127 Restored off state always becomes hvac_off_manual: hvac_off_reason is read from the root level instead of specific_states
- Rointe
- Sensibo
- #847 VTherm sends fan command after turning off the VTherm
- Discussion #843 When I set hvac mode: off , Versatile continue to send command with effect to power on the air conditioner
- #1984 over_climate AC: spurious set_hvac_mode: off after set_temperature, and infinite loop with follow_underlying_temp_change
- #585 [Feature Request] - Add an auto-start/stop feature for over_climate VTherm
- Discussion #1128 Fighting with the fan mode (and some other confusions)
- LG ThinQ
- Discussion #1051 Is there a way to disable target_temperature_low/target_temperature_high being set on the vtherm climate entities in cooling/heating mode?
- #2003 over_climate: set_temperature() crashes with "TypeError: argument of type 'int' is not a container or iterable" when the underlying's supported_features is a plain int
- Discussion #1310 Can't get Versatile Thermostat to work on my AC
- Gree
- Airzone Aidoo
- Panasonic Comfort Cloud
- Mitsubishi Heavy Industries WF-RAC
- ecobee
- Atlantic Naviclim