1dvbv5-zap(1) User Commands dvbv5-zap(1)
2
6 dvbv5-zap - DVBv5 tool for service tuning
7
9 dvbv5-zap [OPTION]... channel-name
10 dvbv5-zap [OPTION]... frequency-name (for monitor or all PIDs mode)
12
14 dvbv5-zap is a command line tuning tool for digital TV services that is
15 compliant with version 5 of the DVB API, and backward compatible with
16 the older v3 DVB API.
17 dvbv5-zap uses by default a new channel/service file format that it is
19 capable of supporting all types of Digital TV standards. It can also
20 support the legacy format used by the legacy dvb-apps.
21 The dvbv5-zap tool can be used on several different modes, depending on
23 the parameters used.
24 Please note that, in order to be able to use it in record mode, where
26 both the audio and video Packet IDs (PIDs) are output to a dvr record
27 node, the input file should contain the PIDs, e. g. they should have
28 been produced by a digital TV zap application like dvbv5-zap.
29
31 -c, --channels= channel-name-file
32 Read channels list from 'file'. Defaults to ~/.tzap/chan‐
33 nels.conf.
34 -3, --dvbv3
36 Force dvbv5-zap to use DVBv3 only. Useful to test if the legacy
37 API support is working.
38 -a, --adapter=adapter#
40 Use the given adapter. Default value: 0.
41 -A, --audio_pid=audio_pid#
43 Select a different audio Packet ID (PID). The default is to use
44 the first audio PID found at the channel-name-file.
45 -C, --cc=country_code
47 Set the default country to be used by the MPEG-TS parsers, in
48 ISO 3166-1 two letter code. If not specified, the default
49 charset is guessed from the locale environment variables.
50 -d, --demux=demux#
52 Use the given demux. Default value: 0.
53 -f, --frontend=frontend#
55 Use the given frontend. Default value: 0.
56 -I, --input-format=format
58 Format of the input file. Please notice that caps is ignored. It
59 can be:
60 channel - for dvb-apps compatible channel file;
62 zap - for dvb-apps compatible zap file;
64 dvbv5 (default) - for the dvbv5 apps format.
66 -l, --lnbf=LNBf_type
68 Type of LNBf to use 'help' lists the available ones.
69 -L, --search=string
71 Search/look for a string inside the traffic. Used only on moni‐
72 tor mode.
73 -m, --monitor
75 Enable monitor mode. On this mode, it will monitor de DVB traf‐
76 fic for all Packet IDs (PIDs) received by the device, showing
77 the Packet IDs (optionally filtered by a string), and presenting
78 some traffic statistics: number of packets per second, number of
79 Kbytes per second and total traffic. Those statistics are shown
80 per PID and the total per MPEG-TS.
81 -o, --output=file
83 Output filename. If specified, it will output the content of the
84 MPEG-TS into the file with the first video PID and the first au‐
85 dio PID (or the one specified by audio_pid#). Use -o - for di‐
86 recting the output to stdout.
87 -p, --pat
89 Add PAT and PMT MPEG-TS tables to TS recording (implies -r).
90 -P, --all-pids
92 Don't filter any pids. Instead, outputs all of them.
93 -r, --record
95 Sets up the /dev/dvb/adapteradapter#/dvr0 for MPEG-TS record.
96 -s, --silence
98 Increases silence (can be used more than once).
99 -S, --sat_number=satellite_number
101 Satellite number. Used only on satellite delivery systems. If
102 not specified, disable DISEqC satellite switch.
103 -t, --timeout=seconds
105 Amount of seconds to keep the tool running for zapping and for
106 recording. Useful if you want to record a program that you know
107 its duration.
108 -U, --freq_bpf=frequency
110 SCR/Unicable band-pass filter frequency to use, in kHz. Used
111 only on satellite delivery systems.
112 -v, --verbose
114 Be verbose. Useful to check if the MPEG-TS is happenning fine.
115 This option can be used multiple times to increase verbosity.
116 -V, --video_pid=video_pid#
118 video pid program to use (default 0)
119 -w, --lna=LNA
121 Enable, disable or put LNA power in auto mode. Not all frontends
122 support it. Valid values are:
123 0 - disable
125 1 - enable
127 -1 - auto
129 -W, --wait=time
131 Adds additional wait time for DISEqC command completion.
132 -x, --exit
134 Exit after tuning.
135 -X, --low_traffic
137 Also shows DVB traffic with less than 1 packet per second. Used
138 only in monitor mode.
139 -?, --help
141 Outputs the usage help.
142 --usage
144 Gives a short usage message.
145 --version
147 Prints program version.
148
150 On success, it returns 0.
151
153 Recording a channel
154 The typical use is to tune into a channel and put it into record mode:
155 $ dvbv5-zap -c dvb_channel.conf 'music' -r
157 using demux '/dev/dvb/adapter0/demux0'
158 reading channels from file 'dvb_channel.conf'
159 service has pid type 05: 204
160 tuning to 573000000 Hz
161 audio pid 104
162 dvb_set_pesfilter 104
163 Lock (0x1f) Quality= Good Signal= 100.00% C/N= -13.80dB UCB= 70 postBER= 3.14x10^-3 PER= 0
164 DVR interface '/dev/dvb/adapter0/dvr0' can now be opened
165 The channel can be watched by playing the contents of the DVR inter‐
167 face, with some player that recognizes the MPEG-TS format.
168 For example, this audio-only channel can be played with mplayer:
170 $ mplayer -cache 800 /dev/dvb/adapter0/dvr0
172 MPlayer SVN-r37077-4.8.2 (C) 2000-2014 MPlayer Team
173 TS file format detected.
174 NO VIDEO! AUDIO MPA(pid=104) NO SUBS (yet)! PROGRAM N. 0
175 ==================================================================
176 Opening audio decoder: [mpg123] MPEG 1.0/2.0/2.5 layers I, II, III
177 AUDIO: 48000 Hz, 2 ch, s16le, 192.0 kbit/12.50% (ratio: 24000->192000)
178 Selected audio codec: [mpg123] afm: mpg123 (MPEG 1.0/2.0/2.5 layers I, II, III)
179 ==================================================================
180 AO: [alsa] 48000Hz 2ch s16le (2 bytes per sample)
181 Video: no video
182 Starting playback...
183 Monitoring a channel
185 The dvbv5-zap tool can also be used to monitor a DVB channel:
186 $ dvbv5-zap -c dvb_channel.conf 573000000 -m
188 using demux '/dev/dvb/adapter0/demux0'
189 reading channels from file 'dvb_channel.conf'
190 service has pid type 05: 204
191 tuning to 573000000 Hz
192 Lock (0x1f) Quality= Good Signal= 100.00% C/N= -13.90dB UCB= 384 postBER= 96.8x10^-6 PER= 0
193 dvb_set_pesfilter to 0x2000
194 PID FREQ SPEED TOTAL
196 0000 9.88 p/s 14.5 Kbps 1 KB
197 0001 1.98 p/s 2.9 Kbps 376 B
198 0010 18.77 p/s 27.6 Kbps 3 KB
199 0011 48.42 p/s 71.1 Kbps 8 KB
200 0012 1455.53 p/s 2137.8 Kbps 270 KB
201 …
202 1fff 1033.60 p/s 1518.1 Kbps 192 KB
203 TOT 25296.44 p/s 37154.2 Kbps 4700 KB
204 Lock (0x1f) Quality= Good Signal= 100.00% C/N= -13.90dB UCB= 384 postBER= 96.8x10^-6 PER= 0
206
208 Report bugs to Linux Media Mailing List <linux-media@vger.kernel.org>
209
211 Copyright (c) 2011-2014 by Mauro Carvalho Chehab.
212 License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl.html>.
214 This is free software: you are free to change and redistribute it.
215 There is NO WARRANTY, to the extent permitted by law.
216DVBv5 Utils 1.22.1 Fri Oct 3 2014 dvbv5-zap(1)