+ + TellStick +
++
Setting up the Tellstick service and tools contained in the telldus-core package and adding configuration to enable Tellstick and Tellstick Duo to work on your Hass.io.
+To use this add-on, you first install it from the list of Built-in add-ons in Hass.io. +After installation you are presented with a default and example configuration, to alter this you must follow both the JSON format and also be aligned with the valid parameters for Tellstick configuration file (tellstick.conf).
+After any changes has been made to the configuration you need to restart the add-on for the changes to take effect.
+Configuration variables:
+-
+
- id (Required): This is 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 parameter model 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 selflearning 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 house. +
- fade (Optional): Fade is either
trueorfalseand tells a dimmer if is 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.
# Example configuration.yaml entry
+
+tellstick:
+ host: core-tellstick
+ port: [50800, 50801]
+
+To add lights, sensors and switches you follow the guidelines for each type individually that is described for Home Assistant
+The add-on will also enable you to interact with tdtool via a Home Assistant services call, see example below for selflearning device.
+Examples
+Example for adding more devices in the add-on configuration (note the comma separator between devices):
+{
+ "devices": [
+ {
+ "id": 1,
+ "name": "Outdoor light",
+ "protocol": "everflourish",
+ "model": "selflearning-switch",
+ "house": "A",
+ "unit": "1"
+ },
+ {
+ "id": 2,
+ "name": "Hallway dimmer",
+ "protocol": "risingsun",
+ "model": "selflearning-dimmer",
+ "house": "A",
+ "unit": "2"
+ }
+ ]
+}
+If you wish to teach a selflearning device in your TellStick configuration:
+Go to Home Assistant service call in Developer tools +Select
+-
+
- Domain
hassio
+ - Service:
addon_stdin
+ - Service Data:
{"addon":"core_tellstick","input":"learn 1"}
+
Replace 1 with the corresponding ID of the device in your TellStick configuration.