readme

从 IEEE 1394总线接收传输流

MPEG2-TS 1394 decoder
=====================

Introduction
------------

This program receives MPEG-2 transport streams from an IEEE 1394 (FireWire)
bus according to IEC 61883-4.
It can decode one audio and video stream and present them on the
local sound card and on the local display.

For video, a new window with the dimensions of the decoded video pops up
when decoding video is started. The window is closed when decoding
video stops.
However, if it is configured with --enable-fix-window (on compile time),
it will open the window for video output on startup. The window is always
open, regardless whether video is currently available. This option was added
to enable a more TV like operation where the "TV screen" is alway there and
goes black  when there is no video (e. g. when decoding a radio program).

Requirements
------------

This software requires access to the IEEE 1394 adapter via libraw1394.
This version uses the rawiso API. Therefore, it requires libraw1394 
version 0.10.0 or higher and linux kernel 2.4.21 or higher.
In the current versions of the drivers, the rawiso API only works with
ohci cards, but not with pcilynx cards.

Libmpeg2 (available at http://libmpeg2.sourceforge.net) must be installed.
This software was tested with libmpeg2 from mpeg2dec-0.4.0 installed.

Furthermore, it requires sound support according to the Open Sound System,
as it is part of Linux 2.2 and 2.4.

License
-------

Most parts of this software are distributed under the terms of the
GNU General Public License (see COPYING).

The only exception is the audio decoder. It is an adapted version of
mpg123, which is distributed under a different license
(see COPYING.mpg123 in the audio subdirectory). This applies to all
files in the audio subdirectory except audiobuffer.c and audiobuffer.h.
Furthermore, this applies to a small portion of mpeg2demux.c.
The audio decoder is based on an old version of mpg123 (version 0.59r).
The latest versions of mpg123 are available under GNU GPL. So when this
old code is replaced with the new version of mpg123, mpeg2ts1394dec as
a whole will be available under GNU GPL.

How to build
------------

Type "./configure" and then "make" on the console!
If you want a version with fix video window, then type
"./configure --enable-fix-window" instead of "./configure"!
If you want to install the program, become root and type "make install"!

How to use
----------

Start the program (mpeg2ts1394dec) and type "help" on the prompt!

Acknowledgements
----------------

This software is based on several open source software packages.

The audio decoder is based on mpg123 from Michael Hipp, which is
available at http://www.mpg123.de.

Video is decoded using libmpeg2 available at
http://libmpeg2.sourceforge.net.

Ideas for the MPEG-2 transport stream demultiplexer were taken
from an implementation by Alex Theo de Jong (NIST, February 1996).



January 11th, 2007     Manfred Weihs <[e-mail]>