Update configuration variable style

This commit is contained in:
Fabian Affolter 2017-11-20 08:45:47 +01:00
parent 36a2863d10
commit 65029f3b71
No known key found for this signature in database
GPG Key ID: DDF3D6F44AAB1336

View File

@ -12,38 +12,55 @@ ha_category: Notifications
ha_release: 0.49 ha_release: 0.49
--- ---
This component allows to send notification to a LaMetric device. It needs the LaMetric platform to be configured first. The `lametric` notification platform allows to send notification to a LaMetric device. It needs the LaMetric platform to be configured first.
To enable LaMetric notifications in your installation, add the following to your `configuration.yaml` file:
```yaml ```yaml
notify: notify:
name: lametric1 name: NOTIFIER_NAME
platform: lametric platform: lametric
``` ```
- **name** (*Optional*): The name of the LaMetric device. Usually it is "My Lametric". {% configuration %}
- **lifetime** (*Optional*): Defines how long the message remains in LaMetric notification queue (in seconds). Defaults to 10. name:
- **icon** (*Optional*): An icon or animation. Check out the list of all icons here: https://developer.lametric.com/icons description: "The optional parameter `name` allows multiple notifiers to be created. The notifier will bind to the service `notify.NOTIFIER_NAME`."
Note that icons always begin with "i" while animations begin with "a". This is part of the name, you can't just use the number! required: false
- **cycles** (*Optional*): Defines how often the notification is displayed. Defaults to 1. type: string
default: notify
lifetime:
description: Defines how long the message remains in LaMetric notification queue (in seconds).
required: false
type: int
default: 10
icon:
description: An icon or animation.
required: false
type: string
cycles:
description: Defines how often the notification is displayed.
required: false
type: int
default: 1
{% endconfiguration %}
Extended functionality: Check out the list of all icons at [https://developer.lametric.com/icons](https://developer.lametric.com/icons). Note that icons always begin with "i" while animations begin with "a". This is part of the name, you can't just use the number!
## {% linkable_title Example %}
To add a notification sound or an icon override, it has to be done via service data. To add a notification sound or an icon override, it has to be done via service data.
Example: ```yaml
- alias: "Send notification on arrival at school"
```
...
- alias: 'Send notification on arrival at school'
trigger: trigger:
platform: state platform: state
entity_id: device_tracker.son_mobile entity_id: device_tracker.son_mobile
from: 'not_home' from: 'not_home'
to: 'school' to: 'school'
action: action:
service: notify.lametric1 service: notify.lametric
data: data:
message: 'Son has arrived at school!' message: "Son has arrived at school!"
data: data:
sound: 'notification' sound: 'notification'
icon: 'i51' icon: 'i51'