npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

homebridge-melcloud-external-sensor

v1.0.4

Published

Homebridge plugin to control Mitsubishi Air Conditioner with external temperature sensor support (Shelly). Fork of homebridge-melcloud-control by grzegorz914.

Readme

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 or MELCloud Home.

Package Requirements

| Package | Installation | Role | Required | | --- | --- | --- | --- | | Homebridge v2.0.0 | Homebridge Wiki | HomeKit Bridge | Required | | Homebridge UI <= v5.5.0 | Homebridge UI Wiki | Homebridge User Interface | Required | | MELCloud | Plug-In Wiki | Plug-In | Required |

About The Plugin

  • Support:
    • Devices connected to MELCloud or MELCloud Home.
    • Multiple accounts, buildings, floors, areas.
    • Temperature display units Celsius/Fahrenheit.
    • Assing individual operating mode for Heat/Cool/Auto.
    • Presets, only MELCloud.
    • Scenes, only MELCloud Home.
    • Frost protection, only MELCloud Home.
    • Overheat Protection, only MELCloud Home.
    • Holiday Mode, only MELCloud Home.
    • Physical lock controls LOCK/UNLOCK, only MELCloud.
    • Functions, using extra Buttons, switch to OFF restore previous state.
    • Automations, shortcuts and Siri.
    • 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.
    • 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.
        • Preset SET/UNSET
        • Frost protection ON/OFF/MINTEMP/MAXTEMP.
        • Overheat protection ON/OFF/MINTEMP/MAXTEMP.
        • Holiday mode ON/OFF.
        • Schedules ON/OFF.
        • Scene ON/OFF.
    • 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/.
        • Preset ACTIV/UNACTIV.
        • Room temperature.
        • Outdoor temperature.
        • Frost protection.
        • Overheat protection.
        • Holiday mode.
        • Shedules control.
        • Shedule active.
        • Scene control.
        • In standby.
        • Is connected.
        • Error.
  • 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.
        • Preset SET/UNSET.
        • Frost protection ON/OFF/MINTEMP/MAXTEMP.
        • Holiday mode ON/OFF.
        • Schedules ON/OFF.
        • Scene ON/OFF.
    • 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.
        • Preset 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.
        • Frost protection.
        • Holiday mode.
        • Shedules control.
        • Shedule active.
        • Scene control.
        • In standby.
        • Is connected.
        • Error.
  • 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.
        • Preset SET/UNSET.
        • Holiday mode ON/OFF.
        • Schedules ON/OFF.
        • Scene ON/OFF.
    • 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.
        • Holiday mode.
        • Shedules control.
        • Shedule active.
        • Scene control.
        • In standby.
        • Is connected.
        • Error.

HOME app current device mode display

  • In AUTO mode, the tile display current state based on current mode:
    • HEATING mode, th tile display current state as HEATING - orange
    • COOLING mode, the tile display current state as COOLING - blue
    • DRY mode, the tile display current state as IDLE - black
    • FAN mode, the tile display current state as IDLE - black
    • IDLE mode, the tile display current state as IDLE - black
    • 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 is send 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 UI <= v5.5.0 to configure this plugin.
  • 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 account credential (username). | | passwd | Here set the account credential (password). | | language | Here select the account language. | | type | Here select the account type 0 - None / Disabled, 1 - MELCloud, 2 - MELCloud Home. | | 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[].name | Here set Your own name Accessory Name which is exposed to the Homebridge / HomeKit. | | ataDevices[].displayType | Here select device control mode 0 - None / Disabled, 1 - Heater / Cooler, 2 - 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 sensor and use in HomeKit automations. | | ataDevices[].temperatureOutdoorSensor | This enable extra Outdoor temperature sensor and use in HomeKit automations. | | ataDevices[].inStandbySensor | This enable In Standby Mode sensor and use in HomeKit automations. | | ataDevices[].connectSensor | This enable Connect State sensor and use in HomeKit automations. | | ataDevices[].errorSensor | This enable Error sensor and use in HomeKit automations. | | ataDevices[].frostProtectionSupport | This enable extra Frost Protection control and sensors and use in HomeKit automations. | | ataDevices[].overheatProtectionSupport | This enable extra Overheat Protection control and sensors and use in HomeKit automations. | | ataDevices[].holidayModeSupport | This enable extra Holiday Mode control and sensors and use in HomeKit automations. | | 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 set Your own name Preset Name which is exposed to the Homebridge / HomeKit. | | ataDevices[].presets[].displayType | Here select display type in HomeKit, 0 - None / Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor, 4 - Switch + Motion Sensor, 5 - Switch + Occupancy Sensor, 6 - Switch + Contact Sensor, 7 - Switch. | | ataDevices[].schedules[] | Array of ATA device Schedules created automatically after login to MELCloud Home from plugin config UI. | | ataDevices[].schedules[].id | Read only data, do not change it. | | ataDevices[].schedules[].name | Here set Your own name Schedule Name which is exposed to the Homebridge / HomeKit. | | ataDevices[].schedules[].displayType | Here select display type in HomeKit, 0 - None / Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor, 4 - Switch + Motion Sensor, 5 - Switch + Occupancy Sensor, 6 - Switch + Contact Sensor, 7 - Switch. | | ataDevices[].scenes[].id | Read only data, do not change it. | | ataDevices[].scenes[].name | Here set Your own name Scene Name which is exposed to the Homebridge / HomeKit. | | ataDevices[].scenes[].displayType | Here select display type in HomeKit, 0 - None / Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor, 4 - Switch + Motion Sensor, 5 - Switch + Occupancy Sensor, 6 - Switch + Contact Sensor, 7 - Switch. | | ataDevices[].buttonsSensors[] | Array of buttons sensors. | | ataDevices[].buttonsSensors[].name | Here set Button Name which You want expose to the Homebridge / HomeKit. | | ataDevices[].buttonsSensors[].mode | Here select button mode, VH - Vane Horizontal, VV - Vane Horizontal. | | ataDevices[].buttonsSensors[].displayType | Here select display type in HomeKit, 0 - None / Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor, 4 - Switch + Motion Sensor, 5 - Switch + Occupancy Sensor, 6 - Switch + Contact Sensor, 7 - Switch. | | ataDevices[].buttonsSensors[].namePrefix | Here enable 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[].name | Here set Your own name Accessory Name which is exposed to the Homebridge / HomeKit. | | atwDevices[].displayType | Here select main control mode None / Disabled, Heater / Cooler, Thermostat. | | atwDevices[].hideZone | Here select which zone need to be hidden None / Disabled, Heat Pump, Heat Pump / Zone 1, Heat Pump / Zone 1 / Hot Water, Heat Pump / Zone 1 / Zone 2, Heat Pump / Hot Water,Heat Pump / Hot Water / Zone 2, Heat Pump / Zone 2, Zone 1, Zone 1 / Hot Water, Zone 1 / Hot Water / Zone 2, Zone 1 / Zone 2, Hot Water, Hot Water / Zone 2, Zone 2, All. | | atwDevices[].temperatureSensor | This enable extra Room temperature sensor and use in HomeKit automations. | | atwDevices[].temperatureFlowSensor | This enable extra Flow temperature sensor and use in HomeKit automations. | | atwDevices[].temperatureReturnSensor | This enable extra Return temperature sensor and use in HomeKit automations. | | atwDevices[].temperatureFlowZone1Sensor | This enable extra Flow Zone 1 temperature sensor and use in HomeKit automations. | | atwDevices[].temperatureReturnZone1Sensor | This enable extra Return Zone 1 temperature sensor and use in HomeKit automations. | | atwDevices[].temperatureFlowWaterTankSensor | This enable extra Flow Water Tank temperature sensor and use in HomeKit automations. | | atwDevices[].temperatureReturnWaterTankSensor | This enable extra Return Water Tank temperature sensor and use in HomeKit automations. | | atwDevices[].temperatureFlowZone2Sensor | This enable extra Flow Zone 2 temperature sensor and use in HomeKit automations. | | atwDevices[].temperatureReturnZone2Sensor | This enable extra Return Zone 2 temperature sensor and use in HomeKit automations. | | atwDevices[].inStandbySensor | This enable In Standby Mode sensor and use in HomeKit automations. | | atwDevices[].connectSensor | This enable Connect State sensor and use in HomeKit automations. | | atwDevices[].errorSensor | This enable Error sensors and use in HomeKit automations. | | atwDevices[].holidayModeSupport | This enable extra Holiday Mode control and sensors and use in HomeKit automations. | | atwDevices[].presets[] | Array of ATW 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 set Your own name Preset Name which is exposed to the Homebridge/HomeKit. | | atwDevices[].presets[].displayType | Here select display type in HomeKit, 0 - None/Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor, 4 - Switch + Motion Sensor, 5 - Switch + Occupancy Sensor, 6 - Switch + Contact Sensor, 7 - Switch. | | atwDevices[].schedules[] | Array of ATW device Schedules created automatically after login to MELCloud Home from plugin config UI. | | atwDevices[].schedules[].id | Read only data, do not change it. | | atwDevices[].schedules[].name | Here set Your own name Schedule Name which is exposed to the Homebridge/HomeKit. | | atwDevices[].schedules[].displayType | Here select display type in HomeKit, 0 - None/Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor, 4 - Switch + Motion Sensor, 5 - Switch + Occupancy Sensor, 6 - Switch + Contact Sensor, 7 - Switch. | | atwDevices[].scenes[].id | Read only data, do not change it. | | atwDevices[].scenes[].name | Here set Your own name Scene Name which is exposed to the Homebridge/HomeKit. | | atwDevices[].scenes[].displayType | Here select display type in HomeKit, 0 - None/Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor, 4 - Switch + Motion Sensor, 5 - Switch + Occupancy Sensor, 6 - Switch + Contact Sensor, 7 - Switch. | | atwDevices[].buttonsSensors[] | Array of buttons sensors. | | atwDevices[].buttonsSensors[].name | Here set Button Name which You want expose to the Homebridge / HomeKit. | | atwDevices[].buttonsSensors[].mode | Here select button mode. | | atwDevices[].buttonsSensors[].displayType | Here select display type in HomeKit, 0 - None / Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor, 4 - Switch + Motion Sensor, 5 - Switch + Occupancy Sensor, 6 - Switch + Contact Sensor, 7 - Switch. | | atwDevices[].buttonsSensors[].namePrefix | Here enable 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[].name | Here set Your own name Accessory Name which is exposed to the Homebridge / HomeKit. | | ervDevices[].displayType | Here select main control mode None / Disabled, Heater / Cooler, Thermostat. | | ervDevices[].temperatureSensor | This enable extra Room temperature sensor and use in HomeKit automations. | | ervDevices[].temperatureOutdoorSensor | This enable extra Outdoor temperature sensor and use in HomeKit automations. | | ervDevices[].temperatureSupplySensor | This enable extra Supply temperature sensor and use in HomeKit automations. | | atwDevices[].inStandbySensor | This enable In Standby Mode sensor and use in HomeKit automations. | | ervDevices[].connectSensor | This enable Connect State sensor and use in HomeKit automations. | | ervDevices[].errorSensor | This enable Error sensors and use in HomeKit automations. | | ervDevices[].holidayModeSupport | This enable extra Holiday Mode control and sensors and use in HomeKit automations. | | ervDevices[].presets[] | Array of ERV 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 set Your own name Preset Name which is exposed to the Homebridge / HomeKit. | | ervDevices[].presets[].displayType | Here select display type in HomeKit, 0 - None / Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor, 4 - Switch + Motion Sensor, 5 - Switch + Occupancy Sensor, 6 - Switch + Contact Sensor, 7 - Switch. | | ervDevices[].schedules[] | Array of ERV device Schedules created automatically after login to MELCloud Home from plugin config UI. | | ervDevices[].schedules[].id | Read only data, do not change it. | | ervDevices[].schedules[].name | Here set Your own name Schedule Name which is exposed to the Homebridge / HomeKit. | | ervDevices[].schedules[].displayType | Here select display type in HomeKit, 0 - None / Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor, 4 - Switch + Motion Sensor, 5 - Switch + Occupancy Sensor, 6 - Switch + Contact Sensor, 7 - Switch. | | ervDevices[].scenes[].id | Read only data, do not change it. | | ervDevices[].scenes[].name | Here set Your own name Scene Name which is exposed to the Homebridge / HomeKit. | | ervDevices[].scenes[].displayType | Here select display type in HomeKit, 0 - None / Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor, 4 - Switch + Motion Sensor, 5 - Switch + Occupancy Sensor, 6 - Switch + Contact Sensor, 7 - Switch. | | ervDevices[].buttonsSensors[] | Array of buttons sensors. | | ervDevices[].buttonsSensors[].name | Here set Button Name which You want expose to the Homebridge / HomeKit. | | ervDevices[].buttonsSensors[].mode | Here select button mode. | | ervDevices[].buttonsSensors[].displayType | Here select display type in HomeKit, 0 - None / Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor, 4 - Switch + Motion Sensor, 5 - Switch + Occupancy Sensor, 6 - Switch + Contact Sensor, 7 - Switch. | | ervDevices[].buttonsSensors[].namePrefix | Here enable the accessory name as a prefix for button / sensor name. | | refreshInterval | Here set the background account data refresh time in (sec) , only for old MELCLoud, default 120s. | | log{} | Log object. | | log.deviceInfo | This enable log device info will be displayed by every connections device to the network. | | log.success | This enable success log will be displayed in console. | | log.info | This enable info log will be displayed in console. | | log.warn | This enable warn log will be displayed in console. | | log.error | This enable error log will be displayed in console. | | log.debug | This enable debug log will be displayed in console. | | restFul{} | RSTful object. | | restFul.enable | This enable RESTful server will start automatically and respond to any path request. | | mqtt{} | MQTT object. | | mqtt.enable | This enable 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{} | MQTT authorization object. | | mqtt.auth.enable | Here enable authorization for MQTT Broker. | | mqtt.auth.user | Here set the MQTT Broker user. | | mqtt.auth.passwd | Here set the MQTT Broker password. |

RESTful Integration

  • Port:
    • MELCLoud, last 4 numbers of device Id, correct port is displayed in HB log during start.
    • MELCLoud Home, start at 30000, correct port is displayed in HB log during start.
  • POST data as a JSON Object {OperationMode: 8}.
  • Header content type must be application/json.
  • Path status response all available paths.

| 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. | | | http//ip:port | FrostProtection | true, false | boolean | Frost protectin. | | | http//ip:port | OverheatProtection | true, false | boolean | Overheat protection. | | | http//ip:port | HolidayMode | true, false | boolean | Holiday mode. | | | http//ip:port | Schedules | true, false | boolean | Schedules. | | 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 | 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. | | | http//ip:port | HolidayMode | true, false | boolean | Holiday mode. | | | http//ip:port | Schedules | true, false | boolean | Schedules. | | 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. | | | http//ip:port | HolidayMode | true, false | boolean | Holiday mode. | | | http//ip:port | Schedules | true, false | boolean | Schedules. |

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. | | | Set | FrostProtection | true, false | boolean | Frost protectin. | | | Set | OverheatProtection | true, false | boolean | Overheat protection. | | | Set | HolidayMode | true, false | boolean | Holiday mode. | | | Set | Schedules | true, false | boolean | Schedules. | | 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 | 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. | | | Set | HolidayMode | true, false | boolean | Holiday mode. | | | Set | Schedules | true, false | boolean | Schedules. | | 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. | | | Set | HolidayMode | true, false | boolean | Holiday mode. | | | Set | Schedules | true, false | boolean | Schedules. |