You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Expand all lines: source/_components/cover.mqtt.markdown
+35Lines changed: 35 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -46,11 +46,40 @@ Configuration variables:
46
46
- **qos** (*Optional*): The maximum QoS level of the state topic. Default is `0`. Will also be used when publishing messages.
47
47
- **retain** (*Optional*): If the published message should have the retain flag on or not. Default is `false`.
48
48
- **value_template** (*Optional*): Defines a [template](/topics/templating/) to extract a value from the payload.
49
+
- **tilt_command_topic** (*Optional*): The MQTT topic to publish commands to control the cover tilt.
50
+
- **tilt_status_topic** (*Optional*): The MQTT topic subscribed to receive tilt status update values.
51
+
- **tilt_min** (*Optional*): The minimum tilt value. Default is `0`
52
+
- **tilt_max** (*Optional*): The maximum tilt value. Default is `100`
53
+
- **tilt_closed_value** (*Optional*): The value that will be sent on a `close_cover_tilt` command. Default is `0`
54
+
- **tilt_opened_value** (*Optional*): The value that will be sent on an `open_cover_tilt` command. Default is `100`
55
+
- **tilt_status_optimistic** (*Optional*): Flag that determines if tilt works in optimistic mode. Default is `true` if `tilt_status_topic` is not deinfed, else `false`
49
56
50
57
## {% linkable_title Examples %}
51
58
52
59
In this section you find some real life examples of how to use this sensor.
53
60
61
+
### {% linkable_title Full configuration without tilt %}
62
+
63
+
The example below shows a full configuration for a cover without tilt.
64
+
65
+
```yaml
66
+
# Example configuration.yml entry
67
+
cover:
68
+
- platform: mqtt
69
+
state_topic: "home-assistant/cover"
70
+
command_topic: "home-assistant/cover/set"
71
+
name: "MQTT Cover"
72
+
qos: 0
73
+
retain: true
74
+
payload_open: "OPEN"
75
+
payload_close: "CLOSE"
76
+
payload_stop: "STOP"
77
+
state_open: "OPEN"
78
+
state_closed: "STATE"
79
+
optimistic: false
80
+
value_template: '{% raw %}{{ value.x }}{% endraw %}'
81
+
```
82
+
54
83
### {% linkable_title Full configuration %}
55
84
56
85
The example below shows a full configuration for a cover.
@@ -71,6 +100,12 @@ cover:
71
100
state_closed: "STATE"
72
101
optimistic: false
73
102
value_template: '{% raw %}{{ value.x }}{% endraw %}'
For a check you can use the command line tools `mosquitto_pub` shipped with `mosquitto` to send MQTT messages. This allows you to operate your cover manually:
0 commit comments