homebridge-melcloud-control 4.10.9-beta.3 → 4.10.9

package/CHANGELOG.md

@@ -24,6 +24,13 @@ 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.10.9] - (28.05.2026)
+
+### Changes
+
+- fix ATA HeaterCooler Active.onSet now includes current OperationMode (EffectiveFlags: PowerOperationMode) when powering on, preventing MELCloud from resetting the operation mode to Auto when iOS sends a spurious Active=1 alongside a fan speed change
+- fix ATA and ERV RotationSpeed characteristic scaled to 0-100 HomeKit range instead of raw 0-N; GET scales raw fan speed to percentage (level 1 of 5 → 20%), SET reverse-maps percentage back to raw level, setProps maxValue set to 100 with minStep = 100/numberOfFanSpeeds so the slider snaps to clean positions
+
 ## [4.10.8] - (24.05.2026)
 
 ### Changes

package/homebridge-ui/public/index.html

@@ -451,8 +451,11 @@
         if (removedScenesCount) removedParts.push(`Scenes: ${removedScenesCount}`);
         if (removedParts.length) updateInfo('info1', `Removed old: ${removedParts.join('; ')}`, 'orange');
 
+        homebridge.hideSpinner();
+        $('logIn').disabled = false;
+
         await homebridge.updatePluginConfig(pluginConfig);
-        await homebridge.savePluginConfig(pluginConfig);
+        await homebridge.savePluginConfig();
       } catch (error) {
         const msg = error?.message || error?.error || String(error);
         updateInfo('info', 'Connection failed', 'red');

package/package.json

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

package/src/deviceata.js

@@ -330,8 +330,11 @@ class DeviceAta extends EventEmitter {
                         .onSet(async (state) => {
                             try {
                                 const payload = { power: state ? true : false };
+                                const operationMode = deviceData.Device.OperationMode;
+                                const includeMode = state && operationMode != null;
+                                if (includeMode) payload.operationMode = operationMode;
                                 if (this.logInfo) this.emit('info', `Set power: ${state ? 'On' : 'Off'}`);
-                                await this.melCloudAta.send(this.accountType, this.displayType, deviceData, payload);
+                                await this.melCloudAta.send(this.accountType, this.displayType, deviceData, payload, includeMode ? AirConditioner.EffectiveFlags.OperationMode : null);
                             } catch (error) {
                                 if (this.logWarn) this.emit('warn', `Set power error: ${error}`);
                             };
@@ -382,10 +385,10 @@ class DeviceAta extends EventEmitter {
                             .setProps({
                                 minValue: this.accessory.fanSpeedSetPropsMinValue,
                                 maxValue: this.accessory.fanSpeedSetPropsMaxValue,
-                                minStep: 1
+                                minStep: this.accessory.fanSpeedSetPropsMinStep
                             })
                             .onGet(async () => {
-                                const value = this.accessory.currentFanSpeed; //AUTO, 1, 2, 3, 4, 5, 6, OFF
+                                const value = this.accessory.currentFanSpeed;
                                 return value;
                             })
                             .onSet(async (value) => {
@@ -393,11 +396,12 @@ class DeviceAta extends EventEmitter {
                                     const payload = {};
                                     const fanKeySet = accountTypeMelCloud ? 'fanSpeed' : 'setFanSpeed';
                                     const max = numberOfFanSpeeds;
-                                    const minValue = supportsAutomaticFanSpeed ? 0 : 1;
-                                    const clampedValue = Math.min(Math.max(value, minValue), max);
+                                    const minFanSpeed = supportsAutomaticFanSpeed ? 0 : 1;
+                                    // Reverse-map from 0-100 HomeKit scale to raw fan speed level
+                                    const rawFanSpeed = value === 0 ? 0 : Math.max(minFanSpeed, Math.min(max, Math.round((value / 100) * max)));
 
-                                    payload[fanKeySet] = clampedValue;
-                                    if (this.logInfo) this.emit('info', `Set fan speed mode: ${AirConditioner.FanSpeedMapEnumToString[clampedValue]}`);
+                                    payload[fanKeySet] = rawFanSpeed;
+                                    if (this.logInfo) this.emit('info', `Set fan speed mode: ${AirConditioner.FanSpeedMapEnumToString[rawFanSpeed]}`);
                                     await this.melCloudAta.send(this.accountType, this.displayType, deviceData, payload, AirConditioner.EffectiveFlags.SetFanSpeed);
                                 } catch (error) {
                                     if (this.logWarn) this.emit('warn', `Set fan speed mode error: ${error}`);
@@ -1643,17 +1647,15 @@ class DeviceAta extends EventEmitter {
                             //fan speed mode
                             if (supportsFanSpeed) {
                                 const max = numberOfFanSpeeds;
-
-                                // ograniczamy wartość do zakresu API
-                                const minValue = supportsAutomaticFanSpeed ? 0 : 1;
-                                const maxValue = max;
-
-                                // zabezpieczenie przed out-of-bounds
-                                const clampedValue = Math.min(Math.max(setFanSpeed, minValue), maxValue);
-
-                                obj.currentFanSpeed = clampedValue;
-                                obj.fanSpeedSetPropsMinValue = minValue;
-                                obj.fanSpeedSetPropsMaxValue = maxValue;
+                                const minRaw = supportsAutomaticFanSpeed ? 0 : 1;
+                                const rawFanSpeed = Math.min(Math.max(setFanSpeed, minRaw), max);
+                                // Scale raw fan speed to 0-100 HomeKit range
+                                const scaledFanSpeed = rawFanSpeed === 0 ? 0 : Math.round((rawFanSpeed / max) * 100);
+
+                                obj.currentFanSpeed = scaledFanSpeed;
+                                obj.fanSpeedSetPropsMinValue = 0;
+                                obj.fanSpeedSetPropsMaxValue = 100;
+                                obj.fanSpeedSetPropsMinStep = Math.round(100 / max);
                             }
 
                             //create characteristics

package/src/deviceerv.js

@@ -348,21 +348,22 @@ class DeviceErv extends EventEmitter {
                             .setProps({
                                 minValue: this.accessory.fanSpeedSetPropsMinValue,
                                 maxValue: this.accessory.fanSpeedSetPropsMaxValue,
-                                minStep: 1
+                                minStep: this.accessory.fanSpeedSetPropsMinStep
                             })
                             .onGet(async () => {
-                                const value = this.accessory.fanSpeed; //STOP, 1, 2, 3, 4, OFF
+                                const value = this.accessory.fanSpeed;
                                 return value;
                             })
                             .onSet(async (value) => {
                                 try {
                                     const payload = {};
                                     const max = numberOfFanSpeeds;
-                                    const minValue = supportsAutomaticFanSpeed ? 0 : 1;
-                                    const clampedValue = Math.min(Math.max(value, minValue), max);
+                                    const minFanSpeed = supportsAutomaticFanSpeed ? 0 : 1;
+                                    // Reverse-map from 0-100 HomeKit scale to raw fan speed level
+                                    const rawFanSpeed = value === 0 ? 0 : Math.max(minFanSpeed, Math.min(max, Math.round((value / 100) * max)));
 
-                                    payload.setFanSpeed = clampedValue;
-                                    if (this.logInfo) this.emit('info', `Set fan speed mode: ${Ventilation.FanSpeedMapEnumToString[clampedValue]}`);
+                                    payload.setFanSpeed = rawFanSpeed;
+                                    if (this.logInfo) this.emit('info', `Set fan speed mode: ${Ventilation.FanSpeedMapEnumToString[rawFanSpeed]}`);
                                     await this.melCloudErv.send(this.accountType, this.displayType, deviceData, payload, Ventilation.EffectiveFlags.SetFanSpeed);
                                 } catch (error) {
                                     if (this.logWarn) this.emit('warn', `Set fan speed mode error: ${error}`);
@@ -1274,17 +1275,15 @@ class DeviceErv extends EventEmitter {
                             //fan speed mode
                             if (supportsFanSpeed) {
                                 const max = numberOfFanSpeeds;
-
-                                // ograniczamy wartość do zakresu API
-                                const minValue = supportsAutomaticFanSpeed ? 0 : 1;
-                                const maxValue = max;
-
-                                // zabezpieczenie przed out-of-bounds
-                                const clampedValue = Math.min(Math.max(setFanSpeed, minValue), maxValue);
-
-                                obj.fanSpeed = clampedValue;
-                                obj.fanSpeedSetPropsMinValue = minValue;
-                                obj.fanSpeedSetPropsMaxValue = maxValue;
+                                const minRaw = supportsAutomaticFanSpeed ? 0 : 1;
+                                const rawFanSpeed = Math.min(Math.max(setFanSpeed, minRaw), max);
+                                // Scale raw fan speed to 0-100 HomeKit range
+                                const scaledFanSpeed = rawFanSpeed === 0 ? 0 : Math.round((rawFanSpeed / max) * 100);
+
+                                obj.fanSpeed = scaledFanSpeed;
+                                obj.fanSpeedSetPropsMinValue = 0;
+                                obj.fanSpeedSetPropsMaxValue = 100;
+                                obj.fanSpeedSetPropsMinStep = Math.round(100 / max);
                             }
 
                             //create characteristics