Update Kira component configuration variable (#6671)

Update style of Kira component documentation to follow new configuration variables description.
Related to #6385.
This commit is contained in:
Klaas Schoute 2018-10-11 17:26:45 +02:00 committed by Franck Nijhof
parent 2073f22319
commit 1154e982cd

View File

@ -38,16 +38,45 @@ kira:
port: 65432 port: 65432
``` ```
Configuration variables: {% configuration %}
sensors:
- **sensors** (*Optional*): Kira sensors to register description: Kira sensors to register.
- **name** (*Optional*): Name of this sensor. required: false
- **host** (*Optional*): Bind address for this sensor. 0.0.0.0 is default. type: map
- **port** (*Optional*): UDP port to listen for packets on. 65432 is default. keys:
- **remotes** (*Optional*): Remote Kira modules to register name:
- **name** (*Optional*): Name of this remote. description: Name of this sensor.
- **host** (*Required*): IP address of Kira module to send commands to. required: false
- **port** (*Optional*): UDP port to send packets to. 65432 is default. type: string
host:
description: Bind address for this sensor.
required: false
default: 0.0.0.0
type: string
port:
description: UDP port to listen for packets on.
required: false
default: 65432
type: integer
remotes:
description: Remote Kira modules to register.
required: false
type: map
keys:
name:
description: Name of this remote.
required: false
type: string
host:
description: IP address of Kira module to send commands to.
required: true
type: string
port:
description: UDP port to send packets to.
required: false
default: 65432
type: integer
{% endconfiguration %}
If no sensors or remotes are specified, a sensor with default values will be added. If no sensors or remotes are specified, a sensor with default values will be added.
@ -70,13 +99,30 @@ The first time the Kira component is loaded, `kira_codes.yaml` will be created i
type: nec type: nec
``` ```
Configuration variables: {% configuration %}
name:
- **name** (*Required*): The name of this code. description: The name of this code.
- **code** (*Required*): The data for this code (see below). required: true
- **device** (*Optional*): The device this code is associated with. Default is "unknown". type: string
- **type** (*Optional*): The type of this code. If this field is omitted, the type will be autodetected if possible. code:
- **repeat** (*Optional*): The number of times to repeat this code (on transmit). Default is 1. description: The data for this code (see below).
required: true
type: string
device:
description: The device this code is associated with.
required: false
default: unknown
type: string
type:
description: The type of this code. If this field is omitted, the type will be autodetected if possible.
required: false
type: string
repeat:
description: The number of times to repeat this code (on transmit).
required: false
default: 1
type: integer
{% endconfiguration %}
Some manufacturers (e.g., Samsung) require an IR code to be sent a number of times in a row in rapid succession (usually 3). This doesn't apply to the vast majority of devices, but it can be helpful if needed. Some manufacturers (e.g., Samsung) require an IR code to be sent a number of times in a row in rapid succession (usually 3). This doesn't apply to the vast majority of devices, but it can be helpful if needed.