homebridge-mitsubishi-aircon-au-nz v1.0.3

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:

• Instant unit response - update the unit directly via LAN interface & cloud Melview.
• Automatically find all appliances linked to your account;
• Control power ON/OFF
• Set mode AUTO, HEAT, COOL
• Dehumidifier (DRY): Experimental, disabled by default, use with caution as this feature is not extensively tested.
• Set desired temperature
• Obtain unit status, e.g. power, mode, room temperature and desired temperature. NEW
• Allows control of Zones in ducted Mitsubishi Units. Each Zone will be exposed as a seperate fan accessory in HomeKit.

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

• Dry mode: Does not control fan speed.
• LAN access: Still requires internet connection, as it authenticates the requests with Melview cloud. It still operates way faster than Alexa and Goolge home integration as it has a fast follower command locally removing the know lag.

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.