== 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:
{{{
#!sh
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}}}
libftdi (and the corresponding development package)
 Called {{{libftdi1}}} and {{{libftdi-dev}}} on debian
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:
{{{
#!sh
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:
{{{
#!sh
update-modules
}}}

After makeing this change, the module could be loaded without any extra parameters:
{{{
#!sh
modprobe ftdi_sio
}}}

=== Installing the software ===

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

Unpack it:
{{{
#!sh
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
{{{
#!sh
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:
{{{
#!sh
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:

{{{
#!sh
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:

{{{
#!sh
su -c "make install"
}}}

and enter the root password.

If you want to install in another directory, type:

{{{
#!sh
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:
{{{
#!sh
su -c "ldconfig"
}}}

=== Configuring the receivers === 

After the compilation is done, go on and [wiki:TellStick_conf "configure"] the receivers