jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-25 10:17:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

Added 'availability_template' to all Template Lock platform (#10307)

Browse Source 
* Added 'availability_template' to all Template Lock platform

* Fixed Syntax and default

* Removed optional parameter from example config

* Apply suggestions from code review

Co-Authored-By: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
Gil Peeters 2019-10-03 00:15:54 +10:00 committed by Franck Nijhof
parent cacd810353
commit 4688830ede
1 changed files with 14 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
source/_integrations/lock.template.markdown
View File

@ -22,6 +22,7 @@ In optimistic mode, the lock will immediately change state after every command.
To enable Template Locks in your installation, add the following to your `configuration.yaml` file:
{% raw %}
```yaml
# Example configuration.yaml entry
lock:
@ -37,6 +38,7 @@ lock:
data:
entity_id: switch.door
```
{% endraw %}
{% configuration %}
@ -49,7 +51,12 @@ lock:
description: Defines a template to set the state of the lock.
required: true
type: template
lock:
availability_template:
description: Defines a template to get the `available` state of the component. If the template returns `true`, the device is `available`. If the template returns any other value, the device will be `unavailable`. If `availability_template` is not configured, the component will always be `available`.
required: false
type: template
default: true
lock:
description: Defines an action to run when the lock is locked.
required: true
type: action
@ -77,6 +84,7 @@ In this section, you find some real-life examples of how to use this lock.
This example shows a lock that copies data from a switch.
{% raw %}
```yaml
lock:
- platform: template
@ -91,6 +99,7 @@ lock:
data:
entity_id: switch.source
```
{% endraw %}
### Optimistic Mode
@ -98,6 +107,7 @@ lock:
This example shows a lock in optimistic mode. This lock will immediately change state after command and will not wait for state update from the sensor.
{% raw %}
```yaml
lock:
- platform: template
@ -113,6 +123,7 @@ lock:
data:
entity_id: switch.source
```
{% endraw %}
### Sensor and Two Switches
@ -120,6 +131,7 @@ lock:
This example shows a lock that takes its state from a sensor, and uses two momentary switches to control a device.
{% raw %}
```yaml
lock:
- platform: template
@ -134,4 +146,5 @@ lock:
data:
entity_id: switch.skylight_close
```
{% endraw %}