Return to README CVS log

Up to [DVB] / dvb-kernel

Annotation of dvb-kernel/README, revision 1.9.2.7

1.8       holger      1: Instructions for building the standalone driver:
                      2: ------------------------------------------------
1.1       hunold      3: 
1.9.2.2   holger      4: If you encounter any problems while executing the follwing steps please read
                      5: the TROUBLESHOOTING file.
                      6: 
                      7: Simply type 'make' to build the driver. The compiled modules will be located
1.9.2.4   holger      8: in directory ./build-2.4/ or ./build-2.6/, depening on the kernel version you
1.8       holger      9: are running. There you will also find scripts to load and unload the modules.
                     10: 
                     11: For some cards you need to download additional firmware binaries.  You get
                     12: notified in the build process or when loading the modules, please follow the
                     13: instructions there if you own one of the cards that need a firmware to run.
                     14: 
1.9.2.1   holger     15: In ./build-2.4/ or ./build-2.6/ you find the insmod script.
                     16: 
1.9       holger     17: Use './insmod.sh load' to load the driver modules, './insmod.sh unload' to 
                     18: remove them. './insmod debug' loads the drivers with debugging enabled. 
1.9.2.6   holger     19: These scripts load all drivers for all cards but the ones based on the bt8xx.
                     20: For bt8xx based cards please use the insmod-bt8xx.sh script instead.
1.9.2.1   holger     21: 
1.9.2.5   holger     22: Now check the klog and syslog (in doubt type 'dmesg') for error messages.
1.9       holger     23: 
1.8       holger     24: When you reached this point successfully you probably want to start some
                     25: test applications, download the linuxtv-dvb-apps-1.1.tar.gz package, unpack
                     26: it and compile it. This package contains some tools to test and debug the
                     27: driver:
                     28: 
1.9       holger     29: linuxtv-dvb-apps-1.1/apps/szap/ contains three simple applications called 
                     30: szap, czap and tzap for zapping with DVB-S, DVB-C or DVB-T cards.
                     31: Read linuxtv-dvb-apps-1.1/apps/szap/ README for usage instructions.
1.8       holger     32: 
                     33: Note 1: tuning succeeded if you see the FE_HAS_LOCK flag and "status 1f"; a
                     34: good signal has a low bit error rate (ber) and zero uncorrectable packets (unc).
                     35: 
                     36: Note 2: you must keep ?zap running, or the frontend will go to sleep (unless
                     37: you load dvb-core.o with dvb_shutdown_timeout=0)
                     38: 
                     39: If your card has a hardware MPEG decoder you can watch TV with xawtv (together
                     40: with e.g. szap for DVB tuning); Note: xawtv cannot control the DVB tuner, you
                     41: must use ?zap
                     42: 
                     43: For cards without hardware MPEG decoder you need a software MPEG decoder, 
                     44: e.g. mplayer or xine (you need *very* recent versions which understand MPEG2 
                     45: transport streams; xine v0.9.21 and mplayer dev-CVS-030723-16:39-3.3.1 seem to 
                     46: work); Note: You must run ?zap with the -r flag to enable stream output to the 
                     47: dvr device, and keep it running while watching tv.  
                     48: 
                     49: Examples: 
                     50:        mplayer - < /dev/dvb/adapter0/dvr0 
                     51:        xine stdin://mpeg2 < /dev/dvb/adapter0/dvr0
                     52:        
                     53: Note: Newest mplayer and xine versions are reported to have builtin DVB support
1.9       holger     54: (see ./linux/Documentation/dvb/faq.txt for more info).
1.8       holger     55: 
                     56: For 'real' everyday use you probably don't want to use these test applications 
1.9       holger     57: but install a program like VDR or MythTV.
                     58: (Read ./linux/Documentation/dvb/faq.txt for some links)
1.8       holger     59: 
1.9.2.3   holger     60: When everything is working you probably want to install the driver on your 
                     61: system by typing 'make install'. If you want to load the modules automatically
                     62: when an application tries to open the device you need to add lines like these 
                     63: to your modules.conf:
                     64: 
                     65:        probeall /dev/dvb dvb-ttpci
                     66:        alias /dev/dvb/* /dev/dvb
                     67:        below dvb-ttpci alps_bsrv2 alps_tdmb7 alps_tdlb7
                     68:        add below dvb-ttpci grundig_29504-401 grundig_29504-491
                     69:        add below dvb-ttpci stv0299 ves1820
                     70: 
                     71: Note: this example is for people with Technotrend-based PCI cards, they must 
                     72: load the dvb-ttpci driver and a matching frontend drivers that are potentially
                     73: used on these cards. In order to find out which ones are required for your
                     74: setup check the lsmod output after loading the driver like described above.
                     75: Those DVB modules that have a usecount greater zero are required in your 
                     76: setup - edit the modules.conf file appropriatly]
                     77: 
                     78: Debian users don't edit modules.conf manually but add the lines above to a new
                     79: file in /etc/modutils/ (e.g. /etc/modutils/dvb) and call 'update-modules' then.
                     80: 
1.8       holger     81: --------------------------------------------------------------------------------
                     82: 
                     83: The build system has been tested down to 2.4.20, if you run an older kernel
                     84: either update your kernel or just try - maybe you need to add some tweaks in
                     85: the dvb_compat.[hc] files. Please report your modifications on the linux-dvb 
                     86: mailing list.
                     87: 
                     88: If you want to build a not-standalone driver but want to patch your 2.6 kernel
                     89: source tree with this driver please read README-2.6.
                     90: 
                     91: More documentation is located in ./linux/Documentation/dvb/.
                     92: 
                     93: good luck,
                     94: 
                     95: Holger
1.7       hunold     96: