testclient: fixed vendor id always shown as zero
[deb_libcec.git] / README
1 This library provides support for the Pulse-Eight USB-CEC adapter.
2
3 You can find a list of frequently asked questions on the following page:
4 http://libcec.pulse-eight.com/faq
5
6 ===============================================================================
7 === Linux ===
8 ===============================================================================
9
10 libCEC needs the following dependencies in order to work correctly:
11 * udev v151 or later
12 * cdc-acm support compiled into the kernel or available as module
13 * liblockdev 1.0 or later
14
15 To compile libCEC on Linux, you'll need the following dependencies:
16 * autoconf 2.13 or later
17 * automake 1.11 or later
18 * libtool
19 * gcc 4.2 or later
20 * liblockdev 1.0 development headers
21
22 The following dependencies are recommended. Without them, the adapter can not
23 be auto-detected.
24 * pkg-config
25 * udev development headers v151 or later
26
27 To compile, execute the following commands:
28 # autoreconf -vif
29 # ./configure
30 # make
31 # sudo make install
32
33 ===============================================================================
34 === OS-X ===
35 ===============================================================================
36
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
40 * pkg-config
41 * xcode 3.2.6 or later
42
43 To compile, execute the following commands (TODO: please verify):
44 # autoreconf -vif
45 # ./configure
46 # make
47 # sudo make install
48
49 # Note: You may need to copy pkg.m4 to your m4 sources directory
50
51 ===============================================================================
52 === Windows ===
53 ===============================================================================
54
55 To compile libCEC on Windows, you'll need Visual C++ 2010 or Visual Studio 2010
56 The installer needs the Windows DDK (Driver Development Kit) and Nullsoft's
57 NSIS.
58
59 To compile LibCecSharp on Windows, you'll need Visual C++ 2008 or Visual Studio
60 2008, because it is compiled against .NET 2.0.
61
62 To compile libCEC, follow these instructions:
63 * open /project/libcec.sln with Visual C++ 2010 or Visual Studio 2010.
64 * build the project.
65
66 To build an installer on Windows:
67 * download and install NSIS.
68 * go to /project and execute create-installer.bat to create the installer.
69 * the installer is stored as /build/libCEC-installer.exe
70
71 You will need both Visual Studio 2008 and Visual Studio 2010 to build the
72 installer from the command line. To build with Visual C++ 2008 and 2010,
73 you will need to manually build libcec with Visual C++ 2010 and then
74 build LibCecSharp.sln with Visual Studio 2008. See create-installer.bat
75 for the required steps.
76
77 ===============================================================================
78 === Raspberry Pi ===
79 ===============================================================================
80
81 We've included a script that builds libCEC with support for the Raspberry Pi
82 in /project/RPi/build.sh. This script pulls in the latest toolchain and
83 firmware, builds the necessary dependencies, and finally builds libCEC. The
84 result will be a softfp build.
85
86 To build libCEc on your development machine, follow these instructions:
87 * run '/project/RPi/build.sh /desired/destination/path/for/binaries'
88 * run 'make install'
89
90 To build libCEC on the Pi itself, just follow the instructions for Linux.
91 The configure script automatically checks whether the required headers and
92 libraries can be found.
93
94 To specify the path of the Raspberry Pi's development headers, use the
95 following option for 'configure':
96 --with-rpi-include-path="/path/to/opt/vc/include"
97
98 To specify the path of the Raspberry Pi's libraries, use the following option
99 for 'configure':
100 --with-rpi-lib-path="/path/to/libbcm_host.so"
101
102 ===============================================================================
103 === Debugging / Testing ===
104 ===============================================================================
105
106 We provide a test client, named cec-client, to debug the device.
107 To check whether the device can be detected, execute the following command:
108 * cec-client -l
109
110 "cec-client -h" shows a list of commands and options that are available.
111
112 ===============================================================================
113 === Developers ===
114 ===============================================================================
115
116 We provide a C, C++ and .NET CLR interface to the adapter.
117
118 C++ developers:
119 * the API can be found in /include/cec.h
120 * an example implementation can be found in /src/testclient/main.cpp
121
122 C developers:
123 * the API can be found in /include/cecc.h
124
125 .NET developers:
126 * add a reference to LibCecSharp.dll
127 * an example can be found in \src\CecSharpTester\CecSharpClient.cs
128
129 ===============================================================================
130 === Developers Agreement ===
131 ===============================================================================
132
133 If you wish to contribute to this project, you must first sign our contributors
134 agreement. Please see http://www.pulse-eight.net/contributors for more
135 information.