Window Cover
If the device definition from Zigbee2MQTT contains one or more exposes
entries of type cover
that at least have a feature named position
, a Window Covering service will be created.
The table below shows how the different features within this exposes
entry are mapped to characteristics.
Name | Required access | Characteristic | Remarks |
---|---|---|---|
position |
published, set | Current Position (for the value from MQTT), Target Position (for the value set from HomeKit) |
Required (unless tilt is present) |
tilt |
published, set | Current Horizontal Tilt Angle (for the value from MQTT), Target Horizontal Tilt Angle (for the value set from HomeKit) |
Optional. Will be used as Current Position if position is not available. |
If the device definition also provides a motor_state
, it will be used to update the required Position State characteristic.
If motor_state
is not provided, the Position State characteristic is set when the Target Position is changed or when an position
is received from MQTT (and the movement is assumed to be stopped).
Additionally, if the position
can be get, the plugin will try to get frequent updates, after changing the Target Position. If the same position is reported twice, movement is assumed to be stopped.