W scan: Difference between revisions

From LinuxTVWiki
Jump to navigation Jump to search
(obsolescence notice && hint to successor. Also update link to last version.)
(redirect to w_scan_cpp. Who still really want it, should know about newer and maintained version.)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{lowercase|w_scan}}
{{lowercase|w_scan}}


''w_scan'' is a small command line utility used to perform [[Frequency scan|frequency scan]]s for [[DVB]] and [[ATSC]] transmissions. It is not included in [[LinuxTV dvb-apps]], but complements the two [[Frequency scan|frequency scanning]] utilities available through [[LinuxTV dvb-apps]], [[Dvbscan|dvbscan]] and [[Scan|scan]]. It is meanwhile replaced by the newer tool ''w_scan_cpp'' with similar syntax.
''w_scan'' is a small command line utility used to perform [[Frequency scan|frequency scan]]s for [[DVB]] and [[ATSC]] transmissions. It is not included in [[LinuxTV dvb-apps]], but complements the two [[Frequency scan|frequency scanning]] utilities available through [[LinuxTV dvb-apps]], [[Dvbscan|dvbscan]] and [[Scan|scan]]. It is meanwhile replaced by the newer tool [[w_scan_cpp]] with similar syntax.


''w_scan'' is capable of directly creating channels.conf files as well as initial tuning data for [[Scan|scan]].
''w_scan'' is capable of directly creating channels.conf files as well as initial tuning data for [[Scan|scan]].
Line 12: Line 12:
<pre>w_scan [options...] >> channels.conf</pre>
<pre>w_scan [options...] >> channels.conf</pre>


In general, when using ''w_scan'' you should at least specify three parameters: frontend type, country/satellite and output format. The following table summarizes the basic command line essentials for using ''w_scan''.
In general, when using ''w_scan'' you should at least specify three parameters: frontend type, country/satellite and output format.


''As w_scan was superceeded quite a long time ago, pls refer to the [[w_scan_cpp]] page for it's similar syntax.''
{| class="wikitable"
|+'''Basic w_scan commandline parameters and their respective options'''
|-
! Parameter !! Argument !! Description & Options

|-
| '''Frontend Type'''
| -f''Type''
|
a = ATSC (North America, cable and terrestrial)<br>
c = DVB-C (Europe, cable)<br>
s = DVB-S/S2 (Satellite)<br>
t = DVB-T/T2 (Europe, terrestrial = default)<br>

NOTE:
* ATSC support requires a w_scan version >= 20080815
* Satellite support requires a w_scan version >= 20090504)

|-
| '''ATSC Type'''
| -A''Type''
|
(ignored for DVB-C and DVB-T)<br>
1 = VSB ("Over-the-Air)"<br>
2 = QAM annex B ("cable TV")<br>
3 = both of them

|-
|'''Country ID'''
| -c''ID''
|
(mandatory for ATSC, DVB-C, DVB-T/T2)<br>
uppercase two character identifier as defined in ISO 3166-1,<br>
(DE,FR,GB,US,FI,...)<br>
see -c? for list of countries.

|-
| '''Satellite ID'''
| -s''ID''
|
(mandatory for DVB-S/S2)<br>
uppercase character constant with E (east) or W (west) as separator,<br>
(S19E2,S13E0,S0W8,...)<br>
see -s? for list of satellites.

|-
| '''Output Format'''
| -''Format''
|
X = czap/tzap/xine channels.conf<br>
x = "initial tuning data" for [[Scan]]<br>
G = Gstreamer dvbsrc Plugin<br>
L = VLC xspf playlist (experimental)<br>
M = mplayer format, similar to X<br>
If the output format is not specified, w_scan defaults to create [http://www.tvdr.de/ VDR-2.x channels.conf].
|-
| '''VDR version'''
| -o''N''
|
2 = vdr-2.x<br>
21 = vdr-2.1 (dev)
|-
| '''Help Level'''
| -''Level''
|
h = basic help <br>
H = extended help for expert functionality

|}

Some working examples, cobbled together from the basics given in the above table, are provided below. Note: ''Experts'' or ''experienced users'' may use some of the other ''w_scan'' options available, but this is not recommended. (For example, w_scan searches ''/dev/dvb/adapterX/frontendY'' for DVB/ATSC cards matching to option "-f", therefore specifying the adapter "-a XX" is not recommended.)

==Examples==
{{Note|As mentioned in the above table:
* ATSC support requires a w_scan version <nowiki> >= </nowiki> 20080815
* ATSC support was integrated in vdr-1.7.14, VDR output needs '-o 7'
* DVB-S/S2 support requires a w_scan version <nowiki> >= </nowiki> 20090504
* DVB-T2 support requires a w_scan version <nowiki> >= </nowiki> 20120111 (choose 20140727 or newer.) }}

===Scanning ATSC VSB (United States, Over-the-Air)===
$ w_scan -fa -A1 -c US -X
===Scanning ATSC QAM annex B (United States, digital cable TV)===
$ w_scan -fa -A2 -c US -X
===Scanning DVB-T/T2 (Germany, Over-the-Air, VDR output)===
$ w_scan -ft -c DE
===Scanning DVB-S/S2 (Astra 19.2east, vdr-1.7.x)===
$ w_scan -fs -s S19E2 -o 7
===Scanning DVB-S (Thor 0.8west, vdr-2.x)===
$ w_scan -fs -s S0W8
===Scanning DVB-S (Hotbird, vdr-2.x, 4-port DiSeqC switch, hotbird at port 3)===
$ w_scan -fs -s S13E0 -D2c
Note: ports are counting from '0'.

===Scanning DVB-S/S2 (Astra 19.2east, vdr-2.x, SCR/EN50494 @ CH0/1076MHz/Satpos A)===

$ w_scan -fs -s S19E2 -u 0:1400:A
Note: Channel ID (0..7) needs to fit userband frequency. w_scan >=20140102.

===Generating dvbscan tuning data===
Exactly as above, just specify output format dvbscan with "-x":
$ w_scan -f <FRONTEND_TYPE> {-c <COUNTRY>,-s <SATELLITE>} -x >''cc-Ttttt''

If you choose to create an initial scan file (and you know the name of your local transmitter or cable provider), you can send the resulting file to the [http://linuxtv.org/cgi-bin/mailman/listinfo/linux-dvb dvb mailing list] after checking that it hasn't already been posted or added to the [http://linuxtv.org/hg/dvb-apps/file/tip/util/scan/ scan directory in the dvb-apps repository].

===Generating c/s/tzap tuning data===
Exactly as above, just specify output format zap/czap/xine with "-X" (uppercase X):
$ w_scan -f <FRONTEND_TYPE> {-c <COUNTRY>,-s <SATELLITE>} -X >''cc-Ttttt''

===Defining output charset===
$ w_scan -f <FRONTEND_TYPE> -C <CHARSET> ...
Use 'iconv --list' for a list of possible output charsets, usually something like 'utf-8', 'iso8859-15'.
Needs 20110410 or higher.


==Also See==
==Also See==
Line 134: Line 23:


==External Links==
==External Links==
* [https://www.gen2vdr.de/wirbel/w_scan_cpp/index2.html w_scan_cpp Homepage, including old w_scan download (de)]
* [[w_scan_cpp|see w_scan_cpp]]


[[Category:Apps & Utilities]]
[[Category:Apps & Utilities]]

Latest revision as of 10:21, 8 August 2021

w_scan is a small command line utility used to perform frequency scans for DVB and ATSC transmissions. It is not included in LinuxTV dvb-apps, but complements the two frequency scanning utilities available through LinuxTV dvb-apps, dvbscan and scan. It is meanwhile replaced by the newer tool w_scan_cpp with similar syntax.

w_scan is capable of directly creating channels.conf files as well as initial tuning data for scan.

Obtaining w_scan

The last w_scan version can be still obtained here. There will be no further updates.

Documentation

Detailed information can be found in the w_scan man page (i.e. from a console, run man w_scan). Additionally, running w_scan with the -h parameter will produce an output that provides a summary of it's main command line options.

w_scan [options...] >> channels.conf

In general, when using w_scan you should at least specify three parameters: frontend type, country/satellite and output format.

As w_scan was superceeded quite a long time ago, pls refer to the w_scan_cpp page for it's similar syntax.

Also See

External Links