2 for 1: configuration markdown & usage sample (#6573)

* 2 for 1: configuration markdown & usage sample

Fixing configuration markdown #6385
also, added a simple switch example for AC management.

* Fix configuration section

Hope I got it right this time :)
This commit is contained in:
Amir Hanan 2018-10-07 12:29:20 +03:00 committed by Franck Nijhof
parent d4db78e21c
commit 15db244e12

View File

@ -24,12 +24,16 @@ climate:
api_key: <your_key_here> api_key: <your_key_here>
``` ```
Configuration variables: {% configuration %}
api_key:
- **api_key** (*Required*): Your API key. description: Your Sensibo API key (To get your API key visit <https://home.sensibo.com/me/api>).
- **id** (*Optional*): A unit ID or a list of IDs. If none specified then all units accessible by the `api_key` will be used. required: true
type: string
To get your API key visit <https://home.sensibo.com/me/api> id:
description: A unit ID or a list of IDs. If none specified then all units accessible by the `api_key` will be used.
required: false
type: string
{% endconfiguration %}
<p class="note"> <p class="note">
If you create the API key using a dedicated user (and not your main user), If you create the API key using a dedicated user (and not your main user),
@ -46,3 +50,26 @@ climate:
- id1 - id1
- id2 - id2
``` ```
### {% linkable_title Adding a quick switch example %}
If you want a "Quick Switch" to turn your AC On / Off, you can do that using the following `Switch Template`:
{% raw %}
```yaml
switch:
- platform: template
switches:
ac:
friendly_name: "AC"
value_template: "{{ is_state('climate.ac', 'cool') or is_state('climate.ac', 'heat') or is_state('climate.ac', 'dry') or is_state('climate.ac', 'heat')}}"
turn_on:
service: climate.turn_on
data:
entity_id: climate.ac
turn_off:
service: climate.turn_off
data:
entity_id: climate.ac
```
{% endraw %}