Debian Codegraph @

README

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