Home Assistant custom integration to control Midea (and associated brands) air conditioners via LAN.
Midea is an OEM for many brands including: AirCon, Alpine Home Air, Artel, Beko, Canair, Carrier, Century, Comfee, Electrolux, Friedrich, Galactic, Goodman, Hualing, Idea, Inventor, Kaisai, Kenmore, Klimaire, Lennox, LG, Mitsui, Mr. Cool, Neoclima, Olimpia Splendid, Pioneer, Pridiom, QLIMA, Qzen, Rotenso, Royal Clima, Samsung, Senville, Thermocore, Toshiba, Trane and more.
A device is likely supported if it uses one of the following Android apps or it's iOS equivalent.
- Artic King (com.arcticking.ac)
- Midea Air (com.midea.aircondition.obm)
- NetHome Plus (com.midea.aircondition)
- SmartHome/MSmartHome (com.midea.ai.overseas)
- Toshiba AC NA (com.midea.toshiba)
- 美的美居 (com.midea.ai.appliances)
Note: Only air conditioner devices (type 0xAC) are supported.
See Getting Device Info to determine if a device is supported.
- Automatic device discovery and configuration via the GUI.
- Device capability detection. Only supported modes, presets, fan speeds and functions are displayed.
- Support for sleep, eco, boost (turbo) and away (freeze protection) presets.
- Switch entity for device display.1
- Binary sensor entity for device filter alert.
- Minimum and maximum target temperatures from device.
- Number entity for fan speed if devices support custom speeds.
- Service to enable "Follow Me" function.2
- Select entities to control swing angle when supported.
- Translations
- Català
- English
- Español
- Hrvatski
- Italiano
- 한국어
- Magyar
- Nederlands
- Polski
- Português
- Română
- Slovenčina
- Help contribute a new language
- Device dependent. Some devices only support display control via IR.
- Experimental. "Follow Me" requires the IR remote to transmit temperature data. More info here.
Or search HACS integrations for "Midea Smart AC".
- Locate the
custom_componentsdirectory in your Home Assistant configuration directory. It may need to be created. - Copy the
custom_components/midea_acdirectory into thecustom_componentsdirectory. - Restart Home Assistant.
Midea Smart AC is configured via the GUI. See the HA docs for more details.
Devices can be automatically discovered and configured or manually configured.
For automatic configuration, select "Discover devices". Leave the host field blank to search the local network, or provide an IP/hostname to configure a specific device.
For manual configuration, select "Configure manually". Enter the device ID, IP, and port. V3 devices require the token and key parameter. This information must be acquired manually.
| Name | Description | Required | Example |
|---|---|---|---|
| ID | Device ID | Yes | 123456789012345 |
| Host | Device IP address | Yes | 192.168.1.100 |
| Port | Device port | Yes | 6444 |
| Token | Device token | For V3 devices | ACEDDA53831AE5DC... (Length 128) |
| Key | Device key | For V3 devices | CFFA10FC... (Length 64) |
Additional options are available to tweak integration behavior per device.
| Name | Default | Description |
|---|---|---|
| Beep | True | Enable beep on setting changes. |
| Temperature Step | 1.0 | Step size for temperature set point. |
| Use Fan-only Workaround | False | Enable this option if device updates cause the device to turn on and switch to fan-only. |
| Show All Presets | False | Show all presets regardless of device's reported capabilities. |
| Additional Operation Modes | Empty | Additional HVAC modes to make available in case the device's capabilities are incorrect. |
| Maximum Connection Lifetime | Empty | Limit the time (in seconds) a connection to the device will be used before reconnecting. If left blank, the connection will persist indefinitely. If your device disconnects at regular intervals, set this to a value below the interval. |
Use the midea-discover command from msmart-ng to obtain device information.
pip install msmart-ng
msmart-ng discoverCheck the output to ensure the type is 0xAC and the supported property is True.
This project is a fork of mac-zhou/midea-ac-py, and builds upon the work of: