source: archive/dvb-apps.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 17.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY dvb-apps-download-http
8 "http://anduin.linuxfromscratch.org/sources/BLFS/svn/d/dvb-apps-2012-06-10.tar.xz">
9 <!ENTITY dvb-apps-download-ftp " ">
10 <!ENTITY dvb-apps-md5sum "6102338db203f9808b433d513e648f8e">
11 <!ENTITY dvb-apps-size "368 MB">
12 <!ENTITY dvb-apps-buildsize "17 MB">
13 <!ENTITY dvb-apps-time "0.1 SBU">
14]>
15
16<sect1 id="dvb-apps" xreflabel="dvb-apps-&dvb-apps-version;">
17 <?dbhtml filename="dvb-apps.html"?>
18
19 <sect1info>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>DVB-Apps-&dvb-apps-version;</title>
24
25 <indexterm zone="dvb-apps">
26 <primary sortas="a-dvb-apps">dvb-apps</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to DVB-Apps</title>
31
32 <para>
33 The <application>DVB-Apps</application> package contains a collection of
34 command line utilities for controlling and using a digital television
35 card/chip installed (possibly through a USB port) on your computer. These
36 are useful for scanning to make an index of the available channels, tuning
37 the chip to a chosen station or recording the channel to a file on your
38 computer so you can watch it at a later date.
39 </para>
40
41 &lfs71_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&dvb-apps-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&dvb-apps-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &dvb-apps-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &dvb-apps-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &dvb-apps-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &dvb-apps-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <para condition="html" role="usernotes">
78 User Notes: <ulink url="&blfs-wiki;/dvb-apps"/>
79 </para>
80 </sect2>
81
82 <sect2 role="kernel" id="dvb-apps-kernel">
83 <title>Kernel Configuration</title>
84
85 <para>
86 There are many TV chips available so it is not possible to give guidance
87 on the kernel config for all of them. <command>lspci</command> from
88 <xref linkend="pciutils"/> and Goggle are your friends. One possible
89 gotcha is that some pci cards (such as the <ulink
90 url="http://www.amazon.co.uk/Hauppauge-WinTV-Nova-digital-tuner/dp/B000I1RHWA">
91 Hauppauge Nova T 500</ulink>) present themselves to the motherboard as a
92 USB controller and the TV chip on the card communicates with the
93 motherboard via this USB interface.
94 </para>
95
96<screen>General setup ---&gt;
97 [*] Prompt for development and/or incomplete code/drivers
98Device Drivers ---&gt;
99 Generic Driver Options ---&gt;
100 [*] Userspace firmware loading support
101 [*] Include in-kernel firmware blobs in kernel binary
102 (list of) External firmware blobs to build into the kernel binary
103 (/lib/firmware) Firmware blobs root directory
104 [*] I2C support ---&gt;
105 [*] I2C device interface
106 I2C Algorithms ---&gt;
107 [*] I2C bit-banging interfaces
108 [*] Multimedia support ---&gt;
109 [*] Video For Linux
110 [*] DVB for Linux
111 [*] DVB Network Support
112 [*] Video capture adapters ---&gt;
113 [*] V4L USB devices ---&gt;
114 (as required depending on your hardware)
115 [*] V4L PCI(e) devices ---&gt;
116 (as required depending on your hardware)
117 [*] DVB/ATSC adapters ---&gt;
118 (as required depending on your hardware)</screen>
119
120 <para>
121 Select the appropriate sub-options that appear when the above options are
122 selected and recompile your kernel.
123 </para>
124
125 <indexterm zone="dvb-apps dvb-apps-kernel">
126 <primary sortas="d-dvb-apps">dvb-apps</primary>
127 </indexterm>
128 </sect2>
129
130 <sect2 role="installation">
131 <title>Installation of DVB-Apps</title>
132
133 <para>
134 Install <application>DVB-Apps</application> by running the following
135 commands:
136 </para>
137
138<screen><userinput>sed -i 's/ $(lib_name).a//' Make.rules &amp;&amp;
139sed -i 's/\.a/.so/g' test/*/Makefile &amp;&amp;
140make</userinput></screen>
141
142 <para>
143 This package does not come with a test suite.
144 </para>
145
146 <para>
147 Now, as the <systemitem class="username">root</systemitem> user:
148 </para>
149
150<screen role="root"><userinput>make install</userinput></screen>
151 </sect2>
152
153 <sect2 role="commands">
154 <title>Command Explanations</title>
155
156 <para>
157 <command>sed -i 's/ $(lib_name).a//' Make.rules</command> and
158 <command>sed -i 's/\.a/.so/g' test/*/Makefile</command>: These seds
159 disable compiling the static libraries.
160 </para>
161 </sect2>
162
163 <sect2 role="configuration">
164 <title>Configuring DVB-Apps</title>
165
166 <sect3 id="dvb-apps-config">
167 <title>Config Files</title>
168 <para>
169 <filename>~/.tzap/channels.conf</filename> and
170 <filename>/etc/channels.conf</filename>.
171 </para>
172
173 <indexterm zone="dvb-apps dvb-apps-config">
174 <primary sortas="e-AA.tzap-channels.conf">~/.tzap/channels.conf</primary>
175 </indexterm>
176
177 <indexterm zone="dvb-apps dvb-apps-config">
178 <primary
179 sortas="e-etc-channels.conf">/etc/channels.conf</primary>
180 </indexterm>
181 </sect3>
182
183 <sect3><title>Configuration Information</title>
184
185 <para>
186 For a user to be able to use the device files in /dev the simplest
187 solution is to make the user part of the video group. As the
188 <systemitem class="username">root</systemitem> user:
189 </para>
190
191<screen role="root"><userinput>usermod -a -G video &lt;USERNAME&gt; </userinput></screen>
192
193 <para>
194 Create a channels.conf file listing the channels available from your
195 local transmitter. If it's a terrestrial transmitter there should be a
196 file with its details in /usr/share/dvb/dvb-t. If it's a satellite the
197 file should be in /usr/share/dvb/dvb-s.
198 </para>
199
200<screen><userinput>scan /usr/share/dvb/dvb-t/uk-WinterHill > channels.conf &amp;&amp;
201mkdir -p ~/.tzap &amp;&amp;
202cp channels.conf ~/.tzap</userinput></screen>
203
204 <para>
205 If that went Ok and you saw some familiar TV channels listed in your
206 terminal, as the <systemitem class="username">root</systemitem> user
207 copy it to a system wide location:
208 </para>
209
210<screen role="root"><userinput>cp channels.conf /etc/channels.conf</userinput></screen>
211 </sect3>
212 </sect2>
213
214 <sect2 role="using">
215 <title>Using DVB-Apps</title>
216
217 <para>
218 To record a channel to a file:
219 </para>
220
221<screen><userinput>gnutv -out file bbc1.mpeg "BBC ONE"</userinput></screen>
222
223 <para>
224 If you give it ten seconds or so to buffer you can then start to watch the
225 file with a video player such as <command>xine</command> or
226 <command>mplayer</command>. The advantage of watching TV via a file in
227 this way is that it allows you to pause playback and rewind if you want,
228 plus you can watch the file again later.
229 </para>
230 </sect2>
231
232 <sect2 role="content">
233 <title>Contents</title>
234
235 <segmentedlist>
236 <segtitle>Installed Programs</segtitle>
237 <segtitle>Installed Libraries</segtitle>
238 <segtitle>Installed Directories</segtitle>
239
240 <seglistitem>
241 <seg>
242 atsc_epg,
243 av7110_loadkeys,
244 azap,
245 czap,
246 dib3000-watch,
247 dst_test,
248 dvbdate,
249 dvbnet,
250 dvbscan,
251 dvbtraffic,
252 femon,
253 gnutv,
254 gotox,
255 lsdvb,
256 scan,
257 szap,
258 tzap and
259 zap,
260 </seg>
261 <seg>
262 libdvbapi.so,
263 libdvbcfg.so,
264 libdvben50221.so,
265 libdvbsec.so and
266 libesg.so,
267 libucsi.so
268 </seg>
269 <seg>
270 /usr/include/libdvbapi,
271 /usr/include/libdvbcfg,
272 /usr/include/libdvben50221,
273 /usr/include/libdvbsec,
274 /usr/include/libesg,
275 /usr/include/libucsi and
276 /usr/share/dvb
277 </seg>
278 </seglistitem>
279 </segmentedlist>
280
281 <variablelist>
282 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
283 <?dbfo list-presentation="list"?>
284 <?dbhtml list-presentation="table"?>
285
286 <varlistentry id="atsc_epg">
287 <term><command>atsc_epg</command></term>
288 <listitem>
289 <para>
290 prints out the next three hours worth of programs on a given
291 frequency (for ATSC only)
292 </para>
293 <indexterm zone="dvb-apps atsc_epg">
294 <primary sortas="b-atsc_epg">atsc_epg</primary>
295 </indexterm>
296 </listitem>
297 </varlistentry>
298
299 <varlistentry id="av7110_loadkeys">
300 <term><command>av7110_loadkeys</command></term>
301 <listitem>
302 <para>
303 is a utiltity to load IR remote keymaps into an av7110 based card
304 </para>
305 <indexterm zone="dvb-apps av7110_loadkeys">
306 <primary sortas="b-av7110_loadkeys">av7110_loadkeys</primary>
307 </indexterm>
308 </listitem>
309 </varlistentry>
310
311 <varlistentry id="azap">
312 <term><command>azap</command></term>
313 <listitem>
314 <para>
315 is a tuning utility for ATSC
316 </para>
317 <indexterm zone="dvb-apps azap">
318 <primary sortas="b-azap">azap</primary>
319 </indexterm>
320 </listitem>
321 </varlistentry>
322
323 <varlistentry id="czap">
324 <term><command>czap</command></term>
325 <listitem>
326 <para>
327 is a tuning utilities for DVB-C (cable)
328 </para>
329 <indexterm zone="dvb-apps czap">
330 <primary sortas="b-czap">czap</primary>
331 </indexterm>
332 </listitem>
333 </varlistentry>
334
335 <varlistentry id="dib3000-watch">
336 <term><command>dib3000-watch</command></term>
337 <listitem>
338 <para>
339 is a tool to monitor DIB3000 demodulators
340 </para>
341 <indexterm zone="dvb-apps dib3000-watch">
342 <primary sortas="b-dib3000-watch">dib3000-watch</primary>
343 </indexterm>
344 </listitem>
345 </varlistentry>
346
347 <varlistentry id="dst_test">
348 <term><command>dst_test</command></term>
349 <listitem>
350 <para>
351 is a utility for DST based cards
352 </para>
353 <indexterm zone="dvb-apps dst_test">
354 <primary sortas="b-dst_test">dst_test</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="dvbdate">
360 <term><command>dvbdate</command></term>
361 <listitem>
362 <para>
363 is a utility that can read date time information from the currently
364 tuned multiplex
365 </para>
366 <indexterm zone="dvb-apps dvbdate">
367 <primary sortas="b-dvbdate">dvbdate</primary>
368 </indexterm>
369 </listitem>
370 </varlistentry>
371
372 <varlistentry id="dvbnet">
373 <term><command>dvbnet</command></term>
374 <listitem>
375 <para>
376 is a utility to control digital data network interfaces, a DVB
377 network interface manager (IP over DVB) for streaming programs from
378 one computer to another over a network.
379 </para>
380 <indexterm zone="dvb-apps dvbnet">
381 <primary sortas="b-dvbnet">dvbnet</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 <varlistentry id="dvbscan">
387 <term><command>dvbscan</command></term>
388 <listitem>
389 <para>
390 is another frequency scanning tool used to generate channel lists
391 </para>
392 <indexterm zone="dvb-apps dvbscan">
393 <primary sortas="b-dvbscan">dvbscan</primary>
394 </indexterm>
395 </listitem>
396 </varlistentry>
397
398 <varlistentry id="dvbtraffic">
399 <term><command>dvbtraffic</command></term>
400 <listitem>
401 <para>
402 is a utility to monitor traffic on a digital device and perform PID
403 analysis of currently tuned multiplex
404 </para>
405 <indexterm zone="dvb-apps dvbtraffic">
406 <primary sortas="b-dvbtraffic">dvbtraffic</primary>
407 </indexterm>
408 </listitem>
409 </varlistentry>
410
411 <varlistentry id="femon">
412 <term><command>femon</command></term>
413 <listitem>
414 <para>
415 is a frontend monitor, it monitors the tuning status on a digital TV
416 device
417 </para>
418 <indexterm zone="dvb-apps femon">
419 <primary sortas="b-femon">femon</primary>
420 </indexterm>
421 </listitem>
422 </varlistentry>
423
424 <varlistentry id="gnutv">
425 <term><command>gnutv</command></term>
426 <listitem>
427 <para>
428 is a utility to tune and stream your TV
429 </para>
430 <indexterm zone="dvb-apps gnutv">
431 <primary sortas="b-gnutv">gnutv</primary>
432 </indexterm>
433 </listitem>
434 </varlistentry>
435
436 <varlistentry id="gotox">
437 <term><command>gotox</command></term>
438 <listitem>
439 <para>
440 is a utility for calculating the position of satellites
441 </para>
442 <indexterm zone="dvb-apps gotox">
443 <primary sortas="b-gotox">gotox</primary>
444 </indexterm>
445 </listitem>
446 </varlistentry>
447
448 <varlistentry id="lsdvb">
449 <term><command>lsdvb</command></term>
450 <listitem>
451 <para>
452 is a simple utility to list PCI/PCIe DVB devices
453 </para>
454 <indexterm zone="dvb-apps lsdvb">
455 <primary sortas="b-lsdvb">lsdvb</primary>
456 </indexterm>
457 </listitem>
458 </varlistentry>
459
460 <varlistentry id="scan">
461 <term><command>scan</command></term>
462 <listitem>
463 <para>
464 is a utility to generate channel lists
465 </para>
466 <indexterm zone="dvb-apps scan">
467 <primary sortas="b-scan">scan</primary>
468 </indexterm>
469 </listitem>
470 </varlistentry>
471
472 <varlistentry id="szap">
473 <term><command>szap</command></term>
474 <listitem>
475 <para>
476 is a tool to tune a satellite DVB receiver
477 </para>
478 <indexterm zone="dvb-apps szap">
479 <primary sortas="b-szap">szap</primary>
480 </indexterm>
481 </listitem>
482 </varlistentry>
483
484 <varlistentry id="tzap">
485 <term><command>tzap</command></term>
486 <listitem>
487 <para>
488 is a tool to tune a terrestrial DVB receiver
489 </para>
490 <indexterm zone="dvb-apps tzap">
491 <primary sortas="b-tzap">tzap</primary>
492 </indexterm>
493 </listitem>
494 </varlistentry>
495
496 <varlistentry id="zap">
497 <term><command>zap</command></term>
498 <listitem>
499 <para>
500 just tunes a digital device (and is really intended for developers)
501 </para>
502 <indexterm zone="dvb-apps zap">
503 <primary sortas="b-zap">zap</primary>
504 </indexterm>
505 </listitem>
506 </varlistentry>
507
508 <varlistentry id="libdvbapi">
509 <term><filename class="libraryfile">libdvbapi.so</filename></term>
510 <listitem>
511 <para>
512 is an interface library for digital TV devices
513 </para>
514 <indexterm zone="dvb-apps libdvbapi">
515 <primary sortas="c-libdvbapi">libdvbapi.so</primary>
516 </indexterm>
517 </listitem>
518 </varlistentry>
519
520 <varlistentry id="libdvbcfg">
521 <term><filename class="libraryfile">libdvbcfg.so</filename></term>
522 <listitem>
523 <para>
524 contains functions that parse/create digital TV channel
525 configuration files
526 </para>
527 <indexterm zone="dvb-apps libdvbcfg">
528 <primary sortas="c-libdvbcfg">libdvbcfg.so</primary>
529 </indexterm>
530 </listitem>
531 </varlistentry>
532
533 <varlistentry id="libdvben50221">
534 <term><filename class="libraryfile">libdvben50221.so</filename></term>
535 <listitem>
536 <para>
537 contains functions that implement the CENELEC (European Committee
538 for Electrotechnical Standardization) EN 50221 CAM stack
539 </para>
540 <indexterm zone="dvb-apps libdvben50221">
541 <primary sortas="c-libdvben50221">libdvben50221.so</primary>
542 </indexterm>
543 </listitem>
544 </varlistentry>
545
546 <varlistentry id="libdvbsec">
547 <term><filename class="libraryfile">libdvbsec.so</filename></term>
548 <listitem>
549 <para>
550 is a library for Satellite Equipment Control operations
551 </para>
552 <indexterm zone="dvb-apps libdvbsec">
553 <primary sortas="c-libdvbsec">libdvbsec.so</primary>
554 </indexterm>
555 </listitem>
556 </varlistentry>
557
558 <varlistentry id="libesg">
559 <term><filename class="libraryfile">libesg.so</filename></term>
560 <listitem>
561 <para>
562 contains functions for an Electronic Service Guide parser
563 </para>
564 <indexterm zone="dvb-apps libesg">
565 <primary sortas="c-libesg">libesg.so</primary>
566 </indexterm>
567 </listitem>
568 </varlistentry>
569
570 <varlistentry id="libucsi">
571 <term><filename class="libraryfile">libucsi.so</filename></term>
572 <listitem>
573 <para>
574 is a Fast MPEG2 Transport Stream SI table parsing library
575 </para>
576 <indexterm zone="dvb-apps libucsi">
577 <primary sortas="c-libucsi">libucsi.so</primary>
578 </indexterm>
579 </listitem>
580 </varlistentry>
581 </variablelist>
582 </sect2>
583</sect1>
Note: See TracBrowser for help on using the repository browser.