## Requirements

You need to setup MELCloud integration.

[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=melcloud)

## Limitations

MELCloud is a cloud integration: some commands are lost, and after a restart the auto-start/stop state can be out of sync with the unit. Enable the [incorrect equipment state fix](https://www.versatile-thermostat.org/en/docs/feature-advanced/#fixing-incorrect-equipment-state) to resend the expected state. When you drive the unit by hand, disable the _VTherm_ first, or the fix will undo your change.

The MELCloud fan speeds (1 to 5) do not match the _VTherm_ fan modes, so the automatic fan mode can choose the wrong speed.

## Compatibility status

- **Partial**: This device is supported by Versatile Thermostat, but some advanced features may not be supported. Devices: Mitsubishi MELCloud

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

- [#2036 \[BUG\] Over-climate sometimes fails to turn on MELCloud heat pump](https://github.com/jmcollin78/versatile_thermostat/issues/2036)
- [#787 Auto-fan seems not work with MelCloud](https://github.com/jmcollin78/versatile_thermostat/issues/787)
- [Discussion #1365 Use Auto fan with MelCloud Climate exposing fan speed 1 2 3 4 5 Auto](https://github.com/jmcollin78/versatile_thermostat/discussions/1365)
- [#1391 Auto-start seems broken with two AC splits](https://github.com/jmcollin78/versatile_thermostat/issues/1391)
- [#1654 At startup, VTherm in auto stop mode stop can be not in sync with underlying Heat Pump Split.](https://github.com/jmcollin78/versatile_thermostat/issues/1654)
- [Discussion #2056 Feature request: prevent repair_incorrect_state from fighting manual control of the underlying climate when VTherm is off](https://github.com/jmcollin78/versatile_thermostat/discussions/2056)
- [#2018 `unrecorded_attributes` no longer match since the v8 attribute reorganization -> recorder database bloat (~2.5 KB unique blob per update)](https://github.com/jmcollin78/versatile_thermostat/issues/2018)