1dvb-fe-tool(1)                   User Commands                  dvb-fe-tool(1)
2
3
4

NAME

6       dvb-fe-tool - DVBv5 tool for frontend settings inspect/change
7

SYNOPSIS

9       dvb-fe-tool [OPTION]...
10

DESCRIPTION

12       dvbv5-fe-tool  is  a  command line tool for digital TV services that is
13       compliant with version 5 of the DVB API, and backward  compatible  with
14       the older v3 DVB API.
15
16       dvb-fe-tool  is  a  tool  to  inspect  and change the tuning parameters
17       directly at the Digital TV frontend. If called without  any  parameter,
18       it will show the device capabilities.
19

OPTIONS

21       The following options are valid:
22
23       -3, --dvbv3
24              Use DVBv3 only
25
26       -a, --adapter=ADAPTER
27              Digital TV adapter to use. Default: 0.
28
29       -A, --acoustical
30              beeps if signal quality is good. Also enables femon mode. Please
31              notice that console beep should be enabled on your wm.
32
33       -d, --set-delsys=PARAMS
34              Sets delivery system to the one specified at PARAMS. use help to
35              show all supported delivery systems.
36
37       -f, --frontend=FRONTEND
38              Digital TV frontend to use. Default: 0.
39
40       -g, --get
41              Gets frontend parameters.
42
43       -m, --femon
44              Monitors  the  frontend locking status and the available statis‐
45              tics for a frontend that it is already being streaming via  some
46              other application.  This opens the frontend on read-only mode.
47
48       -v, --verbose
49              Enables debug messages.
50
51       -?, --help
52              Outputs the usage help.
53
54       --usage
55              Gives a short usage message.
56
57       -V, --version
58              Prints program version.
59

EXIT STATUS

61       On success, it returns 0.
62

EXAMPLES

64   Showing device capabilities
65       This  is  the default behavior. It will open the frontend and show what
66       capabilities it supports and what's the version of the DVB API.
67
68       $ dvb-fe-tool
69       Device DRXK DVB-C DVB-T (/dev/dvb/adapter0/frontend0) capabilities:
70            CAN_FEC_1_2
71            CAN_FEC_2_3
72            CAN_FEC_3_4
73            CAN_FEC_5_6
74            CAN_FEC_7_8
75            CAN_FEC_AUTO
76            CAN_GUARD_INTERVAL_AUTO
77            CAN_HIERARCHY_AUTO
78            CAN_INVERSION_AUTO
79            CAN_MUTE_TS
80            CAN_QAM_16
81            CAN_QAM_32
82            CAN_QAM_64
83            CAN_QAM_128
84            CAN_QAM_256
85            CAN_RECOVER
86            CAN_TRANSMISSION_MODE_AUTO
87       DVB API Version 5.10, Current v5 delivery system: DVBC/ANNEX_A
88       Supported delivery systems:
89           [DVBC/ANNEX_A]
90            DVBC/ANNEX_C
91            DVBT
92
93   Setting the delivery system
94       Some devices (like the above example) supports multiple  delivery  sys‐
95       tems.   Older  DVB  applications  might  not be able to switch from one
96       delivery system to another one, as this feature were added only on  DVB
97       API version 5.5.
98
99       This feature allows one to use those legacy applications.
100
101       $ dvb-fe-tool -d dvbc/annex_c
102       Changing delivery system to: DVBC/ANNEX_C
103
104   Getting the current frontend settings
105       The tool can also be used to get the current settings. In this case, it
106       will open the frontend at read-only mode,  allowing  it  to  be  called
107       while some other digital TV application is running.
108
109       $ dvb-fe-tool -g
110       FREQUENCY = 573000000
111       MODULATION = QAM/256
112       INVERSION = AUTO
113       SYMBOL_RATE = 5217000
114       INNER_FEC = NONE
115       DELIVERY_SYSTEM = DVBC/ANNEX_A
116
117   Monitoring the frontend
118       The  dvb-fe-tool  can also be used to monitor a DVB frontend statistics
119       without touching on the device, using the --femon  (or  -m)  parameter.
120       The typical usage is to be able to read the statistics while some other
121       DVB program or application is in use.
122
123       On this mode, it will keep printing the frontend  statistics  on  every
124       second, until the program is aborted with CTRL-C:
125
126       For example, while dvbv5-zap is tuning some channel, it will produce:
127
128       $ dvb-fe-tool --femon
129       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= 36.40dB UCB= 370 postBER= 28.0x10^-6 PER= 0
130       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= 36.80dB UCB= 370 postBER= 25.3x10^-6 PER= 0
131       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= 36.30dB UCB= 370 postBER= 25.7x10^-6 PER= 0
132       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= 36.30dB UCB= 370 postBER= 28.4x10^-6 PER= 0
133       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= 36.50dB UCB= 370 postBER= 26.5x10^-6 PER= 0
134       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= 36.50dB UCB= 370 postBER= 26.9x10^-6 PER= 0
135       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= 36.20dB UCB= 370 postBER= 28.6x10^-6 PER= 0
136       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= 36.70dB UCB= 370 postBER= 26.7x10^-6 PER= 0
137       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= 36.80dB UCB= 370 postBER= 23.3x10^-6 PER= 0
138       Lock   (0x1f) Quality= Good Signal= 100.00% C/N= 36.50dB UCB= 370 postBER= 26.7x10^-6 PER= 0
139
140       If  the standard error device is the console, the messages will be col‐
141       ored according with the signal quality.
142
143       The presented statistics types and unities will depend on the ones that
144       the  hardware  you're  using  support. So, it may vary from hardware to
145       hardware.
146
147       On this mode, it also supports to output an audible signal if the qual‐
148       ity is good, using the '-A' parameter.
149
150       Please notice that, on modern Linux systems, the system audio should be
151       enabled at your window manager and the audio theme  should  be  set  to
152       produce an audio when BELL (character) is sent to the terminal.
153
154   NOTE:
155       C/N on the above stats means Carrier to Noise ratio. This is the Signal
156       to Noise ratio measured at the pilot carrier  or  just  the  Signal  to
157       Noise  ratio  for modulation types where just one carrier is used, like
158       DVB-C or DVB-S.
159

BUGS

161       Report bugs to Linux Media Mailing List <linux-media@vger.kernel.org>
162
164       Copyright (c) 2011-2014 by Mauro Carvalho Chehab.
165
166       License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl.html>.
167       This is free software: you are free  to  change  and  redistribute  it.
168       There is NO WARRANTY, to the extent permitted by law.
169
170
171
172DVBv5 Utils 1.16.3              Fri Oct 3 2014                  dvb-fe-tool(1)
Impressum