zoran

嵌入式系统设计与实例开发实验教材二源码 多线程应用程序设计 串行端口程序设计 AD接口实验 CAN总线通信实验 GPS通信实验 Linux内核移植与编译实验 IC卡读写实验 SD驱动使

DC10/DC10plus/LML33/Buz  Driver for Linux
=========================================

by Rainer Johanni <[e-mail]> (for Iomega Buz Driver)

Adapted for DC10/DC10plus by Wolfgang Scherr <[e-mail]>

Further changes for DC10/DC10plus and LML33 cards by
Serguei Miridonov <[e-mail]>

Current homepage: http://www.cicese.mx/~mirsev/Linux/DC10plus/
Current maintainer: Serguei Miridonov <[e-mail]>

  This is a driver for DC10plus capture cards from Pinnacle Systems
  Inc., LML33 cards from Linux Media Labs and Buz from Iomega.
  It also works with many old Miro DC10 cards with SAA7110A TV decoder
  and ADV7176 TV encoder (please, make sure that your card has these
  chips, otherwise the driver will not work).

  The driver is Video4Linux compliant and contains extensions to
  provide hardware support for full motion MJPEG compression and
  decompression. Since this driver is a derivative from the driver for
  Buz Iomega cards written by Dr. Rainer Johanni,
  http://www.johanni.de/munich-vision/buz/ they both have compatible
  API. I hope that this API will become a part of V4L standard.

Copyright: This driver is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License. Please,
check http://www.gnu.org/ for details.

No warranty: This software is provided on AN "AS-IS" basis WITHOUT
WARRANTY OF ANY KIND. YOU USE IT AT YOUR OWN RISK.



CONTENTS
~~~~~~~~

Supported Formats
Hardware compression
Compiling and Loading the Driver
Driver Options
Tested applications
Programming interface
Features for testing
Mailing lists
Bug Reports


Supported Formats
=================

Card:              DC10/DC10plus             LML33/Buz

TV standard:       NTSC/PAL/SECAM(*)         NTSC/PAL

Format:            Square pixel              CCIR.601
                   640x480 NTSC              720x480 NTSC
                   768x576 PAL/SECAM(*)      720x576 PAL

Frame rates: 30 frames/60 fields per second NTSC
             25 frames/50 fields per second PAL/SECAM(*)

(*) - SECAM is supported for input only in DC10/DC10plus cards. The
output of the recorded SECAM video stream will be in PAL standard.
Also, please, note that monitoring of the SECAM input signal at the
DC10/DC10plus analog output may not be available. Please, use
appropriate application like XawTV to watch full color SECAM video at
the card input.

Hardware compression
====================

Since the card provides hardware compression, even low end machines can
be successfully used for movie capture and playback. I'm testing the
driver with with 2.2.16 kernel running on 233 MHz Pentium MMX with 64M
RAM on 430TX motherboard and with 10GB IDE drive from Western Digital
Corp.

On one test run with DC10plus card I've got 0 frames dropped during
about 20 minutes of full motion NTSC (I live in Mexico) video capture
with fully synchronized audio. The command was

  lavrec -fa -in -d1 -l -1 -q30 -w /dos/g/capture/Linux/test%03d.avi

for recording, and

  lavplay -n128 /dos/g/capture/Linux/test*.avi

for playback. (See lavtools distribution for more information).

Typical run of similar test can provide as few as 6-8 dropped frames per
half of an hour. You mileage may vary, though.

Compiling and Loading the Driver
================================

You should run a 2.2.x kernel in order to use this driver. The driver
was also tested with 2.4-test6 kernel, so hopefully it will work
with 2.4 kernels too.

I would recommend to use only official kernels from www.kernel.org and
its mirrors. Kernels supplied with some Linux distributions may be
patched in some way to meet specific needs of particular Linux
distributor and could be incompatible with this driver. As a driver
maintainer, I am not able to follow every unofficial kernel release,
and no unofficial kernels will be supported.

Besides the files in this directory, the driver needs the 'videodev'
and the 'i2c' module from the Linux kernel (i2c-old for 2.4 kernels).
In order to get these modules available, enable module support for
VIDEODEV and BTTV (which implies i2c) in your 2.2.x kernel
configuration. You will find these devices in the menu "Character
Devices" in your Kernel Configuration.

In newer kernels (2.4) instead of BTTV you should enable support for
Iomega Buz cards and for Zoran 36060/36067 chipset. This will include
i2c or i2c-old modules and Buz/LML33 driver. However, instead of
modules for Buz/LML33 driver from the kernel, use modules from _this_
driver.

To compile the driver, just type make.

Before you load the driver you must have a video device at major device
node 81. If you don't have it yet, do the following (as root!):

cd /dev
mknod video0 c 81 0
ln -s video0 video

If you have more than one card, add more nodes in /dev directory:

mknod video1 c 81 1
mknod video2 c 81 2
...

The driver should operate properly with several cards. It was tested
with one DC10plus and one LML33 cards installed together and the driver
correctly identifies both cards and works with both of them.

Currently the driver does not support LML33 and Buz cards installed
together in the same system. This will be fixed in future versions.

Edit the 'update' script if you want to give the driver special options
(see below for options descriptions) and then type (as root)

./update <card_list>

to insert all necessary modules into the kernel. <card_list> is a list of
cards installed in your system separated by white space. Supported cards 
are dc10, dc10plus, lml33, and buz. For example, if you have both dc10plus
and lml33 cards, please type

./update dc10 lml33

If you want to make full use of the Video for Linux _uncompressed_
grabbing facilities, you must either

- obtain and install the "big_physarea patch" for your kernel and
  set aside the necessary memory during boot time. There seem to be
  several versions of this patch against various kernel versions
  floating around in the net, you may obtain one e.g. from:
  http://www.polyware.nl/~middelin/hob-v4l.html#bigphysarea
  You also have to compile your driver AFTER installing that patch in
  order to get it working

  or

- start your kernel with the mem=xxx option, where xxx is your
  real memory minus the memory needed for the buffers.
  For doing this add an entry in lilo.conf (if you use lilo):
    append "mem=xxxM"
  or add a line in your linux.par file (if you use loadlin):
    mem=xxxM

The second method is by far easier, however it is dangerous if more
than one driver at a time has the idea to use the memory leftover by
setting the mem=xxx parameter below the actual memory size.

Read also below how to use this memory!


  If you use only MJPEG compressed capture provided by the driver, you
  should not need large memory areas for DMA. In this case, you will be
  able to capture and playback movies with lavtools, however you will
  not be able to use capture features of XawTV and other similar
  programs (you can still watch video on the screen).



Driver Options
==============

You are able to customize the behavior of the driver by giving
it some options at start time.

default_input, default_norm
---------------------------

As soon as the driver is loaded, the Buz samples video signals
from one of its input ports and displays it on its output.
The driver uses the Composite Input and the video norm PAL for this.
If you want to change this default behavior, set default_input=1
(for S-VHS input) or default_norm=1 for NTSC or default_norm=2
for SECAM (DC10/DC10plus only).

lock_norm
---------

This option was introduced to disable norm (TV standard) change by some
not well behaving programs. For example, if you have some application
which was written by somebody who lives in a country with PAL standard,
this program may not have NTSC option and may always try to set the
driver to PAL. In this case, you may load the driver with
default_norm=1 and lock_norm=1 and the card will be forced to work in
NTSC standard only.

  Options:
  
  lock_norm=0   default, TV standard change is enabled;
  lock_norm=1   TV standard change is disabled but the driver
                will not notify the application about any error;
  lock_norm=2   TV standard change is disabled and the driver
                will notify the program that TV standards other
                than set by default_norm=X option are not 
                supported.

pass_through
------------

When the driver is not in use (device is not opened by any program) and
pass_through=0 (default) the driver will set the TV encoder to produce
color bar signal at the output. If the driver was loaded with
pass_through=1, the color bar will be disabled and input signal will be
sent to the output even if the driver not in use. If you have LML33 card
and wish the color bar signal at the output, you will also need to set
lml33dpath=1 (please, see next section).

lml33dpath
----------

LML33 card normally (lml33dpath=0) connects its output to the input
using analog switch. Additionally, it also allows real-time monitoring
of digitized video using TV monitor connected to the output. This
"digital path" option can be enabled setting lml33dpath=1. In this
mode, the input is connected only to the TV decoder, digital video data
is sent via internal video bus to the TV encoder and resulting analog
signal is sent to the output. This mode could be very useful for testing and
picture adjustment while watching video at the TV monitor connected to
the output. However, because of lack of 75 ohm terminating resistors at
TV decoder input, the signal will suffer serious distortions.

# These distortions could be eliminated by soldering two 75 ohm resistors
# in LML33 card: in parallel to capacitors C73 and C82 (see schematics of
# H33 board available at www.linuxmedialabs.com and www.zoran.com). Be
# aware, however, that doing so will void card warranty and the card,
# after this change, must always be used with loading option lml33dpath=1.
# 
# WARNING: I DID NOT TRY THIS CARD CHANGE YET, THIS IS JUST AN ASSUMPTION