jherden84 / homebridge-mitsubishi-aircon-au-nz

Apache License 2.0
2 stars 2 forks source link

Homebridge Melview AU/NZ Airconditioners - with Zone Support

Use this plugin to integrate your Mitsubishi AirConditioner appliances with Apple's HomeKit using Homebridge. It now also supports zone controls on ducted A/C.

This plugin was folked from AURC plugin to add additonal support as the previous plugin was no longer being updated. https://github.com/aurc/melview-mitsubishi-au-nz/releases

This is my first plugin for homebridge. Please log any issues and I will try to help.

Overview

This plugin allows you to control the basic functionalities of your AC units through the home app and Siri. The features include:

This original project by aurc was created to address the need for a stable plugin in AU/NZ to control Mitsubishi Air Conditioners. https://github.com/aurc/melview-mitsubishi-au-nz/ It would not have been possible without the great reverse engineering effort done by these folks: NovaGL/diy-melview.

Also note that the Homebridge put together excellent developer documentation which made it possible to get up and running quickly (e.g. plugin-temeplate)!

Compatibility & Pre-requisites

It should work with most modern Mitsubishi Electric Airconditioner units that are Wi-Fi capable. This plugin has been developed and tested against the following products: Model Wi-Fi Module
MSZ-GL71VGD MAC-568IF-E
MSZ-GL35VGD MAC-568IF-E
MSZ-AP25VGD MAC-568IF-E

In a nutshell, if you were able to install the Wi-Fi Control App and operate the unit, this plugin is for you!

Netheless to say, you should have Homebridge running.

Known issues

Installation

Through Homebridge Config UI (recommeded)

It's highly recommended that you use the Homebridge Config UI X.

  1. Access the settings and configure the credentials as per the required fields.
  2. Save and restart homebridge.
  3. All units in your network should be automatically recognised. Open your Home App and allocate them to their respective rooms.
  4. To detect and add Zone fucntionality select in the Plugin Config.

Through CLI

You can install the package manually by issuing:

npm install -g homebridge-airconditioner-mitsubishi-au-nz

and configuring the plugin file config.json as:

{
    "bridge": {
        //...
    },
    "accessories": [],
    "platforms": [
        {
            "user": "user@domain.com",
            "password": "yourpassword",
            "platform": "MitsubishiAUNZ"
        }
    ]
}

where user is your user name, typically the email you used to register with the app and password is your account password.

Questions & Issues

If you have issues, found a bug or have a question, please open an issue here.