The BTTV HOWTO Howard Shane Revision History Revision 0.9 Initial rewrite 2005−01−29 Revised by: jhs This document was written to assist the reader in the steps necessary to configure and use a video tuner card based on the popular Bt848 and Bt878 chipsets within the Linux operating system.
The BTTV HOWTO Table of Contents 1. Introduction.....................................................................................................................................................1 1.1. Copyright Information......................................................................................................................1 1.2. Disclaimer.........................................................................................................................................1 1.3.
1. Introduction This document was written to assist the reader in setting up and configuring TV tuner cards based on the Bt848 or Bt878 chipsets in the Linux operating system. It outlines how to enable the necessary kernel and/or software support and various television applications and software methods of capture usable with your device.
The BTTV HOWTO 1.5. Feedback Please send any information you may feel important to the following email address: , whether you have a correction, addition or update. I welcome suggestions on how to improve this document. 1.6.
2. The BTTV Hardware 2.1. Bttv Basics If you haven't figured it out by now, this document deals with the Linux−specific configuration of frame grabber cards that include the Conexant Bt848 and related family of video decoder chips, collectively referred to as the "Bt8x8" chipset. You can probably see the Bt8x8 chip (it's usually labelled as such) embedded on your TV card upon inspection, in addition to other chips which you should probably make note of before installation in case there are problems later.
The BTTV HOWTO to control the input with your mixer from your primary sound card as well as record (see Appendix D for more information on recording). Alternatively you can use external speakers connected to the line out of your Bt8x8 card. 2.
3. Enabling Support for Your Bt8x8 Hardware in Linux 3.1. The Bttv Driver Drivers for Bt8x8−based hardware have been a part of the Linux kernel since version 2.2.0, and are likely to be already enabled in your running kernel if you have not recompiled or otherwise replaced your system's stock kernel with a custom version.
The BTTV HOWTO $ ls −R /lib/modules/`uname −r`/kernel Where `uname −r`, surrounded by forward tick marks, is your kernel version number. The following output is an example of what you might find in a Bttv−ready kernel, where everything is loaded as a module (edited for brevity): /lib/modules/2.6.8/kernel/drivers/media/video: btcx−risc.ko ir−kbd−i2c.ko tda9875.ko tvaudio.ko bttv.ko msp3400.ko tda9887.ko v4l1−compat.ko ir−kbd−gpio.ko tda7432.ko tuner.ko v4l2−common.ko video−buf.ko videodev.
The BTTV HOWTO If you are running a 2.4 series kernel, btaudio in the OSS "Sound" category is optional if you want to use external speakers attached to the the card's audio out jack, and either (or both) OSS or ALSA sound system btaudio drivers in the 2.6+ series. 3.3. Configuration Requirements for Use of your Bttv Hardware Once you know your kernel is enabled you can proceed to some minor tuning that may already be done for you depending on your system and distributor and distribution features. 3.3.1.
The BTTV HOWTO # see http://roadrunner.swansea.uk.linux.org/v4lapi.shtml echo "*** new device names ***" makedev video 0 makedev radio 64 makedev vtx 192 makedev vbi 224 # "*** old device names (for compatibility only) ***" #makedev bttv 0 #makedev bttv−fm 64 #makedev bttv−vbi 224 Simply copy and paste the above into your favorite editing program, save it as MAKEDEV or whatever name you like, make it executable (i.e., chmod u+x MAKEDEV), and then execute it as root: # ./MAKEDEV 3.4.
4. Loading the Modules This section is only for those whose modules don't load automatically and/or correctly. For a complete list of options by module, see Appendix A. 4.1. The Bttv Module Once your card is installed, you can load the bttv module if your kernel hasn't already done it for you. Using the modprobe command as root, type # modprobe bttv The modules videodev and i2c may be required prior to this if you are running a pre−2.4 series kernel.
The BTTV HOWTO tuner=10 tuner=11 tuner=12 tuner=13 tuner=14 tuner=15 tuner=16 tuner=17 tuner=18 tuner=19 tuner=20 tuner=21 tuner=22 tuner=23 tuner=24 tuner=25 tuner=26 tuner=27 tuner=28 tuner=29 tuner=30 tuner=31 tuner=32 tuner=33 tuner=34 tuner=35 tuner=36 tuner=37 tuner=38 tuner=39 tuner=40 tuner=41 tuner=42 tuner=43 tuner=44 tuner=45 Alps TSBE1 Alps TSBB5 Alps TSBE5 Alps TSBC5 Temic PAL_BG (4006FH5) Alps TSCH6 Temic PAL_DK (4016 FY5) Philips NTSC_M (MK2) Temic PAL_I (4066 FY5) Temic PAL* auto (4006 FN5)
The BTTV HOWTO # TV alias char−major−81 pre−install bttv options options tuner 4.
5. Television Applications Now that your kernel is configured, your devices have been configured, and your modules are inserted, you will also need an application to actually view or capture the images from your card. 5.1. Console−Based Applications 5.1.1. FbTV Fbtv is a console−only mode TV viewing program available for viewing on a framebuffer−video enabled system with a Bt8x8 card. If you don't know what a framebuffer is you can read the Framebuffer HOWTO.
The BTTV HOWTO flags: overlay capture tuner Now that you know your Bt8x8 device is available, try starting Xawtv: $ xawtv −device /dev/video0 Note that some Nvidia cards may confuse xawtv, so if you have one of these be sure to use the −device switch as above. 5.2.2. Motv Motv is a Motif−based rewrite of Xawtv. Other than a more attractive interface, and is also found at the Xawtv homepage. It is otherwise identical to Xawtv. 5.2.3.
A. Optional Arguments for Loading Modules videodev.o −−−−−−−−−−−−−−−−−−−−−−−−−−−−− This is the basic video4linux module, all video drivers (incl. bttv) register themselves here. i2c.o −−−−−−−−−−−−−−−−−−−−−−−− The generic i2c module. It does much of the i2c bus management, all other modules (except videodev.o) use this one. modprobe args: scan=1 scan the bus for i2c devices verbose=0 shut up i2c i2c_debug=1 for debugging, it sticks the whole (software) i2c bus traffic to the syslog bttv.
The BTTV HOWTO stereo card, you probably want to modprobe this one. modprobe args: debug=1/2 print some debug info to the syslog, 2 is more verbose. *tea6300.o −−−−−−−−−−−−−−−−−−−−−−−−−−−−− The driver for the tea6300 fader chip. If you have a stereo card and the msp3400.o doesn't work, you might want to try this one. This chip is seen on most STB TV/FM cards (usually from Gateway OEM sold surplus on auction sites). modprobe args: debug=1 print some debug info to the syslog. *tda8425.
The BTTV HOWTO tuner.o −−−−−−−−−−−−−−−−−−−−−−−−−− The tuner driver. You need this unless you want to use only with a camera or external tuner. modprobe args: debug=1 print some debug info to the syslog type=n type of the tuner chip. n as seen in Section 4 i2c_chardev.o −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Provides a character device for i2c bus access. only, not compiled by default. A. Optional Arguments for Loading Modules Works for 2.1.
B. Bt8x8 Cards by Number These are the option numbers for cards for use with modprobe.This does not boast to be a complete list by any means; it is copied nearly verbatim from the kernel source documentation for bttv. If your card is not listed it may or may not be supported depending on the chipset and accompanying components with which it is constructed.
The BTTV HOWTO card=40 card=41 card=42 card=43 card=44 card=45 card=46 card=47 card=48 card=49 card=50 card=51 card=52 card=53 card=54 card=55 card=56 card=57 card=58 card=59 card=60 card=61 card=62 card=63 card=64 card=65 card=66 card=67 card=68 card=69 card=70 card=71 card=72 card=73 card=74 card=75 card=76 card=77 card=78 card=79 card=80 card=81 card=82 card=83 card=84 card=85 card=86 card=87 card=88 card=89 card=90 STB TV PCI FM, Gateway P/N 6000704 (bt878), 3Dfx VoodooTV 100 AVerMedia TVPhone 98 ProVi
The BTTV HOWTO card=91 card=92 card=93 card=94 card=95 card=96 card=97 card=98 card=99 card=100 card=101 card=102 card=103 card=104 card=105 card=106 card=107 card=108 card=109 card=110 card=111 card=112 card=113 card=114 card=115 card=116 card=117 card=118 card=119 card=120 Osprey 540 Osprey 2000 IDS Eagle Pinnacle PCTV Sat Formac ProTV II (bt878) MachTV Euresys Picolo ProVideo PV150 AD−TVK503 Hercules Smart TV Stereo Pace TV & Radio Card IVC−200 Grand X−Guard / Trust 814PCI Nebula Electronics DigiTV ProV
C. Cards and Features by Manufacturer MATRIX Vision −−−−−−−−−−−−− MV−Delta − Bt848A − 4 Composite inputs, 1 S−VHS input (shared with 4th composite) − EEPROM http://www.matrix−vision.de/ This card has no tuner but supports all 4 composite (1 shared with an S−VHS input) of the Bt848A. Very nice card if you only have satellite TV but several tuners connected to the card via composite.
The BTTV HOWTO − Bt848 (and others but always in 2 crystal operation???) newer cards have a Bt878 − PAL, SECAM, NTSC or tuner with or without Radio support e.g.: PAL: TDA5737: VHF, hyperband and UHF mixer/oscillator for TV and VCR 3−band tuners TSA5522: 1.
The BTTV HOWTO 144F:3002 = CPH05x w/ FM 144F:3005 = CPH06x_LC (w/o remote control) 1) The cards have a sticker with "CPH"−model on the back. 2) These cards have a number printed on the PCB just above the tuner metal box "80−CP2000300−x" = CPH03X "80−CP2000500−x" = CPH05X "80−CP2000600−x" = CPH06X / CPH06x_LC Askey sells these cards as "Magic TView series", Brand "MagicXpress". Other OEM often call these "Tview", "TView99" or else.
The BTTV HOWTO These cards are sold by many OEMs too. FlyVideo A2 (Elta 8680)= LR90 Rev.F (w/Remote, w/o FM, stereo TV by tda9821) { Lifeview 3000 (Elta 8681) as sold by Plus(April 2002), Germany = LR138 w/ saa7 Typhoon TV card series: −−−−−−−−−−−−−−−−−−−−−−− These can be CPH, Flyvideo, Pixelview or KNC1 series. Typhoon is the brand of Anubis. Model 50680 got re−used, some model no. had different contents over time.
The BTTV HOWTO Multimedia TV packages (card + software pack): PixelView Play TV Theater − (Model: PV−M4200) = PixelView PixelView Play TV PAK − (Model: PV−BT878P+ REV 4E) PixelView Play TV/VCR − (Model: PV−M3200 REV 4C / 8D / PixelView Studio PAK − (Model: M2200 REV 4C / 8D / PixelView PowerStudio PAK − (Model: PV−M3600 REV 4E) PixelView DigitalVCR PAK − (Model: PV−M2400 REV 4C / 8D / Play TV pro + Soft 10A ) 10A ) 10A ) PixelView PlayTV PAK II (TV/FM card + usb camera) PV−M3800 PixelView PlayTV XP PV−M47
The BTTV HOWTO CaptureTV M200 (ISA) CaptureTV M205 (Bt848) Lucky Star −−−−−−−−−− Image World Conference TV = LR50 Rev.
The BTTV HOWTO PV−911 Highscreen −−−−−−−−−− TV Karte = LR50 Rev.S TV−Boostar = Terratec Terra TV+ Version 1.0 (Bt848, tda9821) "ceb105.pcb" Zoltrix −−−−−−− Face to Face Capture (Bt848 capture only) (PCB "VP−2848") Face To Face TV MAX (Bt848) (PCB "VP−8482 Rev1.3") Genie TV (Bt878) (PCB "VP−8790 Rev 2.1") Genie Wonder Pro AVerMedia −−−−−−−−− AVer FunTV Lite (ISA, AV3001 chipset) "M101.
The BTTV HOWTO AverTV Stereo AVerTV Studio DE hat diverse Treiber fuer diese Modelle (Stand 09/2002): TVPhone (848) mit Philips tuner FR12X6 (w/ FM radio) TVPhone (848) mit Philips tuner FM12X6 (w/ FM radio) TVCapture (848) w/Philips tuner FI12X6 TVCapture (848) non−Philips tuner TVCapture98 (Bt878) TVPhone98 (Bt878) AVerTV und TVCapture98 w/VCR (Bt 878) AVerTVStudio und TVPhone98 w/VCR (Bt878) AVerTV GO Serie (Kein SVideo Input) AVerTV98 (BT−878 chip) AVerTV98 mit Fernbedienung (BT−878 chip) AVerTV/FM98 (B
The BTTV HOWTO Terra TV/Radio+ Version 1.0, "80−CP2830100−0" TTTV3 printed on the PCB, "CPH010−E83" on the back, SAA6588T, TDA9873H Terra TValue Version BT878, "80−CP2830110−0 TTTV4" printed on the PCB, "CPH011−D83" on back Terra TValue Version 1.0 "ceb105.PCB" (really identical to Terra TV+ Ve Terra TValue New Revision "LR102 Rec.C" Terra Active Radio Upgrade (tea5757h, saa6588t) LR74 is a newer PCB revision of ceb105 (both incl.
The BTTV HOWTO Pinnacle Pinnacle Pinncale Pinnacle PCTV (Bt878, MT2032) PCTV Pro (Bt878, MT2032) PCTV Sat (bt878a, HM1821/1221) ["Conexant CX24110 with CX24108 tuner PCTV Sat XE M(J)PEG capture and playback: DC1+ (ISA) DC10 (zr36057, zr36060, DC10+ (zr36067, zr36060, DC20 (ql16x24b,zr36050, zr36016, DC30 (zr36057, zr36050, zr36016, DC30+ (zr36067, zr36050, zr36016, DC50 (zr36067, zr36050, zr36016, saa7110, saa7110, saa7110, vpx3220, vpx3220, saa7112, adv7176) adv7176) saa7187 ...
The BTTV HOWTO Canopus (jp) −−−−−−− WinDVR = Kworld "KW−TVL878RF" www.sigmacom.co.kr −−−−−−−−−−−−−−−−−− Sigma Cyber TV II www.sasem.co.
The BTTV HOWTO STB Gateway 6000699 (bt848) STB Gateway 6000402 (bt848) STB TV130 PCI Videologic −−−−−−−−−− Captivator Pro/TV (ISA?) Captivator PCI/VC (Bt848 bundled with camera) (capture only) Technotrend −−−−−−−−−−−− TT−SAT PCI (PCB "Sat−PCI Rev.:1.3.1"; zr36125, vpx3225d, stc0056a, Tuner:BSKE TT−DVB−Sat revisions 1.1, 1.3, 1.5, 1.6 and 2.
The BTTV HOWTO JW−TV 878 Galaxis −−−−−−− Galaxis Galaxis Galaxis Galaxis Galaxis = KWorld KW−TV878RF DVB Card S CI DVB Card C CI DVB Card S DVB Card C plug.in S [neuer Name: Galaxis DVB Card S CI Hauppauge −−−−−−−−− many many WinTV models ... WinTV DVBs = Technotrend Premium 1.3 WinTV NOVA = Technotrend Budget 1.1 "S−DVB DATA" WinTV NOVA−CI "SDVBACI" WinTV Nova USB (=Technotrend USB 1.0) WinTV−Nexus−s (=Technotrend Premium 2.1 or 2.
The BTTV HOWTO 564 727 545 898 WinTV−Nexus−s WinTV−DVB−c Common Interface WinTV−Nova−USB UK models 607 WinTV Go 693,793 WinTV Primio FM 647,747 WinTV PCI FM 498 WinTV Theater 883 WinTV PVR 893 WinTV PVR USB (Duplicate entry) 566 WinTV USB (UK) 573 WinTV USB FM 429 Impact VCB (bt848) 600 USB Live (Video−In 1x Comp, 1xSVHS) 542 WinTV Nova 717 WinTV DVB−S 909 Nova−t PCI 893 Nova−t USB (Duplicate entry) 802 MyTV 804 MyView 809 MyVideo 872 MyTV2Go FM 546 543 907 908 717 157 WinTV Nova−S CI WinTV Nova Nova−S
The BTTV HOWTO Matrix−Vision −−−−−−−−−−−−− MATRIX−Vision MV−Delta MATRIX−Vision MV−Delta 2 MVsigma−SLC (Bt848) Conceptronic (.net) −−−−−−−−−−−− TVCON FM, TV card w/ FM = CPH05x TVCON = CPH06x BestData −−−−−−−− HCC100 = VCC100rev1 + camera VCC100 rev1 (bt848) VCC100 rev2 (bt878) Gallant (www.gallantcom.com) www.minton.com.tw −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− Intervision IV−510 (capture only bt8x8) Intervision IV−550 (bt8x8) Intervision IV−100 (zoran) Intervision IV−1000 (bt8x8) Asonic (www.
The BTTV HOWTO MPEG TV KWORLD KWORLD KWORLD KWORLD Station (same cards KW−TV878R −Pro TV KW−TV878RF−Pro TV KW−TV878R −Ultra TV KW−TV878RF−Ultra TV as above plus WinDVR Software MPEG en/decoder) (no Radio) (w/ Radio) (no Radio) (w/ Radio) JTT/ Justy Corp.http://www.justy.co.jp/ (www.jtt.com.jp website down) −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− JTT−02 (JTT TV) "TV watchmate pro" (bt848) ADS www.adstech.
The BTTV HOWTO Sensoray www.sensoray.
The BTTV HOWTO Twinhan −−−−−−− DST Card/DST−IP (bt878, twinhan asic) VP−1020 Sold as: KWorld DVBS Satellite TV−Card Powercolor DSTV Satellite Tuner Card Prolink Pixelview DTV2000 Provideo PV−911 Digital Satellite TV Tuner Card With Common Interface ? DST−CI Card (DVB Satellite) VP−1030 DCT Card (DVB cable) MSI −−− MSI TV@nywhere Tuner Card (MS−8876) (CX23881/883) Not Bt878 compatible. MS−8401 DVB−S Focus www.focusinfo.com −−−−− InVideo PCI (bt878) Sdisilk www.sdisilk.
The BTTV HOWTO −−−−−−− TV−Karte / Poso Power TV (?) = Zoltrix VP−8482 (?) iTVC15 boards: −−−−−−−−−−−−− kuroutoshikou.com ITVC15 yuan.com MPG160 PCI TV (Internal PCI MPEG2 encoder card plus TV−tuner) Asus www.asuscom.com Asus TV Tuner Card 880 NTSC (low profile, cx23880) Asus TV (saa7134) Hoontech −−−−−−−− http://www.hoontech.com/korean/download/down_driver_list03.html HART Vision 848 (H−ART Vision 848) HART Vision 878 (H−Art Vision 878) C.
D. Recording Video and Sound with Bttv In addition to the applications referenced in Section 5, recording can be managed from the command line. The issues discussed here with regard to sound capture deal only with the default kernel−2.6 and higher sound system: the Advanced Linux Sound Architecture. The easy part is grabbing the video, for which we will use streamer, available with the Xawtv suite. Sound is another matter, however.
The BTTV HOWTO Now try to record something: $ streamer −p 4 −t 1:00 −r 24 −q −o test.avi −j 90 −f mjpeg −F mono16 ...and you should be recording a sound−enabled avi file. Press [Ctrl]−C to cancel early. Next step is to automate the recording for your very own home−brewed Tivo"! I offer the following script as an example program for automating recording; you can copy and paste it into a file and make it executable (chmod u+x record−tv.sh).
The BTTV HOWTO if [ ! −z $3 ]; then $V4LCTL setchannel $3 fi # Check for vcr dir if [ ! −x $OUTPUT ]; then mkdir $OUTPUT fi DATE=`date +%m−%d−%Y−%H:%M` # Set the AC97 volume to 0 (so we don't hear the sounds) # Get mixer values first PLAY_VOL=`$AMIXER −c 0 cget name='Master Playback Volume' | grep : | sed 's/^.*=\([^,]*\).*$/\1/ CAP_VOL=`$AMIXER −c 0 cget name='PCM Playback Volume' | grep : | sed 's/^.*=\([^,]*\).
E. Enabling The FM Radio for Radio−Equipped Cards FM radio tuners are easily enabled when inserting modules. Simply $ modprobe bttv radio=1 ...or add a similar option to your /etc/modules.conf and you should be set the next time you restart or load the module. You will also need an application to access the radio. I suggest the console based radio, available with the Xawtv suite, or fmtools. For graphical programs, try gnomeradio or gradio or xmms with the FMRadio plug−in.
F. Gnu Free Documentation License Version 1.2, November 2002 Copyright (C) 2000,2001,2002 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111−1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document but changing it is not allowed. 0.
The BTTV HOWTO The "Cover Texts" are certain short passages of text that are listed, as Front−Cover Texts or Back−Cover Texts, in the notice that says that the Document is released under this License. A Front−Cover Text may be at most five words, and a Back−Cover Text may be at most 25 words.
The BTTV HOWTO If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Document's license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front−Cover Texts on the front cover, and Back−Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies.
The BTTV HOWTO H. Include an unaltered copy of this License. I. Preserve the section Entitled "History", Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section Entitled "History" in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence. J.
The BTTV HOWTO The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number.
The BTTV HOWTO You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under this License. Any other attempt to copy, modify, sublicense, or distribute the Document is void and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 10.