Annotation of dvb-kernel/README, revision 1.15
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:
1.15 ! hunold 11: For some cards or frontends you need to download additional firmware
! 12: binaries:
! 13:
! 14: - dvb-ttpci: http://www.linuxtv.org/download/dvb/
! 15: => wget http://www.linuxtv.org/download/dvb/dvb-ttpci-01.fw
! 16: Place the "dvb-ttpci-01.fw" file in the build-2.4 and/or build-2.6
! 17: directory. The firmware will be compiled into the driver at it used to
! 18: be.
! 19:
! 20: - alps_tdlb7:
! 21: This driver needs a copy of the firmware file 'Sc_main.mc' from the
! 22: Haupauge windows driver in the '/usr/lib/hotplug/firmware' directory.
! 23: Alternatively, you can also pass the complete filename with the module
! 24: parameter 'firmware_file'.
! 25:
! 26: - tda1004x:
! 27: This driver needs a copy of the DLL "ttlcdacc.dll" from the Haupauge or
! 28: Technotrend windows driver saved as
! 29: '/usr/lib/hotplug/firmware/tda1004x.mc'. You can also pass the complete
! 30: file name with the module parameter 'tda1004x_firmware'.
! 31: Currently the DLL from v2.15a of the technotrend driver is supported. Other versions can
! 32: be added reasonably painlessly.
! 33: Windows driver URL: http://www.technotrend.de/
! 34:
! 35: - ttusb-dec:
! 36: see "ttusb-dec.txt" in linux/Documentation for details
! 37:
! 38: If something is missing, you get notified in the build process or when
! 39: loading the modules.
1.8 holger 40:
1.10 holger 41: In ./build-2.4/ or ./build-2.6/ you find the insmod script.
42:
1.9 holger 43: Use './insmod.sh load' to load the driver modules, './insmod.sh unload' to
44: remove them. './insmod debug' loads the drivers with debugging enabled.
1.13 holger 45: These scripts load all drivers for all cards but the ones based on the bt8xx.
46: For bt8xx based cards please use the insmod-bt8xx.sh script instead.
1.10 holger 47:
1.12 holger 48: Now check the klog and syslog (in doubt type 'dmesg') for error messages.
1.9 holger 49:
1.8 holger 50: When you reached this point successfully you probably want to start some
51: test applications, download the linuxtv-dvb-apps-1.1.tar.gz package, unpack
52: it and compile it. This package contains some tools to test and debug the
53: driver:
54:
1.9 holger 55: linuxtv-dvb-apps-1.1/apps/szap/ contains three simple applications called
56: szap, czap and tzap for zapping with DVB-S, DVB-C or DVB-T cards.
57: Read linuxtv-dvb-apps-1.1/apps/szap/ README for usage instructions.
1.8 holger 58:
59: Note 1: tuning succeeded if you see the FE_HAS_LOCK flag and "status 1f"; a
60: good signal has a low bit error rate (ber) and zero uncorrectable packets (unc).
61:
62: Note 2: you must keep ?zap running, or the frontend will go to sleep (unless
63: you load dvb-core.o with dvb_shutdown_timeout=0)
64:
65: If your card has a hardware MPEG decoder you can watch TV with xawtv (together
66: with e.g. szap for DVB tuning); Note: xawtv cannot control the DVB tuner, you
67: must use ?zap
68:
69: For cards without hardware MPEG decoder you need a software MPEG decoder,
70: e.g. mplayer or xine (you need *very* recent versions which understand MPEG2
71: transport streams; xine v0.9.21 and mplayer dev-CVS-030723-16:39-3.3.1 seem to
72: work); Note: You must run ?zap with the -r flag to enable stream output to the
73: dvr device, and keep it running while watching tv.
74:
75: Examples:
76: mplayer - < /dev/dvb/adapter0/dvr0
77: xine stdin://mpeg2 < /dev/dvb/adapter0/dvr0
78:
79: Note: Newest mplayer and xine versions are reported to have builtin DVB support
1.9 holger 80: (see ./linux/Documentation/dvb/faq.txt for more info).
1.8 holger 81:
82: For 'real' everyday use you probably don't want to use these test applications
1.9 holger 83: but install a program like VDR or MythTV.
84: (Read ./linux/Documentation/dvb/faq.txt for some links)
1.8 holger 85:
1.10 holger 86: When everything is working you probably want to install the driver on your
87: system by typing 'make install'. If you want to load the modules automatically
88: when an application tries to open the device you need to add lines like these
89: to your modules.conf:
90:
91: probeall /dev/dvb dvb-ttpci
92: alias /dev/dvb/* /dev/dvb
93: below dvb-ttpci alps_bsrv2 alps_tdmb7 alps_tdlb7
94: add below dvb-ttpci grundig_29504-401 grundig_29504-491
95: add below dvb-ttpci stv0299 ves1820
96:
97: Note: this example is for people with Technotrend-based PCI cards, they must
98: load the dvb-ttpci driver and a matching frontend drivers that are potentially
99: used on these cards. In order to find out which ones are required for your
100: setup check the lsmod output after loading the driver like described above.
101: Those DVB modules that have a usecount greater zero are required in your
102: setup - edit the modules.conf file appropriatly]
103:
104: Debian users don't edit modules.conf manually but add the lines above to a new
105: file in /etc/modutils/ (e.g. /etc/modutils/dvb) and call 'update-modules' then.
106:
1.8 holger 107: --------------------------------------------------------------------------------
108:
109: The build system has been tested down to 2.4.20, if you run an older kernel
110: either update your kernel or just try - maybe you need to add some tweaks in
111: the dvb_compat.[hc] files. Please report your modifications on the linux-dvb
112: mailing list.
113:
114: If you want to build a not-standalone driver but want to patch your 2.6 kernel
115: source tree with this driver please read README-2.6.
116:
117: More documentation is located in ./linux/Documentation/dvb/.
118:
119: good luck,
120:
121: Holger
1.7 hunold 122:
LinuxTV legacy CVS <linuxtv.org/cvs>