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
libCEC needs the following dependencies in order to work correctly:
To compile libCEC on Linux, you'll need the following dependencies:
The following dependencies are recommended. Without them, the adapter can not be auto-detected.
To compile, execute the following commands:
To compile libCEC on OS-X, you'll need the following dependencies:
To compile, execute the following command:
To compile libCEC on Windows, you'll need Visual Studio 2012 and Visual Studio or Visual C++ 2008. The latter is needed to build LibCecSharp for .Net Framework 2.0.
The adapter detection code needs the Windows DDK (Driver Development Kit).
To create an installer, you'll need Nullsoft's NSIS.
To compile libCEC, follow these instructions:
To build an installer on Windows:
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:
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"
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.
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 -h" shows a list of commands and options that are available.
We provide a C, C++ and .NET CLR interface to the adapter.
C++ developers:
C developers:
.NET developers:
If you wish to contribute to this project, you must first sign our contributors agreement. Please see http://www.pulse-eight.net/contributors for more information.