homebridge-melcloud-control 4.3.1 → 4.3.2-beta.1

package/README.md

@@ -90,6 +90,8 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
       * Shedules control.
       * Shedule active.
       * Scene control.
+      * In standby.
+      * Is connected.
       * Error.
 * Heat Pump:
   * Heater Cooler:
@@ -146,6 +148,8 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
       * Shedules control.
       * Shedule active.
       * Scene control.
+      * In standby.
+      * Is connected.
       * Error.
 * Energy Recovery Ventilation Lossnay:
   * Heater Cooler:
@@ -183,6 +187,8 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
       * Shedules control.
       * Shedule active.
       * Scene control.
+      * In standby.
+      * Is connected.
       * Error.
 
 ### HOME app current device mode display

package/config.schema.json

@@ -1287,6 +1287,15 @@
                       "functionBody": "return model.accounts[arrayIndices[0]].type === 'melcloudhome';"
                     }
                   },
+                  "frostProtectionSupport": {
+                    "title": "Frost Protection Support",
+                    "type": "boolean",
+                    "default": false,
+                    "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';"
+                    }
+                  },
                   "refreshInterval": {
                     "title": "Refresh Interval",
                     "type": "integer",
@@ -2769,6 +2778,7 @@
                           "items": [
                             "accounts[].atwDevices[].hideZone",
                             "accounts[].atwDevices[].name",
+                            "accounts[].atwDevices[].frostProtectionSupport",
                             "accounts[].atwDevices[].holidayModeSupport",
                             "accounts[].atwDevices[].refreshInterval"
                           ],

package/package.json

@@ -1,7 +1,7 @@
 {
   "displayName": "MELCloud Control",
   "name": "homebridge-melcloud-control",
-  "version": "4.3.1",
+  "version": "4.3.2-beta.1",
   "description": "Homebridge plugin to control Mitsubishi Air Conditioner, Heat Pump and Energy Recovery Ventilation.",
   "license": "MIT",
   "author": "grzegorz914",
@@ -39,7 +39,7 @@
     "async-mqtt": "^2.6.3",
     "axios": "^1.13.2",
     "express": "^5.1.0",
-    "puppeteer": "^24.30.0",
+    "puppeteer": "^24.31.0",
     "ws": "^8.18.3"
   },
   "keywords": [

package/src/deviceata.js

@@ -1868,6 +1868,7 @@ class DeviceAta extends EventEmitter {
                         if (supportsSwingFunction) this.emit('info', `Air direction: ${AirConditioner.AirDirectionMapEnumToString[obj.currentSwingMode]}`);
                         this.emit('info', `Temperature display unit: ${obj.temperatureUnit}`);
                         this.emit('info', `Lock physical controls: ${obj.lockPhysicalControl ? 'Locked' : 'Unlocked'}`);
+                        if (this.accountType === 'melcloudhome') this.emit('info', `Signal strength: ${deviceData.rssi}dBm`);
                     };
                 })
                 .on('success', (success) => this.emit('success', success))

package/src/deviceatw.js

@@ -44,6 +44,7 @@ class DeviceAtw extends EventEmitter {
         this.inStandbySensor = device.inStandbySensor || false;
         this.connectSensor = device.connectSensor || false;
         this.errorSensor = device.errorSensor || false;
+        this.frostProtectionSupport = device.frostProtectionSupport || false;
         this.holidayModeSupport = device.holidayModeSupport || false;
         this.presets = this.accountType === 'melcloud' ? (device.presets || []).filter(preset => (preset.displayType ?? 0) > 0 && preset.id !== '0') : [];
         this.schedules = this.accountType === 'melcloudhome' ? (device.schedules || []).filter(schedule => (schedule.displayType ?? 0) > 0 && schedule.id !== '0') : [];
@@ -1066,6 +1067,53 @@ class DeviceAtw extends EventEmitter {
                 accessory.addService(this.errorService);
             }
 
+            //frost protection
+            if (this.frostProtectionSupport && this.accessory.frostProtectionEnabled !== null) {
+                //control
+                if (this.logDebug) this.emit('debug', `Prepare frost protection control service`);
+                this.frostProtectionControlService = new Service.Switch(`${serviceName} Frost Protection`, `frostProtectionControlService${deviceId}`);
+                this.frostProtectionControlService.addOptionalCharacteristic(Characteristic.ConfiguredName);
+                this.frostProtectionControlService.setCharacteristic(Characteristic.ConfiguredName, `${accessoryName} Frost Protection`);
+                this.frostProtectionControlService.getCharacteristic(Characteristic.On)
+                    .onGet(async () => {
+                        const state = this.accessory.frostProtectionEnabled;
+                        return state;
+                    })
+                    .onSet(async (state) => {
+                        try {
+                            deviceData.FrostProtection.Enabled = state;
+                            if (this.logInfo) this.emit('info', `Frost protection: ${state ? 'Enabled' : 'Disabled'}`);
+                            await this.melCloudAta.send(this.accountType, this.displayType, deviceData, 'frostprotection');
+                        } catch (error) {
+                            if (this.logWarn) this.emit('warn', `Set frost protection error: ${error}`);
+                        };
+                    });
+                accessory.addService(this.frostProtectionControlService);
+
+                if (this.logDebug) this.emit('debug', `Prepare frost protection control sensor service`);
+                this.frostProtectionControlSensorService = new Service.ContactSensor(`${serviceName} Frost Protection Control`, `frostProtectionControlSensorService${deviceId}`);
+                this.frostProtectionControlSensorService.addOptionalCharacteristic(Characteristic.ConfiguredName);
+                this.frostProtectionControlSensorService.setCharacteristic(Characteristic.ConfiguredName, `${accessoryName} Frost Protection Control`);
+                this.frostProtectionControlSensorService.getCharacteristic(Characteristic.ContactSensorState)
+                    .onGet(async () => {
+                        const state = this.accessory.frostProtectionEnabled;
+                        return state;
+                    })
+                accessory.addService(this.frostProtectionControlSensorService);
+
+                //sensor
+                if (this.logDebug) this.emit('debug', `Prepare frost protection service`);
+                this.frostProtectionSensorService = new Service.ContactSensor(`${serviceName} Frost Protection`, `frostProtectionSensorService${deviceId}`);
+                this.frostProtectionSensorService.addOptionalCharacteristic(Characteristic.ConfiguredName);
+                this.frostProtectionSensorService.setCharacteristic(Characteristic.ConfiguredName, `${accessoryName} Frost Protection`);
+                this.frostProtectionSensorService.getCharacteristic(Characteristic.ContactSensorState)
+                    .onGet(async () => {
+                        const state = this.accessory.frostProtectionActive;
+                        return state;
+                    })
+                accessory.addService(this.frostProtectionSensorService);
+            }
+
             //holiday mode
             if (this.holidayModeSupport && this.accessory.holidayModeEnabled !== null) {
                 //control
@@ -1574,6 +1622,10 @@ class DeviceAtw extends EventEmitter {
                     const holidayModeEnabled = accountTypeMelcloud ? holidayMode : deviceData.HolidayMode?.Enabled;
                     const holidayModeActive = deviceData.HolidayMode?.Active ?? false;
 
+                    //protection
+                    const frostProtectionEnabled = deviceData.FrostProtection?.Enabled;
+                    const frostProtectionActive = deviceData.FrostProtection?.Active ?? false;
+
                     //device info
                     const supportsStanbyMode = deviceData.Device[supportStandbyKey];
                     const supportsHeatPump = ![1, 2, 3, 4, 5, 6, 7, 15].includes(this.hideZone);
@@ -1681,6 +1733,8 @@ class DeviceAtw extends EventEmitter {
                         temperatureUnit: TemperatureDisplayUnits[this.accountInfo.useFahrenheit ? 1 : 0],
                         isConnected: isConnected,
                         isInError: isInError,
+                        frostProtectionEnabled: frostProtectionEnabled,
+                        frostProtectionActive: frostProtectionActive,
                         scheduleEnabled: scheduleEnabled,
                         holidayModeEnabled: holidayModeEnabled,
                         holidayModeActive: holidayModeActive,
@@ -1952,6 +2006,7 @@ class DeviceAtw extends EventEmitter {
                                     this.emit('info', `${heatPumpName},'Outdoor temperature: ${roomTemperature}${obj.temperatureUnit}`);
                                     this.emit('info', `${heatPumpName}, Temperature display unit: ${obj.temperatureUnit}`);
                                     this.emit('info', `${heatPumpName}, Lock physical controls: ${lockPhysicalControl ? 'Locked' : 'Unlocked'}`);
+                                    if (this.accountType === 'melcloudhome') this.emit('info', `Signal strength: ${deviceData.rssi}dBm`);
                                     break;
                                 case caseZone1: //Zone 1 - HEAT THERMOSTAT, HEAT FLOW, HEAT CURVE, COOL THERMOSTAT, COOL FLOW, FLOOR DRY UP
                                     operationModeText = idleZone1 ? HeatPump.ZoneOperationMapEnumToString[6] : HeatPump.ZoneOperationMapEnumToString[operationModeZone1];
@@ -2078,6 +2133,13 @@ class DeviceAtw extends EventEmitter {
                     this.connectService?.updateCharacteristic(Characteristic.ContactSensorState, isConnected);
                     this.errorService?.updateCharacteristic(Characteristic.ContactSensorState, isInError);
 
+                    //frost protection
+                    if (this.frostProtectionSupport && frostProtectionEnabled !== null) {
+                        this.frostProtectionControlService?.updateCharacteristic(Characteristic.On, frostProtectionEnabled);
+                        this.frostProtectionControlSensorService?.updateCharacteristic(Characteristic.ContactSensorState, frostProtectionEnabled);
+                        this.frostProtectionSensorService?.updateCharacteristic(Characteristic.ContactSensorState, frostProtectionActive);
+                    }
+
                     //holiday mode
                     if (this.holidayModeSupport && holidayModeEnabled !== null) {
                         this.holidayModeControlService?.updateCharacteristic(Characteristic.On, holidayModeEnabled);

package/src/deviceerv.js

@@ -1571,6 +1571,7 @@ class DeviceErv extends EventEmitter {
                         if (supportsCO2Sensor) this.emit('info', `CO2 level: ${roomCO2Level} ppm`);
                         if (supportsPM25Sensor) this.emit('info', `PM2.5 air quality: ${Ventilation.PM25AirQualityMapEnumToString[pM25AirQuality]}`);
                         if (supportsPM25Sensor) this.emit('info', `PM2.5 level: ${pM25Level} µg/m`);
+                        if (this.accountType === 'melcloudhome') this.emit('info', `Signal strength: ${deviceData.rssi}dBm`);
                     };
                 })
                 .on('success', (success) => this.emit('success', success))