Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

homebridge-melcloud-control

grzegorz9145.3kMIT3.7.7

Homebridge plugin to control Mitsubishi Air Conditioner, Heat Pump and Energy Recovery Ventilation.

homebridge, homebridge-plugin, homekit, mitsubishi, melcloud, ecodan, zubadan, lossnay, vrf, mqtt, restful

readme

Homebridge MELCloud Control

verified-by-homebridge npm npm npm GitHub pull requests GitHub issues

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 v2.0 Homebridge Wiki HomeKit Bridge Required ab v3.0.0
Config UI X Config UI X Wiki Homebridge Web User Interface Required ab v3.0.0
MELCloud Plug-In Wiki Homebridge Plug-In Required

About The Plugin

  • All devices are detected automatically.
  • Control devices over MELCloud server.
  • Support multiple accounts, buildings, floors, areas.
  • Support temperature display units Celsius/Fahrenheit.
  • Support assing inividual operating mode for Heat/Cool/Auto.
  • Support direct Presets control using extra Buttons, switch it to OFF restore previous device state.
  • Support direct Functions control using extra Buttons, switch it to OFF restore previous device state.
  • Support detect all device states using extra Sensors.
  • Support automations, shortcuts and Siri.
  • Support external integrations, RESTFul, MQTT.
  • Control devices over local network You need use ESP module and Tasmota Control plugin.

Control Mode

  • Air Conditioner:
    • Heater Cooler:
      • Power ON/OFF.
      • Operating mode AUTO/HEAT/COOL/POWER OFF.
      • Temperature HEATING/COOLING/AUTO.
      • Fan speed OFF/1/2/3/4/5/AUTO.
      • Swing mode AUTO/SWING.
      • Physical lock controls LOCK/UNLOCK.
      • Temperature display unit °F/°C.
    • Thermostat:
      • Power ON/OFF.
      • Operating mode POWER OFF/HEAT/COOL/AUTO.
      • Temperature HEATING/COOLING/AUTO.
      • Temperature display unit °F/°C.
      • Assign operating mode for HEAT/AUTO
    • 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/SPLIT/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/SPLIT/SWING.
        • Vane V mode AUTO/1/2/3/4/5/SWING.
        • Fan speed mode AUTO/1/2/3/4/5/.
        • Presets ACTIV/UNACTIV.
        • Room temperature.
        • Outdoor temperature.
  • 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.
        • Presets ACTIV/UNACTIV.
        • Outdoor temperature.
        • Zone 1 temperature.
        • Zone 2 temperature.
        • Water tank temperature.
        • Flow Temperature Zone 1, 2, Hot Water.
        • Return Temperature Zone 1, 2, Hot Water.
  • Energy Recovery Ventilation Lossnay:
    • Heater Cooler:
      • Power ON/OFF.
      • Operating mode AUTO/HEAT/COOL/POWER OFF - AUTO, LOSSNAY, BYPASS, 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, BYPASS, AUTO.
      • Temperature display unit °F/°C.
    • Buttons:
      • For direct device control.
        • Power ON/OFF.
        • Operating mode LOSSNAY/BYPASS/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/BYPASS/AUTO/NIGHT PURGE.
        • Fan speed mode AUTO/1/2/3/4.
        • Presets ACTIV/UNACTIV.
        • Room temperature.
        • Outdoor temperature.
        • Supply temperature.
        • Core maintenance.
        • Filter maintenance.
        • CO2 detected and level.
        • PM2.5 air quality and level.

HOME app current device mode display

  • In AUTO mode, the tile display current state based on current mode:
  • In HEATING mode, th tile display current state as HEATING - orange
  • In COOLING mode, the tile display current state as COOLING - blue
  • In DRY mode, the tile display current state as IDLE - black
  • In FAN mode, the tile display current state as IDLE - black
  • In IDLE mode, the tile display current state as IDLE - black
  • In INACTIVE mode, the tile display current state as INACTIVE - transparent

AUTO Mode

  • Heather/Cooler
    • In this mode we can set heathing threshold and cooling threshold temperature:
    • Target temperature is calculated as a middle value between LO and HI and the rest is calculated internally.
  • Thermostat
    • In this mode we can set only target temperature:
    • Target temperature issend to device and calculated internally:
  • Calculation method in device internally:
    • If the room temperature < Heating Setpoint, the unit will be set to HEAT with a setpoint of 23°C.
    • In HEAT, if the room temperature > Heating Setpoint + 1°C, the unit will be set to FAN.
    • In FAN, if the room temperature > Cooling Setpoint, the unit will be set to COOL with a setpoint of 19°C.
    • In COOL, if the room temperature < Cooling Setpoint - 1°C, the unit will be set to FAN.
    • In FAN, if the room temperature < Heating Setpoint, the unit will be set to HEAT with a setpoint of 23°C.
  • The image shows Heating Setpoint of 19°C and a Cooling Setpoint of 23°C.

Configuration

  • 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, required for version v3 and above.
  • The sample-config.json can be edited and used as an alternative.

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.
ataDevices Array of ATA devices created automatically after login to MELCloud from plugin config UI.
ataDevices.id Read only data, do not change it.
ataDevices.type Read only data, do not change it.
ataDevices.typeString Read only data, do not change it.
ataDevices.name Here You can schange the Accessory Name which is exposed to the Homebridge/HomeKit.
ataDevices.displayMode Here select device control mode None/Disabled, Heater/Cooler, Thermostat.
ataDevices.heatDryFanMode Here select the operatiing mode for Heat, if this mode is not supported, it will be disabled.
ataDevices.coolDryFanMode Here select the operatiing mode for Cool, if this mode is not supported, it will be disabled.
ataDevices.autoDryFanMode Here select the operatiing mode for Auto, if this mode is not supported, it will be disabled..
ataDevices.temperatureSensor This enable extra Room temperature sensors to use with automations in HomeKit app.
ataDevices.temperatureSensorOutdoor This enable extra Outdoor temperature sensors to use with automations in HomeKit app.
ataDevices.refreshInterval Here set the background devices state refresh time in (sec), default 5s.
ataDevices.presets Array of ATA device Presets created automatically after login to MELCloud from plugin config UI.
ataDevices.presets.id Read only data, do not change it.
ataDevices.presets.name Here You can schange the Preset Name which is exposed to the Homebridge/HomeKit.
ataDevices.presets.displayType Here select display type in HomeKit, 0 - None/Disabled, 1 - Outlet, 2 - Switch, 3 - Motion Sensor, 4 - Occupancy Sensor, 5 - Contact Sensor.
buttonsSensors Array of buttons sensors.
buttonsSensors.name Here set Button Name which You want expose to the Homebridge/HomeKit.
buttonsSensors.mode Here select button mode, VH - Vane Horizontal, VV - Vane Horizontal.
buttonsSensors.displayType Here select display type in HomeKit, 0 - None/Disabled, 1 - Outlet, 2 - Switch, 3 - Motion Sensor, 4 - Occupancy Sensor, 5 - Contact Sensor.
buttonsSensors.namePrefix Here enable/disable the accessory name as a prefix for button/sensor name.
atwDevices Array of ATA devices created automatically after login to MELCloud from plugin config UI.
atwDevices.id Read only data, do not change it.
atwDevices.type Read only data, do not change it.
atwDevices.typeString Read only data, do not change it.
atwDevices.name Here You can schange the Accessory Name which is exposed to the Homebridge/HomeKit.
atwDevices.displayMode Here select main control mode None/Disabled, Heater/Cooler, Thermostat.
atwDevices.temperatureSensor This enable extra Room temperature sensors to use with automations in HomeKit app.
atwDevices.temperatureSensorFlow This enable extra Flow temperature sensors to use with automations in HomeKit app.
atwDevices.temperatureSensorReturn This enable extra Return temperature sensors to use with automations in HomeKit app.
atwDevices.temperatureSensorFlowZone1 This enable extra Flow Zone 1 temperature sensors to use with automations in HomeKit app.
atwDevices.temperatureSensorReturnZone1 This enable extra Return Zone 1 temperature sensors to use with automations in HomeKit app.
atwDevices.temperatureSensorFlowWaterTank This enable extra Flow Water Tank temperature sensors to use with automations in HomeKit app.
atwDevices.temperatureSensorReturnWaterTank This enable extra Return Water Tank temperature sensors to use with automations in HomeKit app.
atwDevices.temperatureSensorFlowZone2 This enable extra Flow Zone 2 temperature sensors to use with automations in HomeKit app.
atwDevices.temperatureSensorReturnZone2 This enable extra Return Zone 2 temperature sensors to use with automations in HomeKit app.
atwDevices.refreshInterval Here set the background devices state refresh time in (sec), default 5s.
atwDevices.presets Array of ATA device Presets created automatically after login to MELCloud from plugin config UI.
atwDevices.presets.id Read only data, do not change it.
atwDevices.presets.name Here You can schange the Preset Name which is exposed to the Homebridge/HomeKit.
atwDevices.presets.displayType Here select display type in HomeKit, 0 - None/Disabled, 1 - Outlet, 2 - Switch, 3 - Motion Sensor, 4 - Occupancy Sensor, 5 - Contact Sensor.
buttonsSensors Array of buttons sensors.
buttonsSensors.name Here set Button Name which You want expose to the Homebridge/HomeKit.
buttonsSensors.mode Here select button mode.
buttonsSensors.displayType Here select display type in HomeKit, 0 - None/Disabled, 1 - Outlet, 2 - Switch, 3 - Motion Sensor, 4 - Occupancy Sensor, 5 - Contact Sensor.
buttonsSensors.namePrefix Here enable/disable the accessory name as a prefix for button/sensor name.
ervDevices Array of ATA devices created automatically after login to MELCloud from plugin config UI.
ervDevices.id Read only data, do not change it.
ervDevices.type Read only data, do not change it.
ervDevices.typeString Read only data, do not change it.
ervDevices.name Here You can schange the Accessory Name which is exposed to the Homebridge/HomeKit.
ervDevices.displayMode Here select main control mode None/Disabled, Heater/Cooler, Thermostat.
ervDevices.temperatureSensor This enable extra Room temperature sensors to use with automations in HomeKit app.
ervDevices.temperatureSensorOutdoor This enable extra Outdoor temperature sensors to use with automations in HomeKit app.
ervDevices.temperatureSensorSupply This enable extra Supply temperature sensors to use with automations in HomeKit app.
ervDevices.refreshInterval Here set the background devices state refresh time in (sec), default 5s.
ervDevices.presets Array of ATA device Presets created automatically after login to MELCloud from plugin config UI.
ervDevices.presets.id Read only data, do not change it.
ervDevices.presets.name Here You can schange the Preset Name which is exposed to the Homebridge/HomeKit.
ervDevices.presets.displayType Here select display type in HomeKit, 0 - None/Disabled, 1 - Outlet, 2 - Switch, 3 - Motion Sensor, 4 - Occupancy Sensor, 5 - Contact Sensor.
buttonsSensors Array of buttons sensors.
buttonsSensors.name Here set Button Name which You want expose to the Homebridge/HomeKit.
buttonsSensors.mode Here select button mode.
buttonsSensors.displayType Here select display type in HomeKit, 0 - None/Disabled, 1 - Outlet, 2 - Switch, 3 - Motion Sensor, 4 - Occupancy Sensor, 5 - Contact Sensor.
buttonsSensors.namePrefix Here enable/disable the accessory name as a prefix for button/sensor name.
refreshInterval Here set the background account data refresh time in (sec), default 120s.
disableLogDeviceInfo If enabled, add ability to disable log device info by every connections device to the network.
disableLogInfo If enabled, disable log info, all values and state will not be displayed in Homebridge log console.
disableLogSuccess If enabled, disable logging device success.
disableLogWarn If enabled, disable logging device warnings.
disableLogError If enabled, disable logging device error.
enableDebugMode If enabled, deep log will be present in homebridge console.
restFul This is RSTful server.
restFul.enable If enabled, RESTful server will start automatically and respond to any path request.
restFul.debug If enabled, deep log will be present in homebridge console for RESTFul server.
mqtt This is MQTT Broker.
mqtt.enable If enabled, MQTT Broker will start automatically and publish all awailable PV data.
mqtt.host Here set the IP Address or Hostname for MQTT Broker.
mqtt.port Here set the Port for MQTT Broker, default 1883.
mqtt.clientId Here optional set the Client Id of MQTT Broker.
mqtt.prefix Here set the Prefix for Topic or leave empty.
mqtt.auth If enabled, MQTT Broker will use authorization credentials.
mqtt.user Here set the MQTT Broker user.
mqtt.passwd Here set the MQTT Broker password.
mqtt.debug If enabled, deep log will be present in homebridge console for MQTT.

RESTful Integration

  • Port: last 4 numbers of device Id, displayed in HB log during start.
  • POST data as a JSON Object {OperationMode: 8}.
  • Header content type must be application/json.
Method URL Path Response Type
GET http//ip:port Info, State {"Power": true, "SetTemperature": 21.5} JSON object.
Method URL Key Value Type Description
Air Conditioner | |
POST http//ip:port Power true, false boolean Power state.
| http//ip:port HideVaneControls true, false boolean Hide vane controls.
| http//ip:port HideDryModeControl true, false boolean Hide dry mode control.
| http//ip:port ProhibitSetTemperature true, false boolean Lock set temperature.
| http//ip:port ProhibitOperationMode true, false boolean Lock set operating mode.
| http//ip:port ProhibitPower true, false boolean Lock set power.
| http//ip:port OperationMode 1 - Heat, 2 - Dry, 3 - Cool, 7 - Fan, 8 - Auto integer Operating mode.
| http//ip:port FanSpeed 0 - Auto, 1, 2, 3, 4, 5, 6 integer Fan speed.
| http//ip:port VaneHorizontalDirection 0, 1, 2, 3, 4, 5, 8 - Split, 12 - Swing integer Vane H mode.
| http//ip:port VaneVerticalDirection 0, 1, 2, 3, 4, 5, 7 - Swing integer Vane V mode.
| http//ip:port SetTemperature 0.0 float Room temperature.
| http//ip:port DefaultCoolingSetTemperature 0.0 float Default cooling temperature.
| http//ip:port DefaultHeatingSetTemperature 0.0 float Default heating temperature.
Heat Pump | |
POST http//ip:port Power true, false boolean Power state.
| http//ip:port ForcedHotWaterMode true, false boolean Force hot water.
| http//ip:port EcoHotWater true, false boolean Eco hot water.
| http//ip:port HolidayMode true, false boolean Holiday mode.
| http//ip:port ProhibitZone1 true, false boolean Lock control zone 1.
| http//ip:port ProhibitZone2 true, false boolean Lock control zone 2.
| http//ip:port ProhibitHotWater true, false boolean Lock control hot water.
| http//ip:port OperationMode 0 - Auto, 1 - Heat, 2 - Cool integer Operating mode heat pump.
| http//ip:port OperationModeZone1 0 - Heat Thermostat, 1 - Heat Flow, 2 - Heat Curve, 3 - Cool Thermostat, 4 - Cool Flow, 5 - Flor Dry Up integer Operating mode zone 1.
| http//ip:port OperationModeZone2 0 - Heat Thermostat, 1 - Heat Flow, 2 - Heat Curve, 3 - Cool Thermostat, 4 - Cool Flow, 5 - Flor Dry Up integer Operating mode zone 2.
| http//ip:port SetTemperatureZone1 0.0 float Temperature zone 1.
| http//ip:port SetTemperatureZone2 0.0 float Temperature zone 2.
| http//ip:port SetHeatFlowTemperatureZone1 0.0 float Heat flow temperature zone 1.
| http//ip:port SetHeatFlowTemperatureZone2 0.0 float Heat flow temperature zone 2.
| http//ip:port SetCoolFlowTemperatureZone1 0.0 float Cool flow temperature zone 1.
| http//ip:port SetCoolFlowTemperatureZone2 0.0 float Cool flow temperature zone 2.
| http//ip:port SetTankWaterTemperature 0.0 float Hot water temperature.
Energy Recovery Ventilation | |
POST http//ip:port Power true, false boolean Power state.
| http//ip:port NightPurgeMode true, false boolean Night purge mode.
| http//ip:port HideRoomTemperature true, false boolean Hide room temperature.
| http//ip:port HideSupplyTemperature true, false boolean Hide supply temperature.
| http//ip:port HideOutdoorTemperature true, false boolean Hide outdoor temperature.
| http//ip:port OperationMode 1 - Heat, 3 - Cool, 7 - Fan, 8 - Auto integer Operating mode.
| http//ip:port VentilationMode 0 - Lossnay, 1 - Bypass, 2 - Auto integer Ventilation mode.
| http//ip:port SetFanSpeed 0 - Auto, 1, 2, 3, 4 integer Fan speed.
| http//ip:port SetTemperature 0.0 float Room temperature.
| http//ip:port DefaultCoolingSetTemperature 0.0 float Default cooling temperature.
| http//ip:port DefaultHeatingSetTemperature 0.0 float Default heating temperature.

MQTT Integration

  • Subscribe data as a JSON Object {"Power": true}
Direction Topic Message Type
Publish Info, State {"Power": true, "SetTemperature": 21.5} JSON object.
Method Topic Key Value Type Description
Air Conditioner | |
Subscribe Set Power true, false boolean Power state.
| Set HideVaneControls true, false boolean Hide vane controls.
| Set HideDryModeControl true, false boolean Hide dry mode control.
| Set ProhibitSetTemperature true, false boolean Lock set temperature.
| Set ProhibitOperationMode true, false boolean Lock set operating mode.
| Set ProhibitPower true, false boolean Lock set power.
| Set OperationMode 1 - Heat, 2 - Dry, 3 - Cool, 7 - Fan, 8 - Auto integer Operating mode.
| Set FanSpeed 0 - Auto, 1, 2, 3, 4, 5, 6 integer Fan speed.
| Set VaneHorizontalDirection 0, 1, 2, 3, 4, 5, 8 - Split, 12 - Swing integer Vane H mode.
| Set VaneVerticalDirection 0, 1, 2, 3, 4, 5, 7 - Swing integer Vane V mode.
| Set SetTemperature 0.0 float Room temperature.
| Set DefaultCoolingSetTemperature 23.0 float Default cooling temperature.
| Set DefaultHeatingSetTemperature 21.0 float Default heating temperature.
Heat Pump | |
Subscribe Set Power true, false boolean Power state.
| Set ForcedHotWaterMode true, false boolean Force hot water.
| Set EcoHotWater true, false boolean Eco hot water.
| Set HolidayMode true, false boolean Holiday mode.
| Set ProhibitZone1 true, false boolean Lock control zone 1.
| Set ProhibitZone2 true, false boolean Lock control zone 2.
| Set ProhibitHotWater true, false boolean Lock control hot water.
| Set OperationMode 0 - Auto, 1 - Heat, 2 - Cool integer Operating mode heat pump.
| Set OperationModeZone1 0 - Heat Thermostat, 1 - Heat Flow, 2 - Heat Curve, 3 - Cool Thermostat, 4 - Cool Flow, 5 - Flor Dry Up integer Operating mode zone 1.
| Set OperationModeZone2 0 - Heat Thermostat, 1 - Heat Flow, 2 - Heat Curve, 3 - Cool Thermostat, 4 - Cool Flow, 5 - Flor Dry Up integer Operating mode zone 2.
| Set SetTemperatureZone1 0.0 float Temperature zone 1.
| Set SetTemperatureZone2 0.0 float Temperature zone 2.
| Set SetHeatFlowTemperatureZone1 0.0 float Heat flow temperature zone 1.
| Set SetHeatFlowTemperatureZone2 0.0 float Heat flow temperature zone 2.
| Set SetCoolFlowTemperatureZone1 0.0 float Cool flow temperature zone 1.
| Set SetCoolFlowTemperatureZone2 0.0 float Cool flow temperature zone 2.
| Set SetTankWaterTemperature 0.0 float Hot water temperature.
Energy Recovery Ventilation | |
Subscribe Set Power true, false boolean Power state.
| Set NightPurgeMode true, false boolean Night purge mode.
| Set HideRoomTemperature true, false boolean Hide room temperature.
| Set HideSupplyTemperature true, false boolean Hide supply temperature.
| Set HideOutdoorTemperature true, false boolean Hide outdoor temperature.
| Set OperationMode 1 - Heat, 3 - Cool, 7 - Fan, 8 - Auto integer Operating mode.
| Set VentilationMode 0 - Lossnay, 1 - Bypass, 2 - Auto integer Ventilation mode.
| Set SetFanSpeed 0 - Auto, 1, 2, 3, 4 integer Fan speed.
| Set SetTemperature 0.0 float Room temperature.
| Set DefaultCoolingSetTemperature 23.0 float Default cooling temperature.
| Set DefaultHeatingSetTemperature 21.0 float Default heating temperature.

changelog

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Important changes

  • v0.1.x The old plugin and config need to be first removed from Homebridge and HomeKit and added again.
  • v0.4.0 Main control mode, buttons and presets need to be configured again!!!
  • v1 After update to v1 and above from v0 the devices need to be added to the Home app again and the old unresponsive remove!!! This devices will be removed from all automations and scenes!!!
  • v2 After update to v2 from v1 only RESTFull and MQTT config settings need to be updated in config.
    • v2.4 and above require upcomming homebridge v2
  • v3 After update to v3 the plugin need to be configured using Config UI X.
    • do not configure it manually, always using Config UI X
    • required Homebridge v2.0.0 and above

[3.7.5] - (25.03.2025)

Changes

  • fix#192, thanks @helloabunai

[3.7.3] - (15.03.2025)

Changes

  • updated Homebridge UI interface

[3.7.1] - (14.03.2025)

Changes

  • removed possibility to disable indyvidual accessory due to duplicated function with displayMode

[3.7.0] - (13.03.2025)

Changes

  • added possibility to disable indyvidual accessory
  • bump dependencies
  • config schema updated
  • redme updated
  • cleanup

[3.6.9] - (28.02.2025)

Changes

[3.6.7] - (26.02.2025)

Changes

  • bump dependencies
  • cleanup
  • redme update

[3.6.6] - (25.02.2025)

Changes

[3.6.4] - (09.02.2025)

Changes

  • fix plugin crash if config dosnt contain devices

[3.6.3] - (07.02.2025)

Changes

  • stability and improvements

[3.6.2] - (04.03.2025)

Changes

[3.6.1] - (29.01.2025)

Changes

  • refactor cnnect and reconnect code
  • refactor external integrations MQTT and RESTFul
  • update logging
  • cleanup

[3.6.0] - (29.01.2025)

Changes

  • added possibility to disable/enable log success, info, warn, error
  • refactor cnnect code
  • bump dependencies
  • config schema updated
  • redme updated
  • cleanup

[3.5.0] - (06.12.2024)

Changes

  • added possibility to set device refresh state indyvidually for every device
  • bump deependemcies
  • config.schema updated
  • redme updated
  • cleanup

[3.4.4] - (05.12.2024)

Changes

  • fix #184
  • bump deependemcies

[3.4.3] - (02.12.2024)

Changes

[3.4.0] - (30.11.2024)

Changes

  • move from commonJS to esm module, fixing #180
  • moved constants.json to constants.js
  • cleanup

[3.3.20] - (25.09.2024)

Changes

  • fix ATA characteristics warning after plugin restart if device in DRY or FAN mode
  • cleanup

[3.3.19] - (25.09.2024)

Changes

  • fix apply presets for ATA
  • cleanup

[3.3.18] - (25.09.2024)

Changes

  • fix get/set temperature during operation mode change for ATA
  • fix #168
  • cleanup

[3.3.17] - (24.09.2024)

Changes

  • fix operation mode for ATA - Thermostat if device go to OFF
  • move some error to warn
  • cleanup

[3.3.16] - (23.09.2024)

Changes

  • fix report wrong target mode if device is OFF and the plugin or bridge reboots
  • fix #167
  • cleanup

[3.3.15] - (21.09.2024)

Changes

  • fix report wrong target temperature in Heat/Cool mode for ATA and ERV
  • cleanup

[3.3.14] - (21.09.2024)

Changes

  • code improvements
  • cleanup

[3.3.13] - (20.09.2024)

Changes

  • fix #166
  • readme update with explanation of AUTO mode in Heather/Cooler and Thermostat mode
  • cleanup

[3.3.5] - (15.09.2024)

Changes

[3.3.3] - (13.09.2024)

Changes

[3.3.2] - (13.09.2024)

Changes

  • corrct setProps for heating/cooling threshold
  • update ERV code to support heating/cooling threshold in auto mode
  • cleanup

[3.3.1] - (13.09.2024)

Changes

  • fix update default Heating/Cooling characteristic temp
  • fix display current state of operation mode:
    • in AUTO mode, tile in Home app display current state as HEATING - orange/COOLING - blue, based on current device mode
    • in HEAT mode, the tile in Home app display current state as HEATING - orange
    • in COOL mode, the tile in Home app display current state as COOLING - blue
    • in DRY mode, the tile in Home app display current state as IDLE - black
    • in FAN mode, the tile in Home app display current state as IDLE - black
    • in IDLE mode, the tile display current state as IDLE - black
    • in INACTIVE mode, the tile display current state as INACTIVE - transparent
  • readme update
  • cleanup

[3.3.0] - (12.09.2024)

Changes

  • added full support for AUTO mode with dead band, low and high temperature
  • fix some log info message
  • bump dependencies
  • cleanup

[3.2.0] - (11.09.2024)

Changes

  • added possibility to set previous value for buttons #154
  • move some message to warning
  • presets previous settings apply improvement
  • cleanup

[3.1.11] - (09.09.2024)

Changes

  • cleanup

[3.1.9] - (05.08.2024)

Changes

  • prevent load device if display mode set to 0 or unknown #150
  • cleanup

[3.1.8] - (03.08.2024)

Changes

[3.1.4] - (02.08.2024)

Changes

[3.1.2] - (31.08.2024)

Changes

  • fix presets configured array

[3.1.0] - (31.08.2024)

Changes

  • improvements in plugin config UI
  • added presets config indyvidually
  • config schema update
  • bump dependencies
  • cleanup

[3.0.7] - (30.08.2024)

Changes

  • improvements in plugin config UI
  • config schema update
  • cleanup

[3.0.0] - (29.08.2024)

Changes

  • added homebridge UI server
  • whole new concept get all devices from melcloud usin config UI X
  • added device config indyvidually
  • config schema updated
  • cleanup

[2.4.0] - (28.08.2024)

Changes

  • required upcomming homebridge 2.x.x required
  • bump dependencies
  • config schema updated

[2.3.3] - (28.08.2024)

Changes

  • cleanup and refactor accessory code
  • bump dependencies

[2.3.0] - (25.08.2024)

Changes

  • removed from config.json ataDisableAutoMode, ataDisableHeatMode, ataAutoHeatMode
  • added to config.json ataHeatDryFanMode, ataCoolDryFanMode, ataAutoDryFanMode
  • added individual operating mode assingn for Heat/Cool/Auto, #132
  • unfortunatelly disabled operating mode cannot be hiden in HomeKit app due to HomeKit app limitations
  • cleanup
  • config schema updated

[2.2.0] - (18.08.2024)

Changes

  • fix MQTT and RESTFul start
  • add control over RESTFul POST JSON Object
  • bump dependencies

[2.1.1] - (18.08.2024)

Changes

  • fix correct catch error
  • log improvements

[2.1.0] - (16.08.2024)

Changes

  • added possibility to set device state refresh inteval
  • rebuilt connect to melcloud code
  • performance and stability improvements
  • fix some found issues
  • config schema updated
  • cleanup

[2.0.0] - (14.08.2024)

Changes

  • RestFul and MQTT refactor
  • bump dependencies
  • cleanup

[1.1.4] - (14.08.2024)

Changes

  • hide passwords, tokens, serial numbers, by typing and display in Config UI
  • remove return duplicate promises from whole code

[1.1.3] - (06.08.2024)

Changes

  • fix #131
  • bump dependencies

[1.1.0] - (23.07.2024)

Changes

  • allow enable/disable every extra temperature sensor indyvidually #126
  • cleanup
  • config.schema updated

[1.0.7] - (06.07.2024)

Changes

  • refactor buttons code
  • cleanup
  • config.schema updated

[1.0.1] - (22.06.2024)

Changes

  • check duplicate account name if run only one Homebridge instance
  • cleanup

[1.0.0] - (21.06.2024)

Changes

  • added #120 possibility run same device many times in other account or in other homebridge instance
  • cleanup

[1.0.0] - (21.06.2024)

Changes

  • added #109, possibility filter out specific device and not exposed to the Homebridge/homekit by deviceId
  • cleanup

[0.21.0] - (25.03.2024)

Changes

  • added #109, possibility filter out specific device and not exposed to the Homebridge/homekit by deviceId
  • cleanup

[0.20.1] - (10.03.2024)

Changes

  • prevent set out of range temperature for Heat Pump
  • prevent set out of range temperature for Energy Recovery Ventilation
  • cleanup

[0.20.0] - (10.03.2024)

Changes

  • dynamically update temp unit
  • prevent set out of range temperature for Air Conditioner
  • cleanup

[0.19.0] - (02.03.2024)

Changes

  • added support to control devices over MQTT protocol
  • cleanup

[0.18.0] - (02.03.2024)

Changes

  • added temperature sensors for heat pump, flow, return, zone 1, zone 2, water tank
  • fix #91, thanks @alesf
  • fix #92, thanks @alesf
  • fix #96
  • fix some grammar mistakes in config schema, readme and in source code, thanks @alesf
  • config.schema updated
  • cleanup

[0.17.0] - (01.03.2024)

Changes

  • added outdoor/room temperature sensors for Air Conditioner if supported
  • added outdoor/room/supply temperature sensors for Losnay if supported
  • added outdoor/room/zone1/zone2/water tank temperature sensors for Heta pump if supported
  • config.schema updated
  • cleanup

[0.16.0] - (10.02.2024)

Changes

  • removed possibility to set indyvidual refresh time for ATA, ATW, ERV state
  • full code refactor for ATA, ATW, ERV
  • fixed accesorry publish if units are not configured in MELCloud
  • remove sensitive information from debug
  • drastically reduce call trace
  • config.schema updated
  • cleanup

[0.15.0] - (05.02.2024)

Changes

  • added possibility to set indyvidual refresh time for Account Settings and ATA, ATW, ERV state, #68
  • config.schema updated
  • cleanup

[0.14.1] - (06.01.2024)

Changes

  • added possibility to enable/disable the accessory name as a prefix for button/sensor name
  • config.schema updated

[0.14.0] - (06.01.2024)

Changes

  • added mode SPLIT to Vane V #62
  • fix Vane V mode assignment for buttons/sensors
  • performance and stability improvements
  • config.schema updated

[0.13.0] - (30.07.2023)

Changes

  • added RESTFul server
  • code refactor and cleanup
  • config.schema updated

[0.12.0] - (21.07.2023)

Changes

  • added extra temperature sensor for Heater/Cooler control mode to use with automations
  • config.schema updeted
  • cleanup

[0.11.0] - (25.03.2023)

Changes

  • full support of ERV Lossnay, fix #37
  • added core maintenance indicator for ERV LOSSNAY
  • added CO2 sensor for ERV LOSSNAY
  • added PM2.5 sensor for ERV LOSSNAY
  • config.schema updated
  • cleanup

[0.10.0] - (15.03.2023)

Changes

  • added filter maintenance indicator for ERV LOSSNAY
  • config.schema updated
  • cleanup

[0.9.0] - (14.03.2023)

Changes

  • changed properties in config.json from ataHeatMode to ataAutoHeatMode
  • updated selectable options for ataAutoHeatMode to DRY/FAN, FAN/DRY
  • fix #19
  • fix #23
  • config.schema updated
  • cleanup

[0.8.0] - (13.03.2023)

Changes

  • added possibility selec mode DRY/FAN for Heat if Heat not supported by device
  • config.schema updated
  • other small fixes

[0.7.1] - (13.03.2023)

Changes

  • cleanup

[0.7.0] - (12.03.2023)

Changes

  • added for Air Conditioner DRY operating mode if HEAT not supported or FAN if DRY not supported too
  • cleanup

[0.6.0] - (08.03.2023)

Changes

  • added full support for Heat Pump control, thanks @Reliktdragons for testing
  • fixed MQTT client
  • performance and stability improvements
  • config.schema updated
  • cleanup

[0.5.0] - (02.02.2023)

Changes

  • added None/Contact/Motion/Occupancy Sensor for displayType in the buttons/sensors section
  • code refactor and fixes
  • stability and performance improvements
  • reduce HB load usage
  • bump dependencies

[0.4.5] - (02.01.2023)

Changes

  • code refactor
  • small fixes in fan speeds

[0.4.4] - (31.12.2022)

Changes

  • bump dependencies

[0.4.3] - (06.12.2022)

Changes Homebridge >= 1.6

  • fix characteristic was supplied illegal value: number 0 exceeded minimum of 10
  • bump dependencies

[0.4.2] - (15.10.2022)

Changes

  • code cleanup
  • fixed display wrong current state for Heat Pump in log
  • fixed display presets as accessory button
  • bump dependencies
  • added new functions for buttons control:
    • Air Conditioner:
      • hide DRY mode control
      • hide VANE H/V conttrols
    • Energy Recovery Ventilation:
      • hide ROOM temperature
      • hide SUPPLY temperature
      • hide OUTDOOR temperature

[0.4.1] - (21.09.2022)

Changes

  • removed mode AUTO for Energy Recovery Ventilation if device not support it
  • removed mode AUTO for Air Conditioner if device not support it
  • fix #19
  • fix characteristic warning for Zone 2 of Heat Pump
  • update config.schema

[0.4.0] - (21.09.2022)

Changes

  • added possibility individually configure (control mode, presets and buttons) for devices of same type
  • update config.schema json

[0.3.2] - (20.09.2022)

Changes

  • fixed many bugs in Heat Pump, thanks user @choooli for patience and tests
  • fixed some bugs in Enrgy Recovery Ventilation (Test phase)
  • code cleanup and refactor
  • bump dependencies

[0.3.1] - (29.08.2022)

Changes

  • code cleanup
  • mqtt topics standarization

[0.3.0] - (27.08.2022)

Changes

  • code cleanup and rebuild
  • stability improvements
  • added account reconect process if for some reason login fail
  • added devices list and state recheck if for some reason fail
  • revert to get serial mumber from wifi adapter not the device itself
  • added expose device presets as a buttons in home app
  • added support for Heat Pump (Test phase)
  • added support for Enrgy Recovery Ventilation (Test phase)

[0.2.16] - (24.07.2022)

Changes

  • fix node.js warning
  • bump minimum version of hombridge to v1.4

[0.2.15] - (24.07.2022)

Changes

  • code cleanup
  • code rebuild

[0.2.14] - (23.07.2022)

Changes

  • update accessory display name and type

[0.2.12] - (23.07.2022)

Changes

  • code rebuild and cleanup
  • reduced MELCloud backroground refresh data to 30sec
  • refresch MELCloud data after user value change

[0.2.11] - (22.07.2022)

Changes

  • fixed #7
  • fixed #8
  • fixed #9
  • fixed #10
  • fixed display undefined outdoor unit in log

[0.2.10] - (05.07.2022)

Changes

  • added auto detection of device support standby mode
  • some logs cosmetics changes
  • config schema updated

[0.2.9] - (04.07.2022)

Changes

  • fix #6
  • added auto detection of device support automatic fan speed mode and detect numbers of fan speeds

[0.2.8] - (03.07.2022)

Changes

  • fix Rotation Speed warning

[0.2.7] - (03.07.2022)

Changes

  • fix sometimes device switch off if set new temp

[0.2.6] - (03.07.2022)

Changes

[0.2.5] - (02.07.2022)

Changes

  • fix setProp step for celsius

[0.2.4] - (02.07.2022)

Changes

  • fix heating cooling threshold warning

[0.2.3] - (27.06.2022)

Changes

  • removed vane H and V tilt angle characteristics from accessory, the data is not available on MELCloud api
  • stability improvements
  • code cleanup

[0.2.2] - (27.06.2022)

Changes

  • fix select button mone abowe as 9

[0.2.1] - (27.06.2022)

Changes

  • config schema updated
  • readme updated
  • code cleanup

[0.2.0] - (27.06.2022)

Added

  • control vane H all modes with buttons
  • control vane V all modes with buttons
  • control fan speed all modes with buttons

Changes

  • code cleanup

[0.1.2] - (26.06.2022)

Changes

  • rebuilded refresch device state

[0.1.1] - (26.06.2022)

Changes

  • added lock physical controls for Heater/Cooler accessory
  • fix display undefined value for fan speed mode in log
  • fix display wrong swing mode in log

[0.1.0] - (26.06.2022)

Changes

  • full code rebuild
  • fix display buttons state
  • performance and stability improvement
  • fix #3

[0.0.11] - (20.06.2022)

Changes

  • fix update state of buttons

[0.0.10] - (20.06.2022)

Changes

  • fix add all operating mode for buttons

[0.0.9] - (20.06.2022)

Changes

  • added possibility to set all modes using extra buttons fix #2

[0.0.8] - (19.06.2022)

Changes

  • code cleanup

[0.0.7] - (19.06.2022)

Changes

  • fix warning for DefaultHeatingSetTemperature
  • code cleanup

[0.0.6] - (19.06.2022)

Changes

  • fix set Target Temperature in Auto Mode
  • prepare for Heat Pump and Energy Recovery Ventilation
  • code cleanup

[0.0.5] - (19.06.2022)

Changes

  • fix parse building structure and read devices #1
  • fix set Temperature treshold
  • fix set Target Temperature
  • code cleanup

[0.0.4] - (18.06.2022)

Changes

  • first working version

[0.0.3] - (18.06.2022)

Changes

  • test release 3

[0.0.2] - (17.06.2022)

Changes

  • test release 2

[0.0.1] - (16.06.2022)

Changes

  • test release