grzegorz914 / homebridge-melcloud-control

Homebridge plugin for Mitsubishi Air Conditioner, Heat Pump and Energy Recovery Ventilation, publish as dynamic external platform accessory.
MIT License
60 stars 4 forks source link

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

Control Mode

HOME app current device mode display

AUTO Mode

Configuration

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.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.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.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.
deviceRefreshInterval Here set the background devices state refresh time in (sec), default 5s.
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.
restFul This is RSTful server.
restFul.enable If enabled, RESTful server will start automatically and respond to any path request.
restFul.port Here set the listening Port for RESTful server.
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

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

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.