summaryrefslogtreecommitdiffstats
path: root/Documentation/userspace-api/media/dvb/dvb-fe-read-status.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/userspace-api/media/dvb/dvb-fe-read-status.rst')
-rw-r--r--Documentation/userspace-api/media/dvb/dvb-fe-read-status.rst25
1 files changed, 25 insertions, 0 deletions
diff --git a/Documentation/userspace-api/media/dvb/dvb-fe-read-status.rst b/Documentation/userspace-api/media/dvb/dvb-fe-read-status.rst
new file mode 100644
index 0000000000..fbd0548f5f
--- /dev/null
+++ b/Documentation/userspace-api/media/dvb/dvb-fe-read-status.rst
@@ -0,0 +1,25 @@
+.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
+
+.. _dvb-fe-read-status:
+
+***************************************
+Querying frontend status and statistics
+***************************************
+
+Once :ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` is called, the
+frontend will run a kernel thread that will periodically check for the
+tuner lock status and provide statistics about the quality of the
+signal.
+
+The information about the frontend tuner locking status can be queried
+using :ref:`FE_READ_STATUS`.
+
+Signal statistics are provided via
+:ref:`FE_GET_PROPERTY`.
+
+.. note::
+
+ Most statistics require the demodulator to be fully locked
+ (e. g. with :c:type:`FE_HAS_LOCK <fe_status>` bit set). See
+ :ref:`Frontend statistics indicators <frontend-stat-properties>` for
+ more details.