diff --git a/source/_components/satel_integra.markdown b/source/_components/satel_integra.markdown index b330fd29938..6f555e7670c 100644 --- a/source/_components/satel_integra.markdown +++ b/source/_components/satel_integra.markdown @@ -17,18 +17,20 @@ The `satel_integra` component will allow Home Assistant users who own a Satel In There is currently support for the following device types within Home Assistant: -- [Binary Sensor](/components/binary_sensor.satel_integra/): Reports on zone statuses +- [Binary Sensor](/components/binary_sensor.satel_integra/): Reports on zone or output statuses - [Alarm Control Panel](/components/alarm_control_panel.satel_integra/): Reports on alarm status, and can be used to arm/disarm the system The module communicates via Satel's open TCP protocol published on their website. It subscribes for new events coming from alarm system and reacts to them immediately. ## {% linkable_title Setup %} +Please note that **ETHM-1 module is currently not supported**: it does not provide functionality used by this extension. At the moment only ETHM-1 Plus module is supported. That might change in the future, but no promisses are given. + The library currently doesn't support encrypted connection to your alarm, so you need **to turn off encryption for integration protocol**. In Polish: "koduj integracje" must be unchecked. You will find this setting in your DloadX program. -A list of all zone IDs can be taken from DloadX program. +A list of all zone and output IDs can be acquired by running DloadX program and connecting to your alarm. -For more information on the available zone types, take a look at the [Binary Sensor](/components/binary_sensor.alarmdecoder/) documentation. Note: If no zones are specified, Home Assistant will not load any binary_sensor components." +For more information on the available zone visualisation types, take a look at the [Binary Sensor](/components/binary_sensor.alarmdecoder/) documentation. Note: If no zones or outputs are specified, Home Assistant will not load any binary_sensor components." ## {% linkable_title Configuration %} @@ -62,7 +64,21 @@ arm_home_mode: default: 1 type: integer zones: - description: "This module does not discover currently which zones are actually in use, so it will only monitor the ones defined in the configuration. For each zone, a proper ID must be given as well as its name (does not need to match the one specified in Satel Integra alarm)." + description: "This parameter lists the zones (or inputs) that will be visible by Home Assistant. For each zone, a proper ID must be given as well as its name. The name is arbitrary and does not need to match the one specified in Satel Integra alarm configuration." + required: false + type: [integer, list] + keys: + name: + description: Name of the zone. + required: true + type: string + type: + description: The zone type. + required: false + default: motion + type: string +outputs: + description: "Very similar to zones, but with outputs. Satel Integra uses outputs to inform external systems about different events. For example power failure, or that alarm started counting for exit or some other user-defined condition. They may be used for simple alarm-based automation. For more information please refer to Satel homepage and forums." required: false type: [integer, list] keys: @@ -101,9 +117,22 @@ satel_integra: 113: name: 'Entry door' type: 'opening' + outputs: + 05: + name: 'Garden lights trigger' + type: 'light' + 09: + name: 'Gate opening trigger' + type: 'opening' + 30: + name: 'Alarm triggered' + type: 'safety' + 32: + name: 'Alarm power problem' + type: 'safety' ``` -Having configured the zones, you can use them for automation, such as to react on the movement in your bedroom. +Having configured the zones and the outputs, you can use them for automation, such as to react on the movement in your bedroom. For example: ```yaml