Edward Firmo
@@ -1,77 +1,75 @@
|
|||||||
# Alarm Control Panel
|
# Alarm Control Panel
|
||||||
|
|
||||||
You can control an Alarm Control Panel from your NSPanel,
|
You can control an Alarm Control Panel from your NSPanel, which allows you to set the alarm mode to standard
|
||||||
which will allow you to set the alarm mode between the standard modes supported by
|
modes supported by Home Assistant (Home, Away, Night, Vacation, or Custom bypass) or disarm the alarm.
|
||||||
Home Assistant (Home, Away, Night, Vacation or Custom bypass) or disarm the alarm.
|
|
||||||
|
|
||||||
Currently, only alarms without a code or alarms with a numeric code will be supported.
|
Currently, the NSPanel supports alarms without a code or with a numeric code. For alarms using a text code,
|
||||||
If your alarm requires a text code, you will still be able to display it on your NSPanel,
|
the NSPanel will display it, but interactions (like button clicks) will send service calls to Home Assistant
|
||||||
however, when you click in any button it will send services calls to Home Assistant
|
without the code, leading to failed operations that require a code.
|
||||||
without the code and it will fail for the calls where a code is required.
|
|
||||||
|
|
||||||
> [!IMPORTANT]
|
> [!IMPORTANT]
|
||||||
> **Security advisory**
|
> **Security advisory**
|
||||||
> By default, the communication between your NSPanel (ESPHome) and Home Assistant (HA) is not encrypted,
|
> The default communication between your NSPanel (ESPHome) and Home Assistant (HA) is not encrypted. This
|
||||||
> which means a person with access to your network could potentially monitor the communication between your panel and HA and replicate the service calls.
|
> could allow someone with network access to monitor and replicate the service calls. This risk is
|
||||||
> Although this is not a big issue for most of the service calls (turn-on a light,
|
> particularly relevant when controlling your alarm system.
|
||||||
close a curtain, etc.), it can be a problem when controlling your alarm system.
|
|
||||||
>
|
>
|
||||||
> Based on that, we hardly reccoment the use of API encryption for all users controlling an Alarm system via a NSPanel.
|
> To enhance security, we strongly recommend enabling API encryption for NSPanel users managing an Alarm
|
||||||
> You can easily enable this by following the ["API encryption" example available here](customization.md#api-encryption).
|
> system. Follow the instructions in the ["API encryption" example here](customization.md#api-encryption)
|
||||||
|
> to implement this security measure.
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
### Allow the device to make Home Assistant service calls
|
### Allow the device to make Home Assistant service calls
|
||||||
|
|
||||||
First, you have to configure your Home Assistant to allow your panel to make service calls.
|
First, you need to configure your Home Assistant to permit your NSPanel to make service calls. While
|
||||||
All other services are called from the Blueprint, however this requires the ESPHome to send
|
most services are handled via the Blueprint, ESPHome needs to send events with all necessary data in
|
||||||
an event containing in plain text all the information needed to the service call,
|
plain text for these service calls. To mitigate any security risks, alarm-related calls are managed
|
||||||
which could be a security issue, so all the alarm calls will be driven by the panel to ensure a safer environment.
|
directly by the panel.
|
||||||
|
|
||||||
To enable this option, go to your ESPHome integrations panel (Settings > Devices and Services > ESPHome)
|
To enable this:
|
||||||
and click "Configure" next to the entry related to your panel:
|
1. Go to your ESPHome integrations panel (Settings > Devices and Services > ESPHome).
|
||||||
|
2. Click "Configure" next to your panel's entry.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Then check the option "Allow the device to make Home Assistant service calls":
|
3. Select the "Allow the device to make Home Assistant service calls" option.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### Blueprint settings
|
### Blueprint settings
|
||||||
|
|
||||||
Alarm Control Panels entities can be assigned to any of the **Custom buttons** on the Home page or any button in the buttons pages.
|
To assign Alarm Control Panel entities to buttons:
|
||||||
|
1. Open the NSPanel Blueprint automation.
|
||||||
|
2. Find the button configuration section.
|
||||||
|
3. Choose a button and select your alarm control panel entity.
|
||||||
|
4. Click "Save" to complete setup.
|
||||||
|
|
||||||
Open the automation based on the NSPanel Blueprint and look for one of these sections,
|
|
||||||
choose the button you want to use, select your alarm control panel entity, click "Save", and your are done. :sunglasses:
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Follow these steps to ensure your NSPanel is correctly configured for controlling your alarm system.
|
||||||
## Controlling your alarm from your panel
|
## Controlling your alarm from your panel
|
||||||
|
|
||||||
When an alarm control panel is set in your Blueprint automation,
|
When an alarm control panel is configured in your Blueprint automation, the alarm icon appears on your
|
||||||
you will see the alarm icon on your panel's Home page.
|
NSPanel's Home page or the respective button page. This icon changes based on the alarm state, detailed
|
||||||
This icon will change following the alarm state as described in the table below.
|
in the following table.
|
||||||
|
|
||||||
A click on that icon will show the Alarm Control Panel page:
|
Clicking this button opens the Alarm Control Panel page. Here, you can adjust alarm settings with a
|
||||||
|
single click or return to the Home page.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
You can change your alarm settings with a single click on the button related to the new state
|
|
||||||
you want to set your alarm to, or close the page to go back to Home page.
|
|
||||||
|
|
||||||
|
|
||||||
### Description of states shown with the alarm icon
|
### Description of states shown with the alarm icon
|
||||||
|
|
||||||
State | Color | Icon | Icon name | Description
|
<!-- markdownlint-disable MD013 -->
|
||||||
|
State | Color | Icon | Icon Name | Description
|
||||||
-- | -- | -- | -- | --
|
-- | -- | -- | -- | --
|
||||||
disarmed | White ||mdi:shield-off-outline | The alarm is disarmed (off).
|
disarmed | White |  | mdi:shield-off-outline | The alarm is disarmed (off).
|
||||||
armed_home | Green || mdi:shield-home-outline | The alarm is armed in home mode.
|
armed_home | Green |  | mdi:shield-home-outline | The alarm is armed in home mode.
|
||||||
armed_away | Green || mdi:shield-lock-outline | The alarm is armed in away mode.
|
armed_away | Green |  | mdi:shield-lock-outline | The alarm is armed in away mode.
|
||||||
armed_night | Green || mdi:shield-moon-outline | The alarm is armed in night mode.
|
armed_night | Green |  | mdi:shield-moon-outline | The alarm is armed in night mode.
|
||||||
armed_vacation | Green || mdi:shield-airplane-outline | The alarm is armed in vacation mode.
|
armed_vacation | Green |  | mdi:shield-airplane-outline | The alarm is armed in vacation mode.
|
||||||
armed_custom_bypass | Green || mdi:shield-half-full | The alarm is armed in bypass mode.
|
armed_custom_bypass | Green |  | mdi:shield-half-full | The alarm is armed in bypass mode.
|
||||||
pending | Amber || mdi:shield-outline | The alarm is pending (towards triggered).
|
pending | Amber |  | mdi:shield-outline | The alarm is pending (towards triggered).
|
||||||
arming | Amber || mdi:shield-outline | The alarm is arming.
|
arming | Amber |  | mdi:shield-outline | The alarm is arming.
|
||||||
disarming | Amber || mdi:shield-off-outline | The alarm is disarming.
|
disarming | Amber |  | mdi:shield-off-outline | The alarm is disarming.
|
||||||
triggered | Red || mdi:shield-alert-outline | The alarm is triggered.
|
triggered | Red |  | mdi:shield-alert-outline | The alarm is triggered.
|
||||||
unknown / unavailable | White || mdi:shield-alert-outline | The alarm state is unknown or unavailable.
|
unknown/unavailable | White |  | mdi:shield-alert-outline | The alarm state is unknown or unavailable.
|
||||||
|
<!-- markdownlint-enable MD013 -->
|
||||||
|
|||||||
Reference in New Issue
Block a user