1059b1c5bSMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
254f38fcaSMauro Carvalho Chehab
354f38fcaSMauro Carvalho Chehab.. _dvb-fe-read-status:
454f38fcaSMauro Carvalho Chehab
554f38fcaSMauro Carvalho Chehab***************************************
654f38fcaSMauro Carvalho ChehabQuerying frontend status and statistics
754f38fcaSMauro Carvalho Chehab***************************************
854f38fcaSMauro Carvalho Chehab
954f38fcaSMauro Carvalho ChehabOnce :ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` is called, the
1054f38fcaSMauro Carvalho Chehabfrontend will run a kernel thread that will periodically check for the
1154f38fcaSMauro Carvalho Chehabtuner lock status and provide statistics about the quality of the
1254f38fcaSMauro Carvalho Chehabsignal.
1354f38fcaSMauro Carvalho Chehab
1454f38fcaSMauro Carvalho ChehabThe information about the frontend tuner locking status can be queried
1554f38fcaSMauro Carvalho Chehabusing :ref:`FE_READ_STATUS`.
1654f38fcaSMauro Carvalho Chehab
1754f38fcaSMauro Carvalho ChehabSignal statistics are provided via
1854f38fcaSMauro Carvalho Chehab:ref:`FE_GET_PROPERTY`.
1954f38fcaSMauro Carvalho Chehab
2054f38fcaSMauro Carvalho Chehab.. note::
2154f38fcaSMauro Carvalho Chehab
2254f38fcaSMauro Carvalho Chehab   Most statistics require the demodulator to be fully locked
2354f38fcaSMauro Carvalho Chehab   (e. g. with :c:type:`FE_HAS_LOCK <fe_status>` bit set). See
2454f38fcaSMauro Carvalho Chehab   :ref:`Frontend statistics indicators <frontend-stat-properties>` for
2554f38fcaSMauro Carvalho Chehab   more details.
26