Git Product home page Git Product logo

midea_ac_py's Introduction

Home Assistant Custom Integration for Midea Group(Hualing, Senville, Klimaire, AirCon, Century, Pridiom, Thermocore, Comfee, Alpine Home Air, Artel, Beko, Electrolux, Galactic, Idea, Inventor, Kaisai, Mitsui, Mr. Cool, Neoclima, Olimpia Splendid, Pioneer, QLIMA, Royal Clima, Qzen, Toshiba, Carrier, Goodman, Friedrich, Samsung, Kenmore, Trane, Lennox, LG and much more) Air Conditioners via LAN.

Tested with Home Assistant 2023.10.1.

Attention!!!

Version >= 0.1.27, The ENTITY ID of the climate devices has been changed. if you have any problem with an old entity being "unavailable", you should check whats the new ID name of the entity and change it in lovlace.

Installation

Install from HACS

Type hacs_badge

Search the HACS Store for midea_ac

Install manually

  1. Clone this repo
  2. Place the custom_components/midea_ac folder into your custom_components folder

Configuration

Configuration variables:

key description example
platform (Required) The platform name. midea_ac
host (Required) Midea AC Device's IP Address. 192.168.1.100
id (Required) Midea AC Device's applianceId. 123456789012345
token (Optional) Midea AC Device's token, V3 is required. ACEDDA53831AE5DC...(Length 128)
k1 (Optional) Midea AC Device's k1, V3 is required. CFFA10FC...(Length 64)
temp_step (Optional) Step size for temperature set point, default is 1.0 0.5
prompt_tone (Optional) Prompt Tone, default is true. false
keep_last_known_online_state (Optional) Set this to true if you see too many unavailable in log. true
use_fan_only_workaround (Optional) Set this to true if you need to turn off device updates because they turn device on and to fan_only true

Example configuration.yaml:

climate:
  - platform: midea_ac
    host: 192.168.1.100
    id: 123456789012345
    # v3 need token and k1(key)
    # token: ACEDDA53831AE5DC...(Length 128)
    # k1: CFFA10FC...(Length 64)

How to Get Configuration variables:

  • midea-discover can help you discover Midea devices from the LAN.
      pip3 install msmart
      midea-discover
    • Basic Usage
    Usage: midea-discover [OPTIONS]
    
      Discover Midea Deivces and Get Device's info
    
    Options:
      -d, --debug           Enable debug logging
      -c, --amount INTEGER  Number of broadcast packets, default is 1.
                            if you have many devices, you may change this value.
      -a, --account TEXT    Your email address for your Midea account.
      -p, --password TEXT   Your password for your Midea account.
      -i, --ip TEXT         IP address of Midea device. you can use:
                            - broadcasts don't work.
                            - just get one device's info.
                            - an error occurred.
      --help                Show this message and exit.
    
    Note:
    • This component only supports devices with model 0xac (air conditioner) and words supported in the output.
    • Configure v3 devices need token and k1.
    • You midea-discover when broadcasts don't work.
    • midea-discover use a registered account of MSmartHome [AppStore] [GooglePlay] to get Token and K1(key). it's my account, but now it’s an open account. If you just only get Token and K1(key) with this account, I and others can't get your information through this account. Don't use this account to login to the APP and add device, this may reveal your information. Of course, you can use your own account,this is also the way I recommend.
      midea-discover -a YOUR_ACCOUNT -p YOUR_PASSWORD

Buy me a cup of coffee

Your donation will make me work better for this project.

midea_ac_py's People

Contributors

alexanderliberty avatar

Watchers

 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.