jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-19 07:17:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update tellstick add-on component configuration (#7541)

Browse Source
This commit is contained in:
Klaas Schoute 2018-11-17 11:46:53 +01:00 committed by Fabian Affolter
parent c4de692296
commit 9fb2734eeb
1 changed files with 36 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
source/_addons/tellstick.markdown
View File

@ -17,20 +17,8 @@ After installation you are presented with a default and example configuration, t
After any changes have been made to the configuration, you need to restart the add-on for the changes to take effect.
Configuration variables:
- **id** (*Required*): A number and must be unique for each device.
- **name** (*Required*): A name for easy identification of the device.
- **protocol** (*Required*): This is the protocol the device uses. More on the different protocols later down.
- **model** (*Optional*): The model parameter is only used by some protocols where there exists different types of devices using the same protocol. This can be dimmers versus non-dimmers, codeswitch versus self-learning, etc.
- **house** (*Optional*): Depending on protocol the values here can vary a lot to identify or group per house or type.
- **unit** (*Optional*): Unit identifier, in most cases a value between 1 to 16 and often used in combination with the house.
- **fade** (*Optional*): Fade is either `true` or `false` and tells a dimmer if it should fade smooth or instant between values (only for IKEA protocol as it seems).
- **code** (*Optional*): A number series based on ones and zeroes often used for dip-switch based devices.
You will need to add internal communication details to `configuration.yaml` to enable the integration from Hass.io and the add-on.
```yaml
# Example configuration.yaml entry
tellstick:
@ -69,11 +57,47 @@ Example for adding more devices in the add-on configuration (note the comma sepa
}
```
{% configuration %}
id:
description: A number and must be unique for each device.
required: true
type: integer
name:
description: A name for easy identification of the device.
required: true
type: string
protocol:
description: This is the protocol the device uses. More on the different protocols later down.
required: true
type: string
model:
description: The model parameter is only used by some protocols where there exists different types of devices using the same protocol. This can be dimmers versus non-dimmers, codeswitch versus self-learning, etc.
required: false
type: string
house:
description: Depending on protocol the values here can vary a lot to identify or group per house or type.
required: false
type: string
unit:
description: Unit identifier, in most cases a value between 1 to 16 and often used in combination with the house.
required: false
type: integer
fade:
description: Fade is either `true` or `false` and tells a dimmer if it should fade smooth or instant between values (only for IKEA protocol as it seems).
required: false
type: boolean
code:
description: A number series based on ones and zeroes often used for dip-switch based devices.
required: false
type: string
{% endconfiguration %}
## {% linkable_title Service calls %}
If you wish to teach a self-learning device in your TellStick configuration:
Go to Home Assistant [service call](http://hassio.local:8123/dev-service) in Developer tools and select.
- Service: `hassio.addon_stdin`
- Enter service Data:
`{"addon":"core_tellstick","input":{"function":"learn","device":"1"}}`