homebridge-melcloud-control 4.4.1-beta.20 → 4.4.1-beta.22

package/CHANGELOG.md

@@ -22,6 +22,15 @@ 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.4.1] - (xx.12.2025)
+
+## Changes
+
+- bump dependencies
+- config schema updated
+- redme updated
+- cleanup
+
 # [4.4.0] - (10.12.2025)
 
 ## Changes

package/README.md

@@ -36,7 +36,7 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
 * Support direct `Scenes`, only MELCloud Home.
 * Support direct `Frost protection`, only MELCloud Home.
 * Support direct `Overheat Protection`, only MELCloud Home.
-* Support direct `Holiday Mode`.
+* Support direct `Holiday Mode`, only MELCloud Home.
 * Support direct `Functions`, using extra `Buttons`, switch it to `OFF` restore previous device state.
 * Support automations, shortcuts and Siri.
 * Support external integrations, [RESTFul](https://github.com/grzegorz914/homebridge-melcloud-control?tab=readme-ov-file#restful-integration), [MQTT](https://github.com/grzegorz914/homebridge-melcloud-control?tab=readme-ov-file#mqtt-integration).
@@ -68,8 +68,8 @@ 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`.
+      * Frost protection `ON/OFF/MINTEMP/MAXTEMP`.
+      * Overheat protection `ON/OFF/MINTEMP/MAXTEMP`.
       * Holiday mode `ON/OFF`.
       * Schedules `ON/OFF`.
       * Scene `ON/OFF`.
@@ -129,7 +129,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`.
-      * Frost protection `ON/OFF`.
+      * Frost protection `ON/OFF/MINTEMP/MAXTEMP`.
       * Holiday mode `ON/OFF`.
       * Schedules `ON/OFF`.
       * Scene `ON/OFF`.
@@ -210,7 +210,7 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
   * 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:
+  * 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.

package/package.json

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

package/src/constants.js

@@ -29,17 +29,17 @@ export const ApiUrls = {
             Scenes: "/api/user/scenes",
         },
         Post: {
-            Schedule: "/api/cloudschedule/deviceid", // POST {"days":[2],"time":"17:59:00","enabled":true,"id":"53c5e804-0663-47d0-85c2-2d8ccd2573de","power":false,"operationMode":null,"setPoint":null,"vaneVerticalDirection":null,"vaneHorizontalDirection":null,"setFanSpeed":null}
-            ProtectionFrost: "/api/protection/frost", // POST {"enabled":true,"min":13,"max":16,"units":{"ATA":["ef333525-2699-4290-af5a-2922566676da"]}}
-            ProtectionOverheat: "/api/protection/overheat", // POST {"enabled":true,"min":32,"max":35,"units":{"ATA":["ef333525-2699-4290-af5a-2922566676da"]}}
-            HolidayMode: "/api/holidaymode", // POST {"enabled":true,"startDate":"2025-11-11T17:42:24.913","endDate":"2026-06-01T09:18:00","units":{"ATA":["ef333525-2699-4290-af5a-2922566676da"]}}
-            Scene: "/api/scene", // POST {"id": "8e484d50-528b-434a-9acb-7d7c81f06a12", "userId": "2db32d6f-c19c-4b1f-a0dd-1915420a5152","name": "Poza domem","enabled": false,"icon": "AwayIcon","ataSceneSettings": [{"unitId": "054dd950-f6e0-4195-bea7-59d8ea0668c2","ataSettings": { "power": false, "operationMode": "heat","setFanSpeed": "auto","vaneHorizontalDirection": "auto", "vaneVerticalDirection": "auto", "setTemperature": 21,"temperatureIncrementOverride": null,"inStandbyMode": null},"previousSettings": null}],"atwSceneSettings": []}
+            ProtectionFrost: "/api/protection/frost", //{"enabled":true,"min":13,"max":16,"units":{"ATA":["deviceid"]}}
+            ProtectionOverheat: "/api/protection/overheat", //{"enabled":true,"min":32,"max":35,"units":{"ATA":["deviceid"]}}
+            HolidayMode: "/api/holidaymode", //{"enabled":true,"startDate":"2025-11-11T17:42:24.913","endDate":"2026-06-01T09:18:00","units":{"ATA":["deviceid"]}}
+            Schedule: "/api/cloudschedule/deviceid", //{"days":[2],"time":"17:59:00","enabled":true,"id":"scheduleid","power":false,"operationMode":null,"setPoint":null,"vaneVerticalDirection":null,"vaneHorizontalDirection":null,"setFanSpeed":null}
+            Scene: "/api/scene", //{"id": "sceneid", "userId": "userid","name": "Poza domem","enabled": false,"icon": "AwayIcon","ataSceneSettings": [{"unitId": "deviceid","ataSettings": { "power": false, "operationMode": "heat","setFanSpeed": "auto","vaneHorizontalDirection": "auto", "vaneVerticalDirection": "auto", "setTemperature": 21,"temperatureIncrementOverride": null,"inStandbyMode": null},"previousSettings": null}],"atwSceneSettings": []}
         },
         Put: {
-            Ata: "/api/ataunit/deviceid",
+            Ata: "/api/ataunit/deviceid", //{ power: true,setTemperature: 22, setFanSpeed: "auto", operationMode: "heat", vaneHorizontalDirection: "auto",vaneVerticalDirection: "auto", temperatureIncrementOverride: null, inStandbyMode: null}
             Atw: "/api/atwunit/deviceid",
             Erv: "/api/ervunit/deviceid",
-            ScheduleEnableDisable: "/api/cloudschedule/deviceid/enabled", // PUT {"enabled":true}
+            ScheduleEnableDisable: "/api/cloudschedule/deviceid/enabled", // {"enabled": true}
             SceneEnableDisable: "/api/scene/sceneid/enabledisable",
         },
         Delete: {

package/src/functions.js

@@ -78,12 +78,13 @@ class Functions extends EventEmitter {
                 await access('/.dockerenv');
                 isDocker = true;
             } catch { }
+
             try {
-                const { stdout } = await execPromise('cat /proc/1/cgroup || true');
+                const { stdout } = await execPromise('cat /proc/1/cgroup');
                 if (stdout.includes('docker') || stdout.includes('containerd')) isDocker = true;
             } catch { }
 
-            const result = { path: null, arch, system: null };
+            const result = { path: null, arch, system: 'unknown' };
 
             /* ===================== macOS ===================== */
             if (isMac) {
@@ -109,7 +110,7 @@ class Functions extends EventEmitter {
                     try {
                         await access(path, fs.constants.X_OK);
                         result.path = path;
-                        result.system = 'QNAP';
+                        result.system = 'Qnap';
                         return result;
                     } catch { }
                 }
@@ -119,13 +120,15 @@ class Functions extends EventEmitter {
                     await execPromise('/opt/bin/opkg update');
                     await execPromise('opkg install chromium nspr nss libx11 libxcomposite libxdamage libxrandr atk libcups libdrm libgbm alsa-lib');
                     process.env.LD_LIBRARY_PATH = `/opt/lib:${process.env.LD_LIBRARY_PATH || ''}`;
-                } catch { }
+                } catch (error) {
+                    if (this.logError) this.emit('error', `Install package for Qnap error: ${error}`);
+                }
 
                 for (const path of qnapCandidates) {
                     try {
                         await access(path, fs.constants.X_OK);
                         result.path = path;
-                        result.system = 'QNAP';
+                        result.system = 'Qnap';
                         return result;
                     } catch { }
                 }
@@ -147,12 +150,11 @@ class Functions extends EventEmitter {
 
                 if (!isDocker) {
                     try {
-                        this.emit('debug', `Try install chromium`);
                         await execPromise('sudo apt update -y');
-                        await execPromise('sudo apt install -y chromium chromium-browser chromium-codecs-ffmpeg || true');
-                        await execPromise('sudo apt install -y libnspr4 libnss3 libx11-6 libxcomposite1 libxdamage1 libxrandr2 libatk1.0-0 libcups2 libdrm2 libgbm1 libasound2 || true');
+                        await execPromise('sudo apt install -y chromium chromium-browser chromium-codecs-ffmpeg');
+                        await execPromise('sudo apt install -y libnspr4 libnss3 libx11-6 libxcomposite1 libxdamage1 libxrandr2 libatk1.0-0 libcups2 libdrm2 libgbm1 libasound2');
                     } catch (error) {
-                        this.emit('debug', `Install chromium failed ${error}`);
+                        if (this.logError) this.emit('error', `Install package for Linux ARM error: ${error}`);
                     }
                 }
 
@@ -171,7 +173,7 @@ class Functions extends EventEmitter {
             if (isLinux) {
                 const linuxCandidates = ['/usr/bin/chromium', '/usr/bin/chromium-browser', '/usr/bin/google-chrome', '/snap/bin/chromium', '/usr/local/bin/chromium'];
                 try {
-                    const { stdout } = await execPromise('which chromium || which chromium-browser || which google-chrome || true');
+                    const { stdout } = await execPromise('which chromium || which chromium-browser || which google-chrome');
                     if (stdout.trim()) {
                         result.path = stdout.trim();
                         return result;
@@ -189,19 +191,21 @@ class Functions extends EventEmitter {
 
                 if (isDocker) {
                     try {
-                        await execPromise('apt update -y && apt install -y chromium || true');
+                        await execPromise('apt update -y && apt install -y chromium');
                         await access('/usr/bin/chromium', fs.constants.X_OK);
                         result.path = '/usr/bin/chromium';
                         result.system = 'Linux Docker';
                         return result;
-                    } catch { }
+                    } catch (error) {
+                        if (this.logError) this.emit('error', `Install package for Linux Docker error: ${error}`);
+                    }
                 }
             }
 
             return result;
-        } catch (err) {
-            if (this.logError) this.emit('error', `Chromium detection error: ${err.message}`);
-            return { path: null, arch: 'unknown' };
+        } catch (error) {
+            if (this.logError) this.emit('error', `Chromium detection error: ${error.message}`);
+            return { path: null, arch: 'unknown', system: 'unknown' };
         }
     }
 

package/src/melcloudhome.js

@@ -231,7 +231,7 @@ class MelCloudHome extends EventEmitter {
 
             // If path is found, use it
             if (chromiumPath) {
-                if (!this.logDebug) this.emit('debug', `Using Chromium ${system} (${arch}) at ${chromiumPath}`);
+                if (!this.logDebug) this.emit('debug', `Using Chromium for ${system} (${arch}) at ${chromiumPath}`);
             } else {
                 if (arch === 'arm') {
                     accountInfo.Info = `No Chromium found for ${system} (${arch}). Please install it manually and try again.`;
@@ -247,7 +247,6 @@ class MelCloudHome extends EventEmitter {
                 }
             }
 
-
             // Verify Chromium executable
             try {
                 const { stdout } = await execPromise(`"${chromiumPath}" --version`);