Skip to content

Commit 224732a

Browse files
c-softc-soft
authored
Multiple partitions and switchable outputs
Added multiple partitions support as well as switchable outputs. Configuration has been changed (breaking change).
1 parent 0a8e58c commit 224732a

File tree

1 file changed

+45
-17
lines changed

1 file changed

+45
-17
lines changed

‎source/_components/satel_integra.markdown

Lines changed: 45 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -12,19 +12,21 @@ ha_category:
1212
- Hub
1313
- Alarm
1414
- Binary Sensor
15+
- Switch
1516
ha_release: 0.54
1617
ha_iot_class: "Local Push"
1718
redirect_from:
1819
- /components/alarm_control_panel.satel_integra/
1920
- /components/binary_sensor.satel_integra/
2021
---
2122

22-
The `satel_integra` component will allow Home Assistant users who own a Satel Integra alarm panel to leverage their alarm system and its sensors to provide Home Assistant with information about their homes. Connectivity between Home Assistant and the alarm is accomplished through a ETHM extension module that must be installed in the alarm. Compatible with ETHM-1 Plus module with firmware version > 2.00 (version 2.04 confirmed).
23+
The `satel_integra` component will allow Home Assistant users who own a Satel Integra alarm panel to leverage their alarm system and its sensors to provide Home Assistant with information about their homes. Connectivity between Home Assistant and the alarm is accomplished through a ETHM extension module that must be installed in the alarm. Compatible with ETHM-1 Plus module with firmware version > 2.00 (version 2.04 confirmed).
2324

2425
There is currently support for the following device types within Home Assistant:
2526

2627
- Binary Sensor: Reports on zone or output statuses
27-
- Alarm Control Panel: Reports on alarm status, and can be used to arm/disarm the system
28+
- Switch: allows for setting states of selected outputs
29+
- Alarm Control Panel: represents the partition (in Polish: "strefa"). Reports its status, and can be used to arm/disarm the the partition
2830

2931
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.
3032

@@ -34,7 +36,7 @@ Please note that **ETHM-1 module is currently not supported**: it does not provi
3436

3537
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.
3638

37-
A list of all zone and output IDs can be acquired by running DloadX program and connecting to your alarm.
39+
A list of all partition, zone and output IDs can be acquired by running DloadX program and connecting to your alarm.
3840

3941
For the Binary Sensor check the [type/class](/components/binary_sensor/) list for a possible visualization of your zones. Note: If no zones or outputs are specified, Home Assistant will not load any binary_sensor components."
4042

@@ -59,16 +61,20 @@ port:
5961
required: false
6062
default: 7094
6163
type: integer
62-
partition:
63-
description: The partition to operate on. Integra can support multiple partitions, this platform only supports one.
64-
required: false
65-
default: 1
66-
type: integer
67-
arm_home_mode:
68-
description: The mode in which arm Satel Integra when 'arm home' is used. Possible options are `1`,`2` or `3`. For more information on what are the differences between them, please refer to Satel Integra manual.
69-
required: false
70-
default: 1
71-
type: integer
64+
partitions:
65+
description: List of the partitions to operate on.
66+
required: true
67+
type: [integer, list]
68+
keys:
69+
name:
70+
description: Name of the partition.
71+
required: true
72+
type: string
73+
arm_home_mode:
74+
description: The mode in which arm the partition when 'arm home' is used. Possible options are `1`,`2` or `3`. For more information on what are the differences between them, please refer to Satel Integra manual.
75+
required: false
76+
default: 1
77+
type: integer
7278
zones:
7379
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."
7480
required: false
@@ -89,14 +95,24 @@ outputs:
8995
type: [integer, list]
9096
keys:
9197
name:
92-
description: Name of the zone.
98+
description: Name of the output.
9399
required: true
94100
type: string
95101
type:
96-
description: The zone type.
102+
description: The type of the device - just for presentation.
97103
required: false
98104
default: motion
99105
type: string
106+
switchable_outputs:
107+
description: "Switchable outputs. These will show up as switches within Home Assistant."
108+
required: false
109+
type: [integer, list]
110+
keys:
111+
name:
112+
description: Name of the output.
113+
required: true
114+
type: string
115+
100116
{% endconfiguration %}
101117

102118
## {% linkable_title Full examples %}
@@ -106,8 +122,12 @@ outputs:
106122
satel_integra:
107123
host: 192.168.1.100
108124
port: 7094
109-
partition: 1
110-
arm_home_mode: 1
125+
partitions:
126+
01:
127+
name: 'House'
128+
arm_home_mode: 2
129+
02:
130+
name: 'Garage'
111131
zones:
112132
01:
113133
name: 'Bedroom'
@@ -134,6 +154,14 @@ satel_integra:
134154
32:
135155
name: 'Alarm power problem'
136156
type: 'safety'
157+
switchable_outputs:
158+
05:
159+
name: 'Gate open'
160+
06:
161+
name: 'Gate close'
162+
14:
163+
name: 'Garden light'
164+
137165
```
138166

139167
Having configured the zones and the outputs, you can use them for automation, such as to react on the movement in your bedroom.

0 commit comments

Comments
 (0)