1 This library provides support for the Pulse-Eight USB-CEC adapter.
3 ===============================================================================
5 ===============================================================================
7 libCEC needs the following dependencies in order to work correctly:
9 * cdc-acm support compiled into the kernel or available as module
11 To compile libCEC on Linux, you'll need the following dependencies:
12 * autoconf 2.13 or later
13 * automake 1.11 or later
16 * udev development headers v151 or later
19 To compile, execute the following commands:
21 # ./configure --prefix=/usr
25 ===============================================================================
27 ===============================================================================
29 To compile libCEC on OS-X, you'll need the following dependencies:
30 * autoconf 2.13 or later
31 * automake 1.11 or later
33 * xcode 3.2.6 or later
35 To compile, execute the following commands (TODO: please verify):
37 # ./configure --prefix=/usr
41 # Note: You may need to copy pkg.m4 to your m4 sources directory
43 ===============================================================================
45 ===============================================================================
47 To compile libCEC on Windows, you'll need Visual C++ 2010 or Visual Studio 2010
48 The installer needs the Windows DDK (Driver Development Kit) and Nullsoft's
51 To compile libCEC, follow these instructions:
52 * open /project/libcec.sln with Visual C++ 2010 or Visual Studio 2010.
55 To build an installer on Windows:
56 * download and install the Windows DDK.
57 * download and install NSIS.
58 * go to /project and execute create-installer.cmd to create the installer.
59 * the installer is stored as /project/libCEC-installer.exe
61 ===============================================================================
62 === Debugging / Testing ===
63 ===============================================================================
65 We provide a test client, named cec-client, to debug the device.
66 To check whether the device can be detected, execute the following command:
69 "cec-client -h" shows a list of commands and options that are available.
71 ===============================================================================
73 ===============================================================================
75 We provide a C, C++ and .NET CLR interface to the adapter.
78 * the API can be found in /include/cec.h
79 * an example implementation can be found in /src/testclient/main.cpp
82 * the API can be found in /include/cecc.h
85 * add a reference to LibCecSharp.dll
86 * an example can be found in \src\CecSharpTester\CecSharpClient.cs
88 ===============================================================================
89 === Developers Agreement ===
90 ===============================================================================
92 If you wish to contribute to this project, you must first sign our contributors
93 agreement. Please see http://www.pulse-eight.net/contributors for more