matterbridge-example-dynamic-platform 3.0.3-dev-20260821-8d97cc8 → 3.0.3-dev-20260822-8bd7fd5

package/CHANGELOG.md

@@ -34,6 +34,13 @@ If you like this project and find it useful, please consider giving it a star on
 ### Breaking changes
 
 - [matterbridge]: Require matterbridge v.3.10.6 with matter v.1.6.0.
+- [fanControl]: Matterbridge v.3.10.6 now manages the compliant FanControl `fanMode` and `percentSetting` synchronization; plugin examples now only update `percentCurrent` as physical device feedback.
+
+### Added
+
+- [platform]: Add `closureSlidingGate` device with pedestrian opening support. Thanks Ludovic BOUÉ.
+- [platform]: Add `closureRoofWindow` device with ventilation opening support. Thanks Ludovic BOUÉ.
+- [devcontainer]: Upgrade the `Dev Container` to v.2.0.0, using the Node.js and Bun stack.
 
 ### Fixed
 

package/README.md

@@ -23,7 +23,7 @@
 
 Matterbridge dynamic platform example plugin is a template to develop your own plugin using the dynamic platform.
 
-It exposes 74 virtual devices:
+It exposes 76 virtual devices:
 
 - a door contact sensor
 - a motion sensor
@@ -99,6 +99,8 @@ It exposes 74 virtual devices:
 - an irrigation system with four zones (Matter 1.5.0)
 - a closure device (Matter 1.5.0, supported by SmartThings)
 - a closure device with Lift and Tilt panels (Matter 1.5.0, supported by SmartThings)
+- a sliding gate closure device with pedestrian opening support (Matter 1.5.0, supported by SmartThings)
+- a roof window closure device with ventilation opening support (Matter 1.5.0, supported by SmartThings)
 
 All these devices continuously change their state and position. The plugin also shows how to use all the command handlers (so you can control all the devices), how to subscribe to attributes, and how to trigger events.
 

package/dist/module.js

@@ -1,8 +1,9 @@
-import { aggregator, airPurifier, airQualitySensor, bridgedNode, colorTemperatureLight, contactSensor, windowCovering, dimmableLight, mountedDimmableLoadControl, dimmablePlugInUnit, doorLock, electricalSensor, extendedColorLight, fan, flowSensor, genericSwitch, getSemtag, humiditySensor, lightSensor, MatterbridgeDynamicPlatform, MatterbridgeEndpoint, modeSelect, occupancySensor, onOffLight, mountedOnOffControl, onOffPlugInUnit, onOffLightSwitch, powerSource, pressureSensor, pump, rainSensor, smokeCoAlarm, temperatureSensor, thermostat, waterFreezeDetector, waterLeakDetector, waterValve, } from 'matterbridge';
-import { AirConditioner, BasicVideoPlayer, BatteryStorage, Closure, Cooktop, Dishwasher, Evse, ExtractorHood, HeatPump, IrrigationSystem, LaundryDryer, LaundryWasher, MicrowaveOven, Oven, Refrigerator, RoboticVacuumCleaner, SoilSensor, SolarPower, Speaker, WaterHeater, } from 'matterbridge/devices';
+import { aggregator, airPurifier, airQualitySensor, bridgedNode, closure, colorTemperatureLight, contactSensor, windowCovering, dimmableLight, mountedDimmableLoadControl, dimmablePlugInUnit, doorLock, electricalSensor, extendedColorLight, fan, flowSensor, genericSwitch, getSemtag, humiditySensor, lightSensor, MatterbridgeDynamicPlatform, MatterbridgeEndpoint, modeSelect, occupancySensor, onOffLight, mountedOnOffControl, onOffPlugInUnit, onOffLightSwitch, powerSource, pressureSensor, pump, rainSensor, smokeCoAlarm, temperatureSensor, thermostat, waterFreezeDetector, waterLeakDetector, waterValve, } from 'matterbridge';
+import { AirConditioner, BasicVideoPlayer, BatteryStorage, Closure, Cooktop, Dishwasher, Evse, ExtractorHood, HeatPump, IrrigationSystem, LaundryDryer, LaundryWasher, MatterbridgeClosureControlServer, MicrowaveOven, Oven, Refrigerator, RoboticVacuumCleaner, SoilSensor, SolarPower, Speaker, WaterHeater, } from 'matterbridge/devices';
 import { debugStringify } from 'matterbridge/logger';
-import { ClosureCoveringTag, ClosurePanelTag, ClosureTag, CommonAreaNamespaceTag, CommonLocationTag, CommonNumberTag, CommonPositionTag, RefrigeratorTag, SwitchesTag, UINT16_MAX, UINT32_MAX, } from 'matterbridge/matter';
+import { ClosureCoveringTag, ClosurePanelTag, ClosureTag, ClosureWindowTag, CommonAreaNamespaceTag, CommonLocationTag, CommonNumberTag, CommonPositionTag, RefrigeratorTag, SwitchesTag, UINT16_MAX, UINT32_MAX, } from 'matterbridge/matter';
 import { AirQuality, BooleanState, BridgedDeviceBasicInformation, CarbonDioxideConcentrationMeasurement, CarbonMonoxideConcentrationMeasurement, ClosureControl, ClosureDimension, ColorControl, Descriptor, DeviceEnergyManagement, DoorLock, ElectricalEnergyMeasurement, ElectricalPowerMeasurement, EnergyEvse, EnergyEvseMode, FanControl, FlowMeasurement, FormaldehydeConcentrationMeasurement, Identify, IlluminanceMeasurement, LevelControl, NitrogenDioxideConcentrationMeasurement, OccupancySensing, OnOff, OperationalState, OvenMode, OzoneConcentrationMeasurement, Pm1ConcentrationMeasurement, Pm10ConcentrationMeasurement, Pm25ConcentrationMeasurement, PowerSource, PressureMeasurement, RadonConcentrationMeasurement, RelativeHumidityMeasurement, RvcCleanMode, RvcOperationalState, RvcRunMode, SmokeCoAlarm, TemperatureMeasurement, Thermostat, TotalVolatileOrganicCompoundsConcentrationMeasurement, WindowCovering, } from 'matterbridge/matter/clusters';
+import { ThreeLevelAuto } from 'matterbridge/matter/types';
 import { fireAndForget, getEnumDescription, isValidBoolean, isValidNumber, isValidObject, isValidString } from 'matterbridge/utils';
 function luxToMatter(lux) {
     if (!Number.isFinite(lux) || lux <= 0)
@@ -36,6 +37,8 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
     irrigationSystem;
     closureGarageDoor;
     closureVenetianBlind;
+    closureSlidingGate;
+    closureRoofWindow;
     select;
     climate;
     switch;
@@ -307,6 +310,96 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         };
         addClosurePanelStepSimulation(closureVenetianBlindLift);
         addClosurePanelStepSimulation(closureVenetianBlindTilt);
+        this.closureSlidingGate = new MatterbridgeEndpoint([closure, powerSource], {
+            id: 'SlidingGate-GAT000073',
+            tagList: [getSemtag(ClosureTag.Gate)],
+        }, this.config.debug)
+            .createDefaultIdentifyClusterServer()
+            .createDefaultBasicInformationClusterServer('Sliding Gate', 'GAT000073', 0xfff1, 'Matterbridge', 0x8000, 'Matterbridge Closure')
+            .createDefaultPowerSourceWiredClusterServer();
+        this.closureSlidingGate.behaviors.require(MatterbridgeClosureControlServer.with(ClosureControl.Feature.Positioning, ClosureControl.Feature.MotionLatching, ClosureControl.Feature.Speed, ClosureControl.Feature.Pedestrian), {
+            countdownTime: 0,
+            mainState: ClosureControl.MainState.Stopped,
+            currentErrorList: [],
+            overallCurrentState: { position: ClosureControl.CurrentPosition.FullyClosed, latch: true, speed: ThreeLevelAuto.Auto, secureState: true },
+            overallTargetState: { position: ClosureControl.TargetPosition.MoveToFullyClosed, latch: true, speed: ThreeLevelAuto.Auto },
+            latchControlModes: { remoteLatching: true, remoteUnlatching: true },
+        });
+        this.closureSlidingGate = await this.addDevice(this.closureSlidingGate);
+        let closureSlidingGateMoveTimeout;
+        this.closureSlidingGate?.addCommandHandler('ClosureControl.moveTo', ({ request: { position, latch, speed }, attributes }) => {
+            this.closureSlidingGate?.log.info(`Command moveTo called position:${position} latch:${latch} speed:${speed}`);
+            attributes.countdownTime = 1;
+            closureSlidingGateMoveTimeout = setTimeout(() => {
+                void (async () => {
+                    const targetState = this.closureSlidingGate?.getAttribute(ClosureControl, 'overallTargetState');
+                    if (targetState === undefined || targetState === null || targetState.position === undefined || targetState.position === null)
+                        return;
+                    await this.closureSlidingGate?.setAttribute(ClosureControl, 'countdownTime', 0, this.closureSlidingGate.log);
+                    await this.closureSlidingGate?.setAttribute(ClosureControl, 'mainState', ClosureControl.MainState.Stopped, this.closureSlidingGate.log);
+                    await this.closureSlidingGate?.setAttribute(ClosureControl, 'currentErrorList', [], this.closureSlidingGate.log);
+                    await this.closureSlidingGate?.setAttribute(ClosureControl, 'overallCurrentState', {
+                        position: closureTargetToCurrentPosition(targetState.position),
+                        latch: targetState.latch,
+                        speed: targetState.speed,
+                        secureState: targetState.position === ClosureControl.TargetPosition.MoveToFullyClosed && targetState.latch === true,
+                    }, this.closureSlidingGate.log);
+                    await this.closureSlidingGate?.setAttribute(ClosureControl, 'overallTargetState', targetState, this.closureSlidingGate.log);
+                    await this.closureSlidingGate?.triggerEvent(ClosureControl, 'movementCompleted', undefined, this.closureSlidingGate.log);
+                })();
+            }, 1000).unref();
+        });
+        this.closureSlidingGate?.addCommandHandler('ClosureControl.stop', ({ attributes }) => {
+            this.closureSlidingGate?.log.info('Command stop called');
+            attributes.countdownTime = 0;
+            clearTimeout(closureSlidingGateMoveTimeout);
+            closureSlidingGateMoveTimeout = undefined;
+        });
+        this.closureRoofWindow = new MatterbridgeEndpoint([closure, powerSource], {
+            id: 'RoofWindow-ROO000074',
+            tagList: [getSemtag(ClosureTag.Window), getSemtag(ClosureWindowTag.Roof)],
+        }, this.config.debug)
+            .createDefaultIdentifyClusterServer()
+            .createDefaultBasicInformationClusterServer('Roof Window', 'ROO000074', 0xfff1, 'Matterbridge', 0x8000, 'Matterbridge Closure')
+            .createDefaultPowerSourceWiredClusterServer();
+        this.closureRoofWindow.behaviors.require(MatterbridgeClosureControlServer.with(ClosureControl.Feature.Positioning, ClosureControl.Feature.MotionLatching, ClosureControl.Feature.Speed, ClosureControl.Feature.Ventilation), {
+            countdownTime: 0,
+            mainState: ClosureControl.MainState.Stopped,
+            currentErrorList: [],
+            overallCurrentState: { position: ClosureControl.CurrentPosition.FullyClosed, latch: true, speed: ThreeLevelAuto.Auto, secureState: true },
+            overallTargetState: { position: ClosureControl.TargetPosition.MoveToFullyClosed, latch: true, speed: ThreeLevelAuto.Auto },
+            latchControlModes: { remoteLatching: true, remoteUnlatching: true },
+        });
+        this.closureRoofWindow = await this.addDevice(this.closureRoofWindow);
+        let closureRoofWindowMoveTimeout;
+        this.closureRoofWindow?.addCommandHandler('ClosureControl.moveTo', ({ request: { position, latch, speed }, attributes }) => {
+            this.closureRoofWindow?.log.info(`Command moveTo called position:${position} latch:${latch} speed:${speed}`);
+            attributes.countdownTime = 1;
+            closureRoofWindowMoveTimeout = setTimeout(() => {
+                void (async () => {
+                    const targetState = this.closureRoofWindow?.getAttribute(ClosureControl, 'overallTargetState');
+                    if (targetState === undefined || targetState === null || targetState.position === undefined || targetState.position === null)
+                        return;
+                    await this.closureRoofWindow?.setAttribute(ClosureControl, 'countdownTime', 0, this.closureRoofWindow.log);
+                    await this.closureRoofWindow?.setAttribute(ClosureControl, 'mainState', ClosureControl.MainState.Stopped, this.closureRoofWindow.log);
+                    await this.closureRoofWindow?.setAttribute(ClosureControl, 'currentErrorList', [], this.closureRoofWindow.log);
+                    await this.closureRoofWindow?.setAttribute(ClosureControl, 'overallCurrentState', {
+                        position: closureTargetToCurrentPosition(targetState.position),
+                        latch: targetState.latch,
+                        speed: targetState.speed,
+                        secureState: targetState.position === ClosureControl.TargetPosition.MoveToFullyClosed && targetState.latch === true,
+                    }, this.closureRoofWindow.log);
+                    await this.closureRoofWindow?.setAttribute(ClosureControl, 'overallTargetState', targetState, this.closureRoofWindow.log);
+                    await this.closureRoofWindow?.triggerEvent(ClosureControl, 'movementCompleted', undefined, this.closureRoofWindow.log);
+                })();
+            }, 1000).unref();
+        });
+        this.closureRoofWindow?.addCommandHandler('ClosureControl.stop', ({ attributes }) => {
+            this.closureRoofWindow?.log.info('Command stop called');
+            attributes.countdownTime = 0;
+            clearTimeout(closureRoofWindowMoveTimeout);
+            closureRoofWindowMoveTimeout = undefined;
+        });
         this.climate = new MatterbridgeEndpoint([bridgedNode, powerSource], { id: 'Climate' }, this.config.debug)
             .createDefaultBridgedDeviceBasicInformationClusterServer('Climate', 'CLI00008', 0xfff1, 'Matterbridge', 'Matterbridge Climate')
             .createDefaultPowerSourceReplaceableBatteryClusterServer(90, PowerSource.BatChargeLevel.Ok, 2990, '2 x AA', 2, PowerSource.BatReplaceability.UserReplaceable)
@@ -1315,33 +1408,15 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         this.airPurifier?.addCommandHandler('identify', ({ request: { identifyTime } }) => {
             this.airPurifier?.log.info(`Command identify called identifyTime:${identifyTime}`);
         });
-        this.airPurifier?.subscribeAttribute(FanControl.id, 'fanMode', (newValue, oldValue, context) => void (async () => {
+        this.airPurifier?.subscribeAttribute(FanControl.id, 'fanMode', (newValue, oldValue, context) => {
             this.airPurifier?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
-            if (context.fabric === undefined)
-                return;
-            if (newValue === FanControl.FanMode.Off) {
-                await this.airPurifier?.setAttribute(FanControl.id, 'percentSetting', 0, this.airPurifier?.log);
-                await this.airPurifier?.setAttribute(FanControl.id, 'percentCurrent', 0, this.airPurifier?.log);
-            }
-            else if (newValue === FanControl.FanMode.Low) {
-                await this.airPurifier?.setAttribute(FanControl.id, 'percentSetting', 33, this.airPurifier?.log);
-                await this.airPurifier?.setAttribute(FanControl.id, 'percentCurrent', 33, this.airPurifier?.log);
-            }
-            else if (newValue === FanControl.FanMode.Medium) {
-                await this.airPurifier?.setAttribute(FanControl.id, 'percentSetting', 66, this.airPurifier?.log);
-                await this.airPurifier?.setAttribute(FanControl.id, 'percentCurrent', 66, this.airPurifier?.log);
-            }
-            else if (newValue === FanControl.FanMode.High || newValue === FanControl.FanMode.On || newValue === FanControl.FanMode.Auto) {
-                await this.airPurifier?.setAttribute(FanControl.id, 'percentSetting', 100, this.airPurifier?.log);
-                await this.airPurifier?.setAttribute(FanControl.id, 'percentCurrent', 100, this.airPurifier?.log);
-            }
-        })(), this.airPurifier.log);
+        }, this.airPurifier.log);
         this.airPurifier?.subscribeAttribute(FanControl.id, 'percentSetting', (newValue, oldValue, context) => void (async () => {
             this.airPurifier?.log.info(`Percent setting changed from ${oldValue} to ${newValue} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
             if (context.fabric === undefined)
                 return;
-            if (isValidNumber(newValue, 0, 100))
-                await this.airPurifier?.setAttribute(FanControl.id, 'percentCurrent', newValue, this.airPurifier?.log);
+            if (newValue === null || isValidNumber(newValue, 0, 100))
+                await this.airPurifier?.setAttribute(FanControl, 'percentCurrent', newValue ?? 50, this.airPurifier?.log);
         })(), this.airPurifier.log);
         this.pump = new MatterbridgeEndpoint([pump, bridgedNode, powerSource], { id: 'Pump' }, this.config.debug)
             .createDefaultBridgedDeviceBasicInformationClusterServer('Pump', 'PUM00028', 0xfff1, 'Matterbridge', 'Matterbridge Pump')
@@ -1383,52 +1458,15 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             .createDefaultFanControlClusterServer()
             .addRequiredClusterServers();
         this.fanDefault = await this.addDevice(this.fanDefault);
-        this.fanDefault?.subscribeAttribute(FanControl, 'fanMode', (newValue, oldValue, context) => void (async () => {
+        this.fanDefault?.subscribeAttribute(FanControl, 'fanMode', (newValue, oldValue, context) => {
             this.fanDefault?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
-            if (context.fabric === undefined)
-                return;
-            if (newValue === FanControl.FanMode.Off) {
-                await this.fanDefault?.setAttribute(FanControl, 'percentSetting', 0, this.fanDefault?.log);
-                await this.fanDefault?.setAttribute(FanControl, 'percentCurrent', 0, this.fanDefault?.log);
-            }
-            else if (newValue === FanControl.FanMode.Low) {
-                await this.fanDefault?.setAttribute(FanControl, 'percentSetting', 33, this.fanDefault?.log);
-                await this.fanDefault?.setAttribute(FanControl, 'percentCurrent', 33, this.fanDefault?.log);
-            }
-            else if (newValue === FanControl.FanMode.Medium) {
-                await this.fanDefault?.setAttribute(FanControl, 'percentSetting', 66, this.fanDefault?.log);
-                await this.fanDefault?.setAttribute(FanControl, 'percentCurrent', 66, this.fanDefault?.log);
-            }
-            else if (newValue === FanControl.FanMode.High) {
-                await this.fanDefault?.setAttribute(FanControl, 'percentSetting', 100, this.fanDefault?.log);
-                await this.fanDefault?.setAttribute(FanControl, 'percentCurrent', 100, this.fanDefault?.log);
-            }
-            else if (newValue === FanControl.FanMode.On) {
-                await this.fanDefault?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.High, this.fanDefault?.log);
-                await this.fanDefault?.setAttribute(FanControl, 'percentSetting', 100, this.fanDefault?.log);
-                await this.fanDefault?.setAttribute(FanControl, 'percentCurrent', 100, this.fanDefault?.log);
-            }
-            else if (newValue === FanControl.FanMode.Auto) {
-                await this.fanDefault?.setAttribute(FanControl, 'percentSetting', null, this.fanDefault?.log);
-                await this.fanDefault?.setAttribute(FanControl, 'percentCurrent', 50, this.fanDefault?.log);
-            }
-        })(), this.fanDefault.log);
+        }, this.fanDefault.log);
         this.fanDefault?.subscribeAttribute(FanControl, 'percentSetting', (newValue, oldValue, context) => void (async () => {
             this.fanDefault?.log.info(`Percent setting changed from ${oldValue} to ${newValue} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
             if (context.fabric === undefined)
                 return;
-            if (isValidNumber(newValue, 0, 100))
-                await this.fanDefault?.setAttribute(FanControl, 'percentCurrent', newValue, this.fanDefault?.log);
-            if (isValidNumber(newValue, 0, 0))
-                await this.fanDefault?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.Off, this.fanDefault?.log);
-            if (isValidNumber(newValue, 1, 33))
-                await this.fanDefault?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.Low, this.fanDefault?.log);
-            if (isValidNumber(newValue, 34, 66))
-                await this.fanDefault?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.Medium, this.fanDefault?.log);
-            if (isValidNumber(newValue, 67, 100))
-                await this.fanDefault?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.High, this.fanDefault?.log);
-            if (newValue === null)
-                await this.fanDefault?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.Auto, this.fanDefault?.log);
+            if (newValue === null || isValidNumber(newValue, 0, 100))
+                await this.fanDefault?.setAttribute(FanControl, 'percentCurrent', newValue ?? 50, this.fanDefault?.log);
         })(), this.fanDefault.log);
         this.fanBase = new MatterbridgeEndpoint([fan, bridgedNode, powerSource], { id: 'Fan off low medium high' }, this.config.debug)
             .createDefaultBridgedDeviceBasicInformationClusterServer('Fan base', 'FBA00031', 0xfff1, 'Matterbridge', 'Matterbridge Fan')
@@ -1436,50 +1474,15 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             .createBaseFanControlClusterServer()
             .addRequiredClusterServers();
         this.fanBase = await this.addDevice(this.fanBase);
-        this.fanBase?.subscribeAttribute(FanControl, 'fanMode', (newValue, oldValue, context) => void (async () => {
+        this.fanBase?.subscribeAttribute(FanControl, 'fanMode', (newValue, oldValue, context) => {
             this.fanBase?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
-            if (context.fabric === undefined)
-                return;
-            if (newValue === FanControl.FanMode.Off) {
-                await this.fanBase?.setAttribute(FanControl, 'percentSetting', 0, this.fanBase?.log);
-                await this.fanBase?.setAttribute(FanControl, 'percentCurrent', 0, this.fanBase?.log);
-            }
-            else if (newValue === FanControl.FanMode.Low) {
-                await this.fanBase?.setAttribute(FanControl, 'percentSetting', 33, this.fanBase?.log);
-                await this.fanBase?.setAttribute(FanControl, 'percentCurrent', 33, this.fanBase?.log);
-            }
-            else if (newValue === FanControl.FanMode.Medium) {
-                await this.fanBase?.setAttribute(FanControl, 'percentSetting', 66, this.fanBase?.log);
-                await this.fanBase?.setAttribute(FanControl, 'percentCurrent', 66, this.fanBase?.log);
-            }
-            else if (newValue === FanControl.FanMode.High) {
-                await this.fanBase?.setAttribute(FanControl, 'percentSetting', 100, this.fanBase?.log);
-                await this.fanBase?.setAttribute(FanControl, 'percentCurrent', 100, this.fanBase?.log);
-            }
-            else if (newValue === FanControl.FanMode.On) {
-                await this.fanBase?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.High, this.fanBase?.log);
-                await this.fanBase?.setAttribute(FanControl, 'percentSetting', 100, this.fanBase?.log);
-                await this.fanBase?.setAttribute(FanControl, 'percentCurrent', 100, this.fanBase?.log);
-            }
-            else if (newValue === FanControl.FanMode.Auto) {
-                await this.fanBase?.setAttribute(FanControl, 'percentSetting', null, this.fanBase?.log);
-                await this.fanBase?.setAttribute(FanControl, 'percentCurrent', 50, this.fanBase?.log);
-            }
-        })(), this.fanBase.log);
+        }, this.fanBase.log);
         this.fanBase?.subscribeAttribute(FanControl, 'percentSetting', (newValue, oldValue, context) => void (async () => {
             this.fanBase?.log.info(`Percent setting changed from ${oldValue} to ${newValue} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
             if (context.fabric === undefined)
                 return;
             if (isValidNumber(newValue, 0, 100))
                 await this.fanBase?.setAttribute(FanControl, 'percentCurrent', newValue, this.fanBase?.log);
-            if (isValidNumber(newValue, 0, 0))
-                await this.fanBase?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.Off, this.fanBase?.log);
-            if (isValidNumber(newValue, 1, 33))
-                await this.fanBase?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.Low, this.fanBase?.log);
-            if (isValidNumber(newValue, 34, 66))
-                await this.fanBase?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.Medium, this.fanBase?.log);
-            if (isValidNumber(newValue, 67, 100))
-                await this.fanBase?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.High, this.fanBase?.log);
         })(), this.fanBase.log);
         this.fanOnHigh = new MatterbridgeEndpoint([fan, bridgedNode, powerSource], { id: 'Fan off high' }, this.config.debug)
             .createDefaultBridgedDeviceBasicInformationClusterServer('Fan off high', 'FOH00032', 0xfff1, 'Matterbridge', 'Matterbridge Fan')
@@ -1487,33 +1490,16 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             .createOnOffFanControlClusterServer()
             .addRequiredClusterServers();
         this.fanOnHigh = await this.addDevice(this.fanOnHigh);
-        this.fanOnHigh?.subscribeAttribute(FanControl, 'fanMode', (newValue, oldValue, context) => void (async () => {
+        this.fanOnHigh?.subscribeAttribute(FanControl, 'fanMode', (newValue, oldValue, context) => {
             this.fanOnHigh?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
-            if (context.fabric === undefined)
-                return;
-            if (newValue === FanControl.FanMode.Off) {
-                await this.fanOnHigh?.setAttribute(FanControl, 'percentSetting', 0, this.fanOnHigh?.log);
-                await this.fanOnHigh?.setAttribute(FanControl, 'percentCurrent', 0, this.fanOnHigh?.log);
-            }
-            else if (newValue === FanControl.FanMode.High) {
-                await this.fanOnHigh?.setAttribute(FanControl, 'percentSetting', 100, this.fanOnHigh?.log);
-                await this.fanOnHigh?.setAttribute(FanControl, 'percentCurrent', 100, this.fanOnHigh?.log);
-            }
-            else if (newValue === FanControl.FanMode.On) {
-                await this.fanOnHigh?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.High, this.fanOnHigh?.log);
-                await this.fanOnHigh?.setAttribute(FanControl, 'percentSetting', 100, this.fanOnHigh?.log);
-                await this.fanOnHigh?.setAttribute(FanControl, 'percentCurrent', 100, this.fanOnHigh?.log);
-            }
-        })(), this.fanOnHigh.log);
+        }, this.fanOnHigh.log);
         this.fanOnHigh?.subscribeAttribute(FanControl, 'percentSetting', (newValue, oldValue, context) => void (async () => {
             this.fanOnHigh?.log.info(`Percent setting changed from ${oldValue} to ${newValue} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
             if (context.fabric === undefined)
                 return;
             if (isValidNumber(newValue, 0, 100)) {
-                if (newValue > 0)
-                    newValue = 100;
-                await this.fanOnHigh?.setAttribute(FanControl, 'percentCurrent', newValue, this.fanOnHigh?.log);
-                await this.fanOnHigh?.setAttribute(FanControl, 'percentSetting', newValue, this.fanOnHigh?.log);
+                await this.fanOnHigh?.setAttribute(FanControl, 'percentCurrent', newValue > 0 ? 100 : 0, this.fanOnHigh?.log);
+                await this.fanOnHigh?.setAttribute(FanControl, 'percentSetting', newValue > 0 ? 100 : 0, this.fanOnHigh?.log);
                 await this.fanOnHigh?.setAttribute(FanControl, 'fanMode', newValue === 0 ? FanControl.FanMode.Off : FanControl.FanMode.High, this.fanOnHigh?.log);
             }
         })(), this.fanOnHigh.log);
@@ -1523,52 +1509,15 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             .createCompleteFanControlClusterServer()
             .addRequiredClusterServers();
         this.fanComplete = await this.addDevice(this.fanComplete);
-        this.fanComplete?.subscribeAttribute(FanControl, 'fanMode', (newValue, oldValue, context) => void (async () => {
+        this.fanComplete?.subscribeAttribute(FanControl, 'fanMode', (newValue, oldValue, context) => {
             this.fanComplete?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
-            if (context.fabric === undefined)
-                return;
-            if (newValue === FanControl.FanMode.Off) {
-                await this.fanComplete?.setAttribute(FanControl, 'percentSetting', 0, this.fanComplete?.log);
-                await this.fanComplete?.setAttribute(FanControl, 'percentCurrent', 0, this.fanComplete?.log);
-            }
-            else if (newValue === FanControl.FanMode.Low) {
-                await this.fanComplete?.setAttribute(FanControl, 'percentSetting', 33, this.fanComplete?.log);
-                await this.fanComplete?.setAttribute(FanControl, 'percentCurrent', 33, this.fanComplete?.log);
-            }
-            else if (newValue === FanControl.FanMode.Medium) {
-                await this.fanComplete?.setAttribute(FanControl, 'percentSetting', 66, this.fanComplete?.log);
-                await this.fanComplete?.setAttribute(FanControl, 'percentCurrent', 66, this.fanComplete?.log);
-            }
-            else if (newValue === FanControl.FanMode.High) {
-                await this.fanComplete?.setAttribute(FanControl, 'percentSetting', 100, this.fanComplete?.log);
-                await this.fanComplete?.setAttribute(FanControl, 'percentCurrent', 100, this.fanComplete?.log);
-            }
-            else if (newValue === FanControl.FanMode.On) {
-                await this.fanComplete?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.High, this.fanComplete?.log);
-                await this.fanComplete?.setAttribute(FanControl, 'percentSetting', 100, this.fanComplete?.log);
-                await this.fanComplete?.setAttribute(FanControl, 'percentCurrent', 100, this.fanComplete?.log);
-            }
-            else if (newValue === FanControl.FanMode.Auto) {
-                await this.fanComplete?.setAttribute(FanControl, 'percentSetting', null, this.fanComplete?.log);
-                await this.fanComplete?.setAttribute(FanControl, 'percentCurrent', 50, this.fanComplete?.log);
-            }
-        })(), this.fanComplete?.log);
+        }, this.fanComplete?.log);
         this.fanComplete?.subscribeAttribute(FanControl, 'percentSetting', (newValue, oldValue, context) => void (async () => {
             this.fanComplete?.log.info(`Percent setting changed from ${oldValue} to ${newValue} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
             if (context.fabric === undefined)
                 return;
-            if (isValidNumber(newValue, 0, 100))
-                await this.fanComplete?.setAttribute(FanControl, 'percentCurrent', newValue, this.fanComplete?.log);
-            if (isValidNumber(newValue, 0, 0))
-                await this.fanComplete?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.Off, this.fanComplete?.log);
-            if (isValidNumber(newValue, 1, 33))
-                await this.fanComplete?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.Low, this.fanComplete?.log);
-            if (isValidNumber(newValue, 34, 66))
-                await this.fanComplete?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.Medium, this.fanComplete?.log);
-            if (isValidNumber(newValue, 67, 100))
-                await this.fanComplete?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.High, this.fanComplete?.log);
-            if (newValue === null)
-                await this.fanComplete?.setAttribute(FanControl, 'fanMode', FanControl.FanMode.Auto, this.fanComplete?.log);
+            if (newValue === null || isValidNumber(newValue, 0, 100))
+                await this.fanComplete?.setAttribute(FanControl, 'percentCurrent', newValue ?? 50, this.fanComplete?.log);
         })(), this.fanComplete?.log);
         this.fanComplete?.subscribeAttribute(FanControl, 'rockSetting', (newValue, oldValue, context) => {
             this.fanComplete?.log.info(`Rock setting changed from ${debugStringify(oldValue)} to ${debugStringify(newValue)} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
@@ -1881,41 +1830,15 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             await this.airConditioner?.setAttribute(RelativeHumidityMeasurement.id, 'measuredValue', null, this.airConditioner?.log);
             await this.airConditioner?.setAttribute(FanControl.id, 'percentSetting', 0, this.airConditioner?.log);
         });
-        this.airConditioner?.subscribeAttribute(FanControl.id, 'fanMode', (newValue, oldValue, context) => void (async () => {
+        this.airConditioner?.subscribeAttribute(FanControl.id, 'fanMode', (newValue, oldValue, context) => {
             this.airConditioner?.log.info(`Fan mode changed from ${this.fanModeLookup[oldValue]} to ${this.fanModeLookup[newValue]} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
-            if (context.fabric === undefined)
-                return;
-            if (newValue === FanControl.FanMode.Off) {
-                await this.airConditioner?.setAttribute(FanControl.id, 'percentSetting', 0, this.airConditioner?.log);
-                await this.airConditioner?.setAttribute(FanControl.id, 'percentCurrent', 0, this.airConditioner?.log);
-            }
-            else if (newValue === FanControl.FanMode.Low) {
-                await this.airConditioner?.setAttribute(FanControl.id, 'percentSetting', 33, this.airConditioner?.log);
-                await this.airConditioner?.setAttribute(FanControl.id, 'percentCurrent', 33, this.airConditioner?.log);
-            }
-            else if (newValue === FanControl.FanMode.Medium) {
-                await this.airConditioner?.setAttribute(FanControl.id, 'percentSetting', 66, this.airConditioner?.log);
-                await this.airConditioner?.setAttribute(FanControl.id, 'percentCurrent', 66, this.airConditioner?.log);
-            }
-            else if (newValue === FanControl.FanMode.High) {
-                await this.airConditioner?.setAttribute(FanControl.id, 'percentSetting', 100, this.airConditioner?.log);
-                await this.airConditioner?.setAttribute(FanControl.id, 'percentCurrent', 100, this.airConditioner?.log);
-            }
-            else if (newValue === FanControl.FanMode.On) {
-                await this.airConditioner?.setAttribute(FanControl.id, 'percentSetting', 100, this.airConditioner?.log);
-                await this.airConditioner?.setAttribute(FanControl.id, 'percentCurrent', 100, this.airConditioner?.log);
-            }
-            else if (newValue === FanControl.FanMode.Auto) {
-                await this.airConditioner?.setAttribute(FanControl.id, 'percentSetting', 50, this.airConditioner?.log);
-                await this.airConditioner?.setAttribute(FanControl.id, 'percentCurrent', 50, this.airConditioner?.log);
-            }
-        })(), this.airConditioner?.log);
+        }, this.airConditioner?.log);
         this.airConditioner?.subscribeAttribute(FanControl.id, 'percentSetting', (newValue, oldValue, context) => void (async () => {
             this.airConditioner?.log.info(`Percent setting changed from ${oldValue} to ${newValue} context: ${context.fabric === undefined ? 'offline' : 'online'}`);
             if (context.fabric === undefined)
                 return;
-            if (isValidNumber(newValue, 0, 100))
-                await this.airConditioner?.setAttribute(FanControl.id, 'percentCurrent', newValue, this.airConditioner?.log);
+            if (newValue === null || isValidNumber(newValue, 0, 100))
+                await this.airConditioner?.setAttribute(FanControl, 'percentCurrent', newValue ?? 50, this.airConditioner?.log);
         })(), this.airConditioner?.log);
         this.basicVideoPlayer = new BasicVideoPlayer('BasicVideoPlayer', 'BVP00062');
         this.basicVideoPlayer = await this.addDevice(this.basicVideoPlayer);
@@ -2518,31 +2441,30 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
         await this.fanBase?.setAttribute(FanControl.id, 'fanMode', FanControl.FanMode.Off, this.fanBase.log);
         await this.fanBase?.setAttribute(FanControl.id, 'percentCurrent', 0, this.fanBase.log);
         await this.fanBase?.setAttribute(FanControl.id, 'percentSetting', 0, this.fanBase.log);
+        await this.fanOnHigh?.setAttribute(FanControl.id, 'fanMode', FanControl.FanMode.Off, this.fanOnHigh.log);
+        await this.fanOnHigh?.setAttribute(FanControl.id, 'percentCurrent', 0, this.fanOnHigh.log);
+        await this.fanOnHigh?.setAttribute(FanControl.id, 'percentSetting', 0, this.fanOnHigh.log);
+        this.fanDefault?.log.info('Set fan initial fanMode to Auto and percentCurrent to 0');
         await this.fanDefault?.setAttribute(FanControl.id, 'fanMode', FanControl.FanMode.Auto, this.fanDefault.log);
         await this.fanDefault?.setAttribute(FanControl.id, 'percentCurrent', 0, this.fanDefault.log);
-        await this.fanDefault?.setAttribute(FanControl.id, 'percentSetting', 0, this.fanDefault.log);
+        this.fanComplete?.log.info('Set fan initial fanMode to Auto and percentCurrent to 0');
         await this.fanComplete?.setAttribute(FanControl.id, 'fanMode', FanControl.FanMode.Auto, this.fanComplete.log);
         await this.fanComplete?.setAttribute(FanControl.id, 'percentCurrent', 0, this.fanComplete.log);
-        await this.fanComplete?.setAttribute(FanControl.id, 'percentSetting', 0, this.fanComplete.log);
         if (this.config.useInterval) {
             this.addInterval(async () => {
-                let mode = this.fanBase?.getAttribute(FanControl, 'fanMode', this.fanBase.log);
-                let value = this.fanBase?.getAttribute(FanControl, 'percentCurrent', this.fanBase.log);
-                mode = this.fanDefault?.getAttribute(FanControl, 'fanMode', this.fanDefault.log);
-                value = this.fanDefault?.getAttribute(FanControl, 'percentCurrent', this.fanDefault.log);
+                let mode = this.fanDefault?.getAttribute(FanControl, 'fanMode', this.fanDefault.log);
+                let value = this.fanDefault?.getAttribute(FanControl, 'percentCurrent', this.fanDefault.log);
                 if (isValidNumber(mode, FanControl.FanMode.Off, FanControl.FanMode.Auto) && mode === FanControl.FanMode.Auto && isValidNumber(value, 0, 100)) {
                     value = value + 10 >= 100 ? 0 : value + 10;
                     await this.fanDefault?.setAttribute(FanControl, 'percentCurrent', value, this.fanDefault.log);
-                    await this.fanDefault?.setAttribute(FanControl, 'percentSetting', value, this.fanDefault.log);
-                    this.fanDefault?.log.info(`Set fan percentCurrent and percentSetting to ${value}`);
+                    this.fanDefault?.log.info(`Set fan percentCurrent to ${value}`);
                 }
                 mode = this.fanComplete?.getAttribute(FanControl, 'fanMode', this.fanComplete.log);
                 value = this.fanComplete?.getAttribute(FanControl, 'percentCurrent', this.fanComplete.log);
                 if (isValidNumber(mode, FanControl.FanMode.Off, FanControl.FanMode.Auto) && mode === FanControl.FanMode.Auto && isValidNumber(value, 0, 100)) {
                     value = value + 10 >= 100 ? 0 : value + 10;
                     await this.fanComplete?.setAttribute(FanControl, 'percentCurrent', value, this.fanComplete.log);
-                    await this.fanComplete?.setAttribute(FanControl, 'percentSetting', value, this.fanComplete.log);
-                    this.fanComplete?.log.info(`Set fan percentCurrent and percentSetting to ${value}`);
+                    this.fanComplete?.log.info(`Set fan percentCurrent to ${value}`);
                 }
             }, 60 * 1000 + 700);
         }

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "3.0.3-dev-20260821-8d97cc8",
+  "version": "3.0.3-dev-20260822-8bd7fd5",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge-example-dynamic-platform",
-      "version": "3.0.3-dev-20260821-8d97cc8",
+      "version": "3.0.3-dev-20260822-8bd7fd5",
       "license": "Apache-2.0",
       "dependencies": {
         "node-ansi-logger": "3.3.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "3.0.3-dev-20260821-8d97cc8",
+  "version": "3.0.3-dev-20260822-8bd7fd5",
   "description": "Matterbridge dynamic plugin",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",