cjay42/midea-ac-py

This is a Home Assistant integration that lets you control Midea air conditioners, and the many other brands Midea manufactures under license, directly over your local network rather than through the internet. Midea makes air conditioning units sold under dozens of other names, including Carrier, Samsung, Toshiba, LG, Comfee, and many more, so a device sold under a completely different brand may still work here if it uses one of a handful of specific companion apps. Only air conditioner type devices are supported, not other kinds of Midea appliances. Control happens locally, so no ongoing internet connection is needed once a device is set up. The one exception is newer devices, referred to as V3 devices, which need to reach Midea's cloud service once, during initial discovery, to obtain a security token and key. After that first setup, the saved token and key are enough, and no further cloud connection is required. Anyone uncomfortable with that step can instead get the token and key themselves using a separate command line tool and their own account. Once connected, the integration automatically figures out which features a given device actually supports and only shows those in Home Assistant, rather than presenting options that would not work. Depending on the device, this can include sleep, eco, boost, and away presets, control of the unit's display, error codes reported as an attribute, energy and power usage sensors, an air purifier toggle, filter alerts, custom fan speeds, humidity sensors and targets, swing angle control, and various other manufacturer specific modes. The project has been translated into more than twenty languages by contributors. Installation is normally done through HACS, a Home Assistant add-on manager, by searching for Midea Smart AC, though it can also be installed manually by copying the integration's folder into Home Assistant's custom components directory and restarting. Setup then happens through the graphical interface, either by letting Home Assistant automatically discover devices on the network or by entering a device's ID, IP address, and, for V3 devices, its token and key by hand. A number of extra options exist per device to fine tune behavior, such as reversing swing direction, adjusting temperature step size, and limiting how long a network connection stays open before reconnecting.