homebridge-melcloud-control 4.13.1 → 4.14.0-beta.0

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.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
+
+- fixed: Config UI, the error shown after a failed Login and Sync was an empty object `{}`, now the real error message is shown
+
 ## [4.13.1] - (29.09.2026)
 
 ### Changes

package/homebridge-ui/public/index.html

@@ -477,7 +477,7 @@
         await homebridge.savePluginConfig();
       } catch (error) {
         updateInfo('info', `Prepare config error`, "red");
-        updateInfo('info1', `Error: ${JSON.stringify(error)}`, "red");
+        updateInfo('info1', `Error: ${error?.message ?? JSON.stringify(error)}`, "red");
       } finally {
         homebridge.hideSpinner();
         $('logIn').disabled = false;

package/package.json

@@ -1,7 +1,7 @@
 {
   "displayName": "MELCloud Control",
   "name": "homebridge-melcloud-control",
-  "version": "4.13.1",
+  "version": "4.14.0-beta.0",
   "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,36 @@ 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 {
+            const day = (offset) => new Date(Date.now() + offset * 86400000).toISOString().slice(0, 10);
+            const params = { unitId, period: 'Daily', from: `${day(-1)}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.