Skip to content

kovapatrik/homebridge-midea-platform

Repository files navigation

Homebridge Verified

homebridge-midea-platform

verified-by-homebridge npm npm

Verified plugin for Midea devices. This is implemented by building on the Homebridge platform plugin template and the work done by @georgezhao2010 in the midea_ac_lan project for Home Assistant. Also thanks to the work done by @mill1000 in the midea-msmart (msmart-ng) project.

Pull requests and/or other offers of development assistance gratefully received.

More information can be found in the wiki.

Features

Currently supports the following devices:

Device ID Docs
Air Conditioner AC link
Dehumidifier A1 link
Front Load Washer DB link
Electric Water Heater E2 link
Gas Water Heater E3 link
Fan FA link

Unsupported Devices

If you have a device not supported by the plugin then useful information will be logged as warnings. If you are interested in developing support for a device please contact the authors by opening an issue. Please attach the lua file to the issue, if possible. Here is the guide on how to download the lua file.

Installation

Option 1: Install via Homebridge Config UI X:

Search for "midea" in homebridge-config-ui-x and install homebridge-midea-platform.

Option 2: Manually Install:

sudo npm install -g homebridge-midea-platform

Midea device status is retrieved over your Local Area Network (LAN) and credentials are obtained from the Midea cloud services over the internet. While the plugin maintains a status cache, use of Homebridge child bridge is strongly encouraged. As noted below in the network resiliency section, this plugin will make multiple attempts to fulfill a request if necessary, which can take time.

Configuration

Homebridge Config UI X

Homebridge Config UI X is the easiest and strongly recommended way to configure this plugin.

You should use the UI to discover and add devices. More information on the settings can be found in the wiki.

License

Copyright (c) 2023 Kovalovszky Patrik,
Copyright (c) 2023 David A. Kerr

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this program except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Trademarks

Apple and HomeKit are registered trademarks of Apple Inc.

Midea is a trademark of Midea Group Co., Ltd.