This custom component for Home Assistant adds support for Midea air conditioner and dehumidifier appliances via the local area network.
homeassistant-midea-air-appliances-lan
Home Assistant custom component for controlling Midea appliance on local network.
Installation instruction
HACS
The easiest way to install this integration is with HACS. First, install HACS if you don't have it yet. In Home Assistant, go to HACS -> Integrations
, click on + Explore & Download Repositories
, search for Midea Air Appliances (LAN)
, and click download. After download, restart Home Assistant.
Once the integration is installed, you can add it to the Home Assistant by going to Configuration -> Devices & Services
, clicking + Add Integration
and searching for Midea Air Appliances (LAN)
or, using My Home Assistant service, you can click on:
Manual installation
- Update Home Assistant to version 2021.12 or newer.
- Clone this repository.
- Copy the
custom_components/midea_dehumidifier_lan
folder into your Home Assistant'scustom_components
folder.
Configuring
- Add
Midea Air Appliances (LAN)
integration via UI. - Enter Midea cloud username and password and select mobile application you use.
- The integration will discover appliance on local network(s).
- If an appliance is not automatically discovered, but is registered to the cloud account, user is prompted to enter IPv4 address of the appliance.
- If you want to use integration with air conditioner unit(s), please select the checkbox on
Advanced settings
page.
Known issues
- If IPv4 address of appliance changes, new IPv4 address will not be used until Home Assistant's restart.
- If Home Assistant installation doesn't have access to physical network, the integration may not discover all appliances.
- Dehumidifier modes correspond to Inventor EVA ΙΟΝ Pro Wi-Fi model. Your dehumidifier might use different names (e.g.,
Boost
instead ofDry
) - Having two integrations accessing the same device can result in undefined behavior. For example, having two Home Assistant instances accessing same device, or using one of other Midea appliance integrations in combination with this one. To avoid problems, use a single integration - this one
🙂 . - If you encounter issues after upgrading, uninstall the integration, restart Home Assistant and re-install it.
- Some of sensors and switches are disabled by default. You need to enable them manually. See tables below for more information.
- Temperature sensor on dehumidifier is often under-reporting real ambient temperature. This may be due to sensor proximity to cooling pipes of the humidifier, algorithm, or electronics error. The under-reporting depends on the active mode, and stronger modes may result in larger offset from real temperature.
- Some Midea appliances, built in 2021 and later, use Tuya based patform and this integration will not work with them. In some cases those appliances have have same model names as old ones.
- When migrating from version 0.6 or 0.7 to 0.8, integration may fail. Please remove and re-install integration.
Supported appliances
- Comfee MDDF-16DEN7-WF or MDDF-20DEN7-WF (tested with 20L version)
- Inventor EVA ΙΟΝ Pro Wi-Fi (EP3-WiFi 16L/20L) (tested with 20L version)
- Inventor Eva II Pro Wi-Fi (EVP-WF16L/20L)
- Pro Breeze 30L Smart Dehumidifier with Wifi / App Control
- Midea SmartDry dehumidifiers (22, 35, 50 pint models)
- Midea Cube dehumidifiers (20, 35, 50 pint models)
Supported are V3 and V2 protocols that allow local network access. V3 protocol requires one connection to Midea cloud to get token and key needed for local network access. Some old models use V1 XML based protocol which is not supported. Some newer models use Tuya protocol.
Supported entities
This custom component creates following entities for each discovered dehumidifier:
Platform | Description |
---|---|
humidifier |
Dehumidifier entity. Depending on the model following modes are supported: Set , Continuos , Smart (if supported), Dry (if supported), Antimould (if supported), Purifier (if supported). |
fan |
Fan entity for controlling dehumidifier fan. Three preset modes are available: Low , Medium and High . |
binary_sensor |
Problem sensor indicating when tank is full. |
binary_sensor |
Problem sensor indicating when tank is removed (created if device announces that pump is supported). |
binary_sensor |
Problem sensor indicating when filter needs cleaning (created if device announces that filter is supported). |
binary_sensor |
Cold sensor indicating defrosting is active (disabled by default). |
sensor |
Sensors for current relative humidity measured by dehumidifier. |
sensor |
Sensor for current temperature measured by dehumidifier. |
sensor |
Sensor for water level in the tank (created if device announces that water level is supported). |
switch |
Switch ion mode on and off (created if device announces that (an)ion mode is supported) |
switch |
Switch pump on and off (created if device announces that pump is supported). |
switch |
Switch to enable pump (created if device announces that pump is supported). |
switch |
Switch to activate beep on action (disabled by default). |
In addition to this, humidifier
entity will have additonal attributes describing capabilities, current and last error code, time of last error, as well as last payloads received.
This custom component creates following entities for each discovered air conditioner:
Platform | Description |
---|---|
climate |
Climate entity. |
sensor |
Sensor for outside temperature measured by air conditioner. |
switch |
Switch purifier mode on and off (enabled if device announces that it is supported). |
switch |
Switch dryer mode on and off (disabled by default). |
switch |
Switch to activate beep on action (disabled by default). |
switch |
Switch display to Fahrenheit degrees (enabled if device announces that it is supported). |
switch |
Switch turbo fan on and off (enabled if device announces that it is supported). |
switch |
Switch screen on and off (enabled if device announces that it is supported). |
In addition to this, climate
entity will have additonal attributes describing capabilities, current and last error code, time of last error, as well as last payloads received.
Troubleshooting
If there are problems while using integration setup, an advanced debug logging can be activated via Advanced settings
page.
Once activated, logs can be see by clicking at:
Select Load Full Home Assistant Log
to see all debug mode logs. Please include as much logs as possible if you open an issue.
Debug logging can be activated without going through setup process:
On entry page, paste following content:
service: logger.set_level
data:
custom_components.midea_dehumidifier_lan: DEBUG
midea_beautiful: DEBUG
It is possible to activate debug logging on Home Assistent start. To do this, open Home Assistant's configuration.yaml
file on your machine, and add following to logger
configuration:
logger:
# Begging of lines to add
logs:
custom_components.midea_dehumidifier_lan: debug
midea_beautiful: debug
# End of lines to add
Home Assistant needs to be restarted after this change.
See also
https://github.com/nbogojevic/midea-beautiful-air
UI
Following Lovelace cards work well with this integration:
https://github.com/MiguelCosta/Dehumidifier_Comfee_Card
https://github.com/sicknesz/midea-inventor-card
Notice
Midea, Inventor, Comfee', Pro Breeze, and other names are trademarks of their respective owners.