Scroll to navigation

w_scan_cpp(1) w_scan_cpp(1)

NAME w_scan_cpp - an universal DTV scanner and successor of w_scan.

SYNOPSIS

w_scan_cpp -fa -c <COUNTRY_ID> [ options ]
w_scan_cpp -fc -c <COUNTRY_ID> [ options ]
w_scan_cpp -ft -c <COUNTRY_ID> [ options ]
w_scan_cpp -fs -s <SATELLITE_ID> [ options ]

DESCRIPTION

w_scan_cpp scans for DVB-C, DVB-S/S2, DVB-T/T2 and ATSC channels,
or, let's call it digital TV and Radio services.
During a scan, this utility writes commands to your DTV hardware
and reads data from it.
Therefore, any other program accessing the DVB hardware
with write access (like e.g. VDR, tvheadend, minisatip,..) has to
be closed in order to avoid conflicts while running w_scan_cpp.
Also, enshure that you start this tool with proper write
permissions to your hardware, i.e using sudo.
After a successful scan, w_scan_cpp provides the channels in
different output formats.
By default, the data is written as VDR channels.conf. If you
prefer another output format, see OPTIONS section.

OPTIONS

The following options are available.

Frontend type, What programs do you want to search for?
"a" = atsc (vsb/qam; North-America)
"c" = DVB-C (digital cable)
"s" = DVB-S/S2 (digital satellite)
"t" = DVB-T/T2 (digital terrestrial)[default]
IMPORTANT: Depending on "TYPE",
either of the arguments "-s" or "-c" is mandatory.
specify ATSC type (North-America only)
"1" = Terrestrial ('VSB') [default]
"2" = Cable (sometimes called wrong 'QAM' or 'clear-QAM')
"3" = both, Terrestrial and Cable
use a SAT>IP (network connected) tuner via VDR Satip Plugin,
instead of a local installed tuner.
see https://www.satip.info
Mandatory argument for ATSC, cable and terrestrian scans,
see option -f.
Specifies the country where you try to scan for channels.
Argument is an uppercase two letter identifier, e.g.
DE = Germany,
FR = France
GB = Great Britain
US = United States,
Use "-c?" for a list of all known identifiers.
choose your satellite here:
S19E2, S13E0, S15W0, ..
? for list
generate transponder ini instead of VDR channels.conf
generate VLC xspf playlist instead of VDR channels.conf
generate VLC xspf playlist for SAT>IP instead of VDR channels.conf
generate mplayer output instead of VDR channels.conf
generate tzap/czap/xine output instead of VDR channels.conf
generate dtv scan table for dvbv5-scan instead of VDR
channels.conf
generate w_scan XML tuning data instead of VDR channels.conf
generate channels.dat for SAT>IP DvbViewer Lite
tune to a channel in VDR syntax and report signal status.
For details about VDR channel syntax, see vdr(5)
view extended help (experts only)

EXPERT OPTIONS

*** General ***

be more verbose (repeat for more)
be more quiet (repeat for less)

*** Services ***

sort services in sequence, as given by FILE.
FILE is a text file, each line gives the name of a service,
optionally followed by a delimiter (',' or ';' or ':') and a comment.
If 'name' is 7bit ASCII only, the comparison is case-insensitive.
Otherwise, for non-7bit ASCII, the case behaviour depends on your system.
w_scan_cpp tries to output services in the same sequence as your file -
but only for those channels which are really found.
If several services match the name, they are grouped together.
Services not matching any sort-criteria appear after the sorted lines.
NOTE: 'FILE' should be in the same encoding as used during scan, ie utf8.
Example:
Das Erste HD;ARD:
ZDF HD
:*** private channels ***
SAT.1 HD;ProSiebenSat.1
RTL HD:should be channel number 4.
0 = don't search radio channels
1 = search radio channels [default]
0 = don't search TV channels
1 = search TV channels[default]
N=0 gets only Free TV channels
N=1 search also encrypted channels [default]

*** Device ***

use device /dev/dvb/adapterN/ [default: auto detect]
(also allowed: -a /dev/dvb/adapterN/frontendM)
do not auto detect the satip server, but use manual
server settings, ie.
192.168.2.66 (the servers IP)
192.168.2.66|DVBC-1 (the server has one DVB-C frontend)
192.168.2.66|DVBS2-2,DVBT2-2|OctopusNet (two different fe types and quirks for OctopusNet)
192.168.2.66|DVBS2-2|minisatip:0x08 (RTP over TCP)
NOTE: as this option is just forwarded to the vdr-plugin-satip,
please refer to it's README for further details.
NOTE: Server quirk 0x08 enables RTP over TCP use.
selects the satellite orbital position for SAT>IP by index N (1 .. 255).
The number of supported positions depends on the SAT>IP server.
For the actual value of N, refer to the setup page of your SAT>IP server.
The default value is 1.

*** DVB-C ***

spectral inversion setting for cable TV
(0: off, 1: on, 2: auto [default])
set DVB-C modulation, see table: 0 = QAM64
1 = QAM256
2 = QAM128
3 = all (SLOW!)
NOTE: for experienced users only!!
extended scan flags (DVB-C only),
Any combination of these flags:
1 = use extended symbolrate list
enables scan of symbolrates
6900, 6875, 6111, 6250, 6790,
6811, 5900, 5000, 3450, 4000,
6950, 7000, 6952, 5156, 5483
2 = extended QAM scan (enable QAM128)
recommended for Nethterlands and Finland
NOTE: extended scan will be *slow*
set DVB-C symbol rate, see table:
0 = 6900 kSymbol/s
1 = 6875 kSymbol/s
4 = 6952 kSymbol/s
5 = 6950 kSymbol/s
6 = 6790 kSymbol/s
7 = 6811 kSymbol/s
8 = 6250 kSymbol/s
9 = 6111 kSymbol/s
11 = 5900 kSymbol/s
12 = 5483 kSymbol/s
14 = 5156 kSymbol/s
15 = 5000 kSymbol/s
16 = 4000 kSymbol/s
17 = 3450 kSymbol/s
NOTE: for experienced users only!!

*** DVB-S/S2 ***

choose LNB type by name (DVB-S/S2 only)
? for list

use DiSEqC committed switch position N
AA..BB => 0..3

use DiSEqC uncommitted switch position N
N = 0..15
use Rotor position N (needs -s)

where PARAMLIST is Lat:Long:Speed:Swing
Lat : your site latitude in tenth of degree, negative south, positive north
Long : your site longitude in tenth of degree, negative west , positive east
Speed: your rotor speed in tenth of degree per second
Swing: your rotor max swing in tenth of degree
example: a rotor located in Berlin/Germany (52.52,13.41),
moving at 1.5deg/sec, max swing 65deg gives
--rotor-usals 525:134:15:650
see --scr
Satellite Channel Routing
a) use EN50494:
slot : slot number for user frequency, 0..7
user_frequency: receiver user frequency for slot in MHz, i.e. 1400
sat_pos : satellite position (upper case), 'A' or 'B'
user_pin : optional user pin, normally not used (0..255)
i.e. -u 0:1400:A for EN50494, slot 0 at 1400 MHz, Satellite Pos 'A'


b) use advanced SCR EN50607/JESS:
slot : slot number for user frequency, 0..31
user_frequency: receiver user frequency for slot in MHz, i.e. 1400
sat_pos : satellite position (lower case), 'a' .. 'p'
user_pin : optional user pin, normally not used (0..255)
i.e. -u 0:1400:a for EN50607 slot 0 at 1400 MHz, Satellite Pos 'a'
sat| committed switch | uncommitted switch
pos| option | position | option | position
'a' 0 | 0 | 0 | 0
'b' 0 | 1 | 0 | 0
'c' 1 | 0 | 0 | 0
'd' 1 | 1 | 0 | 0
'e' 0 | 0 | 0 | 1
'f' 0 | 1 | 0 | 1
'g' 1 | 0 | 0 | 1
'h' 1 | 1 | 0 | 1
'i' 0 | 0 | 1 | 0
'j' 0 | 1 | 1 | 0
'k' 1 | 0 | 1 | 0
'l' 1 | 1 | 1 | 0
'm' 0 | 0 | 1 | 1
'n' 0 | 1 | 1 | 1
'o' 1 | 0 | 1 | 1
'p' 1 | 1 | 1 | 1

REPORTING BUGS

see README file from source code package.

AUTHOR

Written by W.Koehler

Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU General Public License,
Version 2 any later version published by the Free Software
Foundation.

SEE ALSO

vdr (1)
w_scan (1)

16 May 2021