Free your dehumidifier from the cloud — now with ESPHome

This project is an ESPHome-based port of Hypfer’s esp8266-midea-dehumidifier.
While the original version used a custom MQTT firmware, this one is a native ESPHome component, providing full Home Assistant integration without MQTT or cloud dependencies.

Example entities for Inventor EVA II pro:

---

✨ Features

This component allows you to directly control and monitor Midea-based dehumidifiers via UART, completely bypassing the Midea cloud dongle.

Supported entities:

Entity Type	Description
Climate	Power, mode, fan speed, and presets
Bucket Full Binary Sensor (optional)	"Bucket Full" indicator
Clean Filter Binary Sensor (optional)	"Clean Filter" notification if supported
Defrosting Binary Sensor (optional)	Defrosting indicator if supported
Error Sensor (optional)	Reports current error code
Tank Water Level Sensor (optional)	Reports current tank water level
pm2.5 Sensor (optional)	Reports pm2.5 particles from sensor if supported
ION Switch (optional)	Controls ionizer state if supported
Vertical Swing Switch (optional)	Controls vertical swing if supported
Horizontal Swing Switch (optional)	Controls horizontal swing if supported
Beep Switch (optional)	Controls buzzer on ha commands if supported
Sleep Switch (optional)	Controls sleep switch if supported
Pump Switch (optional)	Controls pump if supported
Timer Number (optional)	Controls the internal device timer if supported
Capabilities Text (optional)	Shows device capabilities info

Optional entities can be included or excluded simply by adding or omitting them from your YAML.

---

🧠 Background

Midea-made dehumidifiers (sold under brands like Inventor, Comfee, Midea, etc.) use a UART-based protocol behind their “WiFi SmartKey” dongles.

Those dongles wrap simple serial communication in cloud encryption and authentication layers.
By connecting directly to the UART pins inside the unit, you can fully control it locally — no cloud, no reverse proxy, no token handshakes.

---

🧩 Compatibility

These models are confirmed to work (and more likely will, too):

• Midea MAD22S1WWT
• Comfee MDDF-16DEN7-WF
• Comfee MDDF-20DEN7-WF
• Comfee CDDF7-16DEN7-WFI
• Inventor Eva II PRO Wi-Fi
• Inventor EVA ION PRO Wi-Fi 20L
• Midea Cube 20 / 35 / 50
• Emelson EMLDH20DFR29

Models without USB or Wi-Fi button (e.g., Comfee MDDF-20DEN7, Emelson EMLDH20DFR29) could also work with small wiring changes.

---

🧰 Hardware Setup

You’ll need:

• ESP32 (or ESP8266) board

• UART connection (TX/RX) to your dehumidifier’s USB A female adapter (i.e. male USB A adapter with pins for connection see following photo)

• 3.3 V ↔ 5 V level shifting (if necessary)

The Midea WiFi dongle is just a UART-to-cloud bridge — unplug it and connect your ESP board instead:

Dongle Pin	Function	ESP Pin Example
1	5 V	VIN
2	TX	GPIO17
3	RX	GPIO16
4	GND	GND

---

⚙️ ESPHome Configuration

Example YAML with all supported sensors - controls, full example in dehumidifier.yaml:

external_components:
  - source:
      type: git
      url: https://github.com/Chreece/ESPHome-Dehumidifier
      ref: main
    components: [midea_dehum]
    refresh: 0min

uart:
  id: uart_midea
  tx_pin: GPIO16 # replace with the TX pin used from esp
  rx_pin: GPIO17 # replace with the RX pin used from esp
  baud_rate: 9600

midea_dehum:
  id: midea_dehum_comp
  uart_id: uart_midea
  handshake_enabled: false # Optional if you have problems with unknown states on esp boot
  status_poll_interval: 1000 # Optional, how often should get a status update in ms (1000ms=1sec). Default: 1000ms

  # 🆕 Optional: Rename display modes to match your device’s front panel.
  # For example, your unit may label these as “Cont”, “Dry”, or “Smart”.
  # These names only affect how the presets appear in Home Assistant — 
  # the internal logic and protocol remain the same.
  # 💡 Tip:
  # If any of the modes below are set to "UNUSED" (case-insensitive),
  # that preset will NOT appear in the Home Assistant UI.
  # Use this if your device doesn’t support or respond to a specific mode.
  # For instance, if pressing “SMART”, your unit doesn't change any mode,
  # set display_mode_smart: "UNUSED" to hide it from the UI.
  display_mode_setpoint: 'UNUSED'
  display_mode_continuous: 'Cont'
  display_mode_smart: 'Smart'
  display_mode_clothes_drying: 'Dry'

climate:
  - platform: midea_dehum
    midea_dehum_id: midea_dehum_comp
    name: "Inventor Dehumidifier"

binary_sensor:
  - platform: midea_dehum
    midea_dehum_id: midea_dehum_comp
# Optional sensor to inform when the Bucket is full
    bucket_full:
      name: "Bucket Full"
# Optional sensor to inform that a filter cleaning is required (only if supported)
    clean_filter:
      name: "Clean Filter Request"
# Optional sensor to inform if the defrosting procedure running (only if supported)
    defrost:
      name: "Defrosting"

button:
  - platform: midea_dehum
    midea_dehum_id: midea_dehum_comp
# Optional button to reset the filter clean binary_sensor
    filter_cleaned:
      name: "Reset Filter Cleaning"

# Optional error sensor remove this block if not needed
sensor:
  - platform: midea_dehum
    midea_dehum_id: midea_dehum_comp
    error:
      name: "Error Code"
# Optional tank water level sensor (if supported)
    tank_level:
      name: "Tank water level"
# Optional pm2.5 sensor (if supported)
    pm25:
      name: "pm2.5"

# Optional switches
switch:
  - platform: midea_dehum
    midea_dehum_id: midea_dehum_comp
# Optional ionizer control, add this block only if your device has Ionizer
    ionizer:
      name: "Ionizer"
# Optional swing control (if supported)
    swing:
      name: "Swing"
# Optional control the device pump (if supported)
    pump:
      name: 'Defrost pump'
# Optional sleep mode toggle (not all models support this)
# Enables or disables “Sleep” mode if available on your device (not tested!).
    sleep:
      name: "Sleep Mode"
# Optional beep control
# When enabled, the device will emit a beep sound when it receives
# commands (e.g. from Home Assistant or OTA updates).
    beep:
      name: "Beep on Command"

# Optional timer number entity for the internal device timer
# When device off -> timer to turn on
# When device on -> timer to turn off
# Toggling the device on/off resets the timer
# 0.5h increments, max: 24h
number:
  - platform: midea_dehum
    midea_dehum_id: midea_dehum_comp
    timer:
      name: "Internal Device Timer"

# Optional text sensor to show discovered device capabilities
# Useful for diagnostics — helps confirm which features your model supports.
# (Note: Not all capabilities are necessarily showed.)
text_sensor:
  - platform: midea_dehum
    midea_dehum_id: midea_dehum_comp
    capabilities:
      name: "Device Capabilities"

All entities appear automatically in Home Assistant with native ESPHome support.

---

🧩 Component Architecture

File	Purpose
midea_dehum.cpp / midea_dehum.h	Core UART communication and protocol handling
climate.py	Main control entity — manages mode, fan, humidity, and related features
binary_sensor.py	Reports the “Bucket Full”, Clean Filter, Defrosting
button.py	Provides optional Filter Cleaned button
sensor.py	Provides optional error code reporting, tank water level, pm2.5
switch.py	Defines optional on/off switches
number.py	Adds an optional timer entity
text.py	Displays optional device capability information

---

🧪 Supported Features

• Power on/off

• Mode control (Setpoint, Continuous, Smart, ClothesDrying, etc.)

• Fan speed control

• Humidity Control Target & Current humidity (via native ESPHome climate interface)

• Current Temperature (integer)

• pm2.5 level

• Tank water level

• Bucket full status

• Defrosting status

• Clean filter request

• Filter cleaned button

• Error code reporting

• Ionizer toggle

• Vertical Swing Control-Toggle air swing direction

• Horizontal Swing Control-Toggle air swing direction

• Buzzer (beep) control on HA commands

• Pump switch

• Sleep switch

• On/Off timer

• Get device capabilities

Note: The Temperature-Humidity values from device aren't reliable, better not use them for automations.

---

⚠️ Safety Notice

Many of these dehumidifiers use R290 (Propane) as refrigerant. This gas is flammable. Be extremely careful when opening or modifying your unit. Avoid sparks, heat, or metal contact that could pierce the sealed system.

---

⚠️ Disclaimer

This project interacts directly with hardware inside a mains-powered appliance that may use R290 (propane) refrigerant. Modifying or opening such devices can be dangerous and may cause electric shock, fire, or injury if not done safely.

By using this project, you agree that:

You perform all modifications at your own risk.

The author(s) and contributors are not responsible for any damage, data loss, or injury.

Always disconnect power before working on the device.

Never operate the unit open or modified near flammable materials.

If you’re not confident working with electrical components, don’t attempt this modification.

---

🧑‍💻 Credits

👉 Hypfer/esp8266-midea-dehumidifier

Swing control and native humidity integration contributed by CDank — huge thanks for the collaboration and implementation help!

It builds upon reverse-engineering efforts and research from:

Mac Zhou

NeoAcheron

Rene Klootwijk

Anteater (Handshake + pump control)

---

📜 License

This port follows the same open-source spirit as the original project. See LICENSE for details.

_{Made with ❤️ by Chreece — This project is based on Hypfer's esp8266-midea-dehumidifier, originally licensed under the Apache License 2.0.
Modifications and ESPHome integration © 2025 Chreece.
Original logo © Hypfer, used here for attribution under the Apache License 2.0.}