Homebridge Plugin for LAN Control of Mitsubishi Heavy Industries MH-AC-WIFI-1

This Homebridge plugin allows Mitsubishi Heavy Industries AirCon using the Intesis MH-AC-WIFI-1 controller to be accessible in Apple HomeKit. It creates a platform device that allows aircons to be configured via the Homebridge Config UI or manually in the Homebridge config.json file.

The plugin creates the following Homekit accessories:

• HeaterCooler - HEAT, COOL, and AUTO modes, fan speed, and swing, and remote control lock
• Dehumidifier - DRY mode, fan speed, and swing
• Fan - FAN mode, fan speed, and swing
• Temperature - Optional outdoor temperature sensor accessory on the compressor (if available)

Installing

For instructions on installing Homebridge look here.

The plugin may be installed via the Homebridge Config UI or via npm.

To install under the Homebridge UI, click on "Plugins" and search for "mhacwifi1-lan". Click on the "INSTALL" link for "Homebridge Mhacwifi1 Lan".

If you are not using the Homebridge UI, install with npm install homebridge-mhacwifi1-lan.

Configuration

The easiest approach to configuration is to use the web-based Homebridge UI. If you aren't using the web-based UI, use the following sections to configure the plugin.

Required

The only required configuration for this plugin are the username, password, and IP address of the unit. Adding the following json configuration to the platforms area:

{
    ...
    "platforms": [
        {
            "platform": "MH-AC-WIFI-1",
            "name": "My Aircon",
            "host": "192.168.1.100",
            "username": "admin",
            "password": "admin",
        }
    ]
}

Optional

Additional devices may be added as new platforms. If you need to customise the username or password per device, you can add these values . Additionally, you can disable the outdoor temperature sensor by setting outdoorTemperature to false.

{
    ...
    "platforms": [
        {
            "platform": "MH-AC-WIFI-1",
            "name": "Lounge",
            "host": "192.168.1.100",
            "username": "admin-1",
            "password": "password-1",
            "outdoorTemperature": true
        },
        {
            "platform": "MH-AC-WIFI-1",
            "name": "Bedroom",
            "host": "192.168.1.101",
            "username": "admin-2",
            "password": "password-2",
            "outdoorTemperature": false
        }
    ]
}

All config options

| Config | Description | Default | | ------ | ----------- | ------- | | name | Name you want to identify the aircon by | required | | host | IP address or hostname of the device | required | | username | Login name | admin | | password | Login password | admin| | outdoorTemperature | Enables outdoor temperature sensor | true | | minSetpoint | Minimum allowed temperature | 18 | | maxSetpoint | Maximum allowed temperature | 30 | | slowThreshold | Number of milliseonds before logging slow require | 500 | | syncPeriod | Number of milliseconds between sensor value polling requests | 1000 |

Known Issues

From testing the MH-AC-WIFI-1 controller can be slow to respond to commands. This appears to be normal. To mitigate frequently queries, the plugin is designed to regularly poll all sensors every syncPeriod milliseconds. The update interval is set to 1000 milliseconds by default. You can get increase/decrease slow request logging by changing the slowThrehold value. It is not recommended to sync faster than 1000 milliseconds.

TODO

• Device discovery tools

License

This project is licensed under the Apache v2 License - see the LICENSE.md file for details.

Acknowledgments

• Other existing plugin implementations for MH-AC-WIFI-1
  • https://github.com/LarsenDX/homebridge-mhacwifi1-v2
  • https://github.com/Rickth64/homebridge-mhacwifi1