homebridge-melcloud-control 4.13.2 → 4.14.0-beta.1

package/CHANGELOG.md

@@ -25,6 +25,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - For plugin < v4.6.0 use Homebridge UI <= v5.5.0
 - For plugin >= v4.6.0 use Homebridge UI >= v5.13.0
 
+## [4.14.0-beta.1] - (17.10.2026)
+
+### Changes
+
+- fixed: MELCloud Home, the outdoor temperature of the report was an old value of the previous day, because the report window ended at midnight at the beginning of the current day. The report is now requested from the current day
+
+## [4.14.0-beta.0] - (17.10.2026)
+
+### Changes
+
+- added: MELCloud Home, outdoor temperature sensor for Air Conditioner (ATA) from the trend summary report, because the status of the unit does not contain the outdoor temperature
+  - the sensor is created when `Outdoor Temperature Sensor` is enabled and the unit has an outdoor reading in the report, the report is read every 30 minutes
+  - the report is updated only while the unit is running, so the sensor keeps the last known value when the unit is off
+  - units without an outdoor reading, for example multi split systems, stay without the sensor
+
 ## [4.13.2] - (17.10.2026)
 
 ### Changes

package/package.json

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

package/src/melcloudata.js

@@ -12,6 +12,8 @@ class MelCloudAta extends EventEmitter {
         this.restFulEnabled = account.restFul?.enable;
         this.mqttEnabled = account.mqtt?.enable;
         this.deviceId = device.id;
+        this.temperatureOutdoorSensor = device.temperatureOutdoorSensor || false;
+        this.melCloudClass = melCloudClass;
         this.defaultTempsFile = defaultTempsFile;
 
         this.functions = new Functions(this.logWarn, this.logError, this.logDebug)
@@ -22,6 +24,8 @@ class MelCloudAta extends EventEmitter {
         //set default values
         this.deviceData = {};
         this.client = melCloudClass.client;
+        this.outdoorReading = null;
+        this.outdoorCheckedAt = 0;
 
         //handle melcloud events
         melCloudClass.on('client', (client) => {
@@ -120,8 +124,33 @@ class MelCloudAta extends EventEmitter {
         });
     }
 
+    // MELCloud Home does not send the outdoor temperature in the status of the unit, read it from the trend summary report
+    // every 30 minutes, the report is updated only while the unit is running
+    async checkOutdoorTemperature(deviceData) {
+        if (this.accountTypeMelcloud || !this.temperatureOutdoorSensor || (deviceData.Device.HasOutdoorTemperature && !this.outdoorReading)) return;
+
+        const now = Date.now();
+        if (now - this.outdoorCheckedAt >= 1_800_000) {
+            this.outdoorCheckedAt = now;
+            try {
+                this.outdoorReading = await this.melCloudClass.getOutdoorTemperature(this.deviceId) ?? this.outdoorReading;
+            } catch (error) {
+                if (this.logWarn) this.emit('warn', `Unit ${this.deviceId}, ${error.message}`);
+            }
+        }
+
+        if (!this.outdoorReading) return;
+        const { value, timestamp } = this.outdoorReading;
+        if (this.logDebug && timestamp && now - timestamp > 10_800_000) this.emit('debug', `Unit ${this.deviceId}, outdoor temperature ${value} is older than 3 hours, last measurement ${new Date(timestamp).toLocaleString()}`);
+
+        deviceData.Device.HasOutdoorTemperature = true;
+        deviceData.Device.OutdoorTemperature = value;
+    }
+
     async updateState(type, deviceData) {
         try {
+            await this.checkOutdoorTemperature(deviceData);
+
             if (!this.accountTypeMelcloud) {
                 if (type === 'ws') {
                     deviceData.Device.OperationMode = AirConditioner.OperationModeMapEnumToEnumWs[deviceData.Device.OperationMode] ?? deviceData.Device.OperationMode;

package/src/melcloudhome.js

@@ -726,6 +726,40 @@ class MelCloudHome extends EventEmitter {
         }
     }
 
+    // Latest outdoor temperature of a unit from the trend summary report, the status of the unit does not contain it.
+    // The last point of every dataset is stamped with the generation time of the report and only repeats the last known
+    // value, so the time of the real measurement is the point before it. Returns null when the unit has no outdoor reading.
+    async getOutdoorTemperature(unitId) {
+        try {
+            // the report is a window of 7 days that ends at midnight after `from` and `to` is ignored, so `from` must be today
+            const day = (offset) => {
+                const date = new Date(Date.now() + offset * 86400000);
+                return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`;
+            };
+            const params = { unitId, period: 'Daily', from: `${day(0)}T00:00:00.0000000`, to: `${day(1)}T00:00:00.0000000` };
+            const resp = await this.client.get(ApiUrls.Home.Get.ReportTrendSummary, { params });
+            if (this.logDebug) this.emit('debug', `Trend summary unit ${unitId}: ${JSON.stringify(resp.data)}`);
+
+            const reports = Array.isArray(resp.data) ? resp.data : [];
+            const datasets = reports.flatMap(report => report.datasets ?? []);
+            const outdoor = datasets.find(dataset => dataset.id === 'outside_temperature');
+            const points = (outdoor?.data ?? []).filter(point => this.functions.isValidValue(point?.y));
+
+            if (points.length > 0) {
+                const last = points.at(-1);
+                const otherStamps = datasets.filter(dataset => dataset !== outdoor).map(dataset => dataset.data?.at(-1)?.x);
+                const carried = points.length > 1 && otherStamps.includes(last.x);
+                return { value: last.y, timestamp: Date.parse((carried ? points.at(-2) : last).x) || null };
+            }
+
+            // no point in the requested range, use the last value before it
+            const trigger = reports.flatMap(report => report.previousTriggers ?? []).find(item => item.measure === 'outside_temperature' && this.functions.isValidValue(item.value));
+            return trigger ? { value: trigger.value, timestamp: Date.parse(trigger.trigger) || null } : null;
+        } catch (error) {
+            throw new Error(`Get outdoor temperature error: ${error.message}`);
+        }
+    }
+
     // ── Devices ───────────────────────────────────────────────────────────────
 
     // Wraps checkDevicesList with a single retry on timeout or network error.