Difference between revisions of "W scan"

From LinuxTVWiki
Jump to: navigation, search
(Documentation: modify table and some minor edits)
(Scanning DVB-S (Hotbird, vdr-1.7, 4-port DiSeqC switch, hotbird at port 3))
(17 intermediate revisions by 5 users 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 capable of directly creating channels.conf files as well as initial tuning data for [[Scan|scan]] which is contained in the [[LinuxTV dvb-apps]].
+
''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]].
 +
 
 +
''w_scan'' is capable of directly creating channels.conf files as well as initial tuning data for [[Scan|scan]].
  
 
==Obtaining w_scan==  
 
==Obtaining w_scan==  
You can get w_scan [http://wirbel.htpc-forum.de/w_scan/index2.html here].
+
''w_scan'' can be obtained [http://wirbel.htpc-forum.de/w_scan/index2.html here].
  
 
==Documentation==
 
==Documentation==
Detailed information can be found in the ''w_scan'' man page (i.e. from a console, run <code>man w_scan</code>).  Additionally, running w_scan with the -h parameter will produce an output that provides a summary of it's main command line options.
+
Detailed information can be found in the ''w_scan'' man page (i.e. from a console, run <code>man w_scan</code>).  Additionally, running ''w_scan'' with the -h parameter will produce an output that provides a summary of it's main command line options.
 
<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.  The following table summarizes the basic command line essentials for using ''w_scan''.
  
 
{| class="wikitable"  
 
{| class="wikitable"  
|+'''Basic w_scan options'''
+
|+'''Basic w_scan commandline parameters and their respective options'''
 
|-
 
|-
 
! Parameter !! Argument !! Description & Options
 
! Parameter !! Argument !! Description & Options
Line 21: Line 23:
 
| -f''Type''
 
| -f''Type''
 
|
 
|
a = ATSC (North America, cable and terrestrial<br>
+
a = ATSC (North America, cable and terrestrial)<br>
 
c = DVB-C (Europe, cable)<br>
 
c = DVB-C (Europe, cable)<br>
 
s = DVB-S/S2 (Satellite)<br>
 
s = DVB-S/S2 (Satellite)<br>
t = DVB-T (Europe, terrestrial = default)<br>
+
t = DVB-T/T2 (Europe, terrestrial = default)<br>
  
 
NOTE:
 
NOTE:
Line 43: Line 45:
 
| -c''ID''
 
| -c''ID''
 
|
 
|
(mandatory for ATSC, DVB-C, DVB-T)<br>
+
(mandatory for ATSC, DVB-C, DVB-T/T2)<br>
 
uppercase two character identifier as defined in ISO 3166-1,<br>
 
uppercase two character identifier as defined in ISO 3166-1,<br>
 
(DE,FR,GB,US,FI,...)<br>
 
(DE,FR,GB,US,FI,...)<br>
Line 53: Line 55:
 
|
 
|
 
(mandatory for DVB-S/S2)<br>
 
(mandatory for DVB-S/S2)<br>
uppercase character constant with E (east) or W (west)as separator,<br>
+
uppercase character constant with E (east) or W (west) as separator,<br>
 
(S19E2,S13E0,S0W8,...)<br>
 
(S19E2,S13E0,S0W8,...)<br>
 
see -s? for list of satellites.
 
see -s? for list of satellites.
Line 63: Line 65:
 
X = czap/tzap/xine channels.conf<br>
 
X = czap/tzap/xine channels.conf<br>
 
x = "initial tuning data" for [[Scan]]<br>
 
x = "initial tuning data" for [[Scan]]<br>
 +
G = Gstreamer dvbsrc Plugin<br>
 
k = channels.dvb for [[Kaffeine]]<br>
 
k = channels.dvb for [[Kaffeine]]<br>
If the output format is not specified, w_scan defaults to create [http://www.cadsoft.de/vdr/ VDR-1.6 channels.conf].
+
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-1.6 channels.conf].
 +
|-
 +
| '''VDR version'''
 +
| -o''N''
 +
|
 +
6 = vdr-1.6.x<br>
 +
7 = vdr-1.7.3 or higher
 
|-
 
|-
 
| '''Help Level'''
 
| '''Help Level'''
Line 75: Line 85:
 
|}
 
|}
  
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.)
+
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==
 
==Examples==
:NOTE: ATSC support needs w_scan >= 20080815
+
{{Note|As mentioned in the above table:
:NOTE: DVB-S/S2 support needs w_scan >= 20090504
+
* 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 }}
  
 
===Scanning ATSC VSB (United States, Over-the-Air)===
 
===Scanning ATSC VSB (United States, Over-the-Air)===
Line 85: Line 98:
 
===Scanning ATSC QAM annex B (United States, digital cable TV)===
 
===Scanning ATSC QAM annex B (United States, digital cable TV)===
 
  $ w_scan -fa -A2 -c US -X
 
  $ w_scan -fa -A2 -c US -X
===Scanning DVB-T (Germany, Over-the-Air, VDR output)===
+
===Scanning DVB-T/T2 (Germany, Over-the-Air, VDR output)===
 
  $ w_scan -ft -c DE
 
  $ w_scan -ft -c DE
===Scanning DVB-C (Germany, digital cable TV, kaffeine channels.dvb)===
+
 
 +
===Scanning DVB-C (Germany, digital cable TV, Kaffeine channels.dvb)===
 
  $ w_scan -fc -c DE -k
 
  $ w_scan -fc -c DE -k
 
===Scanning DVB-S/S2 (Astra 19.2east, vdr-1.7.x)===
 
===Scanning DVB-S/S2 (Astra 19.2east, vdr-1.7.x)===
Line 93: Line 107:
 
===Scanning DVB-S (Thor 0.8west, vdr-1.3.x .. vdr-1.6.x)===
 
===Scanning DVB-S (Thor 0.8west, vdr-1.3.x .. vdr-1.6.x)===
 
  $ w_scan -fs -s S0W8
 
  $ w_scan -fs -s S0W8
 +
===Scanning DVB-S (Hotbird, vdr-1.7, 4-port DiSeqC switch, hotbird at port 3)===
 +
$ w_scan -o 7 -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===
 
===Generating dvbscan tuning data===
 
Exactly as above, just specify output format dvbscan with "-x":
 
Exactly as above, just specify output format dvbscan with "-x":
Line 98: Line 121:
  
 
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].
 
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==
 +
* [[Frequency_scan#Comparison_of_DVB_frequency_scanning_commandline_utilities|Comparison of the scanning utilities]].
 
* man w_scan
 
* man w_scan
 
* [[scan]]
 
* [[scan]]
Line 105: Line 138:
  
 
==External Links==
 
==External Links==
* [http://wirbel.htpc-forum.de/w_scan/index2.html Homepage]
+
* [http://wirbel.htpc-forum.de/w_scan/index2.html Homepage (de)]
* [http://64.233.179.104/translate_c?hl=en&langpair=de%7Cen&u=http://wirbel.htpc-forum.de/w_scan/index2.html English translation via Google]
+
* [http://wirbel.htpc-forum.de/w_scan/index_en.html Homepage (en)]
 
* [http://edafe.org/vdr/w_scan/ English howto by edafe]
 
* [http://edafe.org/vdr/w_scan/ English howto by edafe]
  
 
[[Category:Apps & Utilities]]
 
[[Category:Apps & Utilities]]

Revision as of 16:23, 2 January 2014

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.

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

Obtaining w_scan

w_scan can be obtained here.

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. The following table summarizes the basic command line essentials for using w_scan.

Basic w_scan commandline parameters and their respective options
Parameter Argument Description & Options
Frontend Type -fType

a = ATSC (North America, cable and terrestrial)
c = DVB-C (Europe, cable)
s = DVB-S/S2 (Satellite)
t = DVB-T/T2 (Europe, terrestrial = default)

NOTE:

  • ATSC support requires a w_scan version >= 20080815
  • Satellite support requires a w_scan version >= 20090504)
ATSC Type -AType

(ignored for DVB-C and DVB-T)
1 = VSB ("Over-the-Air)"
2 = QAM annex B ("cable TV")
3 = both of them

Country ID -cID

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

Satellite ID -sID

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

Output Format -Format

X = czap/tzap/xine channels.conf
x = "initial tuning data" for Scan
G = Gstreamer dvbsrc Plugin
k = channels.dvb for Kaffeine
L = VLC xspf playlist (experimental)
M = mplayer format, similar to X
If the output format is not specified, w_scan defaults to create VDR-1.6 channels.conf.

VDR version -oN

6 = vdr-1.6.x
7 = vdr-1.7.3 or higher

Help Level -Level

h = basic help
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 >= 20080815
  • ATSC support was integrated in vdr-1.7.14, VDR output needs '-o 7'
  • DVB-S/S2 support requires a w_scan version >= 20090504
  • DVB-T2 support requires a w_scan version >= 20120111

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-C (Germany, digital cable TV, Kaffeine channels.dvb)

$ w_scan -fc -c DE -k

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-1.3.x .. vdr-1.6.x)

$ w_scan -fs -s S0W8

Scanning DVB-S (Hotbird, vdr-1.7, 4-port DiSeqC switch, hotbird at port 3)

$ w_scan -o 7 -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 dvb mailing list after checking that it hasn't already been posted or added to the 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

External Links