Return to README CVS log

Up to [DVB] / dvb-kernel

Annotation of dvb-kernel/README, revision 1.8

1.8     ! holger      1: Instructions for building the standalone driver:
        !             2: ------------------------------------------------
1.1       hunold      3: 
1.8     ! holger      4: You must have the kernel sources for the kernel you are actually using
        !             5: installed, and symlinked to /lib/modules/$(KERNEL_VERSION)/build. This should
        !             6: be the default in proper installations with installed kernel source package.
1.1       hunold      7: 
1.8     ! holger      8: If you are in doubt please get a fresh and clean kernel source tarball from 
        !             9: http://www.kernel.org/, unpack, configure, install and boot this one before
        !            10: building the DVB driver. 80% of the bug reports on the linux-dvb mailing list
        !            11: have been related to not properly installed kernels in the past.
        !            12: 
        !            13: For cards with MPEG decoder onboard make sure that CONFIG_VIDEO_DEV is enabled
        !            14: in the config of your running kernel. If you get unresolved symbols named
        !            15: video_XXXX then you missed this option.
        !            16: 
        !            17: For some cards you need Input and Event Device Support enabled to get the
        !            18: IR receiver on the card running. Be sure to enable CONFIG_INPUT and 
        !            19: CONFIG_INPUT_EVDEV if you get unresolved symbols named input_XXX.
        !            20: 
        !            21: Now Type 'make' to build the driver. The compiled modules will be located
        !            22: in directory ./build-2.4/ or ./build-2.6, depening on the kernel version you
        !            23: are running. There you will also find scripts to load and unload the modules.
        !            24: 
        !            25: For some cards you need to download additional firmware binaries.  You get
        !            26: notified in the build process or when loading the modules, please follow the
        !            27: instructions there if you own one of the cards that need a firmware to run.
        !            28: 
        !            29: Now execute the ./MAKEDEV-DVB.sh script to create the DVB API device nodes.
        !            30: When you reached this point successfully you probably want to start some
        !            31: test applications, download the linuxtv-dvb-apps-1.1.tar.gz package, unpack
        !            32: it and compile it. This package contains some tools to test and debug the
        !            33: driver:
        !            34: 
        !            35: apps/szap/ contains three simple applications for zapping with DVB-S, DVB-C
        !            36: or DVB-T cards (szap/czap/tzap); read the comments in apps/szap/szap.c for
        !            37: instructions.
        !            38: 
        !            39: Note 1: tuning succeeded if you see the FE_HAS_LOCK flag and "status 1f"; a
        !            40: good signal has a low bit error rate (ber) and zero uncorrectable packets (unc).
        !            41: 
        !            42: Note 2: you must keep ?zap running, or the frontend will go to sleep (unless
        !            43: you load dvb-core.o with dvb_shutdown_timeout=0)
        !            44: 
        !            45: If your card has a hardware MPEG decoder you can watch TV with xawtv (together
        !            46: with e.g. szap for DVB tuning); Note: xawtv cannot control the DVB tuner, you
        !            47: must use ?zap
        !            48: 
        !            49: For cards without hardware MPEG decoder you need a software MPEG decoder, 
        !            50: e.g. mplayer or xine (you need *very* recent versions which understand MPEG2 
        !            51: transport streams; xine v0.9.21 and mplayer dev-CVS-030723-16:39-3.3.1 seem to 
        !            52: work); Note: You must run ?zap with the -r flag to enable stream output to the 
        !            53: dvr device, and keep it running while watching tv.  
        !            54: 
        !            55: Examples: 
        !            56:        mplayer - < /dev/dvb/adapter0/dvr0 
        !            57:        xine stdin://mpeg2 < /dev/dvb/adapter0/dvr0
        !            58:        
        !            59: Note: Newest mplayer and xine versions are reported to have builtin DVB support
        !            60: (see FAQ for more info).
        !            61: 
        !            62: For 'real' everyday use you probably don't want to use these test applications 
        !            63: but install a program like VDR or MythTV. Read the FAQ for some links.
        !            64: 
        !            65: --------------------------------------------------------------------------------
        !            66: 
        !            67: The build system has been tested down to 2.4.20, if you run an older kernel
        !            68: either update your kernel or just try - maybe you need to add some tweaks in
        !            69: the dvb_compat.[hc] files. Please report your modifications on the linux-dvb 
        !            70: mailing list.
        !            71: 
        !            72: If you want to build a not-standalone driver but want to patch your 2.6 kernel
        !            73: source tree with this driver please read README-2.6.
        !            74: 
        !            75: More documentation is located in ./linux/Documentation/dvb/.
        !            76: 
        !            77: good luck,
        !            78: 
        !            79: Holger
1.7       hunold     80: