/[gentoo]/xml/htdocs/doc/en/vdr-guide.xml
Gentoo

Contents of /xml/htdocs/doc/en/vdr-guide.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.2 - (hide annotations) (download) (as text)
Fri Sep 29 10:40:25 2006 UTC (7 years, 9 months ago) by nightmorph
Branch: MAIN
Changes since 1.1: +4 -4 lines
File MIME type: application/xml
fixed VDR guide link for bug 149497

1 nightmorph 1.1 <?xml version="1.0" encoding="UTF-8"?>
2 nightmorph 1.2 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/vdr-guide.xml,v 1.1 2006/09/02 10:04:16 nightmorph Exp $ -->
3 nightmorph 1.1 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4    
5 nightmorph 1.2 <guide link="/doc/en/vdr-guide.xml">
6 nightmorph 1.1 <title>Gentoo Linux VDR Guide</title>
7    
8     <author title="Author">
9     <mail link="mail@ng-plasmon.de">Norman Golisz</mail>
10     </author>
11     <author title="Editor">
12     <mail link="diox@swords.be">Dimitry Bradt</mail>
13     </author>
14     <author title="Editor">
15     <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
16     </author>
17    
18     <abstract>
19     This guide shows you how to prepare Gentoo Linux for DVB and VDR.
20     </abstract>
21    
22     <!-- The content of this document is licensed under the CC-BY-SA license -->
23     <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
24     <license/>
25    
26 nightmorph 1.2 <version>1.1</version>
27     <date>2006-09-29</date>
28 nightmorph 1.1
29     <chapter>
30     <title>General information to DVB</title>
31     <section>
32     <title>What is DVB?</title>
33     <body>
34    
35     <p>
36     <e>DVB</e> stands for <e>Digital Video Broadcasting</e>. DVB describes methods
37     to transfer digital data of TV, radio, interactive services like MHP, EPG and
38     teletext. Through data compression with MPEG-2, or H.264 for HDTV, it's
39     possible to transfer several channels on the same frequency. The more data
40     compression, the more channels can be transferred, but you pay it with quality
41     loss.
42     </p>
43    
44     <p>
45     DVB can be transferred in several ways. The trailing letter identifies the
46     method of transfer, e.g. DVB-<e>T</e> for terrestrial transmission. There are
47     several more types:
48     </p>
49    
50     <ul>
51     <li>DVB-S for transmission over satellites</li>
52     <li>DVB-C for transmission over cable</li>
53     <li>DVB-H for transmission to mobile devices (terrestrial)</li>
54     <li>DVB-IPI for transmission over IP based networks, e.g. internet</li>
55     <li>
56     DVB-RC(S/C/T) return channel for the transmission of data services, e.g.
57     broadband internet
58     </li>
59     </ul>
60    
61     </body>
62     </section>
63    
64     <section>
65     <title>Types and requirement of DVB cards</title>
66     <body>
67    
68     <p>
69     Besides the different methods available to receive a DVB stream, the cards are
70     classified by their type of produced output. There are cards with a decoder
71     implemented which offer direct access to the stream by the device
72     <path>/dev/video</path>. These cards are <e>full featured cards</e>. Other
73     cards have no own decoder implemented and require a software decoder on the
74     computer and are <e>budget cards</e>. This implies higher system requirements.
75     Your computer's CPU should run at at least 600 MHz, and have at least 256MB of
76     RAM. <uri link="http://linuxtv.org/wiki/index.php/DVB_Card_Vendors">This
77     list</uri> is useful for identifying your card.
78     </p>
79    
80     </body>
81     </section>
82     </chapter>
83    
84     <chapter>
85     <title>Preparing the system</title>
86     <section>
87     <title>Configuring the kernel</title>
88     <body>
89    
90     <p>
91     First, we must ensure that your kernel supports DVB and your DVB device. Since
92     kernel version 2.6 the necessary drivers are included. Check your kernel
93     configuration and make sure the following options are selected as a static
94     driver or as modules.
95     </p>
96    
97     <pre caption="Required kernel options">
98     Input Device Support ---&gt;
99     * Event Interface
100     Device Drivers ---&gt;
101     Multimedia Devices ---&gt;
102     Digital Video Broadcasting Devices ---&gt;
103     [*] DVB For Linux
104     * DVB Core Support
105     M [Your driver]
106     </pre>
107    
108     <p>
109     Additionally we have to select the proper driver for your hardware. To find out
110     the right module for your card, we mark every driver as module. If you have a
111     PCI card, install <c>pciutils</c> if you haven't already. If you want built-in
112     drivers or you don't own a PCI card, skip this step and continue with <uri
113     link="#kernel_output">Checking the kernel output</uri>.
114     </p>
115    
116     <pre caption="Installing pciutils">
117     # <i>emerge pciutils</i>
118     </pre>
119    
120     <p>
121     After booting the new kernel, we run <c>pcimodules</c> to list the required
122     modules.
123     </p>
124    
125     <pre caption="Listing the required modules">
126     # <i>pcimodules</i>
127     ohci-hcd
128     ehci-hcd
129     sis900
130     snd-emu10k1
131     b2c2-flexcop-pci
132     nvidia
133     nvidiafb
134     </pre>
135    
136     <p>
137     In this case we have to load the module <c>b2c2-flexcop-pci</c>. We add the
138     name to <path>/etc/modules.autoload.d/kernel-2.6</path>.
139     </p>
140    
141     <pre caption="Adding the module name">
142     # <i>echo b2c2-flexcop-pci &gt;&gt; /etc/modules.autoload.d/kernel-2.6</i>
143     </pre>
144    
145     </body>
146     </section>
147    
148     <section id="kernel_output">
149     <title>Checking the kernel output</title>
150     <body>
151    
152     <p>
153     It's recommended to mark every driver as module, so you are able to add the
154     required module dynamically, especially if you don't know the module name. If
155     you know the module name already, select the driver as built-in driver. Compile
156     the kernel, install the modules and boot it. Check to see if your kernel has
157     successfully detected your card by using <c>dmesg</c>.
158     </p>
159    
160     <pre caption="Checking kernel output">
161     # <i>dmesg | grep DVB</i>
162     <comment>(If you own a TerraTec Cinergy T2, your output might look like this:)</comment>
163     DVB: registering new adaptor (TerraTec/qanu USB2.0 Highspeed DVB-T Receiver).
164     input: TerraTec/qanu USB2.0 Highspeed DVB-T Receiver remote control as /class/input/input2
165     </pre>
166    
167     <p>
168     Now continue with <uri link="#inst_lirc">installing LIRC</uri> if you want to
169     use a remote control.
170     </p>
171    
172     </body>
173     </section>
174     </chapter>
175    
176     <chapter id="inst_lirc">
177     <title>Configuring the remote control - LIRC</title>
178     <section>
179     <title>Installing LIRC</title>
180     <body>
181    
182     <p>
183     If your card can be remotely controlled, you may wish to configure LIRC. LIRC
184     interprets the pressed keys and returns a name for each one. A program that
185     supports LIRC waits for key events and runs the action configured in the config
186     file, mostly stored in the config directory of the executing program (e.g.
187     <c>mplayer</c> loads the file <path>~/.mplayer/lircrc</path>). Before we
188     install LIRC, you have to add <c>lirc</c> to your USE flags and add an
189     additional entry to <path>/etc/make.conf</path>: <c>LIRC_DEVICES</c>. Use <uri
190     link="http://www.lirc.org/html/table.html">this list</uri> to find the proper
191     arguments for the option.
192     </p>
193    
194     <pre caption="Installing LIRC">
195     # <i>nano -w /etc/make.conf</i>
196     <comment>(Replace "devinput" with the proper driver)</comment>
197     LIRC_DEVICES="devinput"
198     USE="lirc"
199     # <i>emerge lirc</i>
200     </pre>
201    
202     <p>
203     At first we have to define each key code with a name. Most supported remote
204     controls are configured already, take a look at the <uri
205     link="http://lirc.sourceforge.net/remotes/">remote list</uri>. Download the
206     required file and save it as <path>/etc/lircd.conf</path>. Now we have to find
207     out where to access your remote control. Run the following command to get a
208     list of the current input devices (make sure your device is running).
209     </p>
210    
211     <pre caption="List of current input devices">
212     # <i>cat /proc/bus/input/devices</i>
213     I: Bus=0000 Vendor=0000 Product=0000 Version=0000
214     N: Name="TerraTec/qanu USB2.0 Highspeed DVB-T Receiver remote control"
215     P: Phys=usb-0000:00:1d.7-1/input0
216     S: Sysfs=/class/input/input2
217     H: Handlers=kbd event1
218     B: EV=100003
219     B: KEY=108fc210 2043 0 0 0 0 8000 2080 1 9e1680 0 0 ffc
220     </pre>
221    
222     <p>
223     In this case we have the Terratec Cinergy T2 device plugged in, so we can
224     access the device over <path>/dev/input/event1</path>. Replace <c>event1</c>
225     with the matching device in your output.
226     </p>
227    
228     <p>
229     <c>lircd</c> needs to know the device to use. Add the following line to
230     <path>/etc/conf.d/lirc.conf</path>. Remember to replace <c>devinput</c> with
231     the name of your driver and <c>event1</c> with the actual device.
232     </p>
233    
234     <pre caption="Adding options to lircd">
235     LIRCD_OPTS="-H devinput -d /dev/input/event1"
236     </pre>
237    
238     <p>
239     It's time to start <c>lircd</c>:
240     </p>
241    
242     <pre caption="Starting lircd">
243     # <i>/etc/init.d/lircd start</i>
244     </pre>
245    
246     <p>
247     Next, add it to the default runlevel so that it starts automatically at boot.
248     </p>
249    
250     <pre caption="Adding lircd to the default runlevel">
251     # <i>rc-update add lircd default</i>
252     </pre>
253    
254     </body>
255     </section>
256     </chapter>
257    
258     <chapter>
259     <title>Setting up VDR</title>
260     <section>
261     <title>Installing VDR</title>
262     <body>
263    
264     <p>
265     To install VDR, we just emerge it.
266     </p>
267    
268     <pre caption="Installing VDR">
269     # <i>emerge vdr</i>
270     </pre>
271    
272     <p>
273     If you want to be able to use your remote control, we have to enable LIRC
274     support in VDR. Add the following line to the <path>/etc/conf.d/vdr</path>:
275     </p>
276    
277     <pre caption="Enabling support for LIRC">
278     # <i>nano -w /etc/conf.d/vdr</i>
279     IR_CTRL="lirc"
280     </pre>
281    
282     <p>
283     Next, start VDR and add it to the default runlevel:
284     </p>
285    
286     <pre caption="Adding vdr to the default runlevel">
287     # <i>/etc/init.d/vdr start</i>
288     # <i>rc-update add vdr default</i>
289     </pre>
290    
291     <p>
292     Now that the basic installation is over, you need to configure VDR. Switch to
293     your output screen and follow the on-screen instructions. VDR asks you to press
294     various keys on your remote control to learn the correct key codes. In case you
295     don't own a remote control unit, you can use your keyboard. If you only have a
296     budget card, you need to install a software output plugin, or <e>softdevice
297     plugin</e>. This decodes the stream and offers a device to access.
298     </p>
299    
300     </body>
301     </section>
302    
303     <section id="softdevice">
304     <title>Optional: Installing a softdevice plugin</title>
305     <body>
306    
307     <p>
308     To install a softdevice, we have to emerge <c>vdr-softdevice</c>. Don't forget
309     to configure the plugin.
310     </p>
311    
312     <pre caption="Installing the softdevice plugin">
313     # <i>emerge vdr-softdevice</i>
314     # <i>emerge --config vdr-softdevice</i>
315     </pre>
316    
317     <p>
318     To select the proper video and audio output, edit
319     <path>/etc/conf.d/vdr.softdevice</path>.
320     </p>
321    
322    
323     <note>
324     Another softdevice available in Portage is <c>vdr-xineliboutput</c>.
325     </note>
326    
327     <p>
328     That's it, you're done! Have fun with your new video streaming capabilities.
329     </p>
330    
331     </body>
332     </section>
333     </chapter>
334     </guide>

  ViewVC Help
Powered by ViewVC 1.1.20