This is an evaluation release of a Linux device driver module for the Kfir
encoder card.

Most of the files in kfir/driver/ are part of all newer Linux kernels.
If you are using a 2.4.x kernel you can also use the i2c and videodev files
from your kernel. They are included here for compatibility with 2.2.x kernels
which use an older I2C interface.

All files are released under the GNU General Public License except
micro/kfir_micro.h which contains material which is copyrighted by Visiontech.

This driver is provided for evaluation purposes only.

Known problems: see http://linuxtv.org/mpeg2

INSTALLATION:

Change into the driver directory.
The Makefile expects the configured sources of the currently used kernel to be 
in /usr/src/linux. Otherwise, change the setting of KERNEL_LOCATION in the Makefile.

Do a "make"

If everything compiled without problems try "make insmod".

Now (if your PC did not crash :-) plug in a PAL composite signal an sound and 
try: "cat /dev/video > test.mpg"

Stop the encoding process by pressing CNTRL-C.


Right now you can only change the recording parameters via module arguments.
Possible options for the kfir module:

loaded       - Altera is already loaded with microcode, so donīt do it again
               (reloading takes time and can lock your machine!)

vidinmode    - vidimode=0  for PAL, 1 for NTSC, 2 for SECAM (default PAL)

vidoutmode   - vidoutmode=0 for NTSC, 1 for PAL (default PAL)
               (yaeh, I know, KFIR and Video4Linux defines are different for PAL/NTSC)

vidsize      - vidsize=(vertical_mode<<4)|horizontal_mode,  cf. KfirCMD.h
               e.g. vidsize=0x12 (=(KFIR_V_288<<4)|KFIR_H_352)

vidrate      - video bitrate

mpeg1mode    - mpeg1mode=1 for MPEG1 

streamtype   - streamtype=0, ..., 7 (cf. KfirCMD.h, default VT_KFIR_PROGRAM) 

sndfreq      - sndfreq=0, ..., 7 (cf. KfirCMD.h, default VT_KFIR_AUDIO_FREQ_32_000) 



July 2000

Ralph Metzler