Update KNX component configuration variable (#6602)

* Update KNX component configuration variable

Update style of KNX component (all the 7 files) documentation to follow new configuration variables description.
Related to #6385.

* Update binary_sensor.knx.markdown

* 🚑 Syntax fix

* 🚑 Tweak after source check

* 🚑 Tweak after suggestion

source/_components/binary_sensor.knx.markdown

@@ -26,13 +26,29 @@ binary_sensor:
     address: '6/0/2'
 ```
 
-Configuration variables:
+{% configuration %}
-
+address:
-- **address** (*Required*): KNX group address of the binary sensor.
+  description: KNX group address of the binary sensor.
-- **name** (*Optional*): A name for this device used within Home Assistant.
+  required: true
-- **device_class** (*Optional*): HASS device class e.g., "motion".
+  type: string
-- **significant_bit** (*Optional*): Specify which significant bit of the KNX value should be used. Default is 1.
+name:
-- **reset_after** (*Optional*): Reset back to OFF state after specified milliseconds.
+  description: A name for this device used within Home Assistant.
+  required: false
+  type: string
+device_class:
+  description: HASS device class e.g., "motion".
+  required: false
+  type: string
+significant_bit:
+  description: Specify which significant bit of the KNX value should be used.
+  required: false
+  default: 1
+  type: integer
+reset_after:
+  description: Reset back to OFF state after specified milliseconds.
+  required: false
+  type: integer
+{% endconfiguration %}
 
 You can also attach actions to binary sensors (e.g., to switch on a light when a switch was pressed). In this example, one light is switched on when the button was pressed once and two others when the button was pressed a second time.
 
@@ -57,10 +73,23 @@ binary_sensor:
             service: homeassistant.turn_on
 ```
 
-Configuration variables:
+{% configuration %}
-
+name:
-- **name** (*Optional*): A name for this device used within Home Assistant.
+  description: A name for this device used within Home Assistant.
-- **counter** (*Optional*): Set to 2 if your only want the action to be executed if the button was pressed twice. To 3 for three times button pressed. Defaults to 1.
+  required: false
-- **hook** (Optional): Indicates if the automation should be executed on what state of the binary sensor. Values: "on" or "off". Defaults to "on".
+  type: string
-- **action**: Specify a list of actions analog to the [automation rules](/docs/automation/action/).
+counter:
-
+  description: Set to 2 if your only want the action to be executed if the button was pressed twice. To 3 for three times button pressed.
+  required: false
+  default: 1
+  type: integer
+hook:
+  description: Indicates if the automation should be executed on what state of the binary sensor. Values are "on" or "off".
+  required: false
+  default: "on"
+  type: string
+action:
+  description: Specify a list of actions analog to the [automation rules](/docs/automation/action/).
+  required: false
+  type: list
+{% endconfiguration %}

source/_components/cover.knx.markdown

@@ -33,17 +33,54 @@ cover:
     travelling_time_up: 61
 ```
 
-Configuration variables:
+{% configuration %}
-
+name:
-- **name** (*Optional*): A name for this device used within Home Assistant.
+  description: A name for this device used within Home Assistant.
-- **move_long_address**: KNX group address for moving the cover full up or down.
+  required: false
-- **move_short_address** (*Optional*): KNX group address for moving the cover short time up or down. If the KNX device has a stop group address you can use that here.
+  default: KNX Cover
-- **position_address** (*Optional*): KNX group address for moving the cover to the dedicated position.
+  type: string
-- **position_state_address** (*Optional*): Separate KNX group address for requesting the current position of the cover.
+move_long_address:
-- **angle_address** (*Optional*): KNX group address for moving the cover to the dedicated angle.
+  description: KNX group address for moving the cover full up or down.
-- **angle_state_address** (*Optional*): Separate KNX group address for requesting the current angle of cover.
+  required: false
-- **travelling_time_down** (*Optional*): Time cover needs to travel down in seconds. Needed to calculate the intermediate positions of cover while traveling. Defaults to 25.
+  type: string
-- **travelling_time_up** (*Optional*): Time cover needs to travel up in seconds. Needed to calculate the intermediate positions of cover while traveling. Defaults to 25.
+move_short_address:
-- **invert_position** (*Optional*): Set this to true if your actuator report fully closed as 100%.
+  description: KNX group address for moving the cover short time up or down. If the KNX device has a stop group address you can use that here.
-- **invert_angle** (*Optional*): Set this to true if your actuator reports tilt fully closed as 100%.
+  required: false
-
+  type: string
+position_address:
+  description: KNX group address for moving the cover to the dedicated position.
+  required: false
+  type: string
+position_state_address:
+  description: Separate KNX group address for requesting the current position of the cover.
+  required: false
+  type: string
+angle_address:
+  description: KNX group address for moving the cover to the dedicated angle.
+  required: false
+  type: string
+angle_state_address:
+  description: Separate KNX group address for requesting the current angle of cover.
+  required: false
+  type: string
+travelling_time_down:
+  description: Time cover needs to travel down in seconds. Needed to calculate the intermediate positions of cover while traveling.
+  required: false
+  default: 25
+  type: integer
+travelling_time_up:
+  description: Time cover needs to travel up in seconds. Needed to calculate the intermediate positions of cover while traveling.
+  required: false
+  default: 25
+  type: integer
+invert_position:
+  description: Set this to true if your actuator report fully closed as 100%.
+  required: false
+  default: false
+  type: boolean
+invert_angle:
+  description: Set this to true if your actuator reports tilt fully closed as 100%.
+  required: false
+  default: false
+  type: boolean
+{% endconfiguration %}

source/_components/knx.markdown

@@ -23,7 +23,7 @@ The component requires a local KNX/IP interface like the [Weinzierl 730](http://
 </p>
 
 There is currently support for the following device types within Home Assistant:
- 
+
 - [Binary Sensor](/components/binary_sensor.knx)
 - [Cover](/components/cover.knx)
 - [Sensor](/components/sensor.knx)
@@ -47,12 +47,16 @@ Optional, recommended for large KNX installations (>100 devices) and/or if you w
 knx:
   config_file: '/path/to/xknx.yaml'
 ```
-
+{% configuration %}
-- **config_file** (*Optional*): The path for XKNX configuration file.
+config_file:
+  description: The path for XKNX configuration file.
+  required: false
+  type: string
+{% endconfiguration %}
 
 If the auto detection of the KNX/IP device does not work you can specify ip/port of the tunneling device:
 
-```yaml 
+```yaml
 knx:
   tunneling:
     host: '192.168.2.23'
@@ -60,9 +64,17 @@ knx:
     local_ip: '192.168.2.109'
 ```
 
-- **host**: Host of the KNX/IP tunneling device.
+{% configuration %}
-- **port**: Port of the KNX/IP tunneling device.
+host:
-- **local_ip**: IP of the local interface.
+  description: Host of the KNX/IP tunneling device.
+  type: string
+port:
+  description: Port of the KNX/IP tunneling device.
+  type: integer
+local_ip:
+  description: IP of the local interface.
+  type: string
+{% endconfiguration %}
 
 Explicit connection to a KNX/IP routing device:
 
@@ -73,7 +85,11 @@ knx:
      local_ip: '192.168.2.109'
 ```
 
-- **local_ip**: The local IP address of interface (which should be used for multicasting).
+{% configuration %}
+local_ip:
+  description: The local IP address of interface (which should be used for multicasting).
+  type: string
+{% endconfiguration %}
 
 ```yaml
 knx:
@@ -81,9 +97,21 @@ knx:
   fire_event_filter: ["1/0/*", "6/2,3,4-6/*"]
 ```
 
-- **fire_event** (*Optional*): If set to True, platform will write all received KNX messages to event bus
+{% configuration %}
-- **fire_event_filter** (*Optional*): If `fire_event` is set `fire_event_filter` has to be specified. `fire_event_filter` defines a list of patterns for filtering KNX addresses. Only telegrams which match this pattern are sent to the HOme Assistant event bus. 
+fire_event:
-- **state_updater** (*Optional*): The component will collect the current state of each configured device from the KNX bus to display it correctly within Home-Assistant. Set this option to False to prevent this behavior.
+  description: If set to True, platform will write all received KNX messages to event bus
+  required: inclusive
+  type: boolean
+fire_event_filter:
+  description: If `fire_event` is set `fire_event_filter` has to be specified. `fire_event_filter` defines a list of patterns for filtering KNX addresses. Only telegrams which match this pattern are sent to the HOme Assistant event bus.
+  required: inclusive
+  type: [list, string]
+state_updater:
+  description: The component will collect the current state of each configured device from the KNX bus to display it correctly within Home-Assistant. Set this option to False to prevent this behavior.
+  required: false
+  default: true
+  type: boolean
+{% endconfiguration %}
 
 ### {% linkable_title Services %}
 
@@ -91,12 +119,18 @@ In order to directly interact with the KNX bus, you can now use the following se
 
 ```
 Domain: knx
-Service: send 
+Service: send
 Service Data: {"address": "1/0/15", "payload": 0}
 ```
 
-* **address**: KNX group address
+{% configuration %}
-* **payload**: Payload, either an integer or an array of integers
+address:
+  description: KNX group address
+  type: string
+payload:
+  description: Payload, either an integer or an array of integers
+  type: [integer, list]
+{% endconfiguration %}
 
 ### {% linkable_title Exposing sensor values or time to knx bus %}
 
@@ -115,11 +149,18 @@ knx:
       address: '0/0/23'
 ```
 
-* **type**: Type of the exposed value. Either time or datetime or any supported type of [KNX Sensor](/components/sensor.knx/) (e.g., "temperature" or "humidity").
+{% configuration %}
-* **entity_id**: Entity id of the HASS component to be exposed. Not necessary for types time and datetime.
+type:
-* **address**: KNX group address.
+  description: Type of the exposed value. Either time or datetime or any supported type of [KNX Sensor](/components/sensor.knx/) (e.g., "temperature" or "humidity").
+  type: string
+entity_id:
+  description: Entity id of the HASS component to be exposed. Not necessary for types time and datetime.
+  type: string
+address:
+  description: KNX group address.
+  type: string
+{% endconfiguration %}
 
 ### {% linkable_title Known issues %}
 
 Due to lame multicast support the routing abstraction and the gateway scanner only work with Python >=3.5.
-

source/_components/light.knx.markdown

@@ -9,7 +9,7 @@ sharing: true
 footer: true
 logo: knx.png
 ha_category: Light
-ha_release: 0.44 
+ha_release: 0.44
 ha_iot_class: "Local Polling"
 ---
 
@@ -26,21 +26,39 @@ To use your KNX light in your installation, add the following lines to your `con
 # Example configuration.yaml entry
 light:
   - platform: knx
-    name: Kitchen-Light-1
     address: '1/0/9'
-    brightness_address: '1/0/11'
 ```
 
-Configuration variables:
+{% configuration %}
-
+address:
-- **address** (*Required*): KNX group address for switching the light on and off.
+  description: KNX group address for switching the light on and off.
-- **name** (*Optional*): A name for this device used within Home Assistant.
+  required: true
-- **brightness_address** (Optional): KNX group address for dimming light.
+  type: string
-- **state_address** (*Optional*): separate KNX group address for retrieving the switch state of the light.
+name:
-- **brightness_state_address** (*Optional*): separate KNX group address for retrieving the dimmed state of the light.
+  description: A name for this device used within Home Assistant.
-- **color_address** (*Optional*): separate KNX group address for setting the color of the light.
+  required: false
-- **color_state_address** (*Optional*): separate KNX group address for retrieving the color of the light.
+  type: string
+brightness_address:
+  description: KNX group address for dimming light.
+  required: false
+  type: string
+state_address:
+  description: separate KNX group address for retrieving the switch state of the light.
+  required: false
+  type: string
+brightness_state_address:
+  description: separate KNX group address for retrieving the dimmed state of the light.
+  required: false
+  type: string
+color_address:
+  description: separate KNX group address for setting the color of the light.
+  required: false
+  type: string
+color_state_address:
+  description: separate KNX group address for retrieving the color of the light.
+  required: false
+  type: string
+{% endconfiguration %}
 
 Some KNX devices can change their state internally without any messages on the KNX bus, e.g., if you configure a timer on a channel. The optional `state_address` can be used to inform Home Assistant about these state changes. If a KNX message is seen on the bus addressed to the given state address, this will overwrite the state of the switch object.
 For switching/light actuators that are only controlled by a single group address and can't change their state internally, you don't have to configure the state address.
-

source/_components/notify.knx.markdown

@@ -28,8 +28,13 @@ notify:
     address: '5/1/10'
 ```
 
-Configuration variables:
+{% configuration %}
-
+address:
-* **address** (*Required*): KNX group address of the notification.
+  description: KNX group address of the notification.
-* **name** (*Optional*): A name for this device used within Home Assistant.
+  required: true
-
+  type: string
+name:
+  description: A name for this device used within Home Assistant.
+  required: false
+  type: string
+{% endconfiguration %}

source/_components/scene.knx.markdown

@@ -29,9 +29,17 @@ scene:
     scene_number: 23
 ```
 
-Configuration variables:
+{% configuration %}
-
+address:
-- **address** (*Required*): KNX group address of the binary sensor.
+  description: KNX group address of the binary sensor.
-- **scene_number** (*Required*): Zero-indexed KNX scene number to be activated.
+  required: true
-- **name** (*Optional*): A name for this device used within Home Assistant.
+  type: string
-
+scene_number:
+  description: Zero-indexed KNX scene number to be activated.
+  required: true
+  type: integer
+name:
+  description: A name for this device used within Home Assistant.
+  required: false
+  type: string
+{% endconfiguration %}

source/_components/sensor.knx.markdown

@@ -13,7 +13,7 @@ ha_release: 0.29
 ha_iot_class: "Local Push"
 ---
 
-The `knx` sensor platform allows you to monitor [KNX](http://www.knx.org) sensors. 
+The `knx` sensor platform allows you to monitor [KNX](http://www.knx.org) sensors.
 
 The `knx` component must be configured correctly, see [KNX Component](/components/knx).
 
@@ -30,10 +30,21 @@ sensor:
 ```
 
 
+{% configuration %}
+address:
+  description: KNX group address of the sensor.
+  required: true
+  type: string
+name:
+  description: A name for this device used within Home Assistant.
+  required: false
+  type: string
+type:
+  description: A type from the following table can be defined. The DPT of the group address should match the expected KNX DPT to be parsed correctly.
+  required: false
+  type: string
+{% endconfiguration %}
 
-- **address** (*Required*): KNX group address of the sensor.
-- **name** (*Optional*): A name for this device used within Home Assistant.
-- **type** (*Optional*): A type from the following table can be defined. The DPT of the group address should match the expected KNX DPT to be parsed correctly. 
 
 | type               | unit | expected KNX DPT |
 |--------------------|------|------------------|