homebridge-melcloud-control 4.1.3-beta.9 → 4.2.0-beta.1

package/CHANGELOG.md

@@ -22,6 +22,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Do not use Homebridge UI > v5.5.0 because of break config.json
 
+## [4.2.0] - (xx.11.2025)
+
+## Changes
+
+- initial support for MELCloud Home ATW device
+- added frost protection control for MELCloud Home ATA device
+- added overheat protection control for MELCloud Home ATA device
+- added holiday mode control MELCloud Home ATA, ERV, ATW devices
+- config schema updated
+- readme updated
+- cleanup
+
 ## [4.1.2] - (11.11.2025)
 
 ## Changes

package/README.md

@@ -65,6 +65,9 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
       * Vane V mode `AUTO/1/2/3/4/5/SWING`.
       * Fan speed mode `AUTO/1/2/3/4/5`.
       * Presets `SET/UNSET`.
+      * Frost protection `ON/OFF`.
+      * Overheat protection `ON/OFF`.
+      * Holiday mode `ON/OFF`.
       * Schedule `ON/OFF`.
   * Sensors:
     * For automation and notifications.
@@ -79,6 +82,8 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
       * Outdoor temperature.
       * Frost protection.
       * Overheat protection.
+      * Frost protection.
+      * Overheat protection.
       * Holiday mode.
       * Shedule control.
       * Shedule active
@@ -119,6 +124,7 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
       * Operating mode `HEAT/COOL/CURVE/HOLIDAY/AUTO HOT WATER/ECO HOT WATER/FORCE HOT WATER`.
       * Physical lock controls `LOCK/UNLOCK`.
       * Presets `SET/UNSET`.
+      * Holiday mode `ON/OFF`.
       * Schedule `ON/OFF`.
   * Sensors:
     * For automation and notifications.
@@ -132,6 +138,7 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
       * Water tank temperature.
       * Flow Temperature Zone 1, 2, Hot Water.
       * Return Temperature Zone 1, 2, Hot Water.
+      * Holiday mode.
       * Shedule control.
       * Shedule active
       * Error
@@ -151,6 +158,7 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
       * Operating mode `LOSSNAY/BYPASS/AUTO/NIGHT PURGE`.
       * Fan speed mode `AUTO/1/2/3/4`.
       * Presets `SET/UNSET`.
+      * Holiday mode `ON/OFF`.
       * Schedule `ON/OFF`.
   * Sensors:
     * For automation and notifications.
@@ -165,6 +173,7 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
       * Filter maintenance.
       * CO2 detected and level.
       * PM2.5 air quality and level.
+      * Holiday mode.
       * Shedule control.
       * Shedule active
       * Error
@@ -234,10 +243,10 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
 | `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 to use with automations in HomeKit app. |
 | `ataDevices[].temperatureOutdoorSensor` | This enable extra `Outdoor` temperature sensor to use with automations in HomeKit app. |
-| `ataDevices[].frostProtectionSensor` | This enable extra `Frost Protectio` sensor to use with automations in HomeKit app. |
-| `ataDevices[].overHeatProtectionSensor` | This enable extra `Overheat Protection` sensor to use with automations in HomeKit app. |
-| `ataDevices[].holidayModeSensor` | This enable extra `Holiday Mode` sensor to use with automations in HomeKit app. |
 | `ataDevices[].errorSensor` | This enable `Error` sensor to use with automations in HomeKit app. |
+| `ataDevices[].frostProtectionSupport` | This enable extra `Frost Protectio` control and sensors to use with automations in HomeKit app. |
+| `ataDevices[].overheatProtectionSupport` | This enable extra `Overheat Protection` control and sensors to use with automations in HomeKit app. |
+| `ataDevices[].holidayModeSupport` | This enable extra `Holiday Mode` control and 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. |
@@ -268,8 +277,8 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
 | `atwDevices[].temperatureReturnWaterTankSensor` | This enable extra `Return Water Tank` temperature sensor to use with automations in HomeKit app. |
 | `atwDevices[].temperatureFlowZone2Sensor` | This enable extra `Flow Zone 2` temperature sensor to use with automations in HomeKit app. |
 | `atwDevices[].temperatureReturnZone2Sensor` | This enable extra `Return Zone 2` temperature sensor to use with automations in HomeKit app. |
-| `atwDevices[].holidayModeSensor` | This enable extra `Holiday Mode` sensor to use with automations in HomeKit app. |
 | `atwDevices[].errorSensor` | This enable `Error` sensors to use with automations in HomeKit app. |
+| `atwDevices[].holidayModeSupport` | This enable extra `Holiday Mode` control and 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 ATW device `Presets` created automatically after login to MELCloud from plugin config UI. |
 | `atwDevices[].presets[].id` | Read only data, do not change it. |
@@ -293,8 +302,8 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
 | `ervDevices[].temperatureSensor` | This enable extra `Room` temperature sensor to use with automations in HomeKit app. |
 | `ervDevices[].temperatureOutdoorSensor` | This enable extra `Outdoor` temperature sensor to use with automations in HomeKit app. |
 | `ervDevices[].temperatureSupplySensor` | This enable extra `Supply` temperature sensor to use with automations in HomeKit app. |
-| `ervDevices[].holidayModeSensor` | This enable extra `Holiday Mode` sensor to use with automations in HomeKit app. |
 | `ervDevices[].errorSensor` | This enable `Error` sensors to use with automations in HomeKit app. |
+| `ervDevices[].holidayModeSupport` | This enable extra `Holiday Mode` control and 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 ERV device `Presets` created automatically after login to MELCloud from plugin config UI. |
 | `ervDevices[].presets[].id` | Read only data, do not change it. |

package/config.schema.json

@@ -395,38 +395,38 @@
                     "default": false,
                     "description": "This enable extra outdoor temperature sensor to use with automations in HomeKit app."
                   },
-                  "frostProtectionSensor": {
-                    "title": "Frost Protection",
+                  "errorSensor": {
+                    "title": "Error",
                     "type": "boolean",
                     "default": false,
-                    "description": "This enable extra frost protection sensor to use with automations in HomeKit app.",
-                    "condition": {
-                      "functionBody": "return model.accounts[arrayIndices[0]].type === 'melcloudhome';"
-                    }
+                    "description": "This enable error sensor to use with automations in HomeKit app."
                   },
-                  "overheatProtectionSensor": {
-                    "title": "Overheat Protection",
+                  "frostProtectionSupport": {
+                    "title": "Frost Protection Support",
                     "type": "boolean",
                     "default": false,
-                    "description": "This enable extra overheat protection sensor to use with automations in HomeKit app.",
+                    "description": "This enable extra frost protection control and sensors to use with automations in HomeKit app.",
                     "condition": {
                       "functionBody": "return model.accounts[arrayIndices[0]].type === 'melcloudhome';"
                     }
                   },
-                  "holidayModeSensor": {
-                    "title": "Holiday Mode",
+                  "overheatProtectionSupport": {
+                    "title": "Overheat Protection Support",
                     "type": "boolean",
                     "default": false,
-                    "description": "This enable extra holiday mode sensor to use with automations in HomeKit app.",
+                    "description": "This enable extra overheat protection control and sensors to use with automations in HomeKit app.",
                     "condition": {
                       "functionBody": "return model.accounts[arrayIndices[0]].type === 'melcloudhome';"
                     }
                   },
-                  "errorSensor": {
-                    "title": "Error",
+                  "holidayModeSupport": {
+                    "title": "Holiday Mode Support",
                     "type": "boolean",
                     "default": false,
-                    "description": "This enable error sensor to use with automations in HomeKit app."
+                    "description": "This enable extra holiday mode control and sensors to use with automations in HomeKit app.",
+                    "condition": {
+                      "functionBody": "return model.accounts[arrayIndices[0]].type === 'melcloudhome';"
+                    }
                   },
                   "refreshInterval": {
                     "title": "Refresh Interval",
@@ -1107,21 +1107,21 @@
                     "default": false,
                     "description": "This enable extra Return Zone 2 temperature sensor to use with automations in HomeKit app."
                   },
-                  "holidayModeSensor": {
-                    "title": "Holiday Mode",
-                    "type": "boolean",
-                    "default": false,
-                    "description": "This enable extra holiday mode sensor to use with automations in HomeKit app.",
-                    "condition": {
-                      "functionBody": "return model.accounts[arrayIndices[0]].type === 'melcloudhome';"
-                    }
-                  },
                   "errorSensor": {
                     "title": "Error",
                     "type": "boolean",
                     "default": false,
                     "description": "This enable error sensor to use with automations in HomeKit app."
                   },
+                  "holidayModeSupport": {
+                    "title": "Holiday Mode Support",
+                    "type": "boolean",
+                    "default": false,
+                    "description": "This enable extra holiday mode control and sensors to use with automations in HomeKit app.",
+                    "condition": {
+                      "functionBody": "return model.accounts[arrayIndices[0]].type === 'melcloudhome';"
+                    }
+                  },
                   "refreshInterval": {
                     "title": "Refresh Interval",
                     "type": "integer",
@@ -1579,21 +1579,21 @@
                     "default": false,
                     "description": "This enable extra supply temperature sensor to use with automations in HomeKit app."
                   },
-                  "holidayModeSensor": {
-                    "title": "Holiday Mode",
-                    "type": "boolean",
-                    "default": false,
-                    "description": "This enable extra holiday mode sensor to use with automations in HomeKit app.",
-                    "condition": {
-                      "functionBody": "return model.accounts[arrayIndices[0]].type === 'melcloudhome';"
-                    }
-                  },
                   "errorSensor": {
                     "title": "Error",
                     "type": "boolean",
                     "default": false,
                     "description": "This enable error sensor to use with automations in HomeKit app."
                   },
+                  "holidayModeSupport": {
+                    "title": "Holiday Mode Support",
+                    "type": "boolean",
+                    "default": false,
+                    "description": "This enable extra holiday mode control and sensors to use with automations in HomeKit app.",
+                    "condition": {
+                      "functionBody": "return model.accounts[arrayIndices[0]].type === 'melcloudhome';"
+                    }
+                  },
                   "refreshInterval": {
                     "title": "Refresh Interval",
                     "type": "integer",
@@ -2139,6 +2139,9 @@
                             "accounts[].ataDevices[].heatDryFanMode",
                             "accounts[].ataDevices[].coolDryFanMode",
                             "accounts[].ataDevices[].autoDryFanMode",
+                            "accounts[].ataDevices[].frostProtectionSupport",
+                            "accounts[].ataDevices[].overheatProtectionSupport",
+                            "accounts[].ataDevices[].holidayModeSupport",
                             "accounts[].ataDevices[].refreshInterval"
                           ],
                           "condition": {
@@ -2218,9 +2221,6 @@
                                 {
                                   "title": "System",
                                   "items": [
-                                    "accounts[].ataDevices[].frostProtectionSensor",
-                                    "accounts[].ataDevices[].overheatProtectionSensor",
-                                    "accounts[].ataDevices[].holidayModeSensor",
                                     "accounts[].ataDevices[].errorSensor"
                                   ]
                                 },
@@ -2285,6 +2285,7 @@
                           "items": [
                             "accounts[].atwDevices[].hideZone",
                             "accounts[].atwDevices[].name",
+                            "accounts[].atwDevices[].holidayModeSupport",
                             "accounts[].atwDevices[].refreshInterval"
                           ],
                           "condition": {
@@ -2371,7 +2372,6 @@
                                 {
                                   "title": "System",
                                   "items": [
-                                    "accounts[].atwDevices[].holidayModeSensor",
                                     "accounts[].atwDevices[].errorSensor"
                                   ]
                                 },
@@ -2435,6 +2435,7 @@
                           "expanded": false,
                           "items": [
                             "accounts[].ervDevices[].name",
+                            "accounts[].ervDevices[].holidayModeSupport",
                             "accounts[].ervDevices[].refreshInterval"
                           ],
                           "condition": {
@@ -2515,7 +2516,6 @@
                                 {
                                   "title": "System",
                                   "items": [
-                                    "accounts[].ervDevices[].holidayModeSensor",
                                     "accounts[].ervDevices[].errorSensor"
                                   ]
                                 },

package/package.json

@@ -1,7 +1,7 @@
 {
   "displayName": "MELCloud Control",
   "name": "homebridge-melcloud-control",
-  "version": "4.1.3-beta.9",
+  "version": "4.2.0-beta.1",
   "description": "Homebridge plugin to control Mitsubishi Air Conditioner, Heat Pump and Energy Recovery Ventilation.",
   "license": "MIT",
   "author": "grzegorz914",