GithubHelp home page GithubHelp logo

sibest19 / midea_ac_lan Goto Github PK

View Code? Open in Web Editor NEW

This project forked from georgezhao2010/midea_ac_lan

0.0 0.0 0.0 1.23 MB

Auto-configure and then control your Midea M-Smart devices (Air conditioner, Fan, Water heater, Washer, etc) via local area network.

License: MIT License

Python 100.00%

midea_ac_lan's Introduction

Midea AC LAN

hacs_badge Donate Stable

English | 简体中文

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.

This component inspired from the repository at @mac-zhou which provides similar functionality for Midea air conditioners. This component include verbatim or adapted portions of the code from his great projects.

Thanks also to @NeoAcheron.

⭐If this component is helpful for you, please star it, it encourages me a lot.

❗Note: Home Assistant 2022.5 or higher required for this integration

Supported brands

ariston beverly bugu carrier colmo comfee electrolux invertor littleswan midea netsu ProBreeze rotenso toshiba vandelo wahin

And more.

Supported appliances

Type Name Documents
13 Light 13.md
26 Bathroom Master 26.md
34 Sink Dishwasher 34.md
40 Integrated Ceiling Fan 40.md
A1 Dehumidifier A1.md
AC Air Conditioner AC.md
B0 Microwave Oven B0.md
B1 Electric Oven B1.md
B3 Dish Sterilizer B3.md
B4 Toaster B4.md
B6 Range Hood B6.md
BF Microwave Steam Oven BF.md
C2 Toilet C2.md
C3 Heat Pump Wi-Fi Controller C3.md
CA Refrigerator CA.md
CC MDV Wi-Fi Controller CC.md
CD Heat Pump Water Heater CC.md
CE Fresh Air Appliance CE.md
CF Heat Pump CF.md
DA Top Load Washer DA.md
DB Front Load Washer DB.md
DC Clothes Dryer DC.md
E1 Dishwasher E1.md
E2 Electric Water Heater E2.md
E3 Gas Water Heater E3.md
E6 Gas Stove E6.md
E8 Electric Slow Cooker E8.md
EA Electric Rice Cooker EA.md
EC Electric Pressure Cooker EC.md
ED Water Drinking Appliance ED.md
FA Fan FA.md
FB Electric Heater FB.md
FC Air Purifier FC.md
FD Humidifier FD.md

Installation

Search 'Midea AC LAN' in HACS and install, or copy all files in custom_components/midea_ac_lan from Latest Release to your /custom_components/midea_ac_lan in Home Assistant manually.

Restart Home Assistant.

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 AC LAN in Home Assistant integrations page.

Or click Configuration

❗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)
  • 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 AC 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 AC 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

{"refresh_interval": 15, "fan_speed":  100}

Debug

Turn on the debug log out,config in configuration.yaml

logger:
  default: warn
  logs:
    custom_components.midea_ac_lan: debug

Support my works

If you like this integration, why do not you support my works by buying me a coffee?

Buy me a coffee

midea_ac_lan's People

Contributors

georgezhao2010 avatar mattedbroadsky avatar olarodes avatar ettingshausen avatar wasilukm avatar 24mu13 avatar misa1515 avatar bokeylee avatar doudou14 avatar rokam avatar dedepete avatar imgbotapp avatar samjongenelen avatar sibest19 avatar v1k70rk4 avatar yingying77 avatar msmarks avatar micturkey avatar drthanwho avatar wrt54g avatar pengfei00 avatar lgtm-migrator avatar szt0idw avatar jdvmanen avatar oopp1800 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.