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