Skip to the content.

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.

The required 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).

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.