Add satel integra multiple partitions and switchable outputs (#8922)

* Multiple partitions and switchable outputs 

Added multiple partitions support as well as switchable outputs. Configuration has been changed (breaking change).

* ✏️ Tweak

* Fixed yaml error (too much indent)

* Post review fixes

source/_components/satel_integra.markdown

@@ -12,6 +12,7 @@ ha_category:
   - Hub
   - Alarm
   - Binary Sensor
+  - Switch
 ha_release: 0.54
 ha_iot_class: Local Push
 redirect_from:
@@ -24,7 +25,8 @@ 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: Reports on zone or output statuses
-- Alarm Control Panel: Reports on alarm status, and can be used to arm/disarm the system
+- Switch: allows for setting states of selected outputs 
+- Alarm Control Panel: represents the partition (in Polish: "strefa"). Reports its status, and can be used to arm/disarm the the partition
 
 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.
 
@@ -34,7 +36,7 @@ Please note that **ETHM-1 module is currently not supported**: it does not provi
 
 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 and output IDs can be acquired by running DloadX program and connecting to your alarm.
+A list of all partition, zone and output IDs can be acquired by running DloadX program and connecting to your alarm.
 
 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."
 
@@ -59,13 +61,17 @@ port:
   required: false
   default: 7094
   type: integer
-partition:
+partitions:
-  description: The partition to operate on. Integra can support multiple partitions, this platform only supports one.
+  description: List of the partitions to operate on.
   required: false
-  default: 1
+  type: [integer, list]
-  type: integer
+  keys:
-arm_home_mode:
+    name:
-  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.
+      description: Name of the partition.
+      required: true
+      type: string    
+    arm_home_mode:
+      description: The mode in which the partition is armed when 'arm home' is used. Possible options are `1`,`2` or `3`. For more information on what the differences are between them, please refer to Satel Integra manual.
       required: false
       default: 1
       type: integer
@@ -89,14 +95,23 @@ outputs:
   type: [integer, list]
   keys:
     name:
-      description: Name of the zone.
+      description: Name of the output.
       required: true
       type: string
     type:
-      description: The zone type.
+      description: The type of the device - just for presentation.
       required: false
       default: motion
       type: string
+switchable_outputs:
+  description: "Switchable outputs. These will show up as switches within Home Assistant."
+  required: false
+  type: [integer, list]
+  keys:
+    name:
+      description: Name of the output.
+      required: true
+      type: string
 {% endconfiguration %}
 
 ## {% linkable_title Full examples %}
@@ -106,8 +121,12 @@ outputs:
 satel_integra:
   host: 192.168.1.100
   port: 7094
-  partition: 1
+  partitions:
-  arm_home_mode: 1
+    01:
+      name: 'House'
+      arm_home_mode: 2
+    02:
+      name: 'Garage'
   zones:
     01:
       name: 'Bedroom'
@@ -134,6 +153,14 @@ satel_integra:
     32:
       name: 'Alarm power problem'
       type: 'safety'
+  switchable_outputs:
+    05:
+      name: 'Gate open'
+    06:
+      name: 'Gate close'    
+    14:
+      name: 'Garden light'
+      
 ```
 
 Having configured the zones and the outputs, you can use them for automation, such as to react on the movement in your bedroom.