Window Covering Channel
Channel Category: window_covering
Controls coverings like blinds, curtains, and shutters, including position and tilt adjustments.
Required Properties
| Property | Data Type | Range | Unit | Permissions |
|---|---|---|---|---|
obstruction | Bool | true/false | - | RO (Read-Only) |
status | Enum | opened/closed/opening/closing/stopped | - | RO (Read-Only) |
position | Enum | open/close/stop | - | RW (Read/Write) |
type | Enum | curtain/blind/roller/outdoor_blind | - | RO (Read-Only) |
Property Details
obstruction
Indicates whether the covering is obstructed:
true: An obstruction is detected, preventing the covering from moving.false: No obstruction is detected.
status
Describes the state of the covering:
- Possible values:
opened: The covering is fully open.closed: The covering is fully closed.opening: The covering is in the process of opening.closing: The covering is in the process of closing.stopped: The covering has stopped mid-operation.
position
Describes the target position of the covering:
- Possible values:
open: Open the covering.close: Close the covering.stopp: Stop the covering movement.
type
Defines the type of window covering:
- Possible values:
curtain: Indoor curtains.blind: Indoor blinds.roller: Roll-up coverings.outdoor_blind: Outdoor blinds.
Optional Properties
| Property | Data Type | Range | Unit | Permissions |
|---|---|---|---|---|
percentage | Uchar | 0–100 | % | RW (Read/Write) |
tilt | Char | -90–90 | degrees | RW (Read/Write) |
fault | Uchar | 0–255 | - | RO (Read-Only) |
Property Details
percentage
Indicates the percentage the covering is open:
0%: Fully closed.100%: Fully open.- Intermediate values indicate partial opening.
angle
Represents the tilt angle of the covering:
0: Neutral position.- Negative values: Tilt towards one direction.
- Positive values: Tilt towards the opposite direction.
fault
Represents the fault state of the actor:
0: No fault detected.- Non-zero: A fault has been detected, potentially affecting functionality.
Last updated on