source: archive/dvb-apps.xml

trunk
Last change on this file was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 17 months ago

Remove sect1info tags

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