From f6b053edf21e46493c9ad069da348b7d79550172 Mon Sep 17 00:00:00 2001 From: endor-force <1937941+endor-force@users.noreply.github.com> Date: Thu, 30 Nov 2017 21:40:51 +0100 Subject: [PATCH 1/4] Create tellstick.markdown --- source/_addons/tellstick.markdown | 1 + 1 file changed, 1 insertion(+) create mode 100644 source/_addons/tellstick.markdown diff --git a/source/_addons/tellstick.markdown b/source/_addons/tellstick.markdown new file mode 100644 index 000000000000..8b137891791f --- /dev/null +++ b/source/_addons/tellstick.markdown @@ -0,0 +1 @@ + From 85c356067692273052e5cb63f760575879e5c4c9 Mon Sep 17 00:00:00 2001 From: endor-force <1937941+endor-force@users.noreply.github.com> Date: Thu, 30 Nov 2017 22:23:42 +0100 Subject: [PATCH 2/4] Created basics for tellstick addon --- source/_addons/tellstick.markdown | 65 +++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) diff --git a/source/_addons/tellstick.markdown b/source/_addons/tellstick.markdown index 8b137891791f..ebc45f7040f8 100644 --- a/source/_addons/tellstick.markdown +++ b/source/_addons/tellstick.markdown @@ -1 +1,66 @@ +--- +layout: page +title: "TellStick" +description: "Telldus TellStick service enabler and tools." +date: 2017-11-30 21:43 +sidebar: true +comments: false +sharing: true +footer: true +featured: false +--- +Setting up the [Tellstick](http://telldus.com) service and tools contained in the [telldus-core](http://developer.telldus.com/) 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)](https://developer.telldus.com/wiki/TellStick_conf). + +After any changes has been made to the configuration you need to restart the add-on for the changes to take effect. + +Example for adding more devices (note the comma separator between devices): + +```json +{ + "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" + } + ] +} +``` + +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 `true` or `false` and tells a dimmer if is should fade smooth or instand 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. + + +In order to communicate with the add-on you will also need to add Hass.io specific data in the `configuration.yaml` file. +For regular Home Assistant you add `tellstick:` but for the add-on you need to add internal communication details. + +``` +tellstick: + host: core-tellstick + port: [50800, 50801] +``` + +To add [lights](https://home-assistant.io/components/light.tellstick/), [sensors](https://home-assistant.io/components/sensor.tellstick/) and [switches](https://home-assistant.io/components/switch.tellstick/) you follow the guidelines for each type individually that is [described for Home Assistant](https://home-assistant.io/components/tellstick/) From e780371ce9d168a9f5f65d4ea9b8c00653e16387 Mon Sep 17 00:00:00 2001 From: endor-force <1937941+endor-force@users.noreply.github.com> Date: Thu, 30 Nov 2017 22:26:00 +0100 Subject: [PATCH 3/4] Updated formatting --- source/_addons/tellstick.markdown | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/source/_addons/tellstick.markdown b/source/_addons/tellstick.markdown index ebc45f7040f8..4697af0ce843 100644 --- a/source/_addons/tellstick.markdown +++ b/source/_addons/tellstick.markdown @@ -12,11 +12,13 @@ featured: false Setting up the [Tellstick](http://telldus.com) service and tools contained in the [telldus-core](http://developer.telldus.com/) 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)](https://developer.telldus.com/wiki/TellStick_conf). After any changes has been made to the configuration you need to restart the add-on for the changes to take effect. + Example for adding more devices (note the comma separator between devices): ```json @@ -42,6 +44,7 @@ Example for adding more devices (note the comma separator between devices): } ``` + Configuration variables: - **id** (*Required*): This is a number and must be unique for each device. @@ -54,8 +57,10 @@ Configuration variables: - **code** (*Optional*): A number series based on ones and zeroes often used for dip-switch based devices. + + In order to communicate with the add-on you will also need to add Hass.io specific data in the `configuration.yaml` file. -For regular Home Assistant you add `tellstick:` but for the add-on you need to add internal communication details. +For regular Home Assistant you only add `tellstick:` but for Hass.io and this add-on you need to add internal communication details. ``` tellstick: @@ -63,4 +68,6 @@ tellstick: port: [50800, 50801] ``` + + To add [lights](https://home-assistant.io/components/light.tellstick/), [sensors](https://home-assistant.io/components/sensor.tellstick/) and [switches](https://home-assistant.io/components/switch.tellstick/) you follow the guidelines for each type individually that is [described for Home Assistant](https://home-assistant.io/components/tellstick/) From f868fffbc3c88b22c071e5640cd0fc599e14ffca Mon Sep 17 00:00:00 2001 From: endor-force <1937941+endor-force@users.noreply.github.com> Date: Thu, 30 Nov 2017 22:30:16 +0100 Subject: [PATCH 4/4] Update tellstick.markdown --- source/_addons/tellstick.markdown | 61 +++++++++++++++++-------------- 1 file changed, 34 insertions(+), 27 deletions(-) diff --git a/source/_addons/tellstick.markdown b/source/_addons/tellstick.markdown index 4697af0ce843..33b301440fe3 100644 --- a/source/_addons/tellstick.markdown +++ b/source/_addons/tellstick.markdown @@ -19,32 +19,6 @@ After installation you are presented with a default and example configuration, t After any changes has been made to the configuration you need to restart the add-on for the changes to take effect. -Example for adding more devices (note the comma separator between devices): - -```json -{ - "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" - } - ] -} -``` - - Configuration variables: - **id** (*Required*): This is a number and must be unique for each device. @@ -62,12 +36,45 @@ Configuration variables: In order to communicate with the add-on you will also need to add Hass.io specific data in the `configuration.yaml` file. For regular Home Assistant you only add `tellstick:` but for Hass.io and this add-on you need to add internal communication details. -``` + +```yaml +# Example configuration.yaml entry + tellstick: host: core-tellstick port: [50800, 50801] + ``` To add [lights](https://home-assistant.io/components/light.tellstick/), [sensors](https://home-assistant.io/components/sensor.tellstick/) and [switches](https://home-assistant.io/components/switch.tellstick/) you follow the guidelines for each type individually that is [described for Home Assistant](https://home-assistant.io/components/tellstick/) + + +## {% linkable_title Examples %} + + +Example for adding more devices in the add-on configuration (note the comma separator between devices): + +```json +{ + "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" + } + ] +} +```