From 27aeb069aa930c0c8fa0e0f41885bbedc69d0bcb Mon Sep 17 00:00:00 2001 From: Darren Salt Date: Tue, 14 Aug 2007 19:40:33 +0100 Subject: Update and reformat the DVB README. Remove the DVB driver installation instructions in favour of a pointer to the "getting started" section of the LinuxTV wiki. Add a pointer to the scan documentation (same site). Mention the requirement for membership of group "video". --- doc/README.dvb | 169 +++++++++++++++++++++++++++------------------------------ 1 file changed, 81 insertions(+), 88 deletions(-) (limited to 'doc') diff --git a/doc/README.dvb b/doc/README.dvb index c04013330..38ea6613d 100644 --- a/doc/README.dvb +++ b/doc/README.dvb @@ -4,52 +4,54 @@ xine Digital TV (DVB) xine can be used to watch digital television. -xine supports Digital TV (Digital Video Broadcasting - DVB) cards -using the Linux DVB driver from Convergence (http://www.linuxtv.org). -DVB-S (direct satellite reception), DVB-C (Cable) and DVB-T (Teresstrical) -cards should be supported (e.g. the Hauppauge WinTV Nova DVB-S card). +xine supports Digital TV (Digital Video Broadcasting - DVB) cards using the +Linux DVB drivers in your kernel or from http://www.linuxtv.org/. + +Many DVB-S (direct satellite reception), DVB-C (Cable) and DVB-T and ATSC +(Terrestrial) devices are supported via these drivers. -driver download and installation --------------------------------- -Download and install the drivers from http://www.linuxtv.org, the 1.0.0 or later release -should work fine. +Driver download and installation +-------------------------------- -You will need kernel sources configured for your configuration for -a successfull build, preferably in /usr/src/linux plus a link to them in -/lib/modules//build. Once you have that you should be ready -to compile the driver +You may need to download and install drivers for recent hardware. See the +"Getting Started" section at http://www.linuxtv.org/wiki/index.php/ . -# cd linuxtv-dvb-1.0.0/driver -# make +You will probably need to add yourself to group "video". With a DVB device +installed and recognised: -if that doesn't fail, do a + $ ls -l /deb/dvb/adapter0 + total 0 + crw-rw---- 1 root video 212, 4 2007-08-07 15:33 demux0 + crw-rw---- 1 root video 212, 5 2007-08-07 15:33 dvr0 + crw-rw---- 1 root video 212, 3 2007-08-07 15:33 frontend0 + crw-rw---- 1 root video 212, 7 2007-08-07 15:33 net0 -# make insmod +This shows that you need to be either root or in group "video" to be able to +use the DVB device. -UPDATE: the latest 2.6 kernels include the necessary drivers for most - cards, check on the linuxtv.org website for information about supported - cards, or read the documentation available in the linux kernel - sources (linux/Documentation/dvb/*). +You can find out if you're already in this group by using the "groups" +command in a terminal. If you aren't, then trying to use the DVB plugin will +cause a "no input plugin" error: this is somewhat misleading because the DVB +plugin was actually found but it failed because it couldn't open the device +nodes. -to load the generated modules into your running kernel. If everything went -fine, you should have something like +Adding yourself to group "video" is the best way; one of -DVB: registering new adapter (TT-Budget/WinTV-NOVA-S PCI). -PCI: Found IRQ 10 for device 00:0d.0 -PCI: Sharing IRQ 10 with 00:0c.0 -DVB: registering frontend 0:0 (stv0299 based (e.g. Alps BSRU6 or LG TDQB-S00x))... + # adduser fred video + $ sudo adduser fred video -in your dmesg. +will do the job for a user named "fred". Note that the change won't take +effect until after fred has logged out if he's currently logged in. -install a channel list +Install a channel list ---------------------- -xine's dvb input plugin needs a channel/transponder list that fits your -dvb equipment. xine now uses the channels.conf format of szap, czap and -tzap as appropriate for DVB-S, DVB-C and DVB-T. it will search the channel -list file in ~/.xine/channels.conf +xine-lib's dvb input plugin needs a channel/transponder list that fits your +dvb equipment. xine-lib uses the channels.conf format of szap, czap and tzap +as appropriate for DVB-S, DVB-C and DVB-T. It will search the channel list +file in ~/.xine/channels.conf. channel list format for DVB-S: (satellite) ------------------------------------------- @@ -64,80 +66,71 @@ WINSA :557500000:INVERSION_AUTO:BANDWIDTH_7_MHZ:FEC_2_3:FEC_AUTO:QAM_64: \ station name:frequency:config options go on seemingly forever ... :vpid:apid:serviceid ------------------------------------------- -you automatically scan for all available channels using the scan utility -which comes with the dvb package. compile it using something like - -# cd linuxtv-dvb-1.0.0/apps/scan -# make - -then start scanning +You scan for all available channels using the scan utility which comes with +the dvb-apps package (also known as dvb-utils). See +http://www.linuxtv.org/wiki/index.php/Scan for more information. -# scan >~/.xine/channels.conf + $ scan /usr/share/doc/dvb-utils/examples/scan/dvb-t/uk-PontopPike >~/.xine/channels.conf + $ scan Hotbird-13.0 >~/.xine/channels.conf -newer versions of scan (after July 2004) are called dvbscan, but you can use it much the same way: +This can take a while. In a DiSEqC environment, use the -s N switch to +select different satellites to scan and paste the results in one big +channels.conf file. As always, please be sure to read the man page for the +version of the tool you are using. -# dvbscan Hotbird-13.0 >~/.xine/channels.conf +HINT: you might want to manually sort the channels.conf file to have your +favourite channels at the top and maybe remove any scrambled channels to +which you don't have access. -this can take a while. in a DiSEqC environment, use the -s N switch to select -different sattelites to scan and paste the results in one big channels.conf file. As always, -please be sure to read the man page for the version of the tool you are using. -HINT 1: you might want to manually sort the channels.conf file to have your favourite - channels at the top and maybe remove scrambled channels which you don't have access to. - - - ************************ If the dvb plugin doesn't seem to work for you ****************** -* if xine doesn't seem to work for you, double check to make sure that the channels.conf * -* file is _NOT_ in vdr format, which looks something like this: * -* WINSA:557500:I999B7C23D0M64T8G8Y0:T:27500:33:36:47:0:1:0:0:0 * - ****************************************************************************************** - -using xine to watch digital television +Using xine to watch digital television -------------------------------------- -make sure you have a recent libxine and frontend installed (latest CVS as of -this writing). then simply start something like +Make sure you have a recent libxine and front end installed, then simply +start something like -$ gxine dvb:// + $ gxine dvb:// -or click on the DVB button in xine-ui. you should be able to zap around using -the NumPad-9 / NumPad-3 keys, the xine playlist, or using the next/previous chapter -buttons in your gui. +or, perhaps, click on the DVB button in xine-ui. You should be able to zap +around using the NumPad-9 / NumPad-3 keys, the xine playlist, or using the +next/previous chapter buttons in your gui. -An OSD menu is available too. Press NumPad-8 / NumPad-2 to scroll -through the channels, then press NumPad-Enter to switch to the channel -you have selected. As of 06-12-2004, the channel list can be brought up and scrolled -through via the wheel on many mouses. Use the left mouse button to switch to -the channel you've selected. The side buttons (6 & 7) can be used to rapidly switch -to previous/next channels, if they are available on your mouse. +An OSD menu is available too. Press NumPad-8 / NumPad-2 to scroll through +the channels, then press NumPad-Enter to switch to the channel you have +selected. The channel list can be brought up and scrolled through via the +mouse wheel. Use the left mouse button to switch to the channel you've +selected. The side buttons (6 & 7) can be used to rapidly switch to +previous/next channels, if they are available on your mouse. -You can use MENU3 (F2 in xine-ui, F3 in gxine) to zoom into the centre of a videostream. -This will allow you to view 4:3 content that has been embedded into a -16:9 stream in fullscreen (no more black borders). Press the key again -to return to normal viewing. There is also an option in the xine +You can use MENU3 (F2 in xine-ui, F3 in gxine) to zoom into the centre of a +videostream. This will allow you to view 4:3 content that has been embedded +into a 16:9 stream in fullscreen (no more black borders). Press the key +again to return to normal viewing. There is also an option in the xine preferences to zoom automatically when using xine to view DVB. -MENU7 (F6 in xine-ui or F7 in gxine) will toggle viewing of the current channels' -Electronic Program Guide (information on the current/next program) on the OSD, if available. +MENU7 (F6 in xine-ui or F7 in gxine) will toggle viewing of the current +channel's Electronic Program Guide (information on the current/next program) +on the OSD, if available. -HINT: if audio or video is stuttering, pause (space key) shortly -to give xine a chance to fill up it's buffers. If watching a large HDTV stream, you -may need to increase the xine video & audio buffer size - increasing audio buffers to -300 and video buffers to 700 has been known to work with streams up to 1920x1088 in size. +HINT: if audio or video is stuttering, pause (space key) shortly to give +xine-lib a chance to fill its buffers. If watching a large HDTV stream, you +may need to increase the xine video & audio buffer size - increasing audio +buffers to 300 and video buffers to 700 has been known to work with streams +up to 1920x1088 in size. -recording digital television +Recording digital television ---------------------------- -there is a very simple vcr-like feature built into the xine engine. just press -MENU2 (that is F2 in gxine, or F1 in xine-ui for example) to start/stop recording -the currently displayed program to your local disc. a small osd in the upper -left corner of your screen will tell you the file name the recorded stream is -written to. You can select the directory to save to in the xine configuration under -the MISC tab, otherwise the plugin will record to your home directory. You can -pause the recording at any time by pressing MENU4 (F3 in xine-ui, F4 in gxine). -An OSD in the top left hand corner will notify you of the status of the recording. +There is a very simple VCR-like feature built into the xine engine. just +press MENU2 (that is F2 in gxine, or F1 in xine-ui for example) to +start/stop recording the currently displayed program to your local disc. A +small OSD message in the upper left corner of your screen will tell you the +file name the recorded stream is being written to. You can select the +directory to save to in the xine configuration under the MISC tab, otherwise +the plugin will record to your home directory. You can pause the recording +at any time by pressing MENU4 (F3 in xine-ui, F4 in gxine). An OSD in the +top left hand corner will notify you of the status of the recording. Pressing MENU4 again will resume recording. Have fun. - -- cgit v1.2.3