TellStick installation - Linux

The Linux installation of TellStick requires kernel version 2.6.14 or later. You will also need support for the driver ftdi_sio.

To find out which version of the kernel you are running, use this command:

uname -r

Prerequisites

In order to build the software under Linux some softwares is required. You need at least the following:

gcc (compiler) and a working toolchain.

On debian systems, this can be installed by installing the package build-essentials

libconfuse (and the corresponding development package)

Called libconfuse0 and libconfuse-dev on debian

cmake

Using kernel 2.6.20 or earlier

If you are using kernel version 2.6.14 to 2.6.20 you need the kernel driver compiled as a module. If it is compiled into the kernel it will not find TellStick. ftdi_sio could be found under:

Device Drivers--->
  USB support--->
    USB Serial Converter support--->
      <M> USB FTDI Single Port Serial Driver (EXPERIMENTAL)

Insert the module into the kernel by:

modprobe ftdi_sio vendor=0x1781 product=0x0c30

For Ubuntu, do the following changes to /etc/modprobe.d/options:

modprobe ftdi_sio vendor=0x1781 product=0x0c30

Then, update the module settings:

update-modules

After makeing this change, the module could be loaded without any extra parameters:

modprobe ftdi_sio

Installing the software

Download the latest source code from Telldus at: ​http://download.telldus.se/TellStick/Software/telldus-core/

Unpack it:

cd /usr/src
gunzip telldus-core-{version}.tar.gz #Change {version} to the downloaded version
tar xvf telldus-core-{version}.tar

This creates the directory /usr/src/telldus-core-{version} containing the files from the archive. We only support the GNU version of tar archiving utility. Note on some systems it is called gtar.

Go to the new directory

cd telldus-core

Configuring

Telldus Core is built using CMake (​http://www.cmake.org), version 2.6.0 is the minimum required version. This means there is no configure-script, but you need to run cmake.

To configure telldus-core for your machine type:

cmake .

in the package directory.

By default, Telldus Core is configured for installation in the /usr/local directory, but this can be changed by using the -DCMAKE_INSTALL_PREFIX=/usr option. Alternatively, the DESTDIR="/opt" option can be used to specify a "local" installation within the source directory when running "make install".

Building

To create the library and compile all the tools type:

make

If you did not configure Telldus Core using the -DCMAKE_INSTALL_PREFIX=/usr option, you need to install the library and tools in the appropriate place. To do this, type:

su -c "make install"

and enter the root password.

If you want to install in another directory, type:

su -c "make DESTDIR=/opt install"

Note that on some systems the make utility is named differently, e.g. gmake.

On some systems the cache for libraries need to be updated, type:

su -c "ldconfig"

Configuring the receivers

After the compilation is done, go on and configure the receivers