Midea Smart Home

English | 简体中文

Home Assistant custom integration for Midea smart devices via local network.

Features

• Local Control: Devices are controlled directly via local network, no cloud connection required
• Auto Protocol Download: Automatically download Lua protocol scripts from cloud (first-time setup only)
• Flexible Configuration: Support customizing entity attributes through device mapping files, easy to adapt new devices
• Multi-language Support: Support Chinese and English interface

Workflow

Configuration Phase

1. User enters Midea account credentials
2. Login to Midea Cloud API

Discovery Phase

1. Get device details from cloud (Device ID, Model, SN8, etc.)
2. Auto-download Lua protocol file for the device
3. Scan device IP address in local network
4. Get device Token and Key (for local authentication)

Runtime Phase

1. Connect to device via local network
2. Parse device protocol using Lua script
3. Poll device status periodically
4. User commands sent directly to device (no cloud needed)

Installation

HACS (Recommended)

1. Open HACS in Home Assistant
2. Go to "Integrations"
3. Click the "+" button
4. Search for "Midea Smart Home"
5. Click "Download"

Manual Installation

1. Copy the custom_components/midea_smart_home directory to your Home Assistant custom_components folder
2. Restart Home Assistant
3. Go to Settings > Devices & Services
4. Click "Add Integration"
5. Search for "Midea Smart Home"

Configuration

For detailed configuration guide, please see Configuration Guide

Supported Devices

No.	Code	Device Type
1	0x17	Laundry Machine
2	0x26	Bath Heater
3	0xAC	Floor Air Conditioner / Wall Air Conditioner / Central Air Conditioner / Central Fresh Air
4	0xB0	Microwave Oven
5	0xB6	Range Hood
6	0xB8	Smart Robot Vacuum
7	0xBF	Microwave Steam Oven
8	0xCA	Multi-Door Fridge
9	0xD9	Twin Tub Washing Machine
10	0xDA	Top Load Washing Machine
11	0xDB	Cylinder Washing Machine
12	0xDC	Clothes Dryer
13	0xE1	Dishwasher
14	0xE2	Electric Water Heater
15	0xE3	Gas Water Heater
16	0xEA	Rice Cooker
17	0xED	Net Drinking Machine / Water Purifier / Pipeline Machine
18	0xFA	Electric Fan
19	0xFB	Electric Heater
20	0xFC	Air Purifier
21	0xFD	Humidifier

More device types are being adapted. Contributions are welcome!

Credits

This project uses/references some code from:

• midea_auto_cloud
• midea_ac_lan
• midea-local