Skip to content

homebridge-midea-air plugin fork for better compatibility with osk103 modules

License

Notifications You must be signed in to change notification settings

taylorwilsdon/homebridge-midea-air-osk103

 
 

Repository files navigation

Homebridge Midea Air

Downloads Version
verified-by-homebridge Homebridge Discord

Programming is not easy. If you like this plugin or want to contribute to future development, a donation will help.

Homebridge plugin to control Midea Air Conditioner & Dehumidifier units.

 

Requirements

   

Configuration

Add this to the platforms array in your config.json:

{
    "user": "MIDEA_ACCOUNT_EMAIL",
    "password": "MIDEA_PASSWORD",
    "interval": 30,
    "devices": [
            {
                "deviceId": "DeviceID",
                "supportedSwingMode": "Both",
                "temperatureSteps": 1,
                "fanOnlyMode": false,
                "OutdoorTemperature": false
            }
    ],
    "platform": "midea-air"
}

Notes

Using the Midea app and Homebridge Midea Air plugin at the same time causes a login error. Try to use NetHome Plus app instead. This plugin don't support MSmartHome app.

Supported Devices

This Plugin support Midea providers dongle - OSK102 / OSK103 (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, Electra and much more) and should be able to access all device in the user's account. However, many devices may not be supported or function incorrectly. This is due to the lack of documentation of the raw MSmart API. If you encounter any problems, please open a new issue and specify your device model.

Optional per-device Configuration Values

To set specific per-device values, you need to add deviceId that can find in:

  1. Homebridge console log.
  2. HomeKit app, device settings, info.

Temperature Display Units

This Plugin support Celsius & Fahrenheit (Default unit is Celcius). Display Units can set in HomeKit app, device settings.

Temperature Steps

This option change Temperature Steps on HomeKit. You can choose 1˚ or 0.5˚, default is: 1˚

Supported Swing Mode

"None", "Vertical", "Horizontal", "Both". You have to select which type your device supports.

Rotation Speed and Swing

Rotation Speed and Swing mode can set in the HomeKit app, device settings. Rotation Speed values are:

Air Conditioner Dehumidifier
0% Device off 0% Device off
25% Low 30% Silent
50% Middle 60% Medium
75% High 100% High
100% Auto ...

Dehumidifier Relative Humidity

There is a difference between Midea app / Homebridge to HomeKit. HomeKit Relative Humidity work between 0%-100% - Apple Policy.

App / Homebridge HomeKit
35% 0%
40% 10%
45% 20%
50% 30%
55% 40%
60% 50%
65% 60%
70% 70%
75% 80%
80% 90%
85% 100%

Fan Mode

This allows you to enable a Fan mode service.

Outdoor Temperature Sensor

This allows you to enable Outdoor Temperature service, if the AC support.

Credits

This plugin is based on the project ttimpe/homebridge-midea and would not have been possible without the fundamentals that the ioBroker.midea plugin and all of the other Midea API clients in Ruby and Python provided.

About

homebridge-midea-air plugin fork for better compatibility with osk103 modules

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 54.7%
  • TypeScript 45.3%