summaryrefslogtreecommitdiffstats
path: root/drivers/media/dvb-core/dvb_frontend.h
diff options
context:
space:
mode:
authorMauro Carvalho Chehab <mchehab@osg.samsung.com>2015-11-10 11:12:30 -0200
committerMauro Carvalho Chehab <mchehab@osg.samsung.com>2015-11-17 06:38:33 -0200
commit02f028cfd962106a6d223549f7f898b532117ecf (patch)
treecb7fd734d4a1d58b653cdd97cdfd0e6358728eef /drivers/media/dvb-core/dvb_frontend.h
parent66f4b3cb5c2c68810772e7eee30b3d4b85852639 (diff)
downloadblackbird-op-linux-02f028cfd962106a6d223549f7f898b532117ecf.tar.gz
blackbird-op-linux-02f028cfd962106a6d223549f7f898b532117ecf.zip
[media] dvb_frontend.h: Add a description for the header
This header file provides the kABI functions used by the Digital TV Frontend core support. Add a description for this kABI, to add at the device_drivers Kernel DocBook. Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
Diffstat (limited to 'drivers/media/dvb-core/dvb_frontend.h')
-rw-r--r--drivers/media/dvb-core/dvb_frontend.h23
1 files changed, 23 insertions, 0 deletions
diff --git a/drivers/media/dvb-core/dvb_frontend.h b/drivers/media/dvb-core/dvb_frontend.h
index d15507be60ff..47e1ee44d638 100644
--- a/drivers/media/dvb-core/dvb_frontend.h
+++ b/drivers/media/dvb-core/dvb_frontend.h
@@ -42,6 +42,29 @@
#include "dvbdev.h"
+/**
+ * DOC: Digital TV Frontend
+ *
+ * The Digital TV Frontend kABI defines a driver-internal interface for
+ * registering low-level, hardware specific driver to a hardware independent
+ * frontend layer. It is only of interest for Digital TV device driver writers.
+ * The header file for this API is named dvb_frontend.h and located in
+ * drivers/media/dvb-core.
+ *
+ * Before using the Digital TV frontend core, the bridge driver should attach
+ * the frontend demod, tuner and SEC devices and call dvb_register_frontend(),
+ * in order to register the new frontend at the subsystem. At device
+ * detach/removal, the bridge driver should call dvb_unregister_frontend() to
+ * remove the frontend from the core and then dvb_frontend_detach() to free the
+ * memory allocated by the frontend drivers.
+ *
+ * The drivers should also call dvb_frontend_suspend() as part of their
+ * handler for the &device_driver.suspend(), and dvb_frontend_resume() as
+ * part of their handler for &device_driver.resume().
+ *
+ * A few other optional functions are provided to handle some special cases.
+ */
+
/*
* Maximum number of Delivery systems per frontend. It
* should be smaller or equal to 32
OpenPOWER on IntegriCloud