mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-22 00:36:49 +00:00
New configuration section for Manual Alarm Control Panel (#6973)
This commit is contained in:
parent
f7d7bab08e
commit
bb8ac769a5
@ -13,28 +13,74 @@ ha_release: 0.7.6
|
|||||||
ha_qa_scale: internal
|
ha_qa_scale: internal
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
||||||
The `manual` alarm control panel platform enables you to set manual alarms in Home Assistant.
|
The `manual` alarm control panel platform enables you to set manual alarms in Home Assistant.
|
||||||
|
|
||||||
|
## {% linkable_title Configuration %}
|
||||||
|
|
||||||
|
To enable this, add the following lines to your `configuration.yaml` file:
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
alarm_control_panel:
|
alarm_control_panel:
|
||||||
- platform: manual
|
- platform: manual
|
||||||
```
|
```
|
||||||
|
|
||||||
Configuration variables:
|
{% configuration %}
|
||||||
|
name:
|
||||||
- **name** (*Optional*): The name of the alarm. Default is "HA Alarm".
|
description: The name of the alarm.
|
||||||
- **code** (*Optional*): If defined, specifies a code to enable or disable the alarm in the frontend.
|
required: false
|
||||||
- **code_template** (*Optional*): If defined, returns a code to enable or disable the alarm in the frontend; an empty string disables checking the code. Inside the template, the variables **from_state** and **to_state** identify the current and desired state. Only one of **code** and **code_template** can be specified.
|
type: string
|
||||||
- **delay_time** (*Optional*): The time in seconds of the pending time before triggering the alarm. Default is 0 seconds.
|
default: HA Alarm
|
||||||
- **pending_time** (*Optional*): The time in seconds of the pending time before effecting a state change. Default is 60 seconds.
|
code:
|
||||||
- **trigger_time** (*Optional*): The time in seconds of the trigger time in which the alarm is firing. Default is 120 seconds.
|
description: >
|
||||||
- **disarm_after_trigger** (*Optional*): If true, the alarm will automatically disarm after it has been triggered instead of returning to the previous state.
|
If defined, specifies a code to enable or disable the alarm in the frontend.
|
||||||
- **armed_custom_bypass/armed_home/armed_away/armed_night/disarmed/triggered** (*Optional*): State specific settings
|
Only one of **code** and **code_template** can be specified.
|
||||||
- **delay_time** (*Optional*): State specific setting for **delay_time** (all states except **triggered**)
|
required: exclusive
|
||||||
- **pending_time** (*Optional*): State specific setting for **pending_time** (all states except **disarmed**)
|
type: string
|
||||||
- **trigger_time** (*Optional*): State specific setting for **trigger_time** (all states except **triggered**)
|
code_template:
|
||||||
|
description: >
|
||||||
|
If defined, returns a code to enable or disable the alarm in the frontend; an empty string disables checking the code.
|
||||||
|
Inside the template, the variables **from_state** and **to_state** identify the current and desired state.
|
||||||
|
Only one of **code** and **code_template** can be specified.
|
||||||
|
required: exclusive
|
||||||
|
type: string
|
||||||
|
delay_time:
|
||||||
|
description: The time in seconds of the pending time before triggering the alarm.
|
||||||
|
required: false
|
||||||
|
type: integer
|
||||||
|
default: 0
|
||||||
|
pending_time:
|
||||||
|
description: The time in seconds of the pending time before effecting a state change.
|
||||||
|
required: false
|
||||||
|
type: integer
|
||||||
|
default: 60
|
||||||
|
trigger_time:
|
||||||
|
description: The time in seconds of the trigger time in which the alarm is firing.
|
||||||
|
required: false
|
||||||
|
type: integer
|
||||||
|
default: 120
|
||||||
|
disarm_after_trigger:
|
||||||
|
description: If true, the alarm will automatically disarm after it has been triggered instead of returning to the previous state.
|
||||||
|
required: false
|
||||||
|
type: boolean
|
||||||
|
armed_custom_bypass/armed_home/armed_away/armed_night/disarmed/triggered:
|
||||||
|
description: State specific settings
|
||||||
|
required: false
|
||||||
|
type: list
|
||||||
|
keys:
|
||||||
|
delay_time:
|
||||||
|
description: State specific setting for **delay_time** (all states except **triggered**)
|
||||||
|
required: false
|
||||||
|
type: integer
|
||||||
|
pending_time:
|
||||||
|
description: State specific setting for **pending_time** (all states except **disarmed**)
|
||||||
|
required: false
|
||||||
|
type: integer
|
||||||
|
trigger_time:
|
||||||
|
description: State specific setting for **trigger_time** (all states except **triggered**)
|
||||||
|
required: false
|
||||||
|
type: integer
|
||||||
|
{% endconfiguration %}
|
||||||
|
|
||||||
## {% linkable_title State machine %}
|
## {% linkable_title State machine %}
|
||||||
|
|
||||||
@ -75,12 +121,12 @@ garage door opens, but not for the "armed home" state.
|
|||||||
**trigger_time** is useful to disable the alarm when disarmed, but it can also
|
**trigger_time** is useful to disable the alarm when disarmed, but it can also
|
||||||
be used for example to sound the siren for a shorter time during the night.
|
be used for example to sound the siren for a shorter time during the night.
|
||||||
|
|
||||||
|
## {% linkable_title Examples %}
|
||||||
|
|
||||||
In the config example below:
|
In the config example below:
|
||||||
|
|
||||||
- the disarmed state never triggers the alarm;
|
- the disarmed state never triggers the alarm;
|
||||||
|
|
||||||
- the armed_home state will leave no time to leave the building or disarm the alarm;
|
- the armed_home state will leave no time to leave the building or disarm the alarm;
|
||||||
|
|
||||||
- while other states state will give 30 seconds to leave the building before triggering the alarm, and 20 seconds to disarm the alarm when coming back.
|
- while other states state will give 30 seconds to leave the building before triggering the alarm, and 20 seconds to disarm the alarm when coming back.
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
@ -99,9 +145,7 @@ alarm_control_panel:
|
|||||||
delay_time: 0
|
delay_time: 0
|
||||||
```
|
```
|
||||||
|
|
||||||
## {% linkable_title Examples %}
|
In the rest of this section, you find some real-life examples on how to use this panel.
|
||||||
|
|
||||||
In this section, you find some real-life examples of how to use this panel.
|
|
||||||
|
|
||||||
### {% linkable_title Sensors %}
|
### {% linkable_title Sensors %}
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user