Return to README CVS log

Up to [DVB] / kfir

added md5sums of microcodes to README
minor changes to make building in kernel tree easier

Attention!

This driver comes without the firmware, because the copyright situation
is still unclear. So it's not working. We're trying to work this out
with Visiontech, and hope to provide a working driver soon.

Visiontech makes the microcode available for free download on their own
ftp site ftp.visiontech-dml.com. They offered their own user-space (and not really 
working without many system locks) Linux driver including firmware there.
They removed it for unknown reasons but you can download versions for some 
of those other operating systems which some people use.
Install the Win9x/Kfir1 version on your system, cd to driver/micro, adjust the paths 
in the first two lines of Makefile and do "make" to extract the microcodes.
Afterwards you should be able to compile and use the driver.

The files resulting from the extraction process should have the following md5
cheksums:

05269813b418d4ce733e69b13db8dc03  MPEG1_6.HLD
4e3e3088a1f5ad1e480ef1aa0456cdf5  altera_keb_plx_5e.rbf
40ce0f03215ff51d4a8aaaf846389c5e  kfir_micro.h


There is no license agreement in the installation file of those drivers but 
some microcode files contain a copyright header. 
IANAL, so please figure out for yourself how they apply in the
situtation in which you are using the driver.

--------------------------------------------------------------------------

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.

The actual new files for the Kfir driver are: 

kfir.c kfir.h KfirCMD.h KfirDef.h plx9054.h 

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 and 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=5,6,7 (cf. KfirCMD.h, default VT_KFIR_AUDIO_FREQ_48_000) 
               only 32, 44.1 and 48 KHz seem to work with the Visiontech microcode

vidinput     - 0=Composite, 1=S-Video


Ralph Metzler <ralph@convergence.de>