Documentation/media/uapi/dvb/dvb-fe-read-status.rst

   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/media/uapi/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 ***************************************
  13 Querying frontend status and statistics
  14 ***************************************
  15
  16 Once :ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` is called, the
  17 frontend will run a kernel thread that will periodically check for the
  18 tuner lock status and provide statistics about the quality of the
  19 signal.
  20
  21 The information about the frontend tuner locking status can be queried
  22 using :ref:`FE_READ_STATUS`.
  23
  24 Signal 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.