home-assistant.io/source/_integrations/melcloud.markdown

title, description, ha_category, ha_release, ha_iot_class, ha_config_flow, ha_codeowners, ha_domain

title	description	ha_category	ha_release	ha_iot_class	ha_config_flow	ha_codeowners	ha_domain
MELCloud	MELCloud integration	Climate	0.106	Cloud Polling	true	@vilppuvuorinen	melcloud

The melcloud integration integrates Mitsubishi Electric's MELCloud enabled devices into Home Assistant.

Device support

• Air-to-Air heat pumps, e.g., AC units - Supported
• Air-to-Water heat pumps - Supported
• Energy recovery ventilators - Not supported
• Other - Not supported

Configuration

The integration should be configured through the user interface ("Configurations -> Integrations") using the MELCloud login details. While not optimal, the provided password is not stored.

An expired token needs to be updated manually by adding the MELCloud integration again with the same email address.

Configuration is also possible through configuration.yaml. The required authentication token can be found in X-MitsContextKey header when logged into the MELCloud. The language needs to be set to English and the "Remember me" option needs to be selected.

melcloud:
  username: xxxx@xxxxxxx
  token: xxxxxxxxxxxxxxxxxxx

{% configuration %} username: description: Email address used to login to MELCloud required: true type: string token: description: X-MitsContextKey access token required: true type: string {% endconfiguration %}

Air-to-Air device

An Air-to-Air heat pump provides climate and sensor platforms. Device capabilities can limit the available parameters and sensors.

Climate

The following parameters can be controlled for the climate platform entities:

• Power (using HVAC mode)
• Target temperature
• Operation mode (HVAC mode)
• Fan speed
• Horizontal and vertical vane positions

State attributes

Attribute	Description	Example
vane_horizontal	Current horizontal vane position or mode	auto
vane_horizontal_positions	Available horizontal vane positions and modes	auto, split, swing
vane_vertical	Current vertical vane position or mode	auto
vane_vertical_positions	Available vertical vane positions and modes	auto, split, swing

Controlling vanes

The horizontal and vertical vane positions can be controlled using the corresponding melcloud.set_vane_horizontal and melcloud.set_vane_vertical services.

Swing mode can also be used to control vertical vane position.

Sensor

The following attributes are available for sensor platform entities:

• Room temperature
• Energy - The total consumed energy in kWh. Not supported by all models.

Air-to-Water device

An Air-to-Water device provides water_heater, climate and sensor platforms.

Climate

A climate platform entity is provided for each radiator zone in the air-to-water system. The following parameters can be controlled:

• Target room temperature

The radiators need to be configured to run in room temperature control mode either through the local HMI or MELCloud. Flow temperature and curve modes are not supported.

Some air-to-water devices allow cooling using the radiator zones. This feature has not been implemented due to the lack of sample devices.

The system cannot be turned on/off through the climate entities.

State attributes

Attribute	Description	Example
status	Current operation status	idle

Sensor

The following attributes are available for sensor platform entities:

• Room temperature for each zone
• Tank water temperature
• Outside temperature - 1°C precision, polled every 1-2 hours.

Unlike air-to-air devices, air-to-water devices do not report energy consumption in an easily accessible manner.

Water heater

The following parameters can be controlled for the water_heater platform entities:

• Power - Controls the entire system.
• Target tank temperature
• Operation mode

State attributes

Attribute	Description	Example
status	Current operation status	heat