Basic Cover documentation (home-assistant#951)

chrom3 · fabaff · commit eb2cc6228b70 · 2016-09-19T14:48:35.000+02:00
* Added more content + documentation

* Update cover.markdown

* Update cover.markdown
diff --git a/source/_components/cover.markdown b/source/_components/cover.markdown
@@ -11,3 +11,57 @@ footer: true
 
 Home Assistant can give you an interface to control covers such as
 rollershutters and garage doors.
+## {% linkable_title Services %}
+
+### {% linkable_title Cover control services %}
+Available services: `cover.open_cover`, `cover.close_cover`, `cover.stop_cover`, `cover.open_cover_tilt`, `cover.close_cover_tilt`, `cover.stop_cover_tilt`
+
+| Service data attribute | Optional | Description |
+| ---------------------- | -------- | ----------- |
+| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Else targets all.
+
+### {% linkable_title Service `cover.set_cover_position` %}
+
+Set cover position of one or multiple covers.
+
+| Service data attribute | Optional | Description |
+| ---------------------- | -------- | ----------- |
+| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Else targets all.
+| `position` | no | Integer between 0 and 100.
+
+#### {% linkable_title Automation example  %}
+
+```yaml
+automation:
+  trigger:
+    platform: time
+    after: "07:15:00"
+  action:
+    - service: cover.set_cover_position
+      data:
+        entity_id: cover.demo
+        position: 50
+```
+
+### {% linkable_title Service `cover.set_cover_tilt_position` %}
+
+Set cover tilt position of one or multiple covers.
+
+| Service data attribute | Optional | Description |
+| ---------------------- | -------- | ----------- |
+| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Else targets all.
+| `position` | no | Integer between 0 and 100.
+
+#### {% linkable_title Automation example  %}
+
+```yaml
+automation:
+  trigger:
+    platform: time
+    after: "07:15:00"
+  action:
+    - service: cover.set_cover_tilt_position
+      data:
+        entity_id: cover.demo
+        position: 50
+```
