[deb_libcec.git] / README

This library provides support for the Pulse-Eight USB-CEC adapter.

===============================================================================
                                === Linux ===
===============================================================================

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

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

To compile, execute the following commands:
# autoreconf -vif
# ./configure --prefix=/usr
# make
# sudo make install

===============================================================================
                                === OS-X ===
===============================================================================

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 3.2.6 or later

To compile, execute the following commands (TODO: please verify):
# autoreconf -vif
# ./configure --prefix=/usr
# make
# sudo make install

# Note: You may need to copy pkg.m4 to your m4 sources directory

===============================================================================
                              === Windows ===
===============================================================================

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 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

===============================================================================
                            === Debugging / Testing ===
===============================================================================

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 -l

"cec-client -h" shows a list of commands and options that are available.

===============================================================================
                              === Developers ===
===============================================================================

We provide a C, C++ and .NET CLR interface to the adapter.

C++ developers:
* the API can be found in /include/cec.h
* an example implementation can be found in /src/testclient/main.cpp

C developers:
* the API can be found in /include/cecc.h

.NET developers:
* add a reference to LibCecSharp.dll
* an example can be found in \src\CecSharpTester\CecSharpClient.cs

===============================================================================
                        === Developers Agreement ===
===============================================================================

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.
Commit	Line	Data
	1	This library provides support for the Pulse-Eight USB-CEC adapter.
	2
	3	===============================================================================
	4	=== Linux ===
	5	===============================================================================
	6
	7	libCEC needs the following dependencies in order to work correctly:
	8	* udev v151 or later
	9	* cdc-acm support compiled into the kernel or available as module
	10
	11	To compile libCEC on Linux, you'll need the following dependencies:
	12	* autoconf 2.13 or later
	13	* automake 1.11 or later
	14	* pkg-config
	15	* libtool
	16	* udev development headers v151 or later
	17	* gcc 4.2 or later
	18
	19	To compile, execute the following commands:
	20	# autoreconf -vif
	21	# ./configure --prefix=/usr
	22	# make
	23	# sudo make install
	24
	25	===============================================================================
	26	=== OS-X ===
	27	===============================================================================
	28
	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
	32	* pkg-config
	33	* xcode 3.2.6 or later
	34
	35	To compile, execute the following commands (TODO: please verify):
	36	# autoreconf -vif
	37	# ./configure --prefix=/usr
	38	# make
	39	# sudo make install
	40
	41	# Note: You may need to copy pkg.m4 to your m4 sources directory
	42
	43	===============================================================================
	44	=== Windows ===
	45	===============================================================================
	46
	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
	49	NSIS.
	50
	51	To compile libCEC, follow these instructions:
	52	* open /project/libcec.sln with Visual C++ 2010 or Visual Studio 2010.
	53	* build the project.
	54
	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
	60
	61	===============================================================================
	62	=== Debugging / Testing ===
	63	===============================================================================
	64
	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:
	67	* cec-client -l
	68
	69	"cec-client -h" shows a list of commands and options that are available.
	70
	71	===============================================================================
	72	=== Developers ===
	73	===============================================================================
	74
	75	We provide a C, C++ and .NET CLR interface to the adapter.
	76
	77	C++ developers:
	78	* the API can be found in /include/cec.h
	79	* an example implementation can be found in /src/testclient/main.cpp
	80
	81	C developers:
	82	* the API can be found in /include/cecc.h
	83
	84	.NET developers:
	85	* add a reference to LibCecSharp.dll
	86	* an example can be found in \src\CecSharpTester\CecSharpClient.cs
	87
	88	===============================================================================
	89	=== Developers Agreement ===
	90	===============================================================================
	91
	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
	94	information.