^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) .. _dvb-fe-read-status:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) ***************************************
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) Querying frontend status and statistics
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) ***************************************
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) Once :ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` is called, the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) frontend will run a kernel thread that will periodically check for the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) tuner lock status and provide statistics about the quality of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) signal.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) The information about the frontend tuner locking status can be queried
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) using :ref:`FE_READ_STATUS`.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) Signal statistics are provided via
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) :ref:`FE_GET_PROPERTY`.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) .. note::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) Most statistics require the demodulator to be fully locked
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) (e. g. with :c:type:`FE_HAS_LOCK <fe_status>` bit set). See
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) :ref:`Frontend statistics indicators <frontend-stat-properties>` for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) more details.