libiec61883 README Copyright (C) 2004-2005 Kristian Hogsberg, Dan Dennedy, and Dan Maas. http://www.linux1394.org/ Overview -------- This library is an implementation of IEC 61883, part 1 (CIP, plug registers, and CMP), part 2 (DV-SD), part 4 (MPEG2-TS), and part 6 (AMDTP). Outside of IIDC, nearly all FireWire multimedia devices use IEC 61883 protocols. The libiec61883 library provides a higher level API for streaming DV, MPEG-2 and audio over Linux IEEE 1394. This includes both reception and transmission. It uses the new "rawiso" API of libraw1394, which transparently provides mmap-ed DMA for efficient data transfer. It also represents the third generation of I/O technology for Linux 1394 for these media types thereby removing the complexities of additional kernel modules, /dev nodes, and procfs. It also consolidates features for plug control registers and connection management that previously existed in experimental form in an unreleased version of libavc1394. Requirements ------------ Linux kernel 2.4.20 or newer libraw1394 1.2.0 or newer Documentation ------------- Nearly everything is documented in the header file. The comments from the header can be extracted and formatted using the Linux kernel script, e.g.: /usr/src/linux/scripts/kernel-doc -man src/iec61883.h | nroff -man | less Pkg-Config ---------- The library comes with a pkg-config .pc file, so you can check for libiec61883 and its version in your configure script. For example, here is how to use the autoconf macro: PKG_CHECK_MODULES(LIBIEC61883, libiec61883 >= 1.0.0) This macro sets the variables LIBIEC61883_CFLAGS and LIBIEC61883_LIBS. You have to include those into your build variables so that the build process correctly links with libraw1394. Maintainer ---------- Maintainer of libiec61883 is currently Dan Dennedy. Send suggestions, bug reports and fixes to linux1394-devel@lists.sourceforge.net. See the file AUTHORS for a complete list of contributors to libiec61883. Visit http://www.linux1394.org/ for more information or to see what is new.