X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=README;h=5c7364b19882ad5b765448ab7097e4ef45ad2179;hb=5c57af4817a04e92fbfd60d5d99d8782194a45a7;hp=c60a92110b70d14b70ac42ac79541f0faf8bd7ea;hpb=80feba65eae076b681f80253a91568725f2f0c90;p=deb_libcec.git diff --git a/README b/README index c60a921..5c7364b 100644 --- a/README +++ b/README @@ -1,5 +1,8 @@ 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 === =============================================================================== @@ -7,18 +10,23 @@ This library provides support for the Pulse-Eight USB-CEC adapter. 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 +# ./configure # make # sudo make install @@ -30,14 +38,16 @@ To compile libCEC on OS-X, you'll need the following dependencies: * autoconf 2.13 or later * automake 1.11 or later * pkg-config -* xcode (TODO: version?) +* xcode 3.2.6 or later To compile, execute the following commands (TODO: please verify): # autoreconf -vif -# ./configure --prefix=/usr +# ./configure # make # sudo make install +# Note: You may need to copy pkg.m4 to your m4 sources directory + =============================================================================== === Windows === =============================================================================== @@ -46,15 +56,48 @@ To compile libCEC on Windows, you'll need Visual C++ 2010 or Visual Studio 2010 The installer needs the Windows DDK (Driver Development Kit) and Nullsoft's NSIS. +To compile LibCecSharp on Windows, you'll need Visual C++ 2008 or Visual Studio +2008, because it is compiled against .NET 2.0. + To compile libCEC, follow these instructions: * open /project/libcec.sln with Visual C++ 2010 or Visual Studio 2010. * build the project. To build an installer on Windows: -* download and install the Windows DDK. * download and install NSIS. -* go to /project and execute create-installer.cmd to create the installer. -* the installer is stored as /project/libCEC-installer.exe +* go to /project and execute create-installer.bat to create the installer. +* the installer is stored as /build/libCEC-installer.exe + +You will need both Visual Studio 2008 and Visual Studio 2010 to build the +installer from the command line. To build with Visual C++ 2008 and 2010, +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" =============================================================================== === Debugging / Testing ===