homebridge-melcloud-control 4.0.0-beta.500 → 4.0.0-beta.502

package/CHANGELOG.md

@@ -12,17 +12,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - v1 After update to v1 and above from v0 the devices need to be added to the Home app again and the old unresponsive remove!!! This devices will be removed from all automations and scenes!!!
 - v2 After update to v2 from v1 only RESTFull and MQTT config settings need to be updated in config.
   - v2.4 and above require upcomming homebridge v2
-- v3 After update to v3 the plugin need to be configured using Config UI X.
-  - do not configure it manually, always using Config UI X
+- v3 After update to v3 the plugin need to be configured using Homebridge UI.
+  - do not configure it manually, always using Homebridge UI
   - required Homebridge v2.0.0 and above
+- v4 Added support for MELCloud Home.
+  - do not use Homebridge UI > v5.5.0 because of brack config.json
 
-## [4.0.0] - (xx.10.2025)
+## [4.0.0] - (xx.11.2025)
 
 ## Changes
 
 - added support for MELCloud Home [#215](https://github.com/grzegorz914/homebridge-melcloud-control/issues/215)
-- redme updated
 - config schema updated
+- redme updated
 - cleanup
 
 ## [3.9.5] - (02.09.2025)

package/README.md

@@ -277,21 +277,19 @@ Homebridge plugin for Air Conditioner, Heat Pump and Energy Recovery Ventilation
 | `refreshInterval` | Here set the background account data refresh time in (sec), default `120s`. |
 | `log{}` | Log object. |
 | `log.deviceInfo` | If enabled, log device info will be displayed by every connections device to the network. |
-| `log.sSuccess` | If enabled, success log will be displayed in console. |
+| `log.success` | If enabled, success log will be displayed in console. |
 | `log.info` | If enabled, info log will be displayed in console. |
 | `log.warn` | If enabled, warn log will be displayed in console. |
 | `log.error` | If enabled, error log will be displayed in console. |
 | `log.debug` | If enabled, debug log will be displayed in console. |
 | `restFul{}` | RSTful object. |
 | `restFul.enable` | If enabled, RESTful server will start automatically and respond to any path request. |
-| `restFul.debug` | If enabled, deep log will be present in homebridge console for RESTFul server. |
 | `mqtt{}` | MQTT object. |
 | `mqtt.enable` | If enabled, MQTT Broker will start automatically and publish all awailable PV data. |
 | `mqtt.host` | Here set the `IP Address` or `Hostname` for MQTT Broker. |
 | `mqtt.port` | Here set the `Port` for MQTT Broker, default 1883. |
 | `mqtt.clientId` | Here optional set the `Client Id` of MQTT Broker. |
 | `mqtt.prefix` | Here set the `Prefix` for `Topic` or leave empty. |
-| `mqtt.debug` | If enabled, deep log will be present in homebridge console for MQTT. |
 | `mqtt.auth{}` | MQTT authorization object. |
 | `mqtt.auth.enable` | Here enable authorization for MQTT Broker. |
 | `mqtt.auth.user` | Here set the MQTT Broker user. |

package/index.js

@@ -109,8 +109,6 @@ class MelCloudPlatform {
 									if (logLevel.warn) log.warn(`${accountName}, ${accountInfo.Info}`);
 									return;
 								}
-
-								const contextKey = accountInfo.ContextKey;
 								const useFahrenheit = accountInfo.UseFahrenheit;
 
 								//check devices list
@@ -183,7 +181,7 @@ class MelCloudPlatform {
 
 									configuredDevice.on('melCloud', async (key, value) => {
 										try {
-											accountInfo[key] = value;
+											accountInfo.LoginData[key] = value;
 											await melCloud.send(accountInfo);
 										} catch (error) {
 											if (logLevel.error) log.error(`${accountName}, ${deviceTypeText}, ${deviceName}, ${error.message ?? error}.`);
@@ -202,7 +200,7 @@ class MelCloudPlatform {
 										if (logLevel.success) log.success(`${accountName}, ${deviceTypeText}, ${deviceName}, Published as external accessory.`);
 
 										//start impulse generators\
-										const timmers = accountType === 'melcloudhome' ? [{ name: 'connect', sampling: 300000 }, { name: 'checkDevicesList', sampling: deviceRefreshInterval }] : [{ name: 'checkDevicesList', sampling: refreshInterval }];
+										const timmers = accountType === 'melcloudhome' ? [{ name: 'connect', sampling: 600000 }, { name: 'checkDevicesList', sampling: deviceRefreshInterval }] : [{ name: 'checkDevicesList', sampling: refreshInterval }];
 										await melCloud.impulseGenerator.state(true, timmers);
 										await configuredDevice.startStopImpulseGenerator(true, [{ name: 'checkState', sampling: deviceRefreshInterval }]);
 

package/package.json

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

package/src/deviceatw.js

@@ -1315,10 +1315,10 @@ class DeviceAtw extends EventEmitter {
                     //accessory info
                     this.manufacturer = manufacturer;
                     this.model = modelIndoor ? modelIndoor : modelOutdoor ? modelOutdoor : `${this.deviceTypeText} ${this.deviceId}`;
-                    this.serialNumber = serialNumber;
-                    this.firmwareRevision = firmwareAppVersion;
+                    this.serialNumber = serialNumber.toString();
+                    this.firmwareRevision = firmwareAppVersion.toString();
 
-                    this.informationService?.setCharacteristic(Characteristic.FirmwareRevision, firmwareAppVersion);
+                    this.informationService?.setCharacteristic(Characteristic.FirmwareRevision, this.firmwareAppVersion);
                 })
                 .on('deviceState', async (deviceData) => {
                     this.deviceData = deviceData;

package/src/deviceerv.js

@@ -864,10 +864,10 @@ class DeviceErv extends EventEmitter {
                     //accessory info
                     this.manufacturer = manufacturer;
                     this.model = modelIndoor ? modelIndoor : modelOutdoor ? modelOutdoor : `${this.deviceTypeText} ${this.deviceId}`;
-                    this.serialNumber = serialNumber;
-                    this.firmwareRevision = firmwareAppVersion;
+                    this.serialNumber = serialNumber.toString();
+                    this.firmwareRevision = firmwareAppVersion.toString();
 
-                    this.informationService?.setCharacteristic(Characteristic.FirmwareRevision, firmwareAppVersion);
+                    this.informationService?.setCharacteristic(Characteristic.FirmwareRevision, this.firmwareAppVersion);
                 })
                 .on('deviceState', async (deviceData) => {
                     this.deviceData = deviceData;

package/src/melcloud.js

@@ -140,7 +140,7 @@ class MelCloud extends EventEmitter {
         if (this.logDebug) this.emit('debug', `Connecting to MELCloud`);
 
         try {
-            const accountInfo = { State: false, Info: '', ContextKey: null, UseFahrenheit: false }
+            const accountInfo = { State: false, Info: '', LoginData: null, ContextKey: null, UseFahrenheit: false }
             const axiosInstance = axios.create({
                 method: 'POST',
                 baseURL: ApiUrls.BaseURL,
@@ -486,12 +486,12 @@ class MelCloud extends EventEmitter {
                 baseURL: ApiUrls.BaseURL,
                 timeout: 15000,
                 headers: {
-                    'X-MitsContextKey': this.contextKey,
+                    'X-MitsContextKey': accountInfo.ContextKey,
                     'content-type': 'application/json'
                 }
             });
 
-            const options = { data: accountInfo };
+            const options = { data: accountInfo.LoginData };
             await axiosInstance.post(ApiUrls.UpdateApplicationOptions, options);
             await this.functions.saveData(this.accountFile, accountInfo);
             return true;

package/src/melcloudata.js

@@ -7,7 +7,7 @@ import { ApiUrls, ApiUrlsHome, AirConditioner } from './constants.js';
 class MelCloudAta extends EventEmitter {
     constructor(account, device, devicesFile, defaultTempsFile) {
         super();
-        this.accountType = account.type
+        this.accountType = account.type;
         this.deviceId = device.id;
         this.logWarn = device.log?.warn;
         this.logError = device.log?.error;
@@ -50,7 +50,6 @@ class MelCloudAta extends EventEmitter {
 
     async checkState() {
         try {
-
             //read device info from file
             const devicesData = await this.functions.readData(this.devicesFile, true);
 
@@ -121,7 +120,6 @@ class MelCloudAta extends EventEmitter {
                 return acc;
             }, { indoor: {}, outdoor: {} });
 
-
             //display info if units are not configured in MELCloud service
             if (unitsCount === 0) {
                 if (this.logDebug) this.emit('debug', `Units are not configured in MELCloud service`);

package/src/melcloudatw.js

@@ -7,7 +7,7 @@ import { ApiUrls, ApiUrlsHome, HeatPump } from './constants.js';
 class MelCloudAtw extends EventEmitter {
     constructor(account, device, devicesFile, defaultTempsFile) {
         super();
-        this.accountType = account.type
+        this.accountType = account.type;
         this.deviceId = device.id;
         this.logWarn = device.log?.warn;
         this.logError = device.log?.error;
@@ -58,10 +58,14 @@ class MelCloudAtw extends EventEmitter {
                 return null;
             }
             const deviceData = devicesData.find(device => device.DeviceID === this.deviceId);
+            if (this.accountType === 'melcloudhome') {
+                deviceData.SerialNumber = deviceData.Device.DeviceID || '4.0.0';
+                deviceData.Device.FirmwareAppVersion = '4.0.0';
+            }
             if (this.logDebug) this.emit('debug', `Device Data: ${JSON.stringify(deviceData, null, 2)}`);
 
             //device info
-            const serialNumber = deviceData.SerialNumber ?? 'Undefined';
+            const serialNumber = deviceData.SerialNumber;
 
             //device
             const device = deviceData.Device ?? {};
@@ -91,7 +95,7 @@ class MelCloudAtw extends EventEmitter {
             const setCoolFlowTemperatureZone2 = device.SetCoolFlowTemperatureZone2;
             const idleZone1 = device.IdleZone1 ?? false;
             const idleZone2 = device.IdleZone2 ?? false;
-            const firmwareAppVersion = device.FirmwareAppVersion?.toString() ?? 'Undefined';
+            const firmwareAppVersion = device.FirmwareAppVersion;
             const hasZone2 = device.HasZone2 ?? false;
 
             //units
@@ -99,55 +103,22 @@ class MelCloudAtw extends EventEmitter {
             const unitsCount = units.length;
             const manufacturer = 'Mitsubishi';
 
-            //indoor
-            let idIndoor = 0;
-            let deviceIndoor = 0;
-            let serialNumberIndoor = 'Undefined';
-            let modelNumberIndoor = 0;
-            let modelIndoor = false;
-            let typeIndoor = 0;
-
-            //outdoor
-            let idOutdoor = 0;
-            let deviceOutdoor = 0;
-            let serialNumberOutdoor = 'Undefined';
-            let modelNumberOutdoor = 0;
-            let modelOutdoor = false;
-            let typeOutdoor = 0;
-
-            //units array
-            for (const unit of units) {
-                const unitId = unit.ID;
-                const unitDevice = unit.Device;
-                const unitSerialNumber = unit.SerialNumber ?? 'Undefined';
-                const unitModelNumber = unit.ModelNumber;
-                const unitModel = unit.Model ?? false;
-                const unitType = unit.UnitType;
-                const unitIsIndoor = unit.IsIndoor ?? false;
-
-                switch (unitIsIndoor) {
-                    case true:
-                        idIndoor = unitId;
-                        deviceIndoor = unitDevice;
-                        serialNumberIndoor = unitSerialNumber;
-                        modelNumberIndoor = unitModelNumber;
-                        modelIndoor = unitModel;
-                        typeIndoor = unitType;
-                        break;
-                    case false:
-                        idOutdoor = unitId;
-                        deviceOutdoor = unitDevice;
-                        serialNumberOutdoor = unitSerialNumber;
-                        modelNumberOutdoor = unitModelNumber;
-                        modelOutdoor = unitModel;
-                        typeOutdoor = unitType;
-                        break;
-                }
-            }
+            const { indoor, outdoor } = units.reduce((acc, unit) => {
+                const target = unit.IsIndoor ? 'indoor' : 'outdoor';
+                acc[target] = {
+                    id: unit.ID,
+                    device: unit.Device,
+                    serialNumber: unit.SerialNumber ?? 'Undefined',
+                    modelNumber: unit.ModelNumber ?? 0,
+                    model: unit.Model ?? false,
+                    type: unit.UnitType ?? 0
+                };
+                return acc;
+            }, { indoor: {}, outdoor: {} });
 
             //display info if units are not configured in MELCloud service
             if (unitsCount === 0) {
-                this.emit('message', `Units are not configured in MELCloud service`);
+                if (this.logDebug) this.emit('debug', `Units are not configured in MELCloud service`);
             };
 
             const deviceState = {
@@ -195,7 +166,7 @@ class MelCloudAtw extends EventEmitter {
             this.deviceState = deviceState;
 
             //emit info
-            this.emit('deviceInfo', manufacturer, modelIndoor, modelOutdoor, serialNumber, firmwareAppVersion, hasHotWaterTank, hasZone2);
+            this.emit('deviceInfo', manufacturer, indoor.model, outdoor.model, serialNumber, firmwareAppVersion, hasHotWaterTank, hasZone2);
 
             //emit state
             this.emit('deviceState', deviceData);

package/src/melclouderv.js

@@ -7,7 +7,7 @@ import { ApiUrls, ApiUrlsHome, Ventilation } from './constants.js';
 class MelCloudErv extends EventEmitter {
     constructor(account, device, devicesFile, defaultTempsFile) {
         super();
-        this.accountType = account.type
+        this.accountType = account.type;
         this.deviceId = device.id;
         this.logWarn = device.log?.warn;
         this.logError = device.log?.error;
@@ -58,13 +58,17 @@ class MelCloudErv extends EventEmitter {
                 return null;
             }
             const deviceData = devicesData.find(device => device.DeviceID === this.deviceId);
+            if (this.accountType === 'melcloudhome') {
+                deviceData.SerialNumber = deviceData.Device.DeviceID || '4.0.0';
+                deviceData.Device.FirmwareAppVersion = '4.0.0';
+            }
             if (this.logDebug) this.emit('debug', `Device Data: ${JSON.stringify(deviceData, null, 2)}`);
 
             //presets
             const hideRoomTemperature = deviceData.HideRoomTemperature ?? false;
             const hideSupplyTemperature = deviceData.HideSupplyTemperature ?? false;
             const hideOutdoorTemperature = deviceData.HideOutdoorTemperature ?? false;
-            const serialNumber = deviceData.SerialNumber ?? 'Undefined';
+            const serialNumber = deviceData.SerialNumber;
 
             //device
             const device = deviceData.Device ?? {};
@@ -87,62 +91,29 @@ class MelCloudErv extends EventEmitter {
             const ventilationMode = device.VentilationMode; //Lossnay, Bypass, Auto
             const defaultCoolingSetTemperature = device.DefaultCoolingSetTemperature ?? 23;
             const defaultHeatingSetTemperature = device.DefaultHeatingSetTemperature ?? 21;
-            const firmwareAppVersion = device.FirmwareAppVersion?.toString() ?? 'Undefined';
+            const firmwareAppVersion = device.FirmwareAppVersion;
 
             //units
             const units = Array.isArray(device.Units) ? device.Units : [];
             const unitsCount = units.length;
             const manufacturer = 'Mitsubishi';
 
-            //indoor
-            let idIndoor = 0;
-            let deviceIndoor = 0;
-            let serialNumberIndoor = 'Undefined';
-            let modelNumberIndoor = 0;
-            let modelIndoor = false;
-            let typeIndoor = 0;
-
-            //outdoor
-            let idOutdoor = 0;
-            let deviceOutdoor = 0;
-            let serialNumberOutdoor = 'Undefined';
-            let modelNumberOutdoor = 0;
-            let modelOutdoor = false;
-            let typeOutdoor = 0;
-
-            //units array
-            for (const unit of units) {
-                const unitId = unit.ID;
-                const unitDevice = unit.Device;
-                const unitSerialNumber = unit.SerialNumber ?? 'Undefined';
-                const unitModelNumber = unit.ModelNumber;
-                const unitModel = unit.Model ?? false;
-                const unitType = unit.UnitType;
-                const unitIsIndoor = unit.IsIndoor ?? false;
-
-                switch (unitIsIndoor) {
-                    case true:
-                        idIndoor = unitId;
-                        deviceIndoor = unitDevice;
-                        serialNumberIndoor = unitSerialNumber;
-                        modelNumberIndoor = unitModelNumber;
-                        modelIndoor = unitModel;
-                        typeIndoor = unitType;
-                        break;
-                    case false:
-                        idOutdoor = unitId;
-                        deviceOutdoor = unitDevice;
-                        serialNumberOutdoor = unitSerialNumber;
-                        modelNumberOutdoor = unitModelNumber;
-                        modelOutdoor = unitModel;
-                        typeOutdoor = unitType;
-                        break;
-                }
-            }
+            const { indoor, outdoor } = units.reduce((acc, unit) => {
+                const target = unit.IsIndoor ? 'indoor' : 'outdoor';
+                acc[target] = {
+                    id: unit.ID,
+                    device: unit.Device,
+                    serialNumber: unit.SerialNumber ?? 'Undefined',
+                    modelNumber: unit.ModelNumber ?? 0,
+                    model: unit.Model ?? false,
+                    type: unit.UnitType ?? 0
+                };
+                return acc;
+            }, { indoor: {}, outdoor: {} });
 
             //display info if units are not configured in MELCloud service
             if (unitsCount === 0) {
-                this.emit('message', `Units are not configured in MELCloud service`);
+                if (this.logDebug) this.emit('debug', `Units are not configured in MELCloud service`);
             };
 
             const deviceState = {
@@ -187,7 +158,7 @@ class MelCloudErv extends EventEmitter {
             this.deviceState = deviceState;
 
             //emit info
-            this.emit('deviceInfo', manufacturer, modelIndoor, modelOutdoor, serialNumber, firmwareAppVersion);
+            this.emit('deviceInfo', manufacturer, indoor.model, outdoor.model, serialNumber, firmwareAppVersion);
 
             //emit state 
             this.emit('deviceState', deviceData);