https://github.com/wuwentao/midea_lan
Auto-configure and then control your Midea M-Smart devices (Air conditioner, Fan, Water heater, Washer, etc) via local area network.
https://github.com/wuwentao/midea_lan
air-conditioner air-purifier dishwasher hacs hacs-integration home-assistant home-assistant-component home-assistant-hacs home-assistant-integration humidifier midea refrigerator washer
Last synced: 2 months ago
JSON representation
Auto-configure and then control your Midea M-Smart devices (Air conditioner, Fan, Water heater, Washer, etc) via local area network.
- Host: GitHub
- URL: https://github.com/wuwentao/midea_lan
- Owner: wuwentao
- License: mit
- Created: 2024-06-26T15:20:23.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-09-23T12:40:58.000Z (7 months ago)
- Last Synced: 2024-11-24T20:59:55.786Z (5 months ago)
- Topics: air-conditioner, air-purifier, dishwasher, hacs, hacs-integration, home-assistant, home-assistant-component, home-assistant-hacs, home-assistant-integration, humidifier, midea, refrigerator, washer
- Language: Python
- Homepage:
- Size: 178 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Midea LAN
[](https://github.com/hacs/integration)
[](https://github.com/wuwentao/midea_lan/releases/latest)
English | [简体中文](README_hans.md) | [Discord Chat](https://discord.com/invite/ZWdd2fXndn)
**_❗ [georgezhao2010/midea_ac_lan](https://github.com/georgezhao2010/midea_ac_lan) not update for a long time, we will maintain it now_**
Control your Midea M-Smart appliances via local area network.
- Automated device discover and configuration based Home Assistant config flow UI.
- Extra sensors and switches.
- Synchronize status with the appliance by long TCP connection in time.
⭐If this component is helpful for you, please star it, it encourages me a lot.
**_❗Note: Home Assistant 2023.8 or higher required for this integration_**
## Supported brands
   \
   \
   \
   \
   \
And more.
## Supported appliances
| Type | Name | Documents |
| ---- | -------------------------- | ------------------ |
| 13 | Light | [13.md](doc/13.md) |
| 26 | Bathroom Master | [26.md](doc/26.md) |
| 34 | Sink Dishwasher | [34.md](doc/34.md) |
| 40 | Integrated Ceiling Fan | [40.md](doc/40.md) |
| A1 | Dehumidifier | [A1.md](doc/A1.md) |
| AC | Air Conditioner | [AC.md](doc/AC.md) |
| B0 | Microwave Oven | [B0.md](doc/B0.md) |
| B1 | Electric Oven | [B1.md](doc/B1.md) |
| B3 | Dish Sterilizer | [B3.md](doc/B3.md) |
| B4 | Toaster | [B4.md](doc/B4.md) |
| B6 | Range Hood | [B6.md](doc/B6.md) |
| BF | Microwave Steam Oven | [BF.md](doc/BF.md) |
| C2 | Toilet | [C2.md](doc/C2.md) |
| C3 | Heat Pump Wi-Fi Controller | [C3.md](doc/C3.md) |
| CA | Refrigerator | [CA.md](doc/CA.md) |
| CC | MDV Wi-Fi Controller | [CC.md](doc/CC.md) |
| CD | Heat Pump Water Heater | [CC.md](doc/CD.md) |
| CE | Fresh Air Appliance | [CE.md](doc/CE.md) |
| CF | Heat Pump | [CF.md](doc/CF.md) |
| DA | Top Load Washer | [DA.md](doc/DA.md) |
| DB | Front Load Washer | [DB.md](doc/DB.md) |
| DC | Clothes Dryer | [DC.md](doc/DC.md) |
| E1 | Dishwasher | [E1.md](doc/E1.md) |
| E2 | Electric Water Heater | [E2.md](doc/E2.md) |
| E3 | Gas Water Heater | [E3.md](doc/E3.md) |
| E6 | Gas Stove | [E6.md](doc/E6.md) |
| E8 | Electric Slow Cooker | [E8.md](doc/E8.md) |
| EA | Electric Rice Cooker | [EA.md](doc/EA.md) |
| EC | Electric Pressure Cooker | [EC.md](doc/EC.md) |
| ED | Water Drinking Appliance | [ED.md](doc/ED.md) |
| FA | Fan | [FA.md](doc/FA.md) |
| FB | Electric Heater | [FB.md](doc/FB.md) |
| FC | Air Purifier | [FC.md](doc/FC.md) |
| FD | Humidifier | [FD.md](doc/FD.md) |
## Installation
**Search `Midea LAN` in HACS not available now, it will be ready later**
Please use manual install as below:
Option 1:
1. make sure you have installed HACS to Home Assistant [HACS install guide](https://hacs.xyz/docs/setup/download)
2. open HACS, click [Custom repositories], Repository input: `https://github.com/wuwentao/midea_lan`, Category select [Integration]
3. **Restart Home Assistant**.
Option 2:
1. Download `midea_lan.zip` from [Latest Release](https://github.com/wuwentao/midea_lan/releases/latest)
2. copy `midea_lan.zip` to `/custom_components/midea_lan` in Home Assistant.
3. **Restart Home Assistant**.
Once it done, open `[Settings]`, `[Device & services]`, `[Integrations]`, `[Midea Lan]`, do init config and add all your devices.
## Add device
**_❗Note: First, set a static IP address for your appliance in the router, in case the IP address of the appliance changes after set-up._**
After installation, search and add component `Midea LAN` in Home Assistant integrations page.
Or click [](https://my.home-assistant.io/redirect/config_flow_start?domain=midea_lan)
**_❗Note: During the configuration process, you may be asked to enter your Midea account and password. It's necessary to retrieve appliance information (Token and Key) from Midea cloud server. After all appliances configured, you can remove the Midea account configuration without affecting the use of the appliance._**
After the account is configured, Click 'ADD DEVICE' once more to add new device. You could repeat the above action to add multiple devices.
### Discover automatically
Using this option, the component could auto-discover and list Midea M-Smart appliances in network or specified IP address, select one and add it in.
You can also use an IP address to search within a specified network, such as `192.168.1.255`.
**_❗Note: Discovery automatically requires your appliances and your Home Assistant must be in the same sub-network. Otherwise, devices may not be auto-discovered. Check this by yourself._**
### Configure manually
If you already know following information, you could add the appliance manually.
- Appliance code
- Appliance type (one of [Supported appliances](README.md#supported-appliances))
- IP address
- Port (default 6444)
- Protocol version
- Token
- Key
### List all appliances only
Using this option, you can list all discoverable Midea M-Smart devices on the network, along with their IDs, types, SNs, and other information.
**_❗Note: For certain reasons, not all supported devices may be listed here._**
## Configure
Configure can be found in `Settings -> Devices & Services -> Midea LAN -> Devices -> Configure`.
You can re-set the IP address when device IP changed.
You can also add extra sensor and switch entities or customize your own device.
### IP address
Set the IP address of device. You can reset this when your device IP is changed.
### Refresh interval
Set the interval for actively refreshing the status of a single device (the unit is second) (30 by default and 0 means not refresh actively)
Mostly the status update of Midea devices relies on the active information notification of the device, \
in which condition the status update in HA still works normally even if the refresh interval is set to be "0". \
This component will also actively query the device status at regular intervals, and the default time is 30 seconds. \
Some devices do not have active information notifications when their status changed, so synchronization with the status in HA will be slower. \
If you are very concerned about the synchronization speed of the status, you can try to set a shorter status refresh interval.
**_❗Note: shorter refresh interval may mean more power consumption_**
### Extra sensor and switch entities
After configuration, one of few main entity (e.g. climate entity) may be generated . If you want to make the attributes to extra sensor and switch entities, click `Configure` in `Midea LAN` integration card to choose (if your devices supported).
### Customize
Some types of device have their own configuration items, if your device does not work properly, you may need to customize it. Refer to the device documentation for specific information.
The format of customizations must be JSON.
If multiple customization items need to be configured, the settings must comply with the JSON format.
Example
```json
{ "refresh_interval": 15, "fan_speed": 100 }
```
## Debug
Turn on the debug log out，config in configuration.yaml
```yaml
logger:
default: warn
logs:
custom_components.midea_lan: debug
midealocal: debug
```
we should enable `midea_lan` and `midealocal`