1 This library provides support for the Pulse-Eight USB-CEC adapter.
3 You can find a list of frequently asked questions on the following page:
4 http://libcec.pulse-eight.com/faq
6 ===============================================================================
8 ===============================================================================
10 libCEC needs the following dependencies in order to work correctly:
12 * cdc-acm support compiled into the kernel or available as module
13 * liblockdev 1.0 or later
15 To compile libCEC on Linux, you'll need the following dependencies:
16 * autoconf 2.13 or later
17 * automake 1.11 or later
20 * liblockdev 1.0 development headers
22 The following dependencies are recommended. Without them, the adapter can not
25 * udev development headers v151 or later
27 To compile, execute the following commands:
33 ===============================================================================
35 ===============================================================================
37 To compile libCEC on OS-X, you'll need the following dependencies:
38 * autoconf 2.13 or later
39 * automake 1.11 or later
41 * xcode 3.2.6 or later
43 To compile, execute the following command:
49 # Note: You may need to copy pkg.m4 to your m4 sources directory
51 ===============================================================================
53 ===============================================================================
55 To compile libCEC on Windows, you'll need Visual Studio 2012 and Visual Studio
56 or Visual C++ 2008. The latter is needed to build LibCecSharp for .Net
59 The adapter detection code needs the Windows DDK (Driver Development Kit).
61 To create an installer, you'll need Nullsoft's NSIS.
63 To compile libCEC, follow these instructions:
64 * open /project/libcec.sln with Visual Studio 2012.
67 To build an installer on Windows:
68 * download and install NSIS.
69 * go to /project and execute create-installer.bat to create the installer.
70 * the installer is stored as /build/libCEC-installer.exe
72 ===============================================================================
74 ===============================================================================
76 We've included a script that builds libCEC with support for the Raspberry Pi
77 in /project/RPi/build.sh. This script pulls in the latest toolchain and
78 firmware, builds the necessary dependencies, and finally builds libCEC. The
79 result will be a softfp build.
81 To build libCEc on your development machine, follow these instructions:
82 * run '/project/RPi/build.sh /desired/destination/path/for/binaries'
85 To build libCEC on the Pi itself, just follow the instructions for Linux.
86 The configure script automatically checks whether the required headers and
87 libraries can be found.
89 To specify the path of the Raspberry Pi's development headers, use the
90 following option for 'configure':
91 --with-rpi-include-path="/path/to/opt/vc/include"
93 To specify the path of the Raspberry Pi's libraries, use the following option
95 --with-rpi-lib-path="/path/to/libbcm_host.so"
97 ===============================================================================
98 === CuBox / TDA995x ===
99 ===============================================================================
101 Solid-Run's CuBox uses a combined HDMI tranceiver / CEC controller by NXP. The
102 device driver for it is based on an SDK by the chip vendor and is compiled into
103 the Linux kernel. The following options for 'configure' have been introduced:
105 To enable support for the CuBox / TDA995x:
108 To specify the path to the SDK part of the kernel driver:
109 --with-tda995x-toolkit-path='path/to/linux/drivers/video/dovefb/nxp_hdmi'
111 If the toolkit path is not specified, it is assumed that a directory named
112 'nxp_hdmi' (or a link to it) exists in the top level of the source tree.
114 ===============================================================================
115 === Debugging / Testing ===
116 ===============================================================================
118 To compile libCEC with extensive debugging output, pass the following argument
119 to configure on Linux/OS-X/BSD:
122 We provide a test client, named cec-client, to debug the device.
123 To check whether the device can be detected, execute the following command:
126 "cec-client -h" shows a list of commands and options that are available.
128 ===============================================================================
130 ===============================================================================
132 We provide a C, C++ and .NET CLR interface to the adapter.
135 * the API can be found in /include/cec.h
136 * an example implementation can be found in /src/testclient/main.cpp
139 * the API can be found in /include/cecc.h
142 * add a reference to LibCecSharp.dll
143 * an example can be found in \src\CecSharpTester\CecSharpClient.cs
145 ===============================================================================
146 === Developers Agreement ===
147 ===============================================================================
149 If you wish to contribute to this project, you must first sign our contributors
150 agreement. Please see http://www.pulse-eight.net/contributors for more