# 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

1. **Sensibo**: after an `off` command, a fan mode command can switch the air conditioner back on. Some units also turn off on their own.
2. **LG ThinQ**: the cloud integration rejects some commands (`target_temperature_low`), and regulation cycles are lost when the cloud is unavailable.
3. **Gree**: with auto-start/stop, the auto-stop does not send `off` to the air conditioner.
4. **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 `off` afterwards.
5. **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.
6. **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.
7. **Atlantic Naviclim** (GW003-AS-IN-TE-FC): auto-start works in heating mode, but cooling regulation is slow.

## Thermostats and heating systems

1. **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.
2. **Rointe** type thermostats tend to wake up on their own. The rest works normally.
3. Heating systems based on **Netatmo** perform poorly. Netatmo schedules conflict with _VTherm_ programming. Netatmo devices constantly revert to `Auto` mode, 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](https://www.versatile-thermostat.org/en/docs/troubleshooting/) section.
4. **ecobee**: check the temperature unit. A mix between °F and °C can pin the setpoint to the minimum value of the thermostat.

## Compatibility status

- **Partial**: This device is supported by Versatile Thermostat, but some advanced features may not be supported. Devices: Airzone Aidoo, Atlantic Naviclim, ecobee, Gree, Homematic / Homematic IP, LG ThinQ, Mitsubishi Heavy Industries - WF-RAC, Netatmo, Panasonic Comfort Cloud, Rointe, Sensibo

## VTherm 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.

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 thermostats 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.

- Homematic
  - [#133 Homematic Thermostat: Temperature switches to 5C after window open/close](https://github.com/jmcollin78/versatile_thermostat/issues/133)
  - [#228 Documentation change for Homematic thermostats](https://github.com/jmcollin78/versatile_thermostat/issues/228)
  - [#661 central boiler doesn't work anymore woth 6.8.0beta](https://github.com/jmcollin78/versatile_thermostat/issues/661)
  - [#698 nb_device_active_for_boiler not updating](https://github.com/jmcollin78/versatile_thermostat/issues/698)
  - [Discussion #320 combining over_switch with over_climate](https://github.com/jmcollin78/versatile_thermostat/discussions/320)
- Netatmo
  - [#2092 \[BUG\] Central Boiler Manager stays is_on: false with custom service calls despite active devices > 0](https://github.com/jmcollin78/versatile_thermostat/issues/2092)
  - [#386 "nb device active for boiler" remains zero. My boiler won't turn on when vtherm ask for heat.](https://github.com/jmcollin78/versatile_thermostat/issues/386)
  - [#1520 When underlying temperature stops reporting, trv switched off](https://github.com/jmcollin78/versatile_thermostat/issues/1520)
  - [#2055 \[Issue\] climate.turn_on do not restore the last active hvac_mode instead it forces COOL (ac_mode)](https://github.com/jmcollin78/versatile_thermostat/issues/2055)
  - [#2127 Restored off state always becomes hvac_off_manual: hvac_off_reason is read from the root level instead of specific_states](https://github.com/jmcollin78/versatile_thermostat/issues/2127)
- Rointe
  - [Discussion #159 Does Off not mean Off?](https://github.com/jmcollin78/versatile_thermostat/discussions/159)
- Sensibo
  - [#847 VTherm sends fan command after turning off the VTherm](https://github.com/jmcollin78/versatile_thermostat/issues/847)
  - [Discussion #843 When I set hvac mode: off , Versatile continue to send command with effect to power on the air conditioner](https://github.com/jmcollin78/versatile_thermostat/discussions/843)
  - [#1984 over_climate AC: spurious set_hvac_mode: off after set_temperature, and infinite loop with follow_underlying_temp_change](https://github.com/jmcollin78/versatile_thermostat/issues/1984)
  - [#585 \[Feature Request\] - Add an auto-start/stop feature for over_climate VTherm](https://github.com/jmcollin78/versatile_thermostat/issues/585)
  - [Discussion #1128 Fighting with the fan mode (and some other confusions)](https://github.com/jmcollin78/versatile_thermostat/discussions/1128)
- 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?](https://github.com/jmcollin78/versatile_thermostat/discussions/1051)
  - [#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](https://github.com/jmcollin78/versatile_thermostat/issues/2003)
  - [Discussion #1310 Can't get Versatile Thermostat to work on my AC](https://github.com/jmcollin78/versatile_thermostat/discussions/1310)
- Gree
  - [#1976 \[over_climate\] auto_stop nenvoie pas hvac_mode: off à lentité climate sous-jacente](https://github.com/jmcollin78/versatile_thermostat/issues/1976)
  - [#1975 over_climate: `set_hvac_mode: off` propagates only to first underlying when multiple are configured](https://github.com/jmcollin78/versatile_thermostat/issues/1975)
- Airzone Aidoo
  - [Discussion #216 Stronge behaviour with airzone thermostat](https://github.com/jmcollin78/versatile_thermostat/discussions/216)
  - [#2135 over_climate + auto-start/stop: heat order received while auto-stopped turns the underlying ON, VTherm stays OFF and never sends OFF again](https://github.com/jmcollin78/versatile_thermostat/issues/2135)
  - [Discussion #363 TRVs with air to water heat pump](https://github.com/jmcollin78/versatile_thermostat/discussions/363)
- Panasonic Comfort Cloud
  - [#1935 \[Feature Request\] - Case-insensitive fan mode detection for auto-fan feature](https://github.com/jmcollin78/versatile_thermostat/issues/1935)
  - [Discussion #569 Using the internal temperature option, but to prevent heating when over target.](https://github.com/jmcollin78/versatile_thermostat/discussions/569)
- Mitsubishi Heavy Industries WF-RAC
  - [#873 HA becomes unstable when Vtherm runs](https://github.com/jmcollin78/versatile_thermostat/issues/873)
  - [#299 System turning off immediately after turning on after 5.1.0 update](https://github.com/jmcollin78/versatile_thermostat/issues/299)
- ecobee
  - [#1803 Over climate VTherm consistently placing setpoint at underlying thermostat minimun](https://github.com/jmcollin78/versatile_thermostat/issues/1803)
  - [#1796 9.0.1 Unable to control over_climate - computed target temperature out of valid temperature range](https://github.com/jmcollin78/versatile_thermostat/issues/1796)
  - [#2086 \[Feature request\] Expose last sent temperature and datetime of underlyings as attributes](https://github.com/jmcollin78/versatile_thermostat/issues/2086)
- Atlantic Naviclim
  - [#807 Set temperature action was used with the target temperature parameter but the entity does not support it over_climate from Atlantic AC binded with Zigbee2mqtt](https://github.com/jmcollin78/versatile_thermostat/issues/807)
  - [#518 Google Nest issues after upgrade -> 6.3.0](https://github.com/jmcollin78/versatile_thermostat/issues/518)