Hi,

this is a small channel scan tool for vdr which generates ATSC, DVB-C, DVB-S/S2 and DVB-T channels.conf files.
It's 50% "scan" from linuxtv-dvb-apps-1.1.0, the differences are:

- no initial tuning data needed, because scanning without this data is exactly
  what a scan tool like this should do
- it detects automatically which DVB/ATSC card to use.

0. Newest Version
--------------------
always at http://wirbel-htpc-forum.de

1. Building w_scan
--------------------
Ususally not needed - w_scan is included as binary in this package.

If you really need to compile, just issue the usual

./configure
make
make install

NOTE: For compiling need up-to-date(!) dvb headers with DVB API 5.0 support
are needed. If configure fails complaining about missing or old DVB headers,
run in your kernel source 'make headers_install' 
(needs kernel 2.6.29 or higher (!) ).
At your choice you may also manually update this files; they're located
in /usr/include/linux/dvb.


2. Basic usage
--------------------

NOTE: Newer versions of w_scan need setting '-c' for specifying 
country (ATSC, DVB-C and DVB-T) or '-s' for satellite (DVB-S).


2.a. DVB-C (using Germany as country, option -c)
./w_scan -fc -c DE >> channels.conf

2.b. DVB-T
./w_scan -c DE >> channels.conf

2.c. DVB-C and DVB-T
./w_scan -c DE >> channels.conf && ./w_scan -fc -c DE >> channels.conf

2.d. ATSC (terrestrial, using United States as country)
./w_scan -fa -c US >> channels.conf

2.e. US Digital Cable (QAM Annex-B)
./w_scan -A2 -c US >> channels.conf

2.f. ATSC, both terrestrial and digital cable
./w_scan -A3 -c US >> channels.conf

2.g. DVB-S, here: Astra 19.2 east
./w_scan -fs -s S19E2

	NOTE: see './w_scan -s?' for list of satellites.

2.h. generate (dvb)scan initial-tuning-data
./w_scan -c DE -x > initial_tuning_data.txt

2.i. generate kaffeine-0.8.5 channels.dvb
./w_scan -c DE -k > channels.dvb

2.j. reformat output for UTF8
./w_scan <OPTIONS> | tcs -f 8859-1 > channels.conf

For more sophisticated scan options see ./w_scan -h.


3. Usage of w_scan start script (optional)
-------------------- 

Since linux newbies may have problems in understanding
how to load dvb drivers, stop vdr or copy files there is a
w_scan start script which may help you. 

(Nevertheless the usage as described in 2. Basic usage is still valid
this is only a script which guides you trough the complete scan process..)

What does the script do?
	1) stops the vdr process
	2) loads the dvb drivers if not already loaded
	3) starts a DVB-T scan and after that a DVB-C scan with QAM64 and QAM256
	4) copies the channels.conf file generated to vdr's config directory
	5) restarts vdr

So if you already know how to do that steps, you don't need the script.
The script is started by the command 

./w_scan_start.sh

4. Credits
--------------------
- "e9hack" Hartmut Birr for onid-patch (2006-09-01)
- "seaman" giving his his Airstar2 for testing purposes to me
- "Wicky" for testing with Airstar2/Zarlink MT352 DVB-T
- "kilroy" for testing with Airstar2/Zarlink MT352 DVB-T and Avermedia
- "Fabrizio" for testing with Airstar2/Zarlink MT352 DVB-T
-  Arturo Martinez <martinez@embl.de> for a huge bunch of tests on DVB-S/DVB-S2

5. Copyright
--------------------
w_scan is GPLv2 Software, see included file COPYRIGHT for details.
The author can be reached at: handygewinnspiel AT gmx DOT de

have phun,
wirbel


