home | help 
dvbv5-zap(1)			  User Commands 		    dvbv5-zap(1)

NAME
     dvbv5-zap - DVBv5 tool for service tuning

SYNOPSIS
     dvbv5-zap [OPTION]... channel-name

     dvbv5-zap [OPTION]... frequency-name (for monitor or all PIDs mode)

DESCRIPTION
     dvbv5-zap	is  a  command	line tuning tool for digital TV services that is
     compliant with version 5 of the DVB API, and backward compatible  with  the
     older v3 DVB API.

     dvbv5-zap	uses by default a new channel/service file format that it is ca-
     pable of supporting all types of Digital TV standards. It can also  support
     the legacy format used by the legacy dvb-apps.

     The dvbv5-zap tool can be used on several different modes, depending on the
     parameters used.

     Please  note that, in order to be able to use it in record mode, where both
     the audio and video Packet IDs (PIDs) are output to a dvr record node,  the
     input file should contain the PIDs, e. g. they should have been produced by
     a digital TV zap application like dvbv5-zap.

OPTIONS
     -c, --channels= channel-name-file
	    Read channels list from 'file'.  Defaults to ~/.tzap/channels.conf.

     -3, --dvbv3
	    Force dvbv5-zap to use DVBv3 only.	Useful to test if the legacy API
	    support is working.

     -a, --adapter=adapter#
	    Use the given adapter. Default value: 0.

     -A, --audio_pid=audio_pid#
	    Select a different audio Packet ID (PID).  The default is to use the
	    first audio PID found at the channel-name-file.

     -C, --cc=country_code
	    Set  the  default  country to be used by the MPEG-TS parsers, in ISO
	    3166-1 two letter code. If not specified,  the  default  charset  is
	    guessed from the locale environment variables.

     -d, --demux=demux#
	    Use the given demux. Default value: 0.

     -f, --frontend=frontend#
	    Use the given frontend. Default value: 0.

     -I, --input-format=format
	    Format of the input file. Please notice that caps is ignored. It can
	    be:

	    channel	    - for dvb-apps compatible channel file;

	    zap 	    - for dvb-apps compatible zap file;

	    dvbv5 (default) - for the dvbv5 apps format.

     -l, --lnbf=LNBf_type
	    Type of LNBf to use 'help' lists the available ones.

     -L, --search=string
	    Search/look  for  a string inside the traffic.  Used only on monitor
	    mode.

     -m, --monitor
	    Enable monitor mode. On this mode, it will monitor	de  DVB  traffic
	    for all Packet IDs (PIDs) received by the device, showing the Packet
	    IDs  (optionally  filtered by a string), and presenting some traffic
	    statistics: number of packets per second, number of Kbytes per  sec-
	    ond  and  total traffic.  Those statistics are shown per PID and the
	    total per MPEG-TS.

     -o, --output=file
	    Output filename. If specified, it will output  the	content  of  the
	    MPEG-TS  into  the file with the first video PID and the first audio
	    PID (or the one specified by audio_pid#).  Use -o  -  for  directing
	    the output to stdout.

     -p, --pat
	    Add PAT and PMT MPEG-TS tables to TS recording (implies -r).

     -P, --all-pids
	    Don't filter any pids. Instead, outputs all of them.

     -r, --record
	    Sets up the /dev/dvb/adapteradapter#/dvr0 for MPEG-TS record.

     -s, --silence
	    Increases silence (can be used more than once).

     -S, --sat_number=satellite_number
	    Satellite  number.	Used only on satellite delivery systems.  If not
	    specified, disable DISEqC satellite switch.

     -t, --timeout=seconds
	    Amount of seconds to keep the  tool  running  for  zapping	and  for
	    recording.	Useful if you want to record a program that you know its
	    duration.

     -U, --freq_bpf=frequency
	    SCR/Unicable  band-pass  filter frequency to use, in kHz.  Used only
	    on satellite delivery systems.

     -v, --verbose
	    Be verbose. Useful to check if the MPEG-TS is happenning fine.  This
	    option can be used multiple times to increase verbosity.

     -V, --video_pid=video_pid#
	    video pid program to use (default 0)

     -w, --lna=LNA
	    Enable, disable or put LNA power in auto  mode.  Not  all  frontends
	    support it.  Valid values are:

	     0 - disable

	     1 - enable

	    -1 - auto

     -W, --wait=time
	    Adds additional wait time for DISEqC command completion.

     -x, --exit
	    Exit after tuning.

     -X, --low_traffic
	    Also  shows  DVB  traffic  with less than 1 packet per second.  Used
	    only in monitor mode.

     -?, --help
	    Outputs the usage help.

     --usage
	    Gives a short usage message.

     --version
	    Prints program version.

EXIT STATUS
     On success, it returns 0.

EXAMPLES
   Recording a channel
     The typical use is to tune into a channel and put it into record mode:

     $ dvbv5-zap -c dvb_channel.conf 'music' -r
     using demux '/dev/dvb/adapter0/demux0'
     reading channels from file 'dvb_channel.conf'
     service has pid type 05: 204
     tuning to 573000000 Hz
     audio pid 104
     dvb_set_pesfilter 104
     Lock (0x1f) Quality= Good Signal= 100.00% C/N= -13.80dB UCB= 70 postBER= 3.14x10^-3 PER= 0
     DVR interface '/dev/dvb/adapter0/dvr0' can now be opened

     The channel can be watched by playing the contents of  the  DVR  interface,
     with some player that recognizes the MPEG-TS format.

     For example, this audio-only channel can be played with mplayer:

     $ mplayer -cache 800 /dev/dvb/adapter0/dvr0
     MPlayer SVN-r37077-4.8.2 (C) 2000-2014 MPlayer Team
     TS file format detected.
     NO VIDEO! AUDIO MPA(pid=104) NO SUBS (yet)!  PROGRAM N. 0
     ==================================================================
     Opening audio decoder: [mpg123] MPEG 1.0/2.0/2.5 layers I, II, III
     AUDIO: 48000 Hz, 2 ch, s16le, 192.0 kbit/12.50% (ratio: 24000->192000)
     Selected audio codec: [mpg123] afm: mpg123 (MPEG 1.0/2.0/2.5 layers I, II, III)
     ==================================================================
     AO: [alsa] 48000Hz 2ch s16le (2 bytes per sample)
     Video: no video
     Starting playback...

   Monitoring a channel
     The dvbv5-zap tool can also be used to monitor a DVB channel:

     $ dvbv5-zap -c dvb_channel.conf 573000000 -m
     using demux '/dev/dvb/adapter0/demux0'
     reading channels from file 'dvb_channel.conf'
     service has pid type 05:  204
     tuning to 573000000 Hz
     Lock   (0x1f) Quality= Good Signal= 100.00% C/N= -13.90dB UCB= 384 postBER= 96.8x10^-6 PER= 0
       dvb_set_pesfilter to 0x2000

     PID     FREQ    SPEED   TOTAL
     0000    9.88 p/s	     14.5 Kbps	     1 KB
     0001    1.98 p/s	     2.9 Kbps	     376 B
     0010    18.77 p/s	     27.6 Kbps	     3 KB
     0011    48.42 p/s	     71.1 Kbps	     8 KB
     0012    1455.53 p/s     2137.8 Kbps     270 KB
     ...
     1fff    1033.60 p/s     1518.1 Kbps     192 KB
     TOT     25296.44 p/s    37154.2 Kbps    4700 KB

     Lock   (0x1f) Quality= Good Signal= 100.00% C/N= -13.90dB UCB= 384 postBER= 96.8x10^-6 PER= 0

BUGS
     Report bugs to Linux Media Mailing List <linux-media@vger.kernel.org>

COPYRIGHT
     Copyright (c) 2011-2014 by Mauro Carvalho Chehab.

     License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl.html>.
     This  is  free software: you are free to change and redistribute it.  There
     is NO WARRANTY, to the extent permitted by law.

DVBv5 Utils 1.23.0		 Fri Oct 3 2014 		    dvbv5-zap(1)
home | help