1dvbv5-scan(1)                    User Commands                   dvbv5-scan(1)
2
3
4

NAME

6       dvbv5-scan - DVBv5 tool for frequency scanning
7

SYNOPSIS

9       dvbv5-scan [OPTION]... initial-file
10

DESCRIPTION

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
16       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
20       A single physical channel (also called as transponder) may have several
21       virtual channels inside it, encapsulated via a MPEG Transport stream.
22
23       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
27       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
30       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

OPTIONS

35       The following options are valid:
36
37       -3, --dvbv3
38              Force dvbv5-scan to use DVBv3 only.
39
40       -a, --adapter=adapter#
41              Use the given adapter. Default value: 0.
42
43       -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
48       -d, --demux=demux#
49              Use the given demux. Default value: 0.
50
51       -f, --frontend=frontend#
52              Use the given frontend. Default value: 0.
53
54       -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
60       -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
69       -I, --input-format=format
70              Format of the input file. Please notice that caps is ignored. It
71              can be:
72
73              channel         - for dvb-apps compatible channel file;
74
75              zap             - for dvb-apps compatible zap file;
76
77              dvbv5 (default) - for the dvbv5 apps format.
78
79       -l, --lnbf=LNBf_type
80              Type of LNBf to use 'help' lists the available ones.
81
82       -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
93       -o, --output=file
94              output filename (default: dvb_channel.conf)
95
96       -O, --output-format=format
97              Output format:
98
99              channel         - for dvb-apps compatible channel file;
100
101              zap             - for dvb-apps compatible zap file;
102
103              vdr             - for vdr compatible zap file;
104
105              dvbv5 (default) - for the dvbv5 apps format.
106
107       -p, --parse-other-nit
108              Parse  the  other  NIT/SDT  tables that could be found mainly on
109              some DVB-C carriers.
110
111       -S, --sat_number=satellite_number
112              Satellite number.  Used only on satellite delivery systems.   If
113              not specified, disable DISEqC satellite switch.
114
115       -T, --timeout-multiply=factor
116              Multiply  the  scan  lock wait time and MPEG-TS table parsing by
117              this factor.
118
119       -U, --freq_bpf=frequency
120              SCR/Unicable band-pass filter frequency to use,  in  kHz.   Used
121              only on satellite delivery systems.
122
123       -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
128       -w, --lna=LNA
129              Enable, disable or put LNA power in auto mode. Not all frontends
130              support it.  Valid values are:
131
132               0 - disable
133
134               1 - enable
135
136              -1 - auto
137
138       -W, --wait=time
139              Adds additional wait time for DISEqC command completion.
140
141       -?, --help
142              Outputs the usage help.
143
144       --usage
145              Gives a short usage message.
146
147       -V, --version
148              Prints the program version.
149
150       Mandatory or optional arguments to long options are also  mandatory  or
151       optional for any corresponding short options.
152
153   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

EXIT STATUS

159       On success, it returns 0.
160

EXAMPLE

162       $ dvbv5-scan /usr/share/dvbv5/dvb-c/the-brownfox
163
164       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
176       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
182       [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

BUGS

194       Report bugs to Linux Media Mailing List <linux-media@vger.kernel.org>
195
197       Copyright (c) 2011-2014 by Mauro Carvalho Chehab.
198
199       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.
202
203
204
205DVBv5 Utils 1.22.1              Fri Oct 3 2014                   dvbv5-scan(1)
Impressum