| 1 |
libiec61883 README |
| 2 |
Copyright (C) 2004-2005 Kristian Hogsberg, Dan Dennedy, and Dan Maas. |
| 3 |
http://www.linux1394.org/ |
| 4 |
|
| 5 |
Overview |
| 6 |
-------- |
| 7 |
This library is an implementation of IEC 61883, part 1 (CIP, plug registers, |
| 8 |
and CMP), part 2 (DV-SD), part 4 (MPEG2-TS), and part 6 (AMDTP). Outside of |
| 9 |
IIDC, nearly all FireWire multimedia devices use IEC 61883 protocols. |
| 10 |
|
| 11 |
The libiec61883 library provides a higher level API for streaming DV, |
| 12 |
MPEG-2 and audio over Linux IEEE 1394. This includes both reception and |
| 13 |
transmission. It uses the new "rawiso" API of libraw1394, which transparently |
| 14 |
provides mmap-ed DMA for efficient data transfer. It also represents |
| 15 |
the third generation of I/O technology for Linux 1394 for these media types |
| 16 |
thereby removing the complexities of additional kernel modules, /dev nodes, |
| 17 |
and procfs. It also consolidates features for plug control registers and |
| 18 |
connection management that previously existed in experimental form in an |
| 19 |
unreleased version of libavc1394. |
| 20 |
|
| 21 |
|
| 22 |
Requirements |
| 23 |
------------ |
| 24 |
Linux kernel 2.4.20 or newer |
| 25 |
libraw1394 1.2.0 or newer |
| 26 |
|
| 27 |
|
| 28 |
Documentation |
| 29 |
------------- |
| 30 |
Nearly everything is documented in the header file. The comments from the |
| 31 |
header can be extracted and formatted using the Linux kernel script, e.g.: |
| 32 |
|
| 33 |
/usr/src/linux/scripts/kernel-doc -man src/iec61883.h | nroff -man | less |
| 34 |
|
| 35 |
|
| 36 |
Pkg-Config |
| 37 |
---------- |
| 38 |
The library comes with a pkg-config .pc file, so you can check for |
| 39 |
libiec61883 and its version in your configure script. For example, here is how |
| 40 |
to use the autoconf macro: |
| 41 |
|
| 42 |
PKG_CHECK_MODULES(LIBIEC61883, libiec61883 >= 1.0.0) |
| 43 |
|
| 44 |
This macro sets the variables LIBIEC61883_CFLAGS and LIBIEC61883_LIBS. You |
| 45 |
have to include those into your build variables so that the build process |
| 46 |
correctly links with libraw1394. |
| 47 |
|
| 48 |
|
| 49 |
Maintainer |
| 50 |
---------- |
| 51 |
Maintainer of libiec61883 is currently Dan Dennedy. Send suggestions, bug |
| 52 |
reports and fixes to [email protected]. See the file |
| 53 |
AUTHORS for a complete list of contributors to libiec61883. |
| 54 |
|
| 55 |
Visit http://www.linux1394.org/ for more information or to see what is new. |