Changes between Initial Version and Version 1 of TellStickInstallationSource

Timestamp:

Oct 22, 2009, 9:34:15 AM (16 years ago)

Author:

Micke Prag

Comment:

--

TellStickInstallationSource

@@ +1 @@
+== 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
+}}}
+
+=== 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 ===
+
+To compile {{{telldus-core}}} you need cmake version 2.4.0 or later.
+
+Download the latest source code from Telldus and 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}}}.
+