Skip to content

Commit 020120a

Browse files
committed
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>
1 parent b087982 commit 020120a

1 file changed

Lines changed: 72 additions & 13 deletions

File tree

  • Documentation/driver-api/media/drivers

Documentation/driver-api/media/drivers/vidtv.rst

Lines changed: 72 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -258,6 +258,42 @@ Using dvb-fe-tool
258258
The first step to check whether the demod loaded successfully is to run::
259259

260260
$ dvb-fe-tool
261+
Device Dummy demod for DVB-T/T2/C/S/S2 (/dev/dvb/adapter0/frontend0) capabilities:
262+
CAN_FEC_1_2
263+
CAN_FEC_2_3
264+
CAN_FEC_3_4
265+
CAN_FEC_4_5
266+
CAN_FEC_5_6
267+
CAN_FEC_6_7
268+
CAN_FEC_7_8
269+
CAN_FEC_8_9
270+
CAN_FEC_AUTO
271+
CAN_GUARD_INTERVAL_AUTO
272+
CAN_HIERARCHY_AUTO
273+
CAN_INVERSION_AUTO
274+
CAN_QAM_16
275+
CAN_QAM_32
276+
CAN_QAM_64
277+
CAN_QAM_128
278+
CAN_QAM_256
279+
CAN_QAM_AUTO
280+
CAN_QPSK
281+
CAN_TRANSMISSION_MODE_AUTO
282+
DVB API Version 5.11, Current v5 delivery system: DVBC/ANNEX_A
283+
Supported delivery systems:
284+
DVBT
285+
DVBT2
286+
[DVBC/ANNEX_A]
287+
DVBS
288+
DVBS2
289+
Frequency range for the current standard:
290+
From: 51.0 MHz
291+
To: 2.15 GHz
292+
Step: 62.5 kHz
293+
Tolerance: 29.5 MHz
294+
Symbol rate ranges for the current standard:
295+
From: 1.00 MBauds
296+
To: 45.0 MBauds
261297

262298
This should return what is currently set up at the demod struct, i.e.::
263299

@@ -316,7 +352,7 @@ For this, one should provide a configuration file known as a 'scan file',
316352
here's an example::
317353

318354
[Channel]
319-
FREQUENCY = 330000000
355+
FREQUENCY = 474000000
320356
MODULATION = QAM/AUTO
321357
SYMBOL_RATE = 6940000
322358
INNER_FEC = AUTO
@@ -337,6 +373,14 @@ You can browse scan tables online here: `dvb-scan-tables
337373
Assuming this channel is named 'channel.conf', you can then run::
338374

339375
$ dvbv5-scan channel.conf
376+
dvbv5-scan ~/vidtv.conf
377+
ERROR command BANDWIDTH_HZ (5) not found during retrieve
378+
Cannot calc frequency shift. Either bandwidth/symbol-rate is unavailable (yet).
379+
Scanning frequency #1 330000000
380+
(0x00) Signal= -68.00dBm
381+
Scanning frequency #2 474000000
382+
Lock (0x1f) Signal= -34.45dBm C/N= 33.74dB UCB= 0
383+
Service Beethoven, provider LinuxTV.org: digital television
340384

341385
For more information on dvb-scan, check its documentation online here:
342386
`dvb-scan Documentation <https://www.linuxtv.org/wiki/index.php/Dvbscan>`_.
@@ -346,23 +390,38 @@ Using dvb-zap
346390

347391
dvbv5-zap is a command line tool that can be used to record MPEG-TS to disk. The
348392
typical use is to tune into a channel and put it into record mode. The example
349-
below - which is taken from the documentation - illustrates that::
393+
below - which is taken from the documentation - illustrates that\ [1]_::
350394

351-
$ dvbv5-zap -c dvb_channel.conf "trilhas sonoras" -r
352-
using demux '/dev/dvb/adapter0/demux0'
395+
$ dvbv5-zap -c dvb_channel.conf "beethoven" -o music.ts -P -t 10
396+
using demux 'dvb0.demux0'
353397
reading channels from file 'dvb_channel.conf'
354-
service has pid type 05: 204
355-
tuning to 573000000 Hz
356-
audio pid 104
357-
dvb_set_pesfilter 104
358-
Lock (0x1f) Quality= Good Signal= 100.00% C/N= -13.80dB UCB= 70 postBER= 3.14x10^-3 PER= 0
359-
DVR interface '/dev/dvb/adapter0/dvr0' can now be opened
398+
tuning to 474000000 Hz
399+
pass all PID's to TS
400+
dvb_set_pesfilter 8192
401+
dvb_dev_set_bufsize: buffer set to 6160384
402+
Lock (0x1f) Quality= Good Signal= -34.66dBm C/N= 33.41dB UCB= 0 postBER= 0 preBER= 1.05x10^-3 PER= 0
403+
Lock (0x1f) Quality= Good Signal= -34.57dBm C/N= 33.46dB UCB= 0 postBER= 0 preBER= 1.05x10^-3 PER= 0
404+
Record to file 'music.ts' started
405+
received 24587768 bytes (2401 Kbytes/sec)
406+
Lock (0x1f) Quality= Good Signal= -34.42dBm C/N= 33.89dB UCB= 0 postBER= 0 preBER= 2.44x10^-3 PER= 0
360407

361-
The channel can be watched by playing the contents of the DVR interface, with
362-
some player that recognizes the MPEG-TS format, such as *mplayer* or *vlc*.
408+
.. [1] In this example, it records 10 seconds with all program ID's stored
409+
at the music.ts file.
410+
411+
412+
The channel can be watched by playing the contents of the stream with some
413+
player that recognizes the MPEG-TS format, such as ``mplayer`` or ``vlc``.
363414

364415
By playing the contents of the stream one can visually inspect the workings of
365-
vidtv, e.g.::
416+
vidtv, e.g., to play a recorded TS file with::
417+
418+
$ mplayer music.ts
419+
420+
or, alternatively, running this command on one terminal::
421+
422+
$ dvbv5-zap -c dvb_channel.conf "beethoven" -P -r &
423+
424+
And, on a second terminal, playing the contents from DVR interface with::
366425

367426
$ mplayer /dev/dvb/adapter0/dvr0
368427

0 commit comments

Comments
 (0)