matterbridge-example-dynamic-platform 1.2.2 → 1.2.3

package/CHANGELOG.md

@@ -8,10 +8,27 @@ If you like this project and find it useful, please consider giving it a star on
   <img src="bmc-button.svg" alt="Buy me a coffee" width="120">
 </a>
 
-## [1.2.2] - 2025-05-19
+## [1.2.3] - 2025-05-25
+
+### Added
+
+- [platform]: Added a cover device with both lift and tilt (supported by the Home app).
+- [platform]: Added evse (EV charger) device type (not supported by the Home app).
 
 ### Changed
 
+- [package]: Require matterbridge 3.0.5.
+- [package]: Updated package.
+- [package]: Updated dependencies.
+
+<a href="https://www.buymeacoffee.com/luligugithub">
+  <img src="bmc-button.svg" alt="Buy me a coffee" width="80">
+</a>
+
+## [1.2.2] - 2025-05-19
+
+### Added
+
 - [package]: Added waterHeater device type (not supported by Alexa and Apple Home)
 
 ### Changed

package/README.md

@@ -16,7 +16,7 @@
 
 Matterbridge dynamic platform example plugin is a template to develop your own plugin using the dynamic platform.
 
-It exposes 38 devices:
+It exposes 41 virtual devices:
 
 - a switch with onOff cluster
 - a light with onOff
@@ -26,7 +26,8 @@ It exposes 38 devices:
 - a light with onOff, levelControl and colorControl (with XY and CT) clusters
 - a light with onOff, levelControl and colorControl (with CT only) clusters
 - an outlet (plug) with onOff cluster
-- a cover with windowCovering cluster
+- a cover with windowCovering cluster and lift feature
+- a cover with windowCovering cluster and both lift and tilt features
 - a lock with doorLock cluster
 - a thermo autoMode (i.e. with Auto Heat and Cool features) with thermostat cluster and 3 sub endpoints with flowMeasurement cluster, temperatureMeasurement cluster
   and relativeHumidityMeasurement cluster (to show how to create a composed device with sub endpoints)
@@ -58,6 +59,7 @@ It exposes 38 devices:
 - an extractor Hood device (supported by SmartThings, Alexa and Home Assistant)
 - a cooktop device (supported by SmartThings, Alexa and Home Assistant)
 - a water heater device (supported by SmartThings and Home Assistant)
+- a car charger device (supported by Home Assistant)
 
 All these devices continuously change state and position. The plugin also shows how to use all the command handlers (you can control all the devices), how to subscribe to attributes and how to trigger events.
 

package/dist/appliances.js

@@ -1,7 +1,7 @@
 import { MatterbridgeEndpoint, MatterbridgeServer, MatterbridgeOnOffServer, laundryWasher, laundryDryer, dishwasher, refrigerator, temperatureControlledCabinetCooler, oven, temperatureControlledCabinetHeater, microwaveOven, extractorHood, cooktop, cookSurface, powerSource, } from 'matterbridge';
-import { ClusterBehavior, PositionTag, RefrigeratorTag } from 'matterbridge/matter';
-import { OperationalState, TemperatureControl, DishwasherMode, LaundryWasherControls, LaundryWasherMode, LaundryDryerControls, OvenMode, ModeBase, RefrigeratorAndTemperatureControlledCabinetMode, MicrowaveOvenMode, MicrowaveOvenControl, OvenCavityOperationalState, } from 'matterbridge/matter/clusters';
-import { DishwasherAlarmServer, LaundryDryerControlsServer, LaundryWasherControlsServer, MicrowaveOvenControlBehavior, MicrowaveOvenModeServer, TemperatureControlBehavior, } from 'matterbridge/matter/behaviors';
+import { PositionTag, RefrigeratorTag } from 'matterbridge/matter';
+import { OperationalState, TemperatureControl, DishwasherMode, LaundryWasherControls, LaundryWasherMode, LaundryDryerControls, OvenMode, ModeBase, RefrigeratorAndTemperatureControlledCabinetMode, MicrowaveOvenMode, MicrowaveOvenControl, } from 'matterbridge/matter/clusters';
+import { DishwasherAlarmServer, DishwasherModeBehavior, LaundryDryerControlsServer, LaundryWasherControlsServer, LaundryWasherModeBehavior, MicrowaveOvenControlBehavior, MicrowaveOvenModeServer, OvenCavityOperationalStateBehavior, OvenModeBehavior, RefrigeratorAndTemperatureControlledCabinetModeBehavior, TemperatureControlBehavior, } from 'matterbridge/matter/behaviors';
 export class Appliances extends MatterbridgeEndpoint {
     constructor(deviceType, name, serial) {
         super([deviceType, powerSource], { uniqueStorageKey: `${name}-${serial}` }, true);
@@ -112,7 +112,7 @@ export class Appliances extends MatterbridgeEndpoint {
         }
     }
     createDefaultOvenCavityOperationalStateClusterServer(operationalState = OperationalState.OperationalStateEnum.Stopped) {
-        this.behaviors.require(OvenCavityOperationalStateServer, {
+        this.behaviors.require(MatterbridgeOvenCavityOperationalStateServer, {
             phaseList: [],
             currentPhase: null,
             operationalStateList: [
@@ -126,7 +126,7 @@ export class Appliances extends MatterbridgeEndpoint {
         return this;
     }
     static createDefaultRefrigeratorAndTemperatureControlledCabinetModeClusterServer(endpoint, currentMode) {
-        endpoint.behaviors.require(RefrigeratorAndTemperatureControlledCabinetModeServer, {
+        endpoint.behaviors.require(MatterbridgeRefrigeratorAndTemperatureControlledCabinetModeServer, {
             supportedModes: [
                 { label: 'Auto', mode: 0, modeTags: [{ value: RefrigeratorAndTemperatureControlledCabinetMode.ModeTag.Auto }] },
                 { label: 'RapidCool', mode: 1, modeTags: [{ value: RefrigeratorAndTemperatureControlledCabinetMode.ModeTag.RapidCool }] },
@@ -137,7 +137,7 @@ export class Appliances extends MatterbridgeEndpoint {
         return endpoint;
     }
     static createDefaultOvenModeClusterServer(endpoint, currentMode) {
-        endpoint.behaviors.require(OvenModeServer, {
+        endpoint.behaviors.require(MatterbridgeOvenModeServer, {
             supportedModes: [
                 { label: 'Bake', mode: 1, modeTags: [{ value: OvenMode.ModeTag.Bake }] },
                 { label: 'Convection', mode: 2, modeTags: [{ value: OvenMode.ModeTag.Convection }] },
@@ -155,7 +155,7 @@ export class Appliances extends MatterbridgeEndpoint {
         return endpoint;
     }
     createDefaultDishwasherModeClusterServer(currentMode) {
-        this.behaviors.require(DishwasherModeServer, {
+        this.behaviors.require(MatterbridgeDishwasherModeServer, {
             supportedModes: [
                 { label: 'Light', mode: 1, modeTags: [{ value: DishwasherMode.ModeTag.Light }] },
                 { label: 'Normal', mode: 2, modeTags: [{ value: DishwasherMode.ModeTag.Normal }] },
@@ -166,7 +166,7 @@ export class Appliances extends MatterbridgeEndpoint {
         return this;
     }
     createDefaultLaundryWasherModeClusterServer(currentMode) {
-        this.behaviors.require(LaundryWasherModeServer, {
+        this.behaviors.require(MatterbridgeLaundryWasherModeServer, {
             supportedModes: [
                 { label: 'Delicate', mode: 1, modeTags: [{ value: LaundryWasherMode.ModeTag.Delicate }] },
                 { label: 'Normal', mode: 2, modeTags: [{ value: LaundryWasherMode.ModeTag.Normal }] },
@@ -350,8 +350,7 @@ class MatterbridgeMicrowaveOvenControlServer extends MicrowaveOvenControlBehavio
         }
     }
 }
-export const OvenCavityOperationalStateBehavior = ClusterBehavior.withInterface().for(OvenCavityOperationalState.Cluster);
-export class OvenCavityOperationalStateServer extends OvenCavityOperationalStateBehavior {
+export class MatterbridgeOvenCavityOperationalStateServer extends OvenCavityOperationalStateBehavior {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer).deviceCommand;
         device.log.info('OvenCavityOperationalStateServer initialized: setting operational state to Stopped and operational error to No error');
@@ -377,8 +376,7 @@ export class OvenCavityOperationalStateServer extends OvenCavityOperationalState
         };
     }
 }
-export const RefrigeratorAndTemperatureControlledCabinetModeBehavior = ClusterBehavior.withInterface().for(RefrigeratorAndTemperatureControlledCabinetMode.Cluster);
-class RefrigeratorAndTemperatureControlledCabinetModeServer extends RefrigeratorAndTemperatureControlledCabinetModeBehavior {
+class MatterbridgeRefrigeratorAndTemperatureControlledCabinetModeServer extends RefrigeratorAndTemperatureControlledCabinetModeBehavior {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer).deviceCommand;
         device.log.info('MatterbridgeRefrigeratorAndTemperatureControlledCabinetModeServer initialized: setting currentMode to 1');
@@ -398,8 +396,7 @@ class RefrigeratorAndTemperatureControlledCabinetModeServer extends Refrigerator
         }
     }
 }
-export const OvenModeBehavior = ClusterBehavior.withInterface().for(OvenMode.Cluster);
-class OvenModeServer extends OvenModeBehavior {
+class MatterbridgeOvenModeServer extends OvenModeBehavior {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer).deviceCommand;
         device.log.info('OvenModeServer initialized: setting currentMode to 3');
@@ -419,8 +416,7 @@ class OvenModeServer extends OvenModeBehavior {
         }
     }
 }
-export const DishwasherModeBehavior = ClusterBehavior.withInterface().for(DishwasherMode.Cluster);
-class DishwasherModeServer extends DishwasherModeBehavior {
+class MatterbridgeDishwasherModeServer extends DishwasherModeBehavior {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer).deviceCommand;
         device.log.info('DishwasherModeServer initialized: setting currentMode to 3');
@@ -448,8 +444,7 @@ class DishwasherModeServer extends DishwasherModeBehavior {
         }
     }
 }
-export const LaundryWasherModeBehavior = ClusterBehavior.withInterface().for(LaundryWasherMode.Cluster);
-class LaundryWasherModeServer extends LaundryWasherModeBehavior {
+class MatterbridgeLaundryWasherModeServer extends LaundryWasherModeBehavior {
     initialize() {
         const device = this.endpoint.stateOf(MatterbridgeServer).deviceCommand;
         device.log.info('LaundryWasherModeServer initialized: setting currentMode to 3');

package/dist/platform.js

@@ -1,7 +1,7 @@
-import { MatterbridgeEndpoint, MatterbridgeDynamicPlatform, airQualitySensor, bridgedNode, colorTemperatureLight, coverDevice, dimmableLight, doorLockDevice, fanDevice, flowSensor, humiditySensor, onOffLight, onOffOutlet, onOffSwitch, powerSource, rainSensor, smokeCoAlarm, temperatureSensor, thermostatDevice, waterFreezeDetector, waterLeakDetector, airPurifier, pumpDevice, waterValve, genericSwitch, airConditioner, laundryWasher, cooktop, extractorHood, microwaveOven, oven, refrigerator, dishwasher, laundryDryer, onOffMountedSwitch, dimmableMountedSwitch, extendedColorLight, RoboticVacuumCleaner, WaterHeater, } from 'matterbridge';
+import { MatterbridgeEndpoint, MatterbridgeDynamicPlatform, airQualitySensor, bridgedNode, colorTemperatureLight, coverDevice, dimmableLight, doorLockDevice, fanDevice, flowSensor, humiditySensor, onOffLight, onOffOutlet, onOffSwitch, powerSource, rainSensor, smokeCoAlarm, temperatureSensor, thermostatDevice, waterFreezeDetector, waterLeakDetector, airPurifier, pumpDevice, waterValve, genericSwitch, airConditioner, laundryWasher, cooktop, extractorHood, microwaveOven, oven, refrigerator, dishwasher, laundryDryer, onOffMountedSwitch, dimmableMountedSwitch, extendedColorLight, RoboticVacuumCleaner, WaterHeater, Evse, } from 'matterbridge';
 import { isValidBoolean, isValidNumber } from 'matterbridge/utils';
 import { LocationTag } from 'matterbridge/matter';
-import { PowerSource, BooleanState, OnOff, LevelControl, AirQuality, CarbonDioxideConcentrationMeasurement, CarbonMonoxideConcentrationMeasurement, FlowMeasurement, ColorControl, DoorLock, FanControl, FormaldehydeConcentrationMeasurement, NitrogenDioxideConcentrationMeasurement, OzoneConcentrationMeasurement, Pm10ConcentrationMeasurement, Pm1ConcentrationMeasurement, Pm25ConcentrationMeasurement, RadonConcentrationMeasurement, RelativeHumidityMeasurement, RelativeHumidityMeasurementCluster, SmokeCoAlarm, TemperatureMeasurement, Thermostat, ThermostatCluster, TotalVolatileOrganicCompoundsConcentrationMeasurement, WindowCovering, } from 'matterbridge/matter/clusters';
+import { PowerSource, BooleanState, OnOff, LevelControl, AirQuality, CarbonDioxideConcentrationMeasurement, CarbonMonoxideConcentrationMeasurement, FlowMeasurement, ColorControl, DoorLock, FanControl, FormaldehydeConcentrationMeasurement, NitrogenDioxideConcentrationMeasurement, OzoneConcentrationMeasurement, Pm10ConcentrationMeasurement, Pm1ConcentrationMeasurement, Pm25ConcentrationMeasurement, RadonConcentrationMeasurement, RelativeHumidityMeasurement, RelativeHumidityMeasurementCluster, SmokeCoAlarm, TemperatureMeasurement, Thermostat, ThermostatCluster, TotalVolatileOrganicCompoundsConcentrationMeasurement, WindowCovering, EnergyEvseMode, } from 'matterbridge/matter/clusters';
 import { Appliances } from './appliances.js';
 export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatform {
     switch;
@@ -14,7 +14,8 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
     lightHS;
     lightCT;
     outlet;
-    cover;
+    coverLift;
+    coverLiftTilt;
     lock;
     thermoAuto;
     thermoHeat;
@@ -34,7 +35,8 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
     momentarySwitch;
     latchingSwitch;
     vacuum;
-    heater;
+    waterHeater;
+    evse;
     switchInterval;
     lightInterval;
     outletInterval;
@@ -57,8 +59,8 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
     fanModeLookup = ['Off', 'Low', 'Medium', 'High', 'On', 'Auto', 'Smart'];
     constructor(matterbridge, log, config) {
         super(matterbridge, log, config);
-        if (this.verifyMatterbridgeVersion === undefined || typeof this.verifyMatterbridgeVersion !== 'function' || !this.verifyMatterbridgeVersion('3.0.3')) {
-            throw new Error(`This plugin requires Matterbridge version >= "3.0.3". Please update Matterbridge from ${this.matterbridge.matterbridgeVersion} to the latest version in the frontend.`);
+        if (this.verifyMatterbridgeVersion === undefined || typeof this.verifyMatterbridgeVersion !== 'function' || !this.verifyMatterbridgeVersion('3.0.5')) {
+            throw new Error(`This plugin requires Matterbridge version >= "3.0.5". Please update Matterbridge from ${this.matterbridge.matterbridgeVersion} to the latest version in the frontend.`);
         }
         this.log.info('Initializing platform:', this.config.name);
         if (config.whiteList === undefined)
@@ -432,41 +434,76 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             await this.outlet?.setAttribute(OnOff.Cluster.id, 'onOff', false, this.outlet?.log);
             this.outlet?.log.info('Command off called');
         });
-        this.cover = new MatterbridgeEndpoint([coverDevice, bridgedNode, powerSource], { uniqueStorageKey: 'Cover' }, this.config.debug)
+        this.coverLift = new MatterbridgeEndpoint([coverDevice, bridgedNode, powerSource], { uniqueStorageKey: 'CoverLift' }, this.config.debug)
             .createDefaultIdentifyClusterServer()
             .createDefaultGroupsClusterServer()
-            .createDefaultBridgedDeviceBasicInformationClusterServer('Cover', '0x01020564', 0xfff1, 'Matterbridge', 'Matterbridge Cover', parseInt(this.version.replace(/\D/g, '')), this.version === '' ? 'Unknown' : this.version, parseInt(this.matterbridge.matterbridgeVersion.replace(/\D/g, '')), this.matterbridge.matterbridgeVersion)
+            .createDefaultBridgedDeviceBasicInformationClusterServer('Cover lift', 'CL01020564', 0xfff1, 'Matterbridge', 'Matterbridge Cover', parseInt(this.version.replace(/\D/g, '')), this.version === '' ? 'Unknown' : this.version, parseInt(this.matterbridge.matterbridgeVersion.replace(/\D/g, '')), this.matterbridge.matterbridgeVersion)
             .createDefaultWindowCoveringClusterServer()
             .createDefaultPowerSourceRechargeableBatteryClusterServer(86);
-        this.setSelectDevice(this.cover.serialNumber ?? '', this.cover.deviceName ?? '', undefined, 'hub');
-        if (this.validateDevice(this.cover.deviceName ?? '')) {
-            await this.registerDevice(this.cover);
-            this.bridgedDevices.set(this.cover.deviceName ?? '', this.cover);
+        this.setSelectDevice(this.coverLift.serialNumber ?? '', this.coverLift.deviceName ?? '', undefined, 'hub');
+        if (this.validateDevice(this.coverLift.deviceName ?? '')) {
+            await this.registerDevice(this.coverLift);
+            this.bridgedDevices.set(this.coverLift.deviceName ?? '', this.coverLift);
         }
         else {
-            this.cover = undefined;
+            this.coverLift = undefined;
         }
-        this.cover?.subscribeAttribute(WindowCovering.Cluster.id, 'mode', (newValue, oldValue) => {
-            this.cover?.log.info(`Attribute mode changed from ${oldValue} to ${newValue}. Reverse: ${newValue.motorDirectionReversed}. Calibration: ${newValue.calibrationMode}. Maintenance: ${newValue.maintenanceMode}. LED: ${newValue.ledFeedback}`);
-        }, this.cover.log);
-        this.cover?.addCommandHandler('identify', async ({ request: { identifyTime } }) => {
-            this.cover?.log.info(`Command identify called identifyTime:${identifyTime}`);
+        this.coverLift?.addCommandHandler('identify', async ({ request: { identifyTime } }) => {
+            this.coverLift?.log.info(`Command identify called identifyTime:${identifyTime}`);
         });
-        this.cover?.addCommandHandler('stopMotion', async () => {
-            await this.cover?.setWindowCoveringTargetAsCurrentAndStopped();
-            this.cover?.log.info(`Command stopMotion called`);
+        this.coverLift?.addCommandHandler('stopMotion', async () => {
+            await this.coverLift?.setWindowCoveringTargetAsCurrentAndStopped();
+            this.coverLift?.log.info(`Command stopMotion called`);
         });
-        this.cover?.addCommandHandler('downOrClose', async () => {
-            await this.cover?.setWindowCoveringCurrentTargetStatus(10000, 10000, WindowCovering.MovementStatus.Stopped);
-            this.cover?.log.info(`Command downOrClose called`);
+        this.coverLift?.addCommandHandler('downOrClose', async () => {
+            await this.coverLift?.setWindowCoveringCurrentTargetStatus(10000, 10000, WindowCovering.MovementStatus.Stopped);
+            this.coverLift?.log.info(`Command downOrClose called`);
         });
-        this.cover?.addCommandHandler('upOrOpen', async () => {
-            await this.cover?.setWindowCoveringCurrentTargetStatus(0, 0, WindowCovering.MovementStatus.Stopped);
-            this.cover?.log.info(`Command upOrOpen called`);
+        this.coverLift?.addCommandHandler('upOrOpen', async () => {
+            await this.coverLift?.setWindowCoveringCurrentTargetStatus(0, 0, WindowCovering.MovementStatus.Stopped);
+            this.coverLift?.log.info(`Command upOrOpen called`);
         });
-        this.cover?.addCommandHandler('goToLiftPercentage', async ({ request: { liftPercent100thsValue } }) => {
-            await this.cover?.setWindowCoveringCurrentTargetStatus(liftPercent100thsValue, liftPercent100thsValue, WindowCovering.MovementStatus.Stopped);
-            this.cover?.log.info(`Command goToLiftPercentage ${liftPercent100thsValue} called`);
+        this.coverLift?.addCommandHandler('goToLiftPercentage', async ({ request: { liftPercent100thsValue } }) => {
+            await this.coverLift?.setWindowCoveringCurrentTargetStatus(liftPercent100thsValue, liftPercent100thsValue, WindowCovering.MovementStatus.Stopped);
+            this.coverLift?.log.info(`Command goToLiftPercentage ${liftPercent100thsValue} called`);
+        });
+        this.coverLiftTilt = new MatterbridgeEndpoint([coverDevice, bridgedNode, powerSource], { uniqueStorageKey: 'CoverLiftTilt' }, this.config.debug)
+            .createDefaultIdentifyClusterServer()
+            .createDefaultGroupsClusterServer()
+            .createDefaultBridgedDeviceBasicInformationClusterServer('Cover lift and tilt', 'CLT01020554', 0xfff1, 'Matterbridge', 'Matterbridge Cover', parseInt(this.version.replace(/\D/g, '')), this.version === '' ? 'Unknown' : this.version, parseInt(this.matterbridge.matterbridgeVersion.replace(/\D/g, '')), this.matterbridge.matterbridgeVersion)
+            .createDefaultLiftTiltWindowCoveringClusterServer()
+            .createDefaultPowerSourceRechargeableBatteryClusterServer(86);
+        this.setSelectDevice(this.coverLiftTilt.serialNumber ?? '', this.coverLiftTilt.deviceName ?? '', undefined, 'hub');
+        if (this.validateDevice(this.coverLiftTilt.deviceName ?? '')) {
+            await this.registerDevice(this.coverLiftTilt);
+            this.bridgedDevices.set(this.coverLiftTilt.deviceName ?? '', this.coverLiftTilt);
+        }
+        else {
+            this.coverLiftTilt = undefined;
+        }
+        this.coverLiftTilt?.addCommandHandler('identify', async ({ request: { identifyTime } }) => {
+            this.coverLiftTilt?.log.info(`Command identify called identifyTime:${identifyTime}`);
+        });
+        this.coverLiftTilt?.addCommandHandler('stopMotion', async () => {
+            await this.coverLiftTilt?.setWindowCoveringTargetAsCurrentAndStopped();
+            this.coverLiftTilt?.log.info(`Command stopMotion called`);
+        });
+        this.coverLiftTilt?.addCommandHandler('downOrClose', async () => {
+            await this.coverLiftTilt?.setWindowCoveringCurrentTargetStatus(10000, 10000, WindowCovering.MovementStatus.Stopped);
+            this.coverLiftTilt?.log.info(`Command downOrClose called`);
+        });
+        this.coverLiftTilt?.addCommandHandler('upOrOpen', async () => {
+            await this.coverLiftTilt?.setWindowCoveringCurrentTargetStatus(0, 0, WindowCovering.MovementStatus.Stopped);
+            this.coverLiftTilt?.log.info(`Command upOrOpen called`);
+        });
+        this.coverLiftTilt?.addCommandHandler('goToLiftPercentage', async ({ request: { liftPercent100thsValue } }) => {
+            await this.coverLiftTilt?.setWindowCoveringCurrentTargetStatus(liftPercent100thsValue, liftPercent100thsValue, WindowCovering.MovementStatus.Stopped);
+            this.coverLiftTilt?.log.info(`Command goToLiftPercentage ${liftPercent100thsValue} called`);
+        });
+        this.coverLiftTilt?.addCommandHandler('goToTiltPercentage', async ({ request: { tiltPercent100thsValue } }) => {
+            const position = this.coverLiftTilt?.getAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', this.coverLiftTilt?.log);
+            await this.coverLiftTilt?.setWindowCoveringTargetAndCurrentPosition(position, tiltPercent100thsValue);
+            this.coverLiftTilt?.log.info(`Command goToTiltPercentage ${tiltPercent100thsValue} called`);
         });
         this.lock = new MatterbridgeEndpoint([doorLockDevice, bridgedNode, powerSource], { uniqueStorageKey: 'Lock' }, this.config.debug)
             .createDefaultIdentifyClusterServer()
@@ -538,14 +575,14 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
                 this.thermoAuto?.log.info('Set occupiedCoolingSetpoint:', setpoint);
             }
         });
-        this.thermoAuto?.subscribeAttribute(ThermostatCluster.id, 'systemMode', async (value) => {
+        await this.thermoAuto?.subscribeAttribute(ThermostatCluster.id, 'systemMode', (value) => {
             const lookupSystemMode = ['Off', 'Auto', '', 'Cool', 'Heat', 'EmergencyHeat', 'Precooling', 'FanOnly', 'Dry', 'Sleep'];
             this.thermoAuto?.log.info('Subscribe systemMode called with:', lookupSystemMode[value]);
         }, this.thermoAuto.log);
-        this.thermoAuto?.subscribeAttribute(ThermostatCluster.id, 'occupiedHeatingSetpoint', async (value) => {
+        await this.thermoAuto?.subscribeAttribute(ThermostatCluster.id, 'occupiedHeatingSetpoint', (value) => {
             this.thermoAuto?.log.info('Subscribe occupiedHeatingSetpoint called with:', value / 100);
         }, this.thermoAuto.log);
-        this.thermoAuto?.subscribeAttribute(ThermostatCluster.id, 'occupiedCoolingSetpoint', async (value) => {
+        await this.thermoAuto?.subscribeAttribute(ThermostatCluster.id, 'occupiedCoolingSetpoint', (value) => {
             this.thermoAuto?.log.info('Subscribe occupiedCoolingSetpoint called with:', value / 100);
         }, this.thermoAuto.log);
         this.thermoHeat = new MatterbridgeEndpoint([thermostatDevice, bridgedNode, powerSource], { uniqueStorageKey: 'Thermostat (Heat)' }, this.config.debug)
@@ -580,11 +617,11 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.thermoHeat?.addCommandHandler('triggerEffect', async ({ request: { effectIdentifier, effectVariant } }) => {
             this.thermoHeat?.log.info(`Command identify called effectIdentifier ${effectIdentifier} effectVariant ${effectVariant}`);
         });
-        this.thermoHeat?.subscribeAttribute(ThermostatCluster.id, 'systemMode', async (value) => {
+        await this.thermoHeat?.subscribeAttribute(ThermostatCluster.id, 'systemMode', (value) => {
             const lookupSystemMode = ['Off', 'Auto', '', 'Cool', 'Heat', 'EmergencyHeat', 'Precooling', 'FanOnly', 'Dry', 'Sleep'];
             this.thermoHeat?.log.info('Subscribe systemMode called with:', lookupSystemMode[value]);
         }, this.thermoHeat.log);
-        this.thermoHeat?.subscribeAttribute(ThermostatCluster.id, 'occupiedHeatingSetpoint', async (value) => {
+        await this.thermoHeat?.subscribeAttribute(ThermostatCluster.id, 'occupiedHeatingSetpoint', (value) => {
             this.thermoHeat?.log.info('Subscribe occupiedHeatingSetpoint called with:', value / 100);
         }, this.thermoHeat.log);
         this.thermoCool = new MatterbridgeEndpoint([thermostatDevice, bridgedNode, powerSource], { uniqueStorageKey: 'Thermostat (Cool)' }, this.config.debug)
@@ -607,11 +644,11 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.thermoCool?.addCommandHandler('triggerEffect', async ({ request: { effectIdentifier, effectVariant } }) => {
             this.thermoCool?.log.info(`Command identify called effectIdentifier ${effectIdentifier} effectVariant ${effectVariant}`);
         });
-        this.thermoCool?.subscribeAttribute(ThermostatCluster.id, 'systemMode', async (value) => {
+        await this.thermoCool?.subscribeAttribute(ThermostatCluster.id, 'systemMode', (value) => {
             const lookupSystemMode = ['Off', 'Auto', '', 'Cool', 'Heat', 'EmergencyHeat', 'Precooling', 'FanOnly', 'Dry', 'Sleep'];
             this.thermoCool?.log.info('Subscribe systemMode called with:', lookupSystemMode[value]);
         }, this.thermoCool.log);
-        this.thermoCool?.subscribeAttribute(ThermostatCluster.id, 'occupiedCoolingSetpoint', async (value) => {
+        await this.thermoCool?.subscribeAttribute(ThermostatCluster.id, 'occupiedCoolingSetpoint', (value) => {
             this.thermoCool?.log.info('Subscribe occupiedCoolingSetpoint called with:', value / 100);
         }, this.thermoCool.log);
         this.airPurifier = new MatterbridgeEndpoint([airPurifier, temperatureSensor, humiditySensor, bridgedNode, powerSource], { uniqueStorageKey: 'Air purifier' }, this.config.debug)
@@ -634,31 +671,28 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.airPurifier?.addCommandHandler('identify', async ({ request: { identifyTime } }) => {
             this.airPurifier?.log.info(`Command identify called identifyTime:${identifyTime}`);
         });
-        this.airPurifier?.subscribeAttribute(FanControl.Cluster.id, 'fanMode', async (newValue, oldValue) => {
-            this.fan?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]}`);
+        await this.airPurifier?.subscribeAttribute(FanControl.Cluster.id, 'fanMode', (newValue, oldValue, context) => {
+            this.airPurifier?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]} context: ${context.offline === true ? 'offline' : 'online'}`);
             if (newValue === FanControl.FanMode.Off) {
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 0, this.airPurifier?.log);
+                this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 0, this.airPurifier?.log);
             }
             else if (newValue === FanControl.FanMode.Low) {
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 33, this.airPurifier?.log);
+                this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 33, this.airPurifier?.log);
             }
             else if (newValue === FanControl.FanMode.Medium) {
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 66, this.airPurifier?.log);
+                this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 66, this.airPurifier?.log);
             }
             else if (newValue === FanControl.FanMode.High) {
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.airPurifier?.log);
+                this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.airPurifier?.log);
             }
             else if (newValue === FanControl.FanMode.On) {
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.airPurifier?.log);
-            }
-            else if (newValue === FanControl.FanMode.Auto) {
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 50, this.airPurifier?.log);
+                this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.airPurifier?.log);
             }
         }, this.airPurifier.log);
-        this.airPurifier?.subscribeAttribute(FanControl.Cluster.id, 'percentSetting', async (newValue, oldValue) => {
-            this.fan?.log.info(`Percent setting changed from ${oldValue} to ${newValue}`);
+        await this.airPurifier?.subscribeAttribute(FanControl.Cluster.id, 'percentSetting', (newValue, oldValue, context) => {
+            this.airPurifier?.log.info(`Percent setting changed from ${oldValue} to ${newValue} context: ${context.offline === true ? 'offline' : 'online'}`);
             if (isValidNumber(newValue, 0, 100))
-                await this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', newValue, this.airPurifier?.log);
+                this.airPurifier?.setAttribute(FanControl.Cluster.id, 'percentCurrent', newValue, this.airPurifier?.log);
         }, this.airPurifier.log);
         this.airConditioner = new MatterbridgeEndpoint([airConditioner, bridgedNode, powerSource], { uniqueStorageKey: 'Air Conditioner' }, this.config.debug)
             .createDefaultBridgedDeviceBasicInformationClusterServer('Air Conditioner', '0x96382864AC', 0xfff1, 'Matterbridge', 'Matterbridge Air Conditioner', parseInt(this.version.replace(/\D/g, '')), this.version === '' ? 'Unknown' : this.version, parseInt(this.matterbridge.matterbridgeVersion.replace(/\D/g, '')), this.matterbridge.matterbridgeVersion)
@@ -756,42 +790,42 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         else {
             this.fan = undefined;
         }
-        this.fan?.subscribeAttribute(FanControl.Cluster.id, 'fanMode', async (newValue, oldValue) => {
-            this.fan?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]}`);
+        await this.fan?.subscribeAttribute(FanControl.Cluster.id, 'fanMode', (newValue, oldValue, context) => {
+            this.fan?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]} context: ${context.offline === true ? 'offline' : 'online'}`);
             if (newValue === FanControl.FanMode.Off) {
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 0, this.fan?.log);
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 0, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 0, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 0, this.fan?.log);
             }
             else if (newValue === FanControl.FanMode.Low) {
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 33, this.fan?.log);
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 33, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 33, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 33, this.fan?.log);
             }
             else if (newValue === FanControl.FanMode.Medium) {
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 66, this.fan?.log);
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 66, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 66, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 66, this.fan?.log);
             }
             else if (newValue === FanControl.FanMode.High) {
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 100, this.fan?.log);
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 100, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.fan?.log);
             }
             else if (newValue === FanControl.FanMode.On) {
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 100, this.fan?.log);
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 100, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 100, this.fan?.log);
             }
             else if (newValue === FanControl.FanMode.Auto) {
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 50, this.fan?.log);
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 50, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentSetting', 50, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', 50, this.fan?.log);
             }
         }, this.fan.log);
-        this.fan?.subscribeAttribute(FanControl.Cluster.id, 'percentSetting', async (newValue, oldValue) => {
-            this.fan?.log.info(`Percent setting changed from ${oldValue} to ${newValue}`);
+        await this.fan?.subscribeAttribute(FanControl.Cluster.id, 'percentSetting', (newValue, oldValue, context) => {
+            this.fan?.log.info(`Percent setting changed from ${oldValue} to ${newValue} context: ${context.offline === true ? 'offline' : 'online'}`);
             if (isValidNumber(newValue, 0, 100))
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', newValue, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'percentCurrent', newValue, this.fan?.log);
         }, this.fan.log);
-        this.fan?.subscribeAttribute(FanControl.Cluster.id, 'speedSetting', async (newValue, oldValue) => {
-            this.fan?.log.info(`Speed setting changed from ${oldValue} to ${newValue}`);
+        await this.fan?.subscribeAttribute(FanControl.Cluster.id, 'speedSetting', (newValue, oldValue, context) => {
+            this.fan?.log.info(`Speed setting changed from ${oldValue} to ${newValue} context: ${context.offline === true ? 'offline' : 'online'}`);
             if (isValidNumber(newValue, 0, 100))
-                await this.fan?.setAttribute(FanControl.Cluster.id, 'speedCurrent', newValue, this.fan?.log);
+                this.fan?.setAttribute(FanControl.Cluster.id, 'speedCurrent', newValue, this.fan?.log);
         }, this.fan.log);
         this.waterLeak = new MatterbridgeEndpoint([waterLeakDetector, bridgedNode, powerSource], { uniqueStorageKey: 'Water leak detector' }, this.config.debug)
             .createDefaultBridgedDeviceBasicInformationClusterServer('Water leak detector', 'serial_98745631222', 0xfff1, 'Matterbridge', 'Matterbridge WaterLeakDetector', parseInt(this.version.replace(/\D/g, '')), this.version === '' ? 'Unknown' : this.version, parseInt(this.matterbridge.matterbridgeVersion.replace(/\D/g, '')), this.matterbridge.matterbridgeVersion)
@@ -933,11 +967,22 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
                 this.bridgedDevices.set(robot.deviceName ?? '', robot);
             }
         }
-        const heater = new WaterHeater('Water Heater', '3456177820');
-        this.setSelectDevice(heater.serialNumber ?? '', heater.deviceName ?? '', undefined, 'hub');
-        if (this.validateDevice(heater.deviceName ?? '')) {
-            await this.registerDevice(heater);
-            this.bridgedDevices.set(heater.deviceName ?? '', heater);
+        this.waterHeater = new WaterHeater('Water Heater', '3456177820');
+        this.setSelectDevice(this.waterHeater.serialNumber ?? '', this.waterHeater.deviceName ?? '', undefined, 'hub');
+        if (this.validateDevice(this.waterHeater.deviceName ?? '')) {
+            await this.registerDevice(this.waterHeater);
+            this.bridgedDevices.set(this.waterHeater.deviceName ?? '', this.waterHeater);
+        }
+        this.evse = new Evse('Evse', '3456127820', 1, [
+            { label: 'On demand', mode: 1, modeTags: [{ value: EnergyEvseMode.ModeTag.Manual }] },
+            { label: 'Scheduled', mode: 2, modeTags: [{ value: EnergyEvseMode.ModeTag.TimeOfUse }] },
+            { label: 'Solar Charging', mode: 3, modeTags: [{ value: EnergyEvseMode.ModeTag.SolarCharging }] },
+            { label: 'Solar Charging Scheduled', mode: 4, modeTags: [{ value: EnergyEvseMode.ModeTag.SolarCharging }, { value: EnergyEvseMode.ModeTag.TimeOfUse }] },
+        ]);
+        this.setSelectDevice(this.evse.serialNumber ?? '', this.evse.deviceName ?? '', undefined, 'hub');
+        if (this.validateDevice(this.evse.deviceName ?? '')) {
+            await this.registerDevice(this.evse);
+            this.bridgedDevices.set(this.evse.deviceName ?? '', this.evse);
         }
         const laundryWasherDevice = new Appliances(laundryWasher, 'Laundry Washer', '1234567890');
         this.setSelectDevice(laundryWasherDevice.serialNumber ?? '', laundryWasherDevice.deviceName ?? '', undefined, 'hub');
@@ -1091,17 +1136,17 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
                 }
             }, 60 * 1000 + 300);
         }
-        await this.cover?.setWindowCoveringTargetAsCurrentAndStopped();
-        this.cover?.log.info('Set cover initial targetPositionLiftPercent100ths = currentPositionLiftPercent100ths and operationalStatus to Stopped.');
+        await this.coverLift?.setWindowCoveringTargetAsCurrentAndStopped();
+        this.coverLift?.log.info('Set cover initial targetPositionLiftPercent100ths = currentPositionLiftPercent100ths and operationalStatus to Stopped.');
         if (this.config.useInterval) {
             this.coverInterval = setInterval(async () => {
-                let position = this.cover?.getAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', this.cover.log);
+                let position = this.coverLift?.getAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', this.coverLift.log);
                 if (isValidNumber(position, 0, 10000)) {
                     position = position > 9000 ? 0 : position + 1000;
-                    await this.cover?.setAttribute(WindowCovering.Cluster.id, 'targetPositionLiftPercent100ths', position, this.cover.log);
-                    await this.cover?.setAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', position, this.cover.log);
-                    await this.cover?.setAttribute(WindowCovering.Cluster.id, 'operationalStatus', { global: WindowCovering.MovementStatus.Stopped, lift: WindowCovering.MovementStatus.Stopped, tilt: WindowCovering.MovementStatus.Stopped }, this.cover.log);
-                    this.cover?.log.info(`Set cover current and target positionLiftPercent100ths to ${position} and operationalStatus to Stopped`);
+                    await this.coverLift?.setAttribute(WindowCovering.Cluster.id, 'targetPositionLiftPercent100ths', position, this.coverLift.log);
+                    await this.coverLift?.setAttribute(WindowCovering.Cluster.id, 'currentPositionLiftPercent100ths', position, this.coverLift.log);
+                    await this.coverLift?.setAttribute(WindowCovering.Cluster.id, 'operationalStatus', { global: WindowCovering.MovementStatus.Stopped, lift: WindowCovering.MovementStatus.Stopped, tilt: WindowCovering.MovementStatus.Stopped }, this.coverLift.log);
+                    this.coverLift?.log.info(`Set cover current and target positionLiftPercent100ths to ${position} and operationalStatus to Stopped`);
                 }
             }, 60 * 1000 + 400);
         }
@@ -1276,26 +1321,27 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         await surface2?.setAttribute(OnOff.Cluster.id, 'onOff', true, surface2.log);
         surface2?.log.info(`Set Surface 2 onOff only OnOff to on`);
         if (this.config.useInterval) {
+            this.genericSwitchLastEvent = 'Release';
             this.genericSwitchInterval = setInterval(async () => {
                 if (this.genericSwitchLastEvent === 'Release') {
-                    await this.momentarySwitch?.triggerSwitchEvent('Single', this.momentarySwitch?.log);
                     this.genericSwitchLastEvent = 'Single';
+                    await this.momentarySwitch?.triggerSwitchEvent('Single', this.momentarySwitch?.log);
                 }
                 else if (this.genericSwitchLastEvent === 'Single') {
-                    await this.momentarySwitch?.triggerSwitchEvent('Double', this.momentarySwitch?.log);
                     this.genericSwitchLastEvent = 'Double';
+                    await this.momentarySwitch?.triggerSwitchEvent('Double', this.momentarySwitch?.log);
                 }
                 else if (this.genericSwitchLastEvent === 'Double') {
-                    await this.momentarySwitch?.triggerSwitchEvent('Long', this.momentarySwitch?.log);
                     this.genericSwitchLastEvent = 'Long';
+                    await this.momentarySwitch?.triggerSwitchEvent('Long', this.momentarySwitch?.log);
                 }
                 else if (this.genericSwitchLastEvent === 'Long') {
-                    await this.latchingSwitch?.triggerSwitchEvent('Press', this.latchingSwitch?.log);
                     this.genericSwitchLastEvent = 'Press';
+                    await this.latchingSwitch?.triggerSwitchEvent('Press', this.latchingSwitch?.log);
                 }
                 else if (this.genericSwitchLastEvent === 'Press') {
-                    await this.latchingSwitch?.triggerSwitchEvent('Release', this.latchingSwitch?.log);
                     this.genericSwitchLastEvent = 'Release';
+                    await this.latchingSwitch?.triggerSwitchEvent('Release', this.latchingSwitch?.log);
                 }
             }, 60 * 1000 + 1900);
         }

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge-example-dynamic-platform",
-      "version": "1.2.2",
+      "version": "1.2.3",
       "license": "MIT",
       "dependencies": {
         "node-ansi-logger": "3.0.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Matterbridge dynamic plugin",
   "author": "https://github.com/Luligu",
   "license": "MIT",
@@ -24,7 +24,11 @@
     "matter",
     "matter.js",
     "example",
-    "plugin"
+    "plugin",
+    "dynamic",
+    "platform",
+    "virtual device",
+    "virtual devices"
   ],
   "engines": {
     "node": ">=18.0.0 <19.0.0 || >=20.0.0 <21.0.0 || >=22.0.0"