== 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---> 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