18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
28c2ecf20Sopenharmony_ci
38c2ecf20Sopenharmony_ci.. _dvb-fe-read-status:
48c2ecf20Sopenharmony_ci
58c2ecf20Sopenharmony_ci***************************************
68c2ecf20Sopenharmony_ciQuerying frontend status and statistics
78c2ecf20Sopenharmony_ci***************************************
88c2ecf20Sopenharmony_ci
98c2ecf20Sopenharmony_ciOnce :ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` is called, the
108c2ecf20Sopenharmony_cifrontend will run a kernel thread that will periodically check for the
118c2ecf20Sopenharmony_cituner lock status and provide statistics about the quality of the
128c2ecf20Sopenharmony_cisignal.
138c2ecf20Sopenharmony_ci
148c2ecf20Sopenharmony_ciThe information about the frontend tuner locking status can be queried
158c2ecf20Sopenharmony_ciusing :ref:`FE_READ_STATUS`.
168c2ecf20Sopenharmony_ci
178c2ecf20Sopenharmony_ciSignal statistics are provided via
188c2ecf20Sopenharmony_ci:ref:`FE_GET_PROPERTY`.
198c2ecf20Sopenharmony_ci
208c2ecf20Sopenharmony_ci.. note::
218c2ecf20Sopenharmony_ci
228c2ecf20Sopenharmony_ci   Most statistics require the demodulator to be fully locked
238c2ecf20Sopenharmony_ci   (e. g. with :c:type:`FE_HAS_LOCK <fe_status>` bit set). See
248c2ecf20Sopenharmony_ci   :ref:`Frontend statistics indicators <frontend-stat-properties>` for
258c2ecf20Sopenharmony_ci   more details.
26