xref: /linux/Documentation/userspace-api/media/dvb/dvb-fe-read-status.rst (revision 1fe44191f361a88b0f9600a5bbc8ebf7ede642ce)
1.. Permission is granted to copy, distribute and/or modify this
2.. document under the terms of the GNU Free Documentation License,
3.. Version 1.1 or any later version published by the Free Software
4.. Foundation, with no Invariant Sections, no Front-Cover Texts
5.. and no Back-Cover Texts. A copy of the license is included at
6.. Documentation/userspace-api/media/fdl-appendix.rst.
7..
8.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
9
10.. _dvb-fe-read-status:
11
12***************************************
13Querying frontend status and statistics
14***************************************
15
16Once :ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` is called, the
17frontend will run a kernel thread that will periodically check for the
18tuner lock status and provide statistics about the quality of the
19signal.
20
21The information about the frontend tuner locking status can be queried
22using :ref:`FE_READ_STATUS`.
23
24Signal statistics are provided via
25:ref:`FE_GET_PROPERTY`.
26
27.. note::
28
29   Most statistics require the demodulator to be fully locked
30   (e. g. with :c:type:`FE_HAS_LOCK <fe_status>` bit set). See
31   :ref:`Frontend statistics indicators <frontend-stat-properties>` for
32   more details.
33