Homebridge-melcloud-control NPM

Homebridge MELCloud Control

Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation Lossnay, manufactured by Mistsubishi and connected to MELCloud.

Package Requirements

Package	Installation	Role	Required
Homebridge	Homebridge Wiki	HomeKit Bridge	Required
Config UI X	Config UI X Wiki	Homebridge Web User Interface	Recommended
MELCloud	Plug-In Wiki	Homebridge Plug-In	Required

All devices are detected automatically.
Support multiple MELCloud accounts, buildings, flors, areas.
Support temperature display units Celsius/Fahrenheit.
Support control device Presets.
Support direct device controll creating extra Buttons, appiled for all devices of same type in account.
Support identify all states of device creating Sensors, appiled for all devices of same type in account.
Support automations, shortcuts and siri.
RESTful server:
- Request: http//homebridge_ip_address:port/path.
- Port: last 4 numbers of device Id, displayed in HB log during start.
- Path: info, state.
- Respone as JSON data.
MQTT client:
- Topic: Info, State.
- Publish as JSON data.

Air Conditioner:
- Heater Cooler:
  - Power ON/OFF.
  - Operating mode AUTO/HEAT/COOL/POWER OFF.
  - Temperature HEATING/COOLING.
  - Fan speed OFF/1/2/3/4/5/AUTO.
  - Swing mode AUTO/SWING.
  - Physical lock controls LOCK/UNLOCK.
  - Temperature display unit °F/°C.
  - If AUTO/HEAT or both modes are not supported by device will use DRY/FAN or FAN/DRY modes instead.
- Thermostat:
  - Power ON/OFF.
  - Operating mode POWER OFF/HEAT/COOL/AUTO.
  - Temperature HEATING/COOLING.
  - Temperature display unit °F/°C.
  - If AUTO/HEAT or both modes are not supported by device will use DRY/FAN or FAN/DRY modes instead.
- Buttons:
  - For direct device control.
    - Power ON/OFF.
    - Operating mode HEAT/DRY/COOL/FAN/AUTO.
    - Physical lock controls LOCK/UNLOCK.
    - Vane H mode AUTO/1/2/3/4/5/SWING.
    - Vane V mode AUTO/1/2/3/4/5/SWING.
    - Fan speed mode AUTO/1/2/3/4/5.
    - Presets SET/UNSET.
- Sensors:
  - For automation and notifications.
    - Power ON/OFF.
    - Operating mode HEAT/DRY/COOL/FAN/AUTO.
    - Physical lock controls LOCK/UNLOCK.
    - Vane H mode AUTO/1/2/3/4/5/SWING.
    - Vane V mode AUTO/1/2/3/4/5/SWING.
    - Fan speed mode AUTO/1/2/3/4/5/.
    - Temperature change for HEATER/COOLER.
    - Device presets.
Heat Pump:
- Heater Cooler:
  - Heat Pump:
    - Power ON/OFF.
    - Operating mode HEAT/COOL.
    - Outdoor temperature GET.
    - Physical lock controls all Zones and Hot Water Tank LOCK/UNLOCK.
    - Temperature display unit °F/°C.
  - Zone 1 and 2:
    - Operating mode heat AUTO/HEAT/COOL - CURVE/HEAT THERMOSTAT/HEAT FLOW.
    - Operating mode cool HEAT/COOL - COOL THERMOSTAT/COOL FLOW.
    - Temperature HEATING/COOLING.
    - Physical lock controls LOCK/UNLOCK.
  - Hot Water Tank:
    - Operating mode AUTO/HEAT - AUTO/HEAT NOW.
    - Temperature SET/GET.
    - Physical lock controls LOCK/UNLOCK.
- Thermostat:
  - Heat Pump:
    - Power ON/OFF.
    - Operating mode HEAT/COOL.
    - Outdoor temperature GET.
    - Temperature display unit °F/°C.
  - Zone 1 and 2:
    - Operating mode heat HEAT/COOL/AUTO - HEAT THERMOSTAT/HEAT FLOW/CURVE.
    - Operating mode cool HEAT/COOL - COOL THERMOSTAT/COOL FLOW.
    - Temperature HEATING/COOLING.
  - Hot Water Tank:
    - Operating mode HEAT/AUTO - HEAT NOW, AUTO.
    - Temperature SET/GET.
- Buttons:
  - For direct device control.
    - Power ON/OFF.
    - Operating mode HEAT/COOL/CURVE/HOLIDAY/AUTO HOT WATER/ECO HOT WATER/FORCE HOT WATER.
    - Physical lock controls LOCK/UNLOCK.
    - Presets SET/UNSET.
- Sensors:
  - For automation and notifications.
    - Power ON/OFF.
    - Operating mode HEAT/COOL/CURVE/HOLIDAY/AUTO HOT WATER/ECO HOT WATER/FORCE HOT WATER.
    - Physical lock controls LOCK/UNLOCK.
    - Temperature change for HEATER/COOLER.
    - Device presets.
Energy Recovery Ventilation Lossnay:
- Heater Cooler:
  - Power ON/OFF.
  - Operating mode AUTO/HEAT/COOL/POWER OFF - AUTO, LOSSNAY, BYPAS, POWER OFF.
  - Fan speed OFF/1/2/3/4/AUTO.
  - Temperature display unit °F/°C.
- Thermostat:
  - Power ON/OFF.
  - Operating mode POWER OFF/HEAT/COOL/AUTO - POWER OFF, LOSSNAY, BYPAS, AUTO.
  - Temperature display unit °F/°C.
- Buttons:
  - For direct device control.
    - Power ON/OFF.
    - Operating mode LOSSNAY/BYPAS/AUTO/NIGHT PURGE.
    - Fan speed mode AUTO/1/2/3/4.
    - Presets SET/UNSET.
- Sensors:
  - For automation and notifications.
    - Power ON/OFF.
    - Operating mode LOSSNAY/BYPAS/AUTO/NIGHT PURGE.
    - Fan speed mode AUTO/1/2/3/4.
    - Temperature change for HEATER/COOLER.
    - Device presets.
    - Core maintenance.
    - Filter maintenance.
    - CO2 detected and level.
    - PM2.5 air quality and level.

Run this plugin as a Child Bridge (Highly Recommended), this prevent crash Homebridge if plugin crashes.
Install and use Homebridge Config UI X to configure this plugin (Highly Recommended).
The sample-config.json can be edited and used as an alternative.
Be sure to always make a backup copy of your config.json file before making any changes to it.

Key	Description
`name`	Here set the own account name.
`user`	Here set the MELCloud username.
`passwd`	Here set the MELCloud password.
`language`	Here select the MELCloud language.
`ataDisplayMode`	Here select main control mode `Heater/Cooler`, `Thermostat`.
`ataTemperatureSensor`	This enable extra temperature sensor for Heater/Cooler control mode to use with automations in HomeKit app.
`ataDisableAutoMode`	This will disable `Auto` mode even this mode is supported by device.
`ataDisableHeatMode`	This will disable `Heat` mode even this mode is supported by device.
`ataAutoHeatMode`	Here select operation mode for `Auto/Heat`, if `Auto`, `Heat` or both modes are not supported by device will be used selected modes instead.
`ataPresets`	This enable display Air Conditioner presets in HomeKit app.
`ataButtons.name`	Here set `Button Name` which You want expose to the `Homebridge/HomeKit`.
`ataButtons.mode`	Here select button mode, VH - Vane Horizontal, VV - Vane Horizontal.
`ataButtons.displayType`	Here select display type in HomeKit app, possible `None/Disabled`, `Outlet`, `Switch`, `Motion Sensor`, `Occupancy Sensor`, `Contact Sensor`.
`atwDisplayMode`	Here select main control mode `Heater/Cooler`, `Thermostat`.
`atwTemperatureSensor`	This enable extra temperature sensor for Heater/Cooler control mode to use with automations in HomeKit app.
`atwPresets`	This enable display Heat Pump presets in HomeKit app.
`atwButtons.name`	Here set `Button Name` which You want expose to the `Homebridge/HomeKit`.
`atwButtons.mode`	Here select button mode.
`atwButtons.displayType`	Here select display type in HomeKit app, possible `None/Disabled`, `Outlet`, `Switch`, `Motion Sensor`, `Occupancy Sensor`, `Contact Sensor`.
`ervDisplayMode`	Here select main control mode `Heater/Cooler`, `Thermostat`.
`ervTemperatureSensor`	This enable extra temperature sensor for Heater/Cooler control mode to use with automations in HomeKit app.
`ervPresets`	This enable display EnergyRecovery Ventilation presets in HomeKit app.
`ervButtons.name`	Here set `Button Name` which You want expose to the `Homebridge/HomeKit`.
`ervButtons.mode`	Here select button mode.
`ervButtons.displayType`	Here select display type in HomeKit app, possible `None/Disabled`, `Outlet`, `Switch`, `Motion Sensor`, `Occupancy Sensor`, `Contact Sensor`.
`enableDebugMode`	This enable deep log in homebridge console.
`disableLogInfo`	This disable display log values and states on every it change.
`disableLogDeviceInfo`	This disable display log device info on plugin start.
`enableRestFul`	If enabled, RESTful server will start automatically and respond to any path request.
`restFulDebug`	If enabled, deep log will be present in homebridge console for RESTFul server.
`enableMqtt`	This enabled MQTT Broker and publish to it all awailable data.
`mqttDebug`	This enabled deep log in homebridge console for MQTT.
`mqttHost`	Here set the `IP Address` or `Hostname` for MQTT Broker.
`mqttPort`	Here set the `Port` for MQTT Broker, default 1883.
`mqttCientId`	Here optinal set the `Client Id` for MQTT broker or leave empty.
`mqttPrefix`	Here set the `Prefix` for `Topic` or leave empty.
`mqttAuth`	This enabled MQTT Broker authorization credentials.
`mqttUser`	Here set the MQTT Broker user.
`mqttPasswd`	Here set the MQTT Broker password.
`Display Type Buttons`	-1 - `None/Disabled`, 0 - `Outlet`, 1 - `Switch`, 2 - `Motion Sensor`, 3 - `Occupancy Sensor`, 4 - `Contact Sensor`.

8 months ago

7 months ago

7 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

11 months ago

11 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

10 months ago

10 months ago

10 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

10 months ago

10 months ago

11 months ago

10 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

Homebridge MELCloud Control

Package Requirements

About The Plugin

Control Mode

Configuration