W scan: Difference between revisions
No edit summary |
(→Documentation: modify table and some minor edits) |
||
Line 7: | Line 7: | ||
==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. |
|||
<pre>w_scan [options...] >> channels.conf</pre> |
<pre>w_scan [options...] >> channels.conf</pre> |
||
⚫ | |||
⚫ | |||
⚫ | |||
{| border=1 cellpadding=1 cellspacing=0 |
|||
|- bgcolor=#efefef |
|||
{| class="wikitable" |
|||
!Parameter |
|||
|+'''Basic w_scan options''' |
|||
!Description |
|||
|- |
|- |
||
! Parameter !! Argument !! Description & Options |
|||
⚫ | |||
'''Frontend Type'''<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 (Europe, terrestrial = default)<br> |
||
⚫ | |||
NOTE: |
|||
⚫ | |||
⚫ | |||
⚫ | |||
|- |
|- |
||
| ''' |
| '''ATSC Type''' |
||
⚫ | |||
⚫ | |||
| |
|||
⚫ | |||
1 = VSB ("Over-the-Air)"<br> |
1 = VSB ("Over-the-Air)"<br> |
||
2 = QAM annex B ("cable TV")<br> |
2 = QAM annex B ("cable TV")<br> |
||
3 = both of them |
3 = both of them |
||
|- |
|- |
||
| |
|'''Country ID''' |
||
⚫ | |||
⚫ | |||
| |
|||
⚫ | |||
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> |
||
see -c? for list of |
see -c? for list of countries. |
||
|- |
|- |
||
| ''' |
| '''Satellite ID''' |
||
| -s''ID'' |
|||
⚫ | |||
| |
|||
⚫ | |||
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. |
||
|- |
|- |
||
| ''' |
| '''Output Format''' |
||
| -''Format'' |
|||
⚫ | |||
| |
| |
||
⚫ | |||
⚫ | |||
"initial tuning data" for [[Scan]] |
x = "initial tuning data" for [[Scan]]<br> |
||
⚫ | |||
⚫ | |||
|- |
|- |
||
| ''' |
| '''Help Level''' |
||
| -''Level'' |
|||
⚫ | |||
| |
| |
||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
|} |
|} |
||
''Experts'' or ''experienced users'' may use some of the other options, but this 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.) |
||
{{Note|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== |
Revision as of 17:17, 17 May 2009
"w_scan" is a small command line utility used to perform frequency scans for DVB and ATSC transmissions. It is capable of directly creating channels.conf files as well as initial tuning data for scan which is contained in the LinuxTV dvb-apps.
Obtaining w_scan
You can get w_scan 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.
Parameter | Argument | Description & Options |
---|---|---|
Frontend Type | -fType |
a = ATSC (North America, cable and terrestrial NOTE:
|
ATSC Type | -AType |
(ignored for DVB-C and DVB-T) |
Country ID | -cID |
(mandatory for ATSC, DVB-C, DVB-T) |
Satellite ID | -sID |
(mandatory for DVB-S/S2) |
Output Format | -Format |
X = czap/tzap/xine channels.conf |
Help Level | -Level |
h = basic help |
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: ATSC support needs w_scan >= 20080815
- NOTE: DVB-S/S2 support needs w_scan >= 20090504
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 (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
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.