Import 2.1.118
[davej-history.git] / Documentation / video4linux / bttv / INSTALL
blob52cac1e6cf613646863c494b9fb7f6b952c29689
1 - Make sure you have a recent 2.0.x kernel (I recommend AT LEAST 2.0.33!)
2   or a recent 2.1.x kernel.
3   Older kernels might lead to problems. 
5 - Do NOT compile videodev into your kernel!
6   Use the module supplied with bttv.
8 - Edit "driver/Makefile":
10   - If you do NOT have a Miro card:
11     Adjust TUNER to a number between 0 and 7. 
13     This number has the following meaning:
15     0: Temic PAL tuner
16     1: Philips PAL_I tuner
17     2: Philips NTSC tuner
18     3: Philips SECAM tuner
19     4: no tuner
20     5: Philips PAL tuner
21     6: Temic NTSC tuner
22     7: Temic PAL tuner
24     The number corresponds to the number (-1) given at the GPIO port of the
25     Bt848 on Miro cards.
28   - Adjust CARD to one of the numbers below:
30     0: Auto-Detect
31     1: Miro
32     2: Hauppauge
33     3: STB
34     4: Intel
35     5: Diamond
36     6: AVerMedia
39   - You may have to adjust BTTV_MAJOR to a different number depending on your
40     kernel version. The official number 81 does not work on some setups.
41     But instead of changing it, better update to a newer kernel.
43   - If you have a Bt848a or Bt849 on your board you might have to
44     uncomment: -DUSE_PLL 
46 - do a "make" in the main directory.
48 If you have Hauppauge card read "README.HAUPPAUGE" before proceeding.
50 - type "make ins"
52   This creates the bttv devices in /dev and installs the bttv module
54   Look in the kernel log file (/var/adm/syslog or /var/log/kernel or something
55   else depending on your /etc/syslogd.conf or just call "dmesg")
56   and see what bttv reported (lines starting with "bttv:")
57   If the installation failed and you send e-mail to me always include those
58   lines! Dumps of the insmod output alone do not help at all.
60 - Start X11 in hi or true color mode 
61   8 bit color is also supported but really ugly!
62   (If you have an S3 card you might have to start X11 before installing
63    the module!)
65   If you have Motif or LessTif, "xtvscreen" in the "XTV" directory should
66   have been compiled with the "make" above.
67   Otherwise use the statically linked version which should be available 
68   on the web site you got bttv from.
69   Read the documentation in "XTV" and start xtvscreen.
71 - make applications by typing "make" in "apps"
72