matterbridge 1.4.1 → 1.4.3

package/dist/matterbridgeDevice.js

@@ -20,12 +20,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License. *
  */
-import { BasicInformationCluster, BooleanState, BooleanStateCluster, ClusterServer, ColorControl, ColorControlCluster, DoorLock, DoorLockCluster, ElectricalMeasurement, ElectricalMeasurementCluster, FanControl, FanControlCluster, FixedLabelCluster, FlowMeasurement, FlowMeasurementCluster, Groups, GroupsCluster, GroupsClusterHandler, Identify, IdentifyCluster, IlluminanceMeasurement, IlluminanceMeasurementCluster, LevelControl, LevelControlCluster, ModeSelectCluster, OccupancySensing, OccupancySensingCluster, OnOff, OnOffCluster, PowerSource, PowerSourceCluster, PowerSourceConfigurationCluster, PressureMeasurement, PressureMeasurementCluster, RelativeHumidityMeasurement, RelativeHumidityMeasurementCluster, Scenes, ScenesCluster, ScenesClusterHandler, Switch, SwitchCluster, TemperatureMeasurement, TemperatureMeasurementCluster, Thermostat, ThermostatCluster, ThreadNetworkDiagnostics, ThreadNetworkDiagnosticsCluster, TimeSync, TimeSyncCluster, WindowCovering, WindowCoveringCluster, getClusterNameById, } from '@project-chip/matter-node.js/cluster';
+import { BasicInformationCluster, BooleanState, BooleanStateCluster, ClusterServer, ColorControl, ColorControlCluster, DoorLock, DoorLockCluster, FanControl, FanControlCluster, FixedLabelCluster, FlowMeasurement, FlowMeasurementCluster, Groups, GroupsCluster, GroupsClusterHandler, Identify, IdentifyCluster, IlluminanceMeasurement, IlluminanceMeasurementCluster, LevelControl, LevelControlCluster, ModeSelectCluster, OccupancySensing, OccupancySensingCluster, OnOff, OnOffCluster, PowerSource, PowerSourceCluster, PowerSourceConfigurationCluster, PressureMeasurement, PressureMeasurementCluster, RelativeHumidityMeasurement, RelativeHumidityMeasurementCluster, Scenes, ScenesCluster, ScenesClusterHandler, Switch, SwitchCluster, TemperatureMeasurement, TemperatureMeasurementCluster, Thermostat, ThermostatCluster, ThreadNetworkDiagnostics, ThreadNetworkDiagnosticsCluster, TimeSync, TimeSyncCluster, WindowCovering, WindowCoveringCluster, getClusterNameById, } from '@project-chip/matter-node.js/cluster';
 import { EndpointNumber, GroupId, VendorId } from '@project-chip/matter-node.js/datatype';
 import { Device, DeviceClasses, DeviceTypeDefinition, Endpoint } from '@project-chip/matter-node.js/device';
 import { extendPublicHandlerMethods } from '@project-chip/matter-node.js/util';
-import { EveHistory, EveHistoryCluster } from 'matter-history';
-import { AnsiLogger, CYAN, db, hk, zb } from 'node-ansi-logger';
+import { EveHistory, EveHistoryCluster, MatterHistory } from 'matter-history';
+import { AnsiLogger, CYAN, YELLOW, db, debugStringify, hk, or, zb } from 'node-ansi-logger';
 import { AirQuality, AirQualityCluster } from './cluster/AirQualityCluster.js';
 import { createHash } from 'crypto';
 import { TvocMeasurement, TvocMeasurementCluster } from './cluster/TvocCluster.js';
@@ -439,9 +439,8 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         if (includeServerList.includes(PowerSource.Cluster.id))
             endpoint.addClusterServer(this.getDefaultPowerSourceWiredClusterServer());
         if (includeServerList.includes(EveHistory.Cluster.id))
-            endpoint.addClusterServer(this.getDefaultStaticEveHistoryClusterServer());
-        if (includeServerList.includes(ElectricalMeasurement.Cluster.id))
-            endpoint.addClusterServer(this.getDefaultElectricalMeasurementClusterServer());
+            endpoint.addClusterServer(MatterHistory.getEveHistoryClusterServer());
+        // if (includeServerList.includes(ElectricalMeasurement.Cluster.id)) endpoint.addClusterServer(this.getDefaultElectricalMeasurementClusterServer());
         if (includeServerList.includes(PowerTopology.Cluster.id))
             endpoint.addClusterServer(this.getDefaultPowerTopologyClusterServer());
         if (includeServerList.includes(ElectricalPowerMeasurement.Cluster.id))
@@ -549,6 +548,88 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
                 return endpoint;
         }
     }
+    /**
+     * Retrieves the value of the specified attribute from the given endpoint and cluster.
+     *
+     * @param {ClusterId} clusterId - The ID of the cluster to retrieve the attribute from.
+     * @param {string} attribute - The name of the attribute to retrieve.
+     * @param {AnsiLogger} [log] - Optional logger for error and info messages.
+     * @param {Endpoint} [endpoint] - Optional the child endpoint to retrieve the attribute from.
+     * @returns {any} The value of the attribute, or undefined if the attribute is not found.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getAttribute(clusterId, attribute, log, endpoint) {
+        if (!endpoint)
+            endpoint = this;
+        const clusterServer = endpoint.getClusterServerById(clusterId);
+        if (!clusterServer) {
+            log?.error(`getAttribute error: Cluster ${clusterId} not found on endpoint ${endpoint.name}:${endpoint.number}`);
+            return undefined;
+        }
+        const capitalizedAttributeName = attribute.charAt(0).toUpperCase() + attribute.slice(1);
+        if (!clusterServer.isAttributeSupportedByName(attribute) && !clusterServer.isAttributeSupportedByName(capitalizedAttributeName)) {
+            if (log)
+                log.error(`getAttribute error: Attribute ${attribute} not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
+            return undefined;
+        }
+        // Find the getter method
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        if (!clusterServer[`get${capitalizedAttributeName}Attribute`]) {
+            log?.error(`getAttribute error: Getter get${capitalizedAttributeName}Attribute not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
+            return undefined;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-empty-object-type
+        const getter = clusterServer[`get${capitalizedAttributeName}Attribute`];
+        const value = getter();
+        log?.info(`${db}Get endpoint ${or}${endpoint.name}:${endpoint.number}${db} attribute ${hk}${clusterServer.name}.${capitalizedAttributeName}${db} value ${YELLOW}${typeof value === 'object' ? debugStringify(value) : value}${db}`);
+        return value;
+    }
+    /**
+     * Sets the value of an attribute on a cluster server endpoint.
+     *
+     * @param {ClusterId} clusterId - The ID of the cluster.
+     * @param {string} attribute - The name of the attribute.
+     * @param {any} value - The value to set for the attribute.
+     * @param {AnsiLogger} [log] - (Optional) The logger to use for logging errors and information.
+     * @param {Endpoint} [endpoint] - (Optional) The endpoint to set the attribute on. If not provided, the attribute will be set on the current endpoint.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    setAttribute(clusterId, attribute, value, log, endpoint) {
+        if (!endpoint)
+            endpoint = this;
+        const clusterServer = endpoint.getClusterServerById(clusterId);
+        if (!clusterServer) {
+            log?.error(`setAttribute error: Cluster ${clusterId} not found on endpoint ${endpoint.name}:${endpoint.number}`);
+            return;
+        }
+        const capitalizedAttributeName = attribute.charAt(0).toUpperCase() + attribute.slice(1);
+        if (!clusterServer.isAttributeSupportedByName(attribute) && !clusterServer.isAttributeSupportedByName(capitalizedAttributeName)) {
+            if (log)
+                log.error(`setAttribute error: Attribute ${attribute} not found on Cluster ${clusterId} on endpoint ${endpoint.name}:${endpoint.number}`);
+            return;
+        }
+        // Find the getter method
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        if (!clusterServer[`get${capitalizedAttributeName}Attribute`]) {
+            log?.error(`setAttribute error: Getter get${capitalizedAttributeName}Attribute not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
+            return;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-empty-object-type
+        const getter = clusterServer[`get${capitalizedAttributeName}Attribute`];
+        // Find the setter method
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        if (!clusterServer[`set${capitalizedAttributeName}Attribute`]) {
+            log?.error(`setAttribute error: Setter set${capitalizedAttributeName}Attribute not found on Cluster ${clusterServer.name} on endpoint ${endpoint.name}:${endpoint.number}`);
+            return;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-empty-object-type
+        const setter = clusterServer[`set${capitalizedAttributeName}Attribute`];
+        const oldValue = getter();
+        setter(value);
+        log?.info(`${db}Set endpoint ${or}${endpoint.name}:${endpoint.number}${db} attribute ${hk}${clusterServer.name}.${capitalizedAttributeName}${db} ` +
+            `from ${YELLOW}${typeof oldValue === 'object' ? debugStringify(oldValue) : oldValue}${db} ` +
+            `to ${YELLOW}${typeof value === 'object' ? debugStringify(value) : value}${db}`);
+    }
     /**
      * Serializes the Matterbridge device into a serialized object.
      *
@@ -603,7 +684,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     /**
      * Returns a default static EveHistoryClusterServer object with the specified voltage, current, power, and consumption values.
      * This shows up in HA as a static sensor!
-     * @deprecated This method is deprecated and will be removed in a future version.
+     * @deprecated This method is deprecated and will be removed in a future version. Use MatterHistory.
      * @param voltage - The voltage value (default: 0).
      * @param current - The current value (default: 0).
      * @param power - The power value (default: 0).
@@ -634,7 +715,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     /**
      * Create a default static EveHistoryClusterServer object with the specified voltage, current, power, and consumption values.
      * This shows up in HA as a static sensor!
-     * @deprecated This method is deprecated and will be removed in a future version.
+     * @deprecated This method is deprecated and will be removed in a future version. Use MatterHistory.
      * @param voltage - The voltage value (default: 0).
      * @param current - The current value (default: 0).
      * @param power - The power value (default: 0).
@@ -646,7 +727,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     }
     /**
      * Creates a room Eve History Cluster Server.
-     * @deprecated This method is deprecated and will be removed in a future version.
+     * @deprecated This method is deprecated and will be removed in a future version. Use MatterHistory.
      *
      * @param history - The MatterHistory object.
      * @param log - The AnsiLogger object.
@@ -705,7 +786,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     }
     /**
      * Creates a Weather Eve History Cluster Server.
-     * @deprecated This method is deprecated and will be removed in a future version.
+     * @deprecated This method is deprecated and will be removed in a future version. Use MatterHistory.
      *
      * @param history - The MatterHistory instance.
      * @param log - The AnsiLogger instance.
@@ -767,7 +848,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     }
     /**
      * Creates an Energy Eve History Cluster Server.
-     * @deprecated This method is deprecated and will be removed in a future version.
+     * @deprecated This method is deprecated and will be removed in a future version. Use MatterHistory.
      *
      * @param history - The MatterHistory object.
      * @param log - The AnsiLogger object.
@@ -845,7 +926,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     }
     /**
      * Creates a Motion Eve History Cluster Server.
-     * @deprecated This method is deprecated and will be removed in a future version.
+     * @deprecated This method is deprecated and will be removed in a future version. Use MatterHistory.
      *
      * @param history - The MatterHistory object.
      * @param log - The AnsiLogger object.
@@ -909,7 +990,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     }
     /**
      * Creates a door EveHistoryCluster server.
-     * @deprecated This method is deprecated and will be removed in a future version.
+     * @deprecated This method is deprecated and will be removed in a future version. Use MatterHistory.
      *
      * @param history - The MatterHistory instance.
      * @param log - The AnsiLogger instance.
@@ -1250,14 +1331,21 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
      * @param power - The active power value.
      * @param consumption - The total active power consumption value.
      */
+    /*
     getDefaultElectricalMeasurementClusterServer(voltage = 0, current = 0, power = 0, consumption = 0) {
-        return ClusterServer(ElectricalMeasurementCluster, {
-            rmsVoltage: voltage,
-            rmsCurrent: current,
-            activePower: power,
-            totalActivePower: consumption,
-        }, {}, {});
+      return ClusterServer(
+        ElectricalMeasurementCluster,
+        {
+          rmsVoltage: voltage,
+          rmsCurrent: current,
+          activePower: power,
+          totalActivePower: consumption,
+        },
+        {},
+        {},
+      );
     }
+    */
     /**
      * @deprecated This method is deprecated and will be removed in a future version.
      * Creates a default Electrical Measurement Cluster Server.
@@ -1267,9 +1355,11 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
      * @param power - The active power value.
      * @param consumption - The total active power consumption value.
      */
+    /*
     createDefaultElectricalMeasurementClusterServer(voltage = 0, current = 0, power = 0, consumption = 0) {
-        this.addClusterServer(this.getDefaultElectricalMeasurementClusterServer(voltage, current, power, consumption));
+      this.addClusterServer(this.getDefaultElectricalMeasurementClusterServer(voltage, current, power, consumption));
     }
+    */
     /**
      * Creates a default Dummy Thread Network Diagnostics Cluster server.
      * @deprecated This method is deprecated and is only used for testing.
@@ -1558,6 +1648,39 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     createDefaultXYColorControlClusterServer(currentX = 0, currentY = 0, colorTemperatureMireds = 500, colorTempPhysicalMinMireds = 147, colorTempPhysicalMaxMireds = 500) {
         this.addClusterServer(this.getDefaultXYColorControlClusterServer(currentX, currentY, colorTemperatureMireds, colorTempPhysicalMinMireds, colorTempPhysicalMaxMireds));
     }
+    /**
+     * Configures the color control cluster for a device.
+     *
+     * @param {boolean} hueSaturation - A boolean indicating whether the device supports hue and saturation control.
+     * @param {boolean} xy - A boolean indicating whether the device supports XY control.
+     * @param {boolean} colorTemperature - A boolean indicating whether the device supports color temperature control.
+     * @param {ColorControl.ColorMode} colorMode - An optional parameter specifying the color mode of the device.
+     * @param {Endpoint} endpoint - An optional parameter specifying the endpoint to configure. If not provided, the device endpoint will be used.
+     */
+    configureColorControlCluster(hueSaturation, xy, colorTemperature, colorMode, endpoint) {
+        if (!endpoint)
+            endpoint = this;
+        endpoint.getClusterServer(ColorControlCluster)?.setFeatureMapAttribute({ hueSaturation, enhancedHue: false, colorLoop: false, xy, colorTemperature });
+        endpoint.getClusterServer(ColorControlCluster)?.setColorCapabilitiesAttribute({ hueSaturation, enhancedHue: false, colorLoop: false, xy, colorTemperature });
+        if (colorMode !== undefined && colorMode >= 0 && colorMode <= 2) {
+            endpoint.getClusterServer(ColorControlCluster)?.setColorModeAttribute(colorMode);
+            endpoint.getClusterServer(ColorControlCluster)?.setEnhancedColorModeAttribute(colorMode);
+        }
+    }
+    /**
+     * Configures the color control mode for the device.
+     *
+     * @param {ColorControl.ColorMode} colorMode - The color mode to set.
+     * @param {Endpoint} endpoint - The optional endpoint to configure. If not provided, the method will configure the current endpoint.
+     */
+    configureColorControlMode(colorMode, endpoint) {
+        if (!endpoint)
+            endpoint = this;
+        if (colorMode !== undefined && colorMode >= 0 && colorMode <= 2) {
+            endpoint.getClusterServer(ColorControlCluster)?.setColorModeAttribute(colorMode);
+            endpoint.getClusterServer(ColorControlCluster)?.setEnhancedColorModeAttribute(colorMode);
+        }
+    }
     /**
      * Get a default window covering cluster server.
      *
@@ -1612,6 +1735,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     }
     /**
      * Sets the window covering target position as the current position and stops the movement.
+     * @param {Endpoint} endpoint - The endpoint on which to set the window covering (default the device endpoint).
      */
     setWindowCoveringTargetAsCurrentAndStopped(endpoint) {
         if (!endpoint)
@@ -1624,7 +1748,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
                 windowCoveringCluster.setOperationalStatusAttribute({
                     global: WindowCovering.MovementStatus.Stopped,
                     lift: WindowCovering.MovementStatus.Stopped,
-                    tilt: 0,
+                    tilt: WindowCovering.MovementStatus.Stopped,
                 });
             }
             this.log.debug(`Set WindowCovering currentPositionLiftPercent100ths and targetPositionLiftPercent100ths to ${position} and operationalStatus to Stopped.`);
@@ -1632,9 +1756,10 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     }
     /**
      * Sets the current and target status of a window covering.
-     * @param current - The current position of the window covering.
-     * @param target - The target position of the window covering.
-     * @param status - The movement status of the window covering.
+     * @param {number} current - The current position of the window covering.
+     * @param {number} target - The target position of the window covering.
+     * @param {WindowCovering.MovementStatus} status - The movement status of the window covering.
+     * @param {Endpoint} endpoint - The endpoint on which to set the window covering (default the device endpoint).
      */
     setWindowCoveringCurrentTargetStatus(current, target, status, endpoint) {
         if (!endpoint)
@@ -1646,7 +1771,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
             windowCoveringCluster.setOperationalStatusAttribute({
                 global: status,
                 lift: status,
-                tilt: 0,
+                tilt: status,
             });
         }
         this.log.debug(`Set WindowCovering currentPositionLiftPercent100ths: ${current}, targetPositionLiftPercent100ths: ${target} and operationalStatus: ${status}.`);
@@ -1654,6 +1779,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
     /**
      * Sets the status of the window covering.
      * @param {WindowCovering.MovementStatus} status - The movement status to set.
+     * @param {Endpoint} endpoint - The endpoint on which to set the window covering (default the device endpoint).
      */
     setWindowCoveringStatus(status, endpoint) {
         if (!endpoint)
@@ -1661,11 +1787,13 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         const windowCovering = endpoint.getClusterServer(WindowCoveringCluster.with(WindowCovering.Feature.Lift, WindowCovering.Feature.PositionAwareLift, WindowCovering.Feature.AbsolutePosition));
         if (!windowCovering)
             return;
-        windowCovering.setOperationalStatusAttribute({ global: status, lift: status, tilt: 0 });
+        windowCovering.setOperationalStatusAttribute({ global: status, lift: status, tilt: status });
         this.log.debug(`Set WindowCovering operationalStatus: ${status}`);
     }
     /**
      * Retrieves the status of the window covering.
+     * @param {Endpoint} endpoint - The endpoint on which to get the window covering (default the device endpoint).
+     *
      * @returns The global operational status of the window covering.
      */
     getWindowCoveringStatus(endpoint) {
@@ -1682,6 +1810,7 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
      * Sets the target and current position of the window covering.
      *
      * @param position - The position to set, specified as a number.
+     * @param {Endpoint} endpoint - The endpoint on which to set the window covering (default the device endpoint).
      */
     setWindowCoveringTargetAndCurrentPosition(position, endpoint) {
         if (!endpoint)
@@ -1788,6 +1917,75 @@ export class MatterbridgeDevice extends extendPublicHandlerMethods(Device) {
         this.addFixedLabel('orientation', 'Switch');
         this.addFixedLabel('label', 'Switch');
     }
+    /**
+     * Triggers a switch event on the specified endpoint.
+     *
+     * @param {string} event - The type of event to trigger. Possible values are 'Single', 'Double', 'Long', 'Press', and 'Release'.
+     * @param {Endpoint} endpoint - The endpoint on which to trigger the event (default the device endpoint).
+     * @returns {void}
+     */
+    triggerSwitchEvent(event, endpoint, log) {
+        if (!endpoint)
+            endpoint = this;
+        if (['Single', 'Double', 'Long'].includes(event)) {
+            const cluster = endpoint.getClusterServer(SwitchCluster.with(Switch.Feature.MomentarySwitch, Switch.Feature.MomentarySwitchRelease, Switch.Feature.MomentarySwitchLongPress, Switch.Feature.MomentarySwitchMultiPress));
+            if (!cluster || !cluster.getFeatureMapAttribute().momentarySwitch) {
+                log?.error(`triggerSwitchEvent ${event} error: Switch cluster with MomentarySwitch not found on endpoint ${endpoint.name}:${endpoint.number}`);
+                return;
+            }
+            if (event === 'Single') {
+                cluster.setCurrentPositionAttribute(1);
+                cluster.triggerInitialPressEvent({ newPosition: 1 });
+                cluster.setCurrentPositionAttribute(0);
+                cluster.triggerShortReleaseEvent({ previousPosition: 1 });
+                cluster.setCurrentPositionAttribute(0);
+                cluster.triggerMultiPressCompleteEvent({ previousPosition: 1, totalNumberOfPressesCounted: 1 });
+                log?.info(`${db}Trigger endpoint ${or}${endpoint.name}:${endpoint.number}${db} event ${hk}${cluster.name}.SinglePress${db}`);
+            }
+            if (event === 'Double') {
+                cluster.setCurrentPositionAttribute(1);
+                cluster.triggerInitialPressEvent({ newPosition: 1 });
+                cluster.setCurrentPositionAttribute(0);
+                cluster.triggerShortReleaseEvent({ previousPosition: 1 });
+                cluster.setCurrentPositionAttribute(1);
+                cluster.triggerInitialPressEvent({ newPosition: 1 });
+                cluster.triggerMultiPressOngoingEvent({ newPosition: 1, currentNumberOfPressesCounted: 2 });
+                cluster.setCurrentPositionAttribute(0);
+                cluster.triggerShortReleaseEvent({ previousPosition: 1 });
+                cluster.triggerMultiPressCompleteEvent({ previousPosition: 1, totalNumberOfPressesCounted: 2 });
+                log?.info(`${db}Trigger endpoint ${or}${endpoint.name}:${endpoint.number}${db} event ${hk}${cluster.name}.DoublePress${db}`);
+            }
+            if (event === 'Long') {
+                cluster.setCurrentPositionAttribute(1);
+                cluster.triggerInitialPressEvent({ newPosition: 1 });
+                cluster.triggerLongPressEvent({ newPosition: 1 });
+                cluster.setCurrentPositionAttribute(0);
+                cluster.triggerLongReleaseEvent({ previousPosition: 1 });
+                log?.info(`${db}Trigger endpoint ${or}${endpoint.name}:${endpoint.number}${db} event ${hk}${cluster.name}.LongPress${db}`);
+            }
+        }
+        if (['Press', 'Release'].includes(event)) {
+            const cluster = endpoint.getClusterServer(Switch.Complete);
+            if (!cluster || !cluster.getFeatureMapAttribute().latchingSwitch) {
+                log?.error(`triggerSwitchEvent ${event} error: Switch cluster with LatchingSwitch not found on endpoint ${endpoint.name}:${endpoint.number}`);
+                return;
+            }
+            if (event === 'Press') {
+                cluster.setCurrentPositionAttribute(1);
+                log?.info(`${db}Update endpoint ${or}${endpoint.name}:${endpoint.number}${db} attribute ${hk}${cluster.name}.CurrentPosition${db} to ${YELLOW}1${db}`);
+                if (cluster.triggerSwitchLatchedEvent)
+                    cluster.triggerSwitchLatchedEvent({ newPosition: 1 });
+                log?.info(`${db}Trigger endpoint ${or}${endpoint.name}:${endpoint.number}${db} event ${hk}${cluster.name}.Press${db}`);
+            }
+            if (event === 'Release') {
+                cluster.setCurrentPositionAttribute(0);
+                log?.info(`${db}Update endpoint ${or}${endpoint.name}:${endpoint.number}${db} attribute ${hk}${cluster.name}.CurrentPosition${db} to ${YELLOW}0${db}`);
+                if (cluster.triggerSwitchLatchedEvent)
+                    cluster.triggerSwitchLatchedEvent({ newPosition: 0 });
+                log?.info(`${db}Trigger endpoint ${or}${endpoint.name}:${endpoint.number}${db} event ${hk}${cluster.name}.Release${db}`);
+            }
+        }
+    }
     /**
      * Retrieves the default mode select cluster server.
      *