/homeassistant-midea-dehumidifier-lan

This Home Assistant custom component adding support for controlling Midea dehumidifiers on local network.

Primary LanguagePythonMIT LicenseMIT

This custom component for Home assistant adds support for Midea air conditioner and dehumidifier appliances via the local area network.

homeassistant-midea-dehumidifier-lan

Repository validation

hacs GitHub Release

Home Assistant custom component for controlling Midea Dehumidifier on local network.

Installation instruction

HACS

The easiest way to install the 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 Dehumidifier (LAN), and click download.

Once the integration is installed, and you have restarted, you can add it to Home Assistant by going to Configuration -> Devices & Services, clicking + Add Integration and searching for Midea Dehumidifier (LAN) or, using My Home Assistant service, you can click on:

Add Midea Dehumidifier (LAN)

Manual installation

  1. Update Home Assistant to version 2021.12 or newer.
  2. Clone this repository.
  3. Copy the custom_components/midea_dehumidifier_lan folder into your Home Assistant's custom_components folder.

Configuring

  1. Add Midea Dehumidifier (LAN) integration via UI.
  2. Enter Midea cloud username and password. Those are the same used in NetHome Plus mobile application.
  3. The integration will discover appliance on local network(s).
  4. If an appliance is not automatically discovered, but is registered to the cloud account, user is prompted to enter IPv4 address of the appliance.

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 of Dry)
  • 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.

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 filter needs replacement (disabled by default).
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 (enabled if device announces that water level is not 0% or 100%).
switch Switch ion mode on and off (enabled if device announces that it is supported)
switch Switch pump on and off (enabled if device announces that it is supported)
switch Switch sleep mode on and off (disabled by default)
switch Switch to activate beep on action (disabled by default)

This custom component creates following entities for each discovered air conditioner:

Platform Description
climate Climate entity.
binary_sensor Problem sensor indicating when tank is full.
binary_sensor Problem sensor indicating when filter needs replacement (disabled by default).
binary_sensor Cold sensor indicating defrosting is active (disabled by default).
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 sleep 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)

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