media: vidtv.rst: update vidtv documentation

Update the vidtv documentation with the relevant changes
after the last patches.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
This commit is contained in:
Mauro Carvalho Chehab 2020-11-19 12:17:49 +01:00
parent b087982886
commit 020120af21
1 changed files with 72 additions and 13 deletions

View File

@ -258,6 +258,42 @@ Using dvb-fe-tool
The first step to check whether the demod loaded successfully is to run:: The first step to check whether the demod loaded successfully is to run::
$ dvb-fe-tool $ dvb-fe-tool
Device Dummy demod for DVB-T/T2/C/S/S2 (/dev/dvb/adapter0/frontend0) capabilities:
CAN_FEC_1_2
CAN_FEC_2_3
CAN_FEC_3_4
CAN_FEC_4_5
CAN_FEC_5_6
CAN_FEC_6_7
CAN_FEC_7_8
CAN_FEC_8_9
CAN_FEC_AUTO
CAN_GUARD_INTERVAL_AUTO
CAN_HIERARCHY_AUTO
CAN_INVERSION_AUTO
CAN_QAM_16
CAN_QAM_32
CAN_QAM_64
CAN_QAM_128
CAN_QAM_256
CAN_QAM_AUTO
CAN_QPSK
CAN_TRANSMISSION_MODE_AUTO
DVB API Version 5.11, Current v5 delivery system: DVBC/ANNEX_A
Supported delivery systems:
DVBT
DVBT2
[DVBC/ANNEX_A]
DVBS
DVBS2
Frequency range for the current standard:
From: 51.0 MHz
To: 2.15 GHz
Step: 62.5 kHz
Tolerance: 29.5 MHz
Symbol rate ranges for the current standard:
From: 1.00 MBauds
To: 45.0 MBauds
This should return what is currently set up at the demod struct, i.e.:: This should return what is currently set up at the demod struct, i.e.::
@ -316,7 +352,7 @@ For this, one should provide a configuration file known as a 'scan file',
here's an example:: here's an example::
[Channel] [Channel]
FREQUENCY = 330000000 FREQUENCY = 474000000
MODULATION = QAM/AUTO MODULATION = QAM/AUTO
SYMBOL_RATE = 6940000 SYMBOL_RATE = 6940000
INNER_FEC = AUTO INNER_FEC = AUTO
@ -337,6 +373,14 @@ You can browse scan tables online here: `dvb-scan-tables
Assuming this channel is named 'channel.conf', you can then run:: Assuming this channel is named 'channel.conf', you can then run::
$ dvbv5-scan channel.conf $ dvbv5-scan channel.conf
dvbv5-scan ~/vidtv.conf
ERROR command BANDWIDTH_HZ (5) not found during retrieve
Cannot calc frequency shift. Either bandwidth/symbol-rate is unavailable (yet).
Scanning frequency #1 330000000
(0x00) Signal= -68.00dBm
Scanning frequency #2 474000000
Lock (0x1f) Signal= -34.45dBm C/N= 33.74dB UCB= 0
Service Beethoven, provider LinuxTV.org: digital television
For more information on dvb-scan, check its documentation online here: For more information on dvb-scan, check its documentation online here:
`dvb-scan Documentation <https://www.linuxtv.org/wiki/index.php/Dvbscan>`_. `dvb-scan Documentation <https://www.linuxtv.org/wiki/index.php/Dvbscan>`_.
@ -346,23 +390,38 @@ Using dvb-zap
dvbv5-zap is a command line tool that can be used to record MPEG-TS to disk. The dvbv5-zap is a command line tool that can be used to record MPEG-TS to disk. The
typical use is to tune into a channel and put it into record mode. The example typical use is to tune into a channel and put it into record mode. The example
below - which is taken from the documentation - illustrates that:: below - which is taken from the documentation - illustrates that\ [1]_::
$ dvbv5-zap -c dvb_channel.conf "trilhas sonoras" -r $ dvbv5-zap -c dvb_channel.conf "beethoven" -o music.ts -P -t 10
using demux '/dev/dvb/adapter0/demux0' using demux 'dvb0.demux0'
reading channels from file 'dvb_channel.conf' reading channels from file 'dvb_channel.conf'
service has pid type 05: 204 tuning to 474000000 Hz
tuning to 573000000 Hz pass all PID's to TS
audio pid 104 dvb_set_pesfilter 8192
dvb_set_pesfilter 104 dvb_dev_set_bufsize: buffer set to 6160384
Lock (0x1f) Quality= Good Signal= 100.00% C/N= -13.80dB UCB= 70 postBER= 3.14x10^-3 PER= 0 Lock (0x1f) Quality= Good Signal= -34.66dBm C/N= 33.41dB UCB= 0 postBER= 0 preBER= 1.05x10^-3 PER= 0
DVR interface '/dev/dvb/adapter0/dvr0' can now be opened Lock (0x1f) Quality= Good Signal= -34.57dBm C/N= 33.46dB UCB= 0 postBER= 0 preBER= 1.05x10^-3 PER= 0
Record to file 'music.ts' started
received 24587768 bytes (2401 Kbytes/sec)
Lock (0x1f) Quality= Good Signal= -34.42dBm C/N= 33.89dB UCB= 0 postBER= 0 preBER= 2.44x10^-3 PER= 0
The channel can be watched by playing the contents of the DVR interface, with .. [1] In this example, it records 10 seconds with all program ID's stored
some player that recognizes the MPEG-TS format, such as *mplayer* or *vlc*. at the music.ts file.
The channel can be watched by playing the contents of the stream with some
player that recognizes the MPEG-TS format, such as ``mplayer`` or ``vlc``.
By playing the contents of the stream one can visually inspect the workings of By playing the contents of the stream one can visually inspect the workings of
vidtv, e.g.:: vidtv, e.g., to play a recorded TS file with::
$ mplayer music.ts
or, alternatively, running this command on one terminal::
$ dvbv5-zap -c dvb_channel.conf "beethoven" -P -r &
And, on a second terminal, playing the contents from DVR interface with::
$ mplayer /dev/dvb/adapter0/dvr0 $ mplayer /dev/dvb/adapter0/dvr0