Skip to content

aurc/melview-mitsubishi-au-nz

Repository files navigation

Homebridge Melview AU/NZ Airconditioners

verified-by-homebridge

npm GitHub release npm

Github CI Github CD Hex.pm

Use this plugin to integrate your Mitsubishi Airconditioner appliances with Apple's HomeKit using Homebridge.

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.

This project is a hobby project and was created to address the need for a stable plugin in AU/NZ to control Mitsubishi Air Conditioners. It was possible due to 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.

Coming Soon

Some capabilities are not yet available and should be released soon:

  • Fan (FAN) mode;
  • Swing;

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.

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.