Readonly
eventsAccess the behavior's events.
Supported features as a flag object.
Readonly
stateAccess the behavior's state.
Readonly
configThis 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.
Readonly
mode: 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.
Readonly
operationalIndicates the currently ongoing operations and applies to all type of devices.
Optional
Readonly
safetyThe 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).
Readonly
endThis 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.
Readonly
type: WindowCovering.WindowCoveringTypeThis attribute shall identify the type of window covering.
Static
Readonly
clusterBase cluster state include all attribute values but may be extended by subclasses.
Readonly
attributes: { Readonly
configThis 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.
Readonly
endThis 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.
Readonly
mode: 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.
Readonly
operationalIndicates the currently ongoing operations and applies to all type of devices.
Readonly
safetyThe 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).
Readonly
type: FixedAttribute<WindowCovering.WindowCoveringType, any>This attribute shall identify the type of window covering.
Readonly
commands: { Readonly
downUpon 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.
Readonly
stopUpon 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.
Readonly
upUpon 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.
Readonly
extensions: readonly [{ This metadata controls which WindowCoveringCluster elements matter.js activates for specific feature combinations.
Readonly
features: { Readonly
absoluteAbsolutePosition
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.
Readonly
lift: 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).
Readonly
positionPositionAwareLift
Position aware lift control is supported.
Readonly
positionPositionAwareTilt
Position aware tilt control is supported.
Readonly
tilt: BitFlagTilt
The Tilt feature applies to window coverings with vertical or horizontal strips.
Readonly
id: 258Readonly
name: "WindowCovering"Readonly
revision: 5Static
Readonly
defaultsStatic
Optional
Readonly
dependenciesStatic
Readonly
earlyStatic
Readonly
EventsStatic
Readonly
ExtensionStatic
Readonly
idThe behavior ID for ClusterBehaviors is the name of the cluster.
Static
Readonly
InterfaceStatic
Readonly
InternalStatic
Readonly
nameStatic
Optional
Readonly
schemaStatic
Readonly
StateStatic
Readonly
supervisorStatic
supportsDoes 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.
Protected
callbackCreate 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.
Optional
targetPercent100ths: 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: {}Protected
reactInstall 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.
Static
alterStatic
enableStatic
forStatic
setStatic
with
The implemented cluster.