1dvb-fe-tool(1) User Commands dvb-fe-tool(1)
2
6 dvb-fe-tool - DVBv5 tool for frontend settings inspect/change
7
9 dvb-fe-tool [OPTION]...
10
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 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
21 The following options are valid:
22 -3, --dvbv3
24 Use DVBv3 only
25 -a, --adapter=ADAPTER
27 Digital TV adapter to use. Default: 0.
28 -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 -d, --set-delsys=PARAMS
34 Sets delivery system to the one specified at PARAMS. use help to
35 show all supported delivery systems.
36 -f, --frontend=FRONTEND
38 Digital TV frontend to use. Default: 0.
39 -g, --get
41 Gets frontend parameters.
42 -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 -v, --verbose
49 Enables debug messages.
50 -?, --help
52 Outputs the usage help.
53 --usage
55 Gives a short usage message.
56 -V, --version
58 Prints program version.
59
61 On success, it returns 0.
62
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 $ 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 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 This feature allows one to use those legacy applications.
100 $ dvb-fe-tool -d dvbc/annex_c
102 Changing delivery system to: DVBC/ANNEX_C
103 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 $ 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 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 On this mode, it will keep printing the frontend statistics on every
124 second, until the program is aborted with CTRL-C:
125 For example, while dvbv5-zap is tuning some channel, it will produce:
127 $ 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 If the standard error device is the console, the messages will be col‐
141 ored according with the signal quality.
142 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 On this mode, it also supports to output an audible signal if the qual‐
148 ity is good, using the '-A' parameter.
149 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 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
161 Report bugs to Linux Media Mailing List <linux-media@vger.kernel.org>
162
164 Copyright (c) 2011-2014 by Mauro Carvalho Chehab.
165 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.
169DVBv5 Utils 1.16.5 Fri Oct 3 2014 dvb-fe-tool(1)