xref: /OK3568_Linux_fs/kernel/Documentation/userspace-api/media/dvb/dvb-fe-read-status.rst (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2*4882a593Smuzhiyun
3*4882a593Smuzhiyun.. _dvb-fe-read-status:
4*4882a593Smuzhiyun
5*4882a593Smuzhiyun***************************************
6*4882a593SmuzhiyunQuerying frontend status and statistics
7*4882a593Smuzhiyun***************************************
8*4882a593Smuzhiyun
9*4882a593SmuzhiyunOnce :ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` is called, the
10*4882a593Smuzhiyunfrontend will run a kernel thread that will periodically check for the
11*4882a593Smuzhiyuntuner lock status and provide statistics about the quality of the
12*4882a593Smuzhiyunsignal.
13*4882a593Smuzhiyun
14*4882a593SmuzhiyunThe information about the frontend tuner locking status can be queried
15*4882a593Smuzhiyunusing :ref:`FE_READ_STATUS`.
16*4882a593Smuzhiyun
17*4882a593SmuzhiyunSignal statistics are provided via
18*4882a593Smuzhiyun:ref:`FE_GET_PROPERTY`.
19*4882a593Smuzhiyun
20*4882a593Smuzhiyun.. note::
21*4882a593Smuzhiyun
22*4882a593Smuzhiyun   Most statistics require the demodulator to be fully locked
23*4882a593Smuzhiyun   (e. g. with :c:type:`FE_HAS_LOCK <fe_status>` bit set). See
24*4882a593Smuzhiyun   :ref:`Frontend statistics indicators <frontend-stat-properties>` for
25*4882a593Smuzhiyun   more details.
26