View source for Basic Tellstick functionality with Domoticz

__NOTOC__

'''This guide will explain how to switch on and off devices with your Tellstick together with Domoticz.'''

==Important information before you begin==

 '''Tellstick support built into Domoticz is only at early stages. Right now there is only support for dimmers and on/off switches and configuration of devices has to be done in tellstick.conf.'''

 '''Contribute to this guide. Correct things that are wrong and add your findings'''

==Links that can be useful==
 [http://elinux.org/R-Pi_Tellstick_core Installing telldus core(Latest Stable release 2.1.1) on Raspbian (Raspberry PI)]
 [[Basic Tellstick functionality with Domoticz/Install Telldus core latest release RaspberryPi|Installing telldus core(Latest Beta) from Trunk on Raspbian (Raspberry PI)]]
 [https://github.com/evilmachina/telldus-core-js/wiki/Installing-telldus-core-on-BeagleBone Installing telldus core on BeagleBone]
 [http://www.tagpad.net/rpm/ RPM (of telldus-core) for Fedora 18 or later] [http://www.telldus.com/forum/viewtopic.php?f=8&t=3288 Instructions (in Swedish) and support]

==Some prerequisites and specifications==

*To get the Tellstick working on your Raspberry/Raspbian or linux you need to install '''Telldus Core'''. I will not cover this in my guide since there are plenty of guides for this out there. Just search for something like ''install telldus core on raspberry pi''.

*After installing Telldus Core you also need to configure your devices/switches. This is done by adding them in the file '''tellstick.conf'''.

Information can be found on [http://developer.telldus.se/wiki/TellStick_conf Telldus Wiki]

Configuration

*Of course you also need to have Domoticz installed on your Raspberry. You can find a [[Installing_and_running_Domoticz_on_a_Raspberry_PI|guide for that here]]


==Adding Tellstick devices in Domoticz==

Ok, so now I assume that you can turn your switches on and off with tdtool from the command line. If you don't know this then you need to go back and study the prerequisities again.

Run command '''man tdtool''' for a complete manual.

In Domoticz goto hardware and add a new Tellstick device. Now all devices tellstick devices should be added to the device tab. If they are not added try to restart domoticz.

==Compiling Domoticz with Tellstick support==
When you run cmake it will detect if it is possible to build support for tellstick or not.

In order to be able to support tellstick Domoticz must have the telldus-core devel package installed on the system that compiles the source code. On systems with apt package manager that can be done like this:

Edit the file '''/etc/apt/sources.list''' and add the following line:

<code>
deb http://download.telldus.com/debian/ stable main
</code>

Above link is giving key error. Read more here http://developer.telldus.se/ticket/473

Try below instead. Tried on Debian 9 Stretch Full('''not RPI''')

<code>
deb http://s3.eu-central-1.amazonaws.com/download.telldus.com stable main
</code>

Run the following commands to install the key and to install the headers and libraries:

<code>
wget -q http://download.telldus.se/debian/telldus-public.key -O- | sudo apt-key add -

sudo apt-get update

sudo apt-get install libtelldus-core-dev
</code>

Then you can run cmake and make as normal and Domoticz should have the Tellstick option in the create hardware dropdown.

==Old workaround for Tellstick==
If you use a older version of Domoticz or your version was not compiled with Tellstick support you can still use this guide to be able to turn switches on and off.

Since your Domoticz doesn't know about Tellstick or about it's devices, we need to add virtual devices in Domoticz that act as our Tellstick devices.

*Browse to your Domoticz installation and select '''Setup''' --> '''Hardware'''.
*Select '''Type: Dummy''', enter a '''name''' for the dummy hardware and press '''Add'''.
*To add a new switch navigate to the '''Switches''' page and press '''Manual Light/Switch'''.
*Select the dummy hardware you created earlier and give your switch a name. Select '''Switch Type: On/Off'''. Type, House Code and Unit Code shouldn't be of any importance. Finally press '''Add Device'''
*Go to '''Setup''' --> '''Devices''' and note down the Idx of your newly created switch. You will need this later.

This concludes the setup inside of Domoticz. Feel free to add as many virtual switches as you like.


===Connect the virtual switches to a Tellstick switch===
Now we just need something between the virtual switches we created and the Tellstick switches. In the Domoticz installation, ''domoticz/scripts/'' , there's a Bash script called '''_domoticz_main'''.
As long as the script is named with the underscore in the beginning it isn't active. When we rename it to just '''domoticz_main''' this script will be executed EVERY TIME a switch is flipped in Domoticz. If you are using Linux ensure that all users can execute this script by setting '''chmod +x domoticz_main'''

Find the script in your installation and have a look at it. You'll see that it's a shell script that's fed with some different input parameters, e.g. ''device_id'' and ''status''. All these parameters are sent to the script every time a domoticz-switch is pressed in the GUI.


Now I suggest that you create some variables of your own, to save time and make the code easier to read.
Create variables for tdtool "On" and "Off":
 tdtoolOn="tdtool --on"
 tdtoolOff="tdtool --off"


You can also create variables for your switches, like:
 bedroom=1
 kitchen=2
 <NAME>=Y
The numbers in these parameters needs to match the switch ID in tdtool. You can get a list of all your switches in tdtool by typing ''tdtool -l''.


So now it's just a matter of writing your code. Some simple if-else statements is sufficient to turn on and off switches. Here's a sample statement:
 if [ "$device_id" = 6 ] ; then
    if [ "$status" = "On" ] ; then
       $tdtoolOn $bedroom &
    else [ "$status" = "Off" ] then
       $tdtoolOff $bedroom &
    fi
 fi
'''The code above says:''' IF the device_id (Idx of the pressed domoticz switch) is "6", and IF the status(code) sent is 'On', DO "$on $bedroom &" (turn on the bedroom switch). ELSE if the status sent is 'Off', DO "$off $bedroom &".


So now you just add your other devices in the same manner and expand the script.
That's it!

[[Category:Domoticz]]
[[Category:Manual]]
[[Category:Setup]]
[[Category:Hardware]]
[[Category:Scripting‏‎]]
[[Category:Bash]]
[[Category:Linux]]
[[Category:Raspberry Pi]]