homebridge-airconditioner-mitsubishi-au-nz
v1.2.6
Published
Control your Mitsubishi Aircon units with Homebridge and Apple HomeKit
Downloads
11
Readme
Homebridge Melview AU/NZ Airconditioners
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.
- Access the settings and configure the credentials as per the required fields.
- Save and restart homebridge.
- 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.