1dvbv5-scan(1) User Commands dvbv5-scan(1)
2
6 dvbv5-scan - DVBv5 tool for frequency scanning
7
9 dvbv5-scan [OPTION]... initial-file
10
12 dvbv5-scan is a command line frequency scanning tool for digital TV
13 services that is compliant with version 5 of the DVB API, and backward
14 compatible with the older v3 DVB API.
15 dvbv5-scan uses by default the new channel/service file format that it
17 is capable of supporting all types of Digital TV standards. It can also
18 support the legacy format used by the legacy dvb-apps.
19 A single physical channel (also called as transponder) may have several
21 virtual channels inside it, encapsulated via a MPEG Transport stream.
22 Those virtual channels are called as 'service' at the MPEG-TS terminol‐
24 ogy, and may have one or more audio, video and other types of elements
25 inside it.
26 The dvbv5-scan goal is to scan for a list of physical chan‐
28 nels/transponders and identify there the MPEG-TS services available.
29 The dvbv5-scan tool is smart enough to retrieve the information at the
31 MPEG-TS Network Information Table (NIT) about other channels available
32 on the stream.
33
35 The following options are valid:
36 -3, --dvbv3
38 Force dvbv5-scan to use DVBv3 only.
39 -a, --adapter=adapter#
41 Use the given adapter. Default value: 0.
42 -C, --cc=country_code
44 Set the default country to be used by the MPEG-TS parsers, in
45 ISO 3166-1 two letter code. If not specified, the default
46 charset is guessed from the locale environment variables.
47 -d, --demux=demux#
49 Use the given demux. Default value: 0.
50 -f, --frontend=frontend#
52 Use the given frontend. Default value: 0.
53 -F, --file-freqs-only
55 Don't use the other frequencies discovered during scan. By de‐
56 fault, dvbv5-scan will find new transponder/physical channels
57 and add them at the internal frequency table it uses for scan.
58 This option disables such feature.
59 -G, --get_frontend
61 Use data from get_frontend on the output file. By default,
62 dvbv5-scan will repeat the same network parameters as found at
63 the scan file. This should work fine if the output file will be
64 used by the same frontend. However, if you intend to use the
65 generated file on another frontend, or wants a faster tuner,
66 this option can be used to store the actual detected parameters,
67 instead of the ones that came from the source channel file.
68 -I, --input-format=format
70 Format of the input file. Please notice that caps is ignored. It
71 can be:
72 channel - for dvb-apps compatible channel file;
74 zap - for dvb-apps compatible zap file;
76 dvbv5 (default) - for the dvbv5 apps format.
78 -l, --lnbf=LNBf_type
80 Type of LNBf to use 'help' lists the available ones.
81 -N, --nit
83 Use data from NIT table on the output file. By default,
84 dvbv5-scan will repeat the same network parameters as found at
85 the scan file. This should work fine if the output file will be
86 used by the same frontend. However, if you intend to use the
87 generated file on another frontend, or wants a faster tuner,
88 this option can be used to store the parameters that are an‐
89 nounced by the broadcaster via the MPEG-TS Network Information
90 Table (NIT), instead of the ones that came from the source chan‐
91 nel file.
92 -o, --output=file
94 output filename (default: dvb_channel.conf)
95 -O, --output-format=format
97 Output format:
98 channel - for dvb-apps compatible channel file;
100 zap - for dvb-apps compatible zap file;
102 vdr - for vdr compatible zap file;
104 dvbv5 (default) - for the dvbv5 apps format.
106 -p, --parse-other-nit
108 Parse the other NIT/SDT tables that could be found mainly on
109 some DVB-C carriers.
110 -S, --sat_number=satellite_number
112 Satellite number. Used only on satellite delivery systems. If
113 not specified, disable DISEqC satellite switch.
114 -T, --timeout-multiply=factor
116 Multiply the scan lock wait time and MPEG-TS table parsing by
117 this factor.
118 -U, --freq_bpf=frequency
120 SCR/Unicable band-pass filter frequency to use, in kHz. Used
121 only on satellite delivery systems.
122 -v, --verbose
124 Be (very) verbose. Useful to check if the MPEG-TS is happenning
125 fine. This option can be used multiple times to increase ver‐
126 bosity.
127 -w, --lna=LNA
129 Enable, disable or put LNA power in auto mode. Not all frontends
130 support it. Valid values are:
131 0 - disable
133 1 - enable
135 -1 - auto
137 -W, --wait=time
139 Adds additional wait time for DISEqC command completion.
140 -?, --help
142 Outputs the usage help.
143 --usage
145 Gives a short usage message.
146 -V, --version
148 Prints the program version.
149 Mandatory or optional arguments to long options are also mandatory or
151 optional for any corresponding short options.
152 NOTE
154 If both --nit and --get_frontend options are used at the same time, the
155 --nit parameters will be applied after the ones that the frontend de‐
156 tected.
157
159 On success, it returns 0.
160
162 $ dvbv5-scan /usr/share/dvbv5/dvb-c/the-brownfox
163 Scanning frequency #1 573000000
165 Lock (0x1f) Quality= Good Signal= 100.00% C/N= -13.80dB UCB= 0 postBER= 3.14x10^-3 PER= 0
166 Service The, provider (null): digital television
167 Service Quick, provider BrownFox: digital television
168 Service Brown, provider (null): digital television
169 Service Jumps, provider (null): digital television
170 …
171 Service Dog, provider (null): digital television
172 New transponder/channel found: #2: 579000000
173 …
174 New transponder/channel found: #39: 507000000
175 The scan process will then scan the other 38 discovered new transpon‐
177 ders, and generate a dvb_channel.conf with several entries with will
178 have not only the physical channel/transponder info, but also the Ser‐
179 vice ID, and the corresponding audio/video/other program IDs (PID),
180 like:
181 [Quick]
183 SERVICE_ID = 5
184 VIDEO_PID = 288
185 AUDIO_PID = 289
186 FREQUENCY = 573000000
187 MODULATION = QAM/256
188 INVERSION = OFF
189 SYMBOL_RATE = 5247500
190 INNER_FEC = NONE
191 DELIVERY_SYSTEM = DVBC/ANNEX_A
192
194 Report bugs to Linux Media Mailing List <linux-media@vger.kernel.org>
195
197 Copyright (c) 2011-2014 by Mauro Carvalho Chehab.
198 License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl.html>.
200 This is free software: you are free to change and redistribute it.
201 There is NO WARRANTY, to the extent permitted by law.
202DVBv5 Utils 1.22.1 Fri Oct 3 2014 dvbv5-scan(1)