ReadonlyeventsAccess the behavior's events.
Supported features as a flag object.
ReadonlystateAccess the behavior's state.
ReadonlyconfigThis attribute specifies the configuration and status information of the window covering.
To change settings, devices shall write to the Mode attribute. The behavior causing the setting or clearing of each bit is vendor specific.
Readonlymode: TypeFromPartialBitSchema<{ The Mode attribute allows configuration of the window covering, such as: reversing the motor direction, placing the window covering into calibration mode, placing the motor into maintenance mode, disabling the network, and disabling status LEDs.
In the case a device does not support or implement a specific mode, e.g. the device has a specific installation method and reversal is not relevant or the device does not include a maintenance mode, any write interaction to the Mode attribute, with an unsupported mode bit or any out of bounds bits set, must be ignored and a response containing the status of CONSTRAINT_ERROR will be returned.
ReadonlyoperationalIndicates the currently ongoing operations and applies to all type of devices.
Optional ReadonlysafetyThe SafetyStatus attribute reflects the state of the safety sensors and the common issues preventing movements. By default for nominal operation all flags are cleared (0). A device might support none, one or several bit flags from this attribute (all optional).
ReadonlyendThis attribute SHOULD provide more detail about the product type than can be determined from the main category indicated by the Type attribute.
The table below helps to match the EndProductType attribute with the Type attribute.
Readonlytype: WindowCovering.WindowCoveringTypeThis attribute shall identify the type of window covering.
Static ReadonlyclusterBase cluster state include all attribute values but may be extended by subclasses.
Readonlyattributes: { ReadonlyconfigThis attribute specifies the configuration and status information of the window covering.
To change settings, devices shall write to the Mode attribute. The behavior causing the setting or clearing of each bit is vendor specific.
ReadonlyendThis attribute SHOULD provide more detail about the product type than can be determined from the main category indicated by the Type attribute.
The table below helps to match the EndProductType attribute with the Type attribute.
Readonlymode: WritableAttribute<TypeFromPartialBitSchema<{ The Mode attribute allows configuration of the window covering, such as: reversing the motor direction, placing the window covering into calibration mode, placing the motor into maintenance mode, disabling the network, and disabling status LEDs.
In the case a device does not support or implement a specific mode, e.g. the device has a specific installation method and reversal is not relevant or the device does not include a maintenance mode, any write interaction to the Mode attribute, with an unsupported mode bit or any out of bounds bits set, must be ignored and a response containing the status of CONSTRAINT_ERROR will be returned.
ReadonlyoperationalIndicates the currently ongoing operations and applies to all type of devices.
ReadonlysafetyThe SafetyStatus attribute reflects the state of the safety sensors and the common issues preventing movements. By default for nominal operation all flags are cleared (0). A device might support none, one or several bit flags from this attribute (all optional).
Readonlytype: FixedAttribute<WindowCovering.WindowCoveringType, any>This attribute shall identify the type of window covering.
Readonlycommands: { ReadonlydownUpon receipt of this command, the window covering will adjust its position so the physical lift/slide and tilt is at the maximum closed/down position. This will happen as fast as possible. The server attributes supported shall be updated as follows:
if the PositionAware feature is supported:
• TargetPositionLiftPercent100ths attribute shall be set to 100.00%.
• TargetPositionTiltPercent100ths attribute shall be set to 100.00%.
The server positioning attributes will follow the movements, once the movement has successfully finished, the server attributes shall be updated as follows:
if the PositionAware feature is supported:
• CurrentPositionLiftPercent100ths attribute shall be 100.00%.
• CurrentPositionLiftPercentage attribute shall be 100%.
• CurrentPositionTiltPercent100ths attribute shall be 100.00%.
• CurrentPositionTiltPercentage attribute shall be 100%. if the AbsolutePosition feature is supported:
• CurrentPositionLift attribute shall be equal to the InstalledClosedLimitLift attribute.
• CurrentPositionTilt attribute shall be equal to the InstalledClosedLimitTilt attribute.
ReadonlystopUpon receipt of this command, the window covering will stop any adjusting to the physical tilt and lift/slide that is currently occurring. The server attributes supported shall be updated as follows:
• TargetPositionLiftPercent100ths attribute will be set to CurrentPositionLiftPercent100ths attribute value.
• TargetPositionTiltPercent100ths attribute will be set to CurrentPositionTiltPercent100ths attribute value.
ReadonlyupUpon receipt of this command, the window covering will adjust its position so the physical lift/slide and tilt is at the maximum open/up position. This will happen as fast as possible. The server attributes shall be updated as follows:
if the PositionAware feature is supported:
• TargetPositionLiftPercent100ths attribute shall be set to 0.00%.
• TargetPositionTiltPercent100ths attribute shall be set to 0.00%.
The server positioning attributes will follow the movements, once the movement has successfully finished, the server attributes shall be updated as follows:
if the PositionAware feature is supported:
• CurrentPositionLiftPercent100ths attribute shall be 0.00%.
• CurrentPositionLiftPercentage attribute shall be 0%.
• CurrentPositionTiltPercent100ths attribute shall be 0.00%.
• CurrentPositionTiltPercentage attribute shall be 0%. if the AbsolutePosition feature is supported:
• CurrentPositionLift attribute shall be equal to the InstalledOpenLimitLift attribute.
• CurrentPositionTilt attribute shall be equal to the InstalledOpenLimitTilt attribute.
Readonlyextensions: readonly [{ This metadata controls which WindowCoveringCluster elements matter.js activates for specific feature combinations.
Readonlyfeatures: { ReadonlyabsoluteAbsolutePosition
The percentage attributes shall indicate the position as a percentage between the InstalledOpenLimits and InstalledClosedLimits attributes of the window covering starting at the open (0.00%).
As a general rule, absolute positioning (in centimeters or tenth of a degrees) SHOULD NOT be supported for new implementations.
Readonlylift: BitFlagLift
The Lift feature applies to window coverings that lift up and down (e.g. for a roller shade, Up and Down is lift Open and Close) or slide left to right (e.g. for a sliding curtain, Left and Right is lift Open and Close).
ReadonlypositionPositionAwareLift
Position aware lift control is supported.
ReadonlypositionPositionAwareTilt
Position aware tilt control is supported.
Readonlytilt: BitFlagTilt
The Tilt feature applies to window coverings with vertical or horizontal strips.
Readonlyid: 258Readonlyname: "WindowCovering"Readonlyrevision: 5Static ReadonlydefaultsStatic Optional ReadonlydependenciesStatic ReadonlyearlyStatic ReadonlyEventsStatic ReadonlyExtensionStatic ReadonlyidThe behavior ID for ClusterBehaviors is the name of the cluster.
Static ReadonlyInterfaceStatic ReadonlyInternalStatic ReadonlynameStatic Optional ReadonlyschemaStatic ReadonlyStateStatic ReadonlysupervisorStaticsupportsDoes this behavior support functionality of a specific implementation?
Release resources. This is the public API for releasing application resources held by behaviors in internal state.
ProtectedcallbackCreate a generic callback function that has the same properties as a Reactor.
Like a reactor, the callback's "this" will be bound to an active Behavior instance. Because of this: The reactor MUST be a real JS function - arrow functions will not work!
Upon receipt of this command, the window covering will adjust its position so the physical lift/slide and tilt is at the maximum closed/down position. This will happen as fast as possible. The server attributes supported shall be updated as follows:
if the PositionAware feature is supported:
• TargetPositionLiftPercent100ths attribute shall be set to 100.00%.
• TargetPositionTiltPercent100ths attribute shall be set to 100.00%.
The server positioning attributes will follow the movements, once the movement has successfully finished, the server attributes shall be updated as follows:
if the PositionAware feature is supported:
• CurrentPositionLiftPercent100ths attribute shall be 100.00%.
• CurrentPositionLiftPercentage attribute shall be 100%.
• CurrentPositionTiltPercent100ths attribute shall be 100.00%.
• CurrentPositionTiltPercentage attribute shall be 100%. if the AbsolutePosition feature is supported:
• CurrentPositionLift attribute shall be equal to the InstalledClosedLimitLift attribute.
• CurrentPositionTilt attribute shall be equal to the InstalledClosedLimitTilt attribute.
OptionaltargetPercent100ths: numberBehaviors are ephemeral and should not perform initialization in their constructor. They can override this method instead.
This method may be synchronous or asyncronous. If asynchronous, the behavior will not be available for external use until initialization completes.
Optional_options: {}ProtectedreactInstall a Reactor.
Important: The reactor MUST be a real JS function - arrow functions will not work!
Upon receipt of this command, the window covering will stop any adjusting to the physical tilt and lift/slide that is currently occurring. The server attributes supported shall be updated as follows:
• TargetPositionLiftPercent100ths attribute will be set to CurrentPositionLiftPercent100ths attribute value.
• TargetPositionTiltPercent100ths attribute will be set to CurrentPositionTiltPercent100ths attribute value.
Upon receipt of this command, the window covering will adjust its position so the physical lift/slide and tilt is at the maximum open/up position. This will happen as fast as possible. The server attributes shall be updated as follows:
if the PositionAware feature is supported:
• TargetPositionLiftPercent100ths attribute shall be set to 0.00%.
• TargetPositionTiltPercent100ths attribute shall be set to 0.00%.
The server positioning attributes will follow the movements, once the movement has successfully finished, the server attributes shall be updated as follows:
if the PositionAware feature is supported:
• CurrentPositionLiftPercent100ths attribute shall be 0.00%.
• CurrentPositionLiftPercentage attribute shall be 0%.
• CurrentPositionTiltPercent100ths attribute shall be 0.00%.
• CurrentPositionTiltPercentage attribute shall be 0%. if the AbsolutePosition feature is supported:
• CurrentPositionLift attribute shall be equal to the InstalledOpenLimitLift attribute.
• CurrentPositionTilt attribute shall be equal to the InstalledOpenLimitTilt attribute.
StaticalterStaticenableStaticforStaticsetStaticwith
The implemented cluster.