alway log unhandled commands

[deb_libcec.git] / README

diff --git a/README b/README
index d90e7ff3cfdc1d68c24e71db5b9e94ff6f65c123..f25c53946cbc5d64fd1772c48977a9fa3f0f191d 100644 (file)
--- a/README
+++ b/README
@@ -1,24 +1,32 @@
 This library provides support for the Pulse-Eight USB-CEC adapter.
 
+You can find a list of frequently asked questions on the following page:
+                    http://libcec.pulse-eight.com/faq
+
 ===============================================================================
-                                === Linux ===
+                             === Linux & BSD ===
 ===============================================================================
 
 libCEC needs the following dependencies in order to work correctly:
 * udev v151 or later
 * cdc-acm support compiled into the kernel or available as module
+* liblockdev 1.0 or later
 
 To compile libCEC on Linux, you'll need the following dependencies:
 * autoconf 2.13 or later
 * automake 1.11 or later
-* pkg-config
 * libtool
-* udev development headers v151 or later
 * gcc 4.2 or later
+* liblockdev 1.0 development headers
+
+The following dependencies are recommended. Without them, the adapter can not
+be auto-detected.
+* pkg-config
+* udev development headers v151 or later
 
 To compile, execute the following commands:
-# autoreconf -vif
-# ./configure --prefix=/usr
+# ./bootstrap 
+# ./configure
 # make
 # sudo make install
 
@@ -32,9 +40,9 @@ To compile libCEC on OS-X, you'll need the following dependencies:
 * pkg-config
 * xcode 3.2.6 or later
 
-To compile, execute the following commands (TODO: please verify):
-# autoreconf -vif
-# ./configure --prefix=/usr
+To compile, execute the following command:
+# ./bootstrap 
+# ./configure
 # make
 # sudo make install
 
@@ -66,10 +74,56 @@ you will need to manually build libcec with Visual C++ 2010 and then
 build LibCecSharp.sln with Visual Studio 2008. See create-installer.bat
 for the required steps.
 
+===============================================================================
+                           === Raspberry Pi ===
+===============================================================================
+
+We've included a script that builds libCEC with support for the Raspberry Pi
+in /project/RPi/build.sh. This script pulls in the latest toolchain and
+firmware, builds the necessary dependencies, and finally builds libCEC. The
+result will be a softfp build.
+
+To build libCEc on your development machine, follow these instructions:
+* run '/project/RPi/build.sh /desired/destination/path/for/binaries'
+* run 'make install'
+
+To build libCEC on the Pi itself, just follow the instructions for Linux.
+The configure script automatically checks whether the required headers and
+libraries can be found.
+
+To specify the path of the Raspberry Pi's development headers, use the
+following option for 'configure':
+--with-rpi-include-path="/path/to/opt/vc/include"
+
+To specify the path of the Raspberry Pi's libraries, use the following option
+for 'configure':
+--with-rpi-lib-path="/path/to/libbcm_host.so"
+
+===============================================================================
+                           === CuBox / TDA995x ===
+===============================================================================
+
+Solid-Run's CuBox uses a combined HDMI tranceiver / CEC controller by NXP. The
+device driver for it is based on an SDK by the chip vendor and is compiled into
+the Linux kernel. The following options for 'configure' have been introduced:
+
+To enable support for the CuBox / TDA995x:
+--enable-tda995x
+
+To specify the path to the SDK part of the kernel driver:
+--with-tda995x-toolkit-path='path/to/linux/drivers/video/dovefb/nxp_hdmi'
+
+If the toolkit path is not specified, it is assumed that a directory named
+'nxp_hdmi' (or a link to it) exists in the top level of the source tree.
+
 ===============================================================================
                             === Debugging / Testing ===
 ===============================================================================
 
+To compile libCEC with extensive debugging output, pass the following argument
+to configure on Linux/OS-X/BSD:
+--enable-debug
+
 We provide a test client, named cec-client, to debug the device.
 To check whether the device can be detected, execute the following command:
 * cec-client -l