homebridge-melcloud-control 4.1.2-beta.2 → 4.1.2-beta.21

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.1.2] - (10.11.2025)
+
+## Changes
+
+- added presets/schedules support for MELCLoud Home ATA devices
+- config schema updated
+- readme updated
+- cleanup
+
 ## [4.1.1] - (10.11.2025)
 
 ## Changes

package/config.schema.json

@@ -239,13 +239,11 @@
                   },
                   "type": {
                     "title": "Type",
-                    "type": "integer",
-                    "default": 0
+                    "type": "integer"
                   },
                   "typeString": {
                     "title": "Type",
-                    "type": "string",
-                    "default": "Air Conditioner"
+                    "type": "string"
                   },
                   "displayType": {
                     "title": "Display Type",

package/homebridge-ui/public/index.html

@@ -224,8 +224,6 @@
 
       document.getElementById('logIn').addEventListener('click', async () => {
         document.getElementById(`logIn`).className = "btn btn-primary";
-
-        updateInfo('info', 'Connecting...', 'yellow');
         homebridge.showSpinner();
 
         try {

package/package.json

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

package/src/constants.js

@@ -21,8 +21,12 @@ export const ApiUrlsHome = {
     BaseURL: "https://melcloudhome.com",
     GetUserContext: "/api/user/context",
     SetAta: "/api/ataunit/deviceid",
+    GetAtaSchedule: "/ata/deviceid/schedule",
     SetAtw: "/api/atwunit/deviceid",
+    GetAtwSchedule: "/atw/deviceid/schedule",
     SetErv: "/api/ervunit/deviceid",
+    GetErvSchedule: "/erv/deviceid/schedule",
+    SetSchedule: "/api/cloudschedule/deviceid/enabled",
 };
 
 export const DeviceType = [

package/src/deviceata.js

@@ -683,8 +683,9 @@ class DeviceAta extends EventEmitter {
             if (this.presets.length > 0) {
                 if (this.logDebug) this.emit('debug', `Prepare presets services`);
                 this.presetsServices = [];
+                const presetsIdKey = this.accountType === 'melcloud' ? 'ID' : 'Id';
                 this.presets.forEach((preset, i) => {
-                    const presetData = presetsOnServer.find(p => p.ID === preset.Id);
+                    const presetData = presetsOnServer.find(p => p[presetsIdKey] === preset.id);
 
                     //get preset name
                     const name = preset.name;
@@ -705,8 +706,6 @@ class DeviceAta extends EventEmitter {
                         })
                         .onSet(async (state) => {
                             try {
-                                const setTempKey = this.accountType === 'melcloud' ? 'SetTemperature' : 'SetPoint';
-                                const fanKey = this.accountType === 'melcloud' ? 'FanSpeed' : 'SetFanSpeed';
                                 switch (state) {
                                     case true:
                                         preset.previousSettings = deviceData.Device;
@@ -715,7 +714,7 @@ class DeviceAta extends EventEmitter {
                                         deviceData.Device.SetTemperature = presetData.SetTemperature;
                                         deviceData.Device.VaneHorizontalDirection = presetData.VaneHorizontalDirection;
                                         deviceData.Device.VaneVerticalDirection = presetData.VaneVerticalDirection;
-                                        deviceData.Device[fanKey] = presetData[fanKey];
+                                        deviceData.Device.SetFanSpeed = presetData.SetFanSpeed;
                                         break;
                                     case false:
                                         deviceData.Device.Power = preset.previousSettings.Power;
@@ -723,7 +722,7 @@ class DeviceAta extends EventEmitter {
                                         deviceData.Device.SetTemperature = preset.previousSettings.SetTemperature;
                                         deviceData.Device.VaneHorizontalDirection = preset.previousSettings.VaneHorizontalDirection;
                                         deviceData.Device.VaneVerticalDirection = preset.previousSettings.VaneVerticalDirection;
-                                        deviceData.Device[fanKey] = preset.previousSettings[fanKey];
+                                        deviceData.Device.SetFanSpeed = preset.previousSettings.SetFanSpeed;
                                         break;
                                 };
 
@@ -765,7 +764,7 @@ class DeviceAta extends EventEmitter {
                         })
                         .onSet(async (state) => {
                             try {
-                                const key = this.accountType === 'melcloud' ? 'FanSpeed' : 'SetFanSpeed';
+                                const fanKey = this.accountType === 'melcloud' ? 'FanSpeed' : 'SetFanSpeed';
                                 let effectiveFlags = null;
                                 switch (mode) {
                                     case 0: //POWER ON,OFF
@@ -1017,6 +1016,7 @@ class DeviceAta extends EventEmitter {
 
                     //keys
                     const presetsKey = this.accountType === 'melcloud' ? 'Presets' : 'Schedule';
+                    const presetsIdKey = this.accountType === 'melcloud' ? 'ID' : 'Id';
                     const setTempKey = this.accountType === 'melcloud' ? 'SetTemperature' : 'SetPoint';
                     const fanKey = this.accountType === 'melcloud' ? 'FanSpeed' : 'SetFanSpeed';
                     const tempStepKey = this.accountType === 'melcloud' ? 'TemperatureIncrement' : 'HasHalfDegreeIncrements';
@@ -1030,16 +1030,17 @@ class DeviceAta extends EventEmitter {
                     const supportCoolKey = this.accountType === 'melcloud' ? 'ModelSupportsCool' : 'HasCoolOperationMode';
 
                     //presets schedule
+                    const scheduleEnabled = deviceData.ScheduleEnabled;
                     const presetsOnServer = deviceData[presetsKey] ?? [];
 
+
                     //protection
-                    const frostProtectionEnabled = deviceData.FrostProtection?.enabled;
-                    const frostProtectionActive = deviceData.FrostProtection?.active;
-                    const overheatProtectionEnabled = deviceData.OverheatProtection?.enabled;
-                    const overheatProtectionActive = deviceData.OverheatProtection?.active;
-                    const holidayModeEnabled = deviceData.HolidayMode?.enabled;
-                    const holidayModeActive = deviceData.HolidayMode?.active;
-                    const scheduleEnabled = deviceData.ScheduleEnabled;
+                    const frostProtectionEnabled = deviceData.FrostProtection?.Enabled;
+                    const frostProtectionActive = deviceData.FrostProtection?.Active;
+                    const overheatProtectionEnabled = deviceData.OverheatProtection?.Enabled;
+                    const overheatProtectionActive = deviceData.OverheatProtection?.Active;
+                    const holidayModeEnabled = deviceData.HolidayMode?.Enabled;
+                    const holidayModeActive = deviceData.HolidayMode?.Active;
 
                     //device control
                     const hideVaneControls = deviceData.HideVaneControls ?? false;
@@ -1283,14 +1284,14 @@ class DeviceAta extends EventEmitter {
                     //update presets state
                     if (this.presets.length > 0) {
                         this.presets.forEach((preset, i) => {
-                            const presetData = presetsOnServer.find(p => p.ID === preset.Id);
+                            const presetData = presetsOnServer.find(p => p[presetsIdKey] === preset.id);
 
-                            preset.state = presetData ? (presetData.Power === power
-                                && presetData[setTempKey] === setTemperature
+                            preset.state = presetData ? (this.accountType === 'melcloudhome' ? scheduleEnabled && presetData.Enabled : (presetData.Power === power
+                                && presetData.SetTemperature === setTemperature
                                 && presetData.OperationMode === operationMode
                                 && presetData.VaneHorizontalDirection === vaneHorizontalDirection
                                 && presetData.VaneVerticalDirection === vaneVerticalDirection
-                                && presetData[fanKey] === setFanSpeed) : false;
+                                && presetData.FanSpeed === setFanSpeed)) : false;
 
                             const characteristicType = preset.characteristicType;
                             this.presetsServices?.[i]?.updateCharacteristic(characteristicType, preset.state);

package/src/deviceatw.js

@@ -1055,8 +1055,9 @@ class DeviceAtw extends EventEmitter {
             if (this.presets.length > 0) {
                 if (this.logDebug) this.emit('debug', `Prepare presets services`);
                 this.presetsServices = [];
+                const presetsIdKey = this.accountType === 'melcloud' ? 'ID' : 'Id';
                 this.presets.forEach((preset, i) => {
-                    const presetData = presetsOnServer.find(p => p.ID === preset.Id);
+                    const presetData = presetsOnServer.find(p => p[presetsIdKey] === preset.id);
 
                     //get preset name
                     const name = preset.name;
@@ -1330,11 +1331,14 @@ class DeviceAtw extends EventEmitter {
                     this.deviceData = deviceData;
 
                     //keys
+                    const presetsKey = this.accountType === 'melcloud' ? 'Presets' : 'Schedule';
+                    const presetsIdKey = accountType === 'melcloud' ? 'ID' : 'Id';
                     const tempStepKey = this.accountType === 'melcloud' ? 'TemperatureIncrement' : 'HasHalfDegreeIncrements';
                     const errorKey = this.accountType === 'melcloud' ? 'HasError' : 'IsInError';
 
                     //presets
-                    const presetsOnServer = deviceData.Presets ?? [];
+                    const scheduleEnabled = deviceData.ScheduleEnabled;
+                    const presetsOnServer = deviceData[presetsKey] ?? [];
 
                     //device info
                     const hasHeatPump = ![1, 2, 3, 4, 5, 6, 7, 15].includes(this.hideZone);
@@ -1436,6 +1440,7 @@ class DeviceAtw extends EventEmitter {
                         useFahrenheit: this.useFahrenheit,
                         temperatureUnit: TemperatureDisplayUnits[this.useFahrenheit],
                         isInError: isInError,
+                        scheduleEnabled: scheduleEnabled,
                         zones: [],
                         zonesSensors: []
                     };
@@ -1816,9 +1821,9 @@ class DeviceAtw extends EventEmitter {
                     //update presets state
                     if (this.presets.length > 0) {
                         this.presets.forEach((preset, i) => {
-                            const presetData = presetsOnServer.find(p => p.ID === preset.Id);
+                            const presetData = presetsOnServer.find(p => p[presetsIdKey] === preset.id);
 
-                            preset.state = presetData ? (presetData.Power === power
+                            preset.state = presetData ? (this.accountType === 'melcloudhome' ? scheduleEnabled && presetData.Enabled : (presetData.Power === power
                                 && presetData.EcoHotWater === ecoHotWater
                                 && presetData.OperationModeZone1 === operationModeZone1
                                 && presetData.OperationModeZone2 === operationModeZone2
@@ -1829,7 +1834,7 @@ class DeviceAtw extends EventEmitter {
                                 && presetData.SetHeatFlowTemperatureZone1 === setHeatFlowTemperatureZone1
                                 && presetData.SetHeatFlowTemperatureZone2 === setHeatFlowTemperatureZone2
                                 && presetData.SetCoolFlowTemperatureZone1 === setCoolFlowTemperatureZone1
-                                && presetData.SetCoolFlowTemperatureZone2 === setCoolFlowTemperatureZone2) : false;
+                                && presetData.SetCoolFlowTemperatureZone2 === setCoolFlowTemperatureZone2)) : false;
 
                             const characteristicType = preset.characteristicType;
                             this.presetsServices?.[i]?.updateCharacteristic(characteristicType, preset.state);

package/src/deviceerv.js

@@ -675,7 +675,7 @@ class DeviceErv extends EventEmitter {
                 if (this.logDebug) this.emit('debug', `Prepare presets services`);
                 this.presetsServices = [];
                 this.presets.forEach((preset, i) => {
-                    const presetData = presetsOnServer.find(p => p.ID === preset.Id);
+                    const presetData = presetsOnServer.find(p => p.ID === preset.id);
 
                     //get preset name
                     const name = preset.name;
@@ -703,14 +703,14 @@ class DeviceErv extends EventEmitter {
                                         deviceData.Device.Power = presetData.Power;
                                         deviceData.Device.OperationMode = presetData.OperationMode;
                                         deviceData.Device.VentilationMode = presetData.VentilationMode;
-                                        deviceData.Device.SetFanSpeed = presetData.FanSpeed;
+                                        deviceData.Device.SetFanSpeed = presetData.SetFanSpeed;
                                         break;
                                     case false:
                                         deviceData.Device.SetTemperature = preset.previousSettings.SetTemperature;
                                         deviceData.Device.Power = preset.previousSettings.Power;
                                         deviceData.Device.OperationMode = preset.previousSettings.OperationMode;
                                         deviceData.Device.VentilationMode = preset.previousSettings.VentilationMode;
-                                        deviceData.Device.SetFanSpeed = preset.previousSettings.FanSpeed;
+                                        deviceData.Device.SetFanSpeed = preset.previousSettings.SetFanSpeed;
                                         break;
                                 };
 
@@ -876,12 +876,15 @@ class DeviceErv extends EventEmitter {
                     this.deviceData = deviceData;
 
                     //keys
+                    const presetsKey = this.accountType === 'melcloud' ? 'Presets' : 'Schedule';
+                    const presetsIdKey = accountType === 'melcloud' ? 'ID' : 'Id';
                     const fanKey = this.accountType === 'melcloud' ? 'FanSpeed' : 'SetFanSpeed';
                     const tempStepKey = this.accountType === 'melcloud' ? 'TemperatureIncrement' : 'HasHalfDegreeIncrements';
                     const errorKey = this.accountType === 'melcloud' ? 'HasError' : 'IsInError';
 
-                    //presets
-                    const presetsOnServer = deviceData.Presets ?? [];
+                    //presets schedule
+                    const scheduleEnabled = deviceData.ScheduleEnabled;
+                    const presetsOnServer = deviceData[presetsKey] ?? [];
 
                     //device control
                     const hideRoomTemperature = deviceData.HideRoomTemperature;
@@ -970,7 +973,8 @@ class DeviceErv extends EventEmitter {
                         maxTempCoolDry: maxTempCoolDry,
                         useFahrenheit: this.useFahrenheit,
                         temperatureUnit: TemperatureDisplayUnits[this.useFahrenheit],
-                        isInError: isInError
+                        isInError: isInError,
+                        scheduleEnabled: scheduleEnabled
                     };
 
                     //ventilation mode - 0, HEAT, 2, COOL, 4, 5, 6, FAN, AUTO
@@ -1113,13 +1117,13 @@ class DeviceErv extends EventEmitter {
                     //update presets state
                     if (this.presets.length > 0) {
                         this.presets.forEach((preset, i) => {
-                            const presetData = presetsOnServer.find(p => p.ID === preset.Id);
+                            const presetData = presetsOnServer.find(p => p[presetsIdKey] === preset.id);
 
-                            preset.state = presetData ? (presetData.Power === power
+                            preset.state = presetData ? (this.accountType === 'melcloudhome' ? scheduleEnabled && presetData.Enabled : (presetData.Power === power
                                 && presetData.SetTemperature === setTemperature
                                 && presetData.OperationMode === operationMode
                                 && presetData.VentilationMode === ventilationMode
-                                && presetData.FanSpeed === setFanSpeed) : false;
+                                && presetData.SetFanSpeed === setFanSpeed)) : false;
 
                             const characteristicType = preset.characteristicType;
                             this.presetsServices?.[i]?.updateCharacteristic(characteristicType, preset.state);

package/src/melcloud.js

@@ -236,11 +236,18 @@ class MelCloud extends EventEmitter {
 
             const devices = buildingsList.flatMap(building => {
                 // Funkcja kapitalizująca klucze obiektu
-                // Rekurencyjna funkcja kapitalizująca klucze w całym obiekcie (łącznie z tablicami)
+                const capitalizeKeys = obj =>
+                    Object.fromEntries(
+                        Object.entries(obj).map(([key, value]) => [
+                            key.charAt(0).toUpperCase() + key.slice(1),
+                            value
+                        ])
+                    );
+
+                // Rekurencyjna kapitalizacja kluczy w obiekcie lub tablicy
                 const capitalizeKeysDeep = obj => {
-                    if (Array.isArray(obj)) {
-                        return obj.map(item => capitalizeKeysDeep(item));
-                    } else if (obj && typeof obj === 'object' && obj.constructor === Object) {
+                    if (Array.isArray(obj)) return obj.map(capitalizeKeysDeep);
+                    if (obj && typeof obj === 'object') {
                         return Object.fromEntries(
                             Object.entries(obj).map(([key, value]) => [
                                 key.charAt(0).toUpperCase() + key.slice(1),
@@ -252,7 +259,8 @@ class MelCloud extends EventEmitter {
                 };
 
                 // Funkcja tworząca finalny obiekt Device
-                const createDevice = (device, type, headers = {}) => {
+                const createDevice = (device, type) => {
+                    // Settings już kapitalizowane w nazwach
                     const settingsArray = device.Settings || [];
 
                     const settingsObject = Object.fromEntries(
@@ -260,23 +268,34 @@ class MelCloud extends EventEmitter {
                             let parsedValue = value;
                             if (value === "True") parsedValue = true;
                             else if (value === "False") parsedValue = false;
-                            else if (!isNaN(Number(value)) && value.trim() !== "") parsedValue = Number(value);
+                            else if (!isNaN(value) && value !== "") parsedValue = Number(value);
 
                             const key = name.charAt(0).toUpperCase() + name.slice(1);
                             return [key, parsedValue];
                         })
                     );
 
+                    // Scal Capabilities + Settings + DeviceType w Device
                     const deviceObject = {
-                        ...capitalizeKeysDeep(device.Capabilities || {}),
+                        ...capitalizeKeys(device.Capabilities || {}),
                         ...settingsObject,
                         DeviceType: type
                     };
 
+                    // Kapitalizacja brakujących obiektów/tablic
+                    if (device.FrostProtection) device.FrostProtection = { ...capitalizeKeys(device.FrostProtection || {}) };
+                    if (device.OverheatProtection) device.OverheatProtection = { ...capitalizeKeys(device.OverheatProtection || {}) };
+                    if (device.HolidayMode) device.HolidayMode = { ...capitalizeKeys(device.HolidayMode || {}) };
+
+                    if (Array.isArray(device.Schedule)) {
+                        device.Schedule = device.Schedule.map(capitalizeKeysDeep);
+                    }
+
+                    // Usuń stare pola Settings i Capabilities
                     const { Settings, Capabilities, Id, GivenDisplayName, ...rest } = device;
 
                     return {
-                        ...capitalizeKeysDeep(rest),
+                        ...rest,
                         Type: type,
                         DeviceID: Id,
                         DeviceName: GivenDisplayName,
@@ -285,11 +304,10 @@ class MelCloud extends EventEmitter {
                     };
                 };
 
-                // Mapowanie urządzeń
                 return [
-                    ...(building.airToAirUnits || []).map(d => createDevice(capitalizeKeysDeep(d), 0)),
-                    ...(building.airToWaterUnits || []).map(d => createDevice(capitalizeKeysDeep(d), 1)),
-                    ...(building.airToVentilationUnits || []).map(d => createDevice(capitalizeKeysDeep(d), 3))
+                    ...(building.airToAirUnits || []).map(d => createDevice(capitalizeKeys(d), 0)),
+                    ...(building.airToWaterUnits || []).map(d => createDevice(capitalizeKeys(d), 1)),
+                    ...(building.airToVentilationUnits || []).map(d => createDevice(capitalizeKeys(d), 3))
                 ];
             });