Hedj: /* Configure receivers */ Added note about restarting the service daemon after changing configuration.

2012-08-12T17:17:21Z

‎Configure receivers: Added note about restarting the service daemon after changing configuration.

Hedj at 14:18, 1 August 2012

2012-08-01T14:18:57Z

Hedj: Created.

2012-08-01T14:14:16Z

Created.

New page

[[Category:RaspberryPi]]

= Tellstick for Raspberry PI =

This document shows how to setup the [http://www.telldus.com/ Telldus] core software for controlling remote switches using a [http://www.telldus.com/products/tellstick Tellstick] USB device on a [http://www.raspberrypi.org Raspberry PI].

The distribution used is Raspbian "Wheezy" 3.1.9+.

== Information sources ==

The information in this document is compiled from these sources, with some testing & googling for myself.

Installation: http://developer.telldus.com/wiki/TellStickInstallationSource<br />
Confuration: http://developer.telldus.com/wiki/TellStick_conf

== Download software ==

Download the source code for Tellstick software.

<pre>wget http://download.telldus.se/TellStick/Software/telldus-core/telldus-core-2.1.1.tar.gz</pre>
== Install prerequisites ==

Install the required software to build the source code.

<pre>sudo apt-get install libftdi1 libftdi-dev libconfuse0 libconfuse-dev cmake</pre>
== Unpack source code ==

Unpack the downloaded source into the <tt>/usr/src</tt> folder.

<pre>cd /usr/src
sudo tar xzf ~/download/telldus-core-2.1.1.tar.gz</pre>
== Build the software ==

Enter the newly extracted directory and execute the build commands from there.

<pre>cd telldus-core-2.1.1</pre>
=== Configure ===

Configure the source code for the hardware.

<pre>sudo cmake .</pre>
Example output:

<pre>-- The C compiler identification is GNU 4.6.3
-- The CXX compiler identification is GNU 4.6.3
-- Check for working C compiler: /usr/bin/gcc
-- Check for working C compiler: /usr/bin/gcc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Looking for include file pthread.h
-- Looking for include file pthread.h - found
-- Looking for pthread_create
-- Looking for pthread_create - not found.
-- Looking for pthread_create in pthreads
-- Looking for pthread_create in pthreads - not found
-- Looking for pthread_create in pthread
-- Looking for pthread_create in pthread - found
-- Found Threads: TRUE
-- Found PkgConfig: /usr/bin/pkg-config (found version "0.26")
-- checking for one of the modules 'libftdi'
-- Configuring done
-- Generating done
-- Build files have been written to: /usr/src/telldus-core-2.1.1</pre>
=== Compile ===

Compile the source code.

<pre>sudo make</pre>
Example output:

<pre>Scanning dependencies of target TelldusCommon
[ 2%] Building CXX object common/CMakeFiles/TelldusCommon.dir/Event.cpp.o
[ 4%] Building CXX object common/CMakeFiles/TelldusCommon.dir/Message.cpp.o
[ 6%] Building CXX object common/CMakeFiles/TelldusCommon.dir/Mutex.cpp.o
[ 8%] Building CXX object common/CMakeFiles/TelldusCommon.dir/Strings.cpp.o
/usr/src/telldus-core-2.1.1/common/Strings.cpp:222:13: note: the mangling of 'va_list' has changed in GCC 4.4
[ 10%] Building CXX object common/CMakeFiles/TelldusCommon.dir/Thread.cpp.o
[ 12%] Building CXX object common/CMakeFiles/TelldusCommon.dir/Event_unix.cpp.o
[ 14%] Building CXX object common/CMakeFiles/TelldusCommon.dir/EventHandler_unix.cpp.o
[ 16%] Building CXX object common/CMakeFiles/TelldusCommon.dir/Socket_unix.cpp.o
Linking CXX static library libTelldusCommon.a
[ 16%] Built target TelldusCommon
Scanning dependencies of target telldusd
[ 18%] Building CXX object service/CMakeFiles/telldusd.dir/ClientCommunicationHandler.cpp.o
[ 20%] Building CXX object service/CMakeFiles/telldusd.dir/Controller.cpp.o
[ 22%] Building CXX object service/CMakeFiles/telldusd.dir/ControllerManager.cpp.o
[ 24%] Building CXX object service/CMakeFiles/telldusd.dir/ControllerMessage.cpp.o
[ 26%] Building CXX object service/CMakeFiles/telldusd.dir/Device.cpp.o
[ 28%] Building CXX object service/CMakeFiles/telldusd.dir/DeviceManager.cpp.o
[ 30%] Building CXX object service/CMakeFiles/telldusd.dir/Log.cpp.o
/usr/src/telldus-core-2.1.1/service/Log.cpp: In member function 'void Log::message(Log::LogLevel, const char*, va_list) const':
/usr/src/telldus-core-2.1.1/service/Log.cpp:125:6: note: the mangling of 'va_list' has changed in GCC 4.4
[ 32%] Building CXX object service/CMakeFiles/telldusd.dir/Sensor.cpp.o
[ 34%] Building CXX object service/CMakeFiles/telldusd.dir/Settings.cpp.o
[ 36%] Building CXX object service/CMakeFiles/telldusd.dir/TelldusMain.cpp.o
[ 38%] Building CXX object service/CMakeFiles/telldusd.dir/TellStick.cpp.o
[ 40%] Building CXX object service/CMakeFiles/telldusd.dir/Timer.cpp.o
[ 42%] Building CXX object service/CMakeFiles/telldusd.dir/EventUpdateManager.cpp.o
[ 44%] Building CXX object service/CMakeFiles/telldusd.dir/ConnectionListener_unix.cpp.o
[ 46%] Building CXX object service/CMakeFiles/telldusd.dir/main_unix.cpp.o
[ 48%] Building CXX object service/CMakeFiles/telldusd.dir/SettingsConfuse.cpp.o
[ 50%] Building CXX object service/CMakeFiles/telldusd.dir/TellStick_libftdi.cpp.o
[ 52%] Building CXX object service/CMakeFiles/telldusd.dir/Protocol.cpp.o
[ 54%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolBrateck.cpp.o
[ 56%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolComen.cpp.o
[ 58%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolEverflourish.cpp.o
[ 60%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolFineoffset.cpp.o
[ 62%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolFuhaote.cpp.o
[ 64%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolGroup.cpp.o
[ 66%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolHasta.cpp.o
[ 68%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolIkea.cpp.o
[ 70%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolMandolyn.cpp.o
[ 72%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolNexa.cpp.o
[ 74%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolOregon.cpp.o
[ 76%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolRisingSun.cpp.o
[ 78%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolSartano.cpp.o
[ 80%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolScene.cpp.o
[ 82%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolSilvanChip.cpp.o
[ 84%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolUpm.cpp.o
[ 86%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolWaveman.cpp.o
[ 88%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolX10.cpp.o
[ 90%] Building CXX object service/CMakeFiles/telldusd.dir/ProtocolYidong.cpp.o
Linking CXX executable telldusd
[ 90%] Built target telldusd
Scanning dependencies of target telldus-core
[ 92%] Building CXX object client/CMakeFiles/telldus-core.dir/CallbackDispatcher.cpp.o
[ 94%] Building CXX object client/CMakeFiles/telldus-core.dir/Client.cpp.o
[ 96%] Building CXX object client/CMakeFiles/telldus-core.dir/telldus-core.cpp.o
Linking CXX shared library libtelldus-core.so
[ 96%] Built target telldus-core
Scanning dependencies of target tdtool
[ 98%] Building CXX object tdtool/CMakeFiles/tdtool.dir/main.cpp.o
Linking CXX executable tdtool
[ 98%] Built target tdtool
Scanning dependencies of target tdadmin
[100%] Building CXX object tdadmin/CMakeFiles/tdadmin.dir/main.cpp.o
Linking CXX executable tdadmin
[100%] Built target tdadmin</pre>
=== Install ===

Install the software (it will be installed into <tt>/usr/local</tt>).

<pre>sudo make install</pre>
Example output:

<pre>[ 16%] Built target TelldusCommon
[ 90%] Built target telldusd
[ 96%] Built target telldus-core
[ 98%] Built target tdtool
[100%] Built target tdadmin
Install the project...
-- Install configuration: ""
-- Installing: /usr/local/sbin/telldusd
-- Installing: /etc/tellstick.conf
-- Installing: /var/state/telldus-core.conf
-- Installing: /usr/local/lib/libtelldus-core.so.2.1.1
-- Installing: /usr/local/lib/libtelldus-core.so.2
-- Installing: /usr/local/lib/libtelldus-core.so
-- Installing: /usr/local/include/telldus-core.h
-- Installing: /usr/local/bin/tdtool
-- Removed runtime path from "/usr/local/bin/tdtool"
-- Installing: /usr/local/sbin/tdadmin
-- Removed runtime path from "/usr/local/sbin/tdadmin"
-- Installing: /etc/udev/rules.d/05-tellstick.rules
-- Installing: /usr/local/share/telldus-core/helpers/udev.sh</pre>
After installation, update the system's library cache.

<pre>sudo ldconfig</pre>
=== Install service ===

Before the switches can be used, the <tt>telldusd</tt> service daemon must be running (and the Tellstick must be connected to your Raspberry PI).

Create an init-script for the service by copying and modifying the <tt>/etc/init.d/skeleton</tt> file.

<pre>cd /etc/init.d
sudo cp skeleton telldusd</pre>
Open the newly created file in your favorite editor (as root with sudo) and do these changes:

Line 3, change:

<pre># Provides: skeleton</pre>
into:

<pre># Provides: telldusd</pre>
Line 8-10, change:

<pre># Short-Description: Example initscript
# Description: This file should be used to construct scripts to be
# placed in /etc/init.d.</pre>
into:

<pre># Short-Description: Tellstick service daemon
# Description: Tellstick service daemon controlling remote switches.
# </pre>
Line 20-24, change:

<pre>PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Description of the service"
NAME=daemonexecutablename
DAEMON=/usr/sbin/$NAME
DAEMON_ARGS="--options args"</pre>
into:

<pre>PATH=/sbin:/usr/sbin:/bin:/usr/bin:/usr/local/sbin
DESC="Tellsick service daemon"
NAME=telldusd
DAEMON=/usr/local/sbin/$NAME
DAEMON_ARGS=""</pre>
Make the script executable.

<pre>sudo chmod +x telldusd</pre>
Test the init-script by starting the service and checking its status.

<pre>sudo service telldusd start
sudo service telldusd status</pre>
Install the script to start at boot.

<pre>sudo update-rc.d telldusd defaults</pre>
== Configure receivers ==

The software is configured with the <tt>/etc/tellstick.conf</tt> file. Since there are many types of receivers supported by Tellstick this document will not cover configuration options. For more information on configuration, please see http://developer.telldus.com/wiki/TellStick_conf.

Here is an example configuration using one Waveman receiver. The <tt>house</tt> and <tt>unit</tt> parameters is where you setup different switches.

<pre>user = "nobody"
group = "plugdev"
ignoreControllerConfirmation = "false"
device {
id = 1
name = "Livingroom lights"
protocol = "waveman"
model = "codeswitch"
parameters {
house = "A"
unit = "1"
}
}</pre>
== Test ==

To turn on a switch (the number is the device id for the switch in the configuration file).

<pre>tdtool --on 1</pre>
To turn off a switch.

<pre>tdtool --off 1</pre>
== Done! ==

You have now the core software for controlling remote receivers using a Tellstick installed. Now you can go ahead and do more amazing things!

For example:

* install a web server and create a web page where you can control switches
* schedule switching on and off lights using cron
* and much more...

=References=
<references/>

← Older revision		Revision as of 14:18, 1 August 2012
Line 1:		Line 1:
	[[Category:RaspberryPi]]		[[Category:RaspberryPi]]
−
−	~~= Tellstick for Raspberry PI =~~

	This document shows how to setup the [http://www.telldus.com/ Telldus] core software for controlling remote switches using a [http://www.telldus.com/products/tellstick Tellstick] USB device on a [http://www.raspberrypi.org Raspberry PI].		This document shows how to setup the [http://www.telldus.com/ Telldus] core software for controlling remote switches using a [http://www.telldus.com/products/tellstick Tellstick] USB device on a [http://www.raspberrypi.org Raspberry PI].

@@ Line 238: / Line 238: @@
+   }
 }</pre>
 == Test ==

R-Pi Tellstick core - Revision history

Hedj: /* Configure receivers */ Added note about restarting the service daemon after changing configuration.

Hedj at 14:18, 1 August 2012

Hedj: Created.