* [PATCH 1/3] rtl2830: add kernel-doc comments for platform_data
@ 2015-02-02 17:39 Antti Palosaari
2015-02-02 17:39 ` [PATCH 2/3] rtl2832: " Antti Palosaari
2015-02-02 17:39 ` [PATCH 3/3] rtl2832_sdr: " Antti Palosaari
0 siblings, 2 replies; 3+ messages in thread
From: Antti Palosaari @ 2015-02-02 17:39 UTC (permalink / raw)
To: linux-media; +Cc: Antti Palosaari
Add kernel-doc comments for platform_data configuration structure.
Signed-off-by: Antti Palosaari <crope@iki.fi>
---
drivers/media/dvb-frontends/rtl2830.h | 33 +++++++++++++--------------------
1 file changed, 13 insertions(+), 20 deletions(-)
diff --git a/drivers/media/dvb-frontends/rtl2830.h b/drivers/media/dvb-frontends/rtl2830.h
index 156edf7..0cde151 100644
--- a/drivers/media/dvb-frontends/rtl2830.h
+++ b/drivers/media/dvb-frontends/rtl2830.h
@@ -20,33 +20,26 @@
#include <linux/dvb/frontend.h>
+/**
+ * struct rtl2830_platform_data - Platform data for the rtl2830 driver
+ * @clk: Clock frequency (4000000, 16000000, 25000000, 28800000).
+ * @spec_inv: Spectrum inversion.
+ * @vtop: AGC take-over point.
+ * @krf: AGC ratio.
+ * @agc_targ_val: AGC.
+ * @get_dvb_frontend: Get DVB frontend.
+ * @get_i2c_adapter: Get I2C adapter.
+ * @pid_filter: Set PID to PID filter.
+ * @pid_filter_ctrl: Control PID filter.
+ */
+
struct rtl2830_platform_data {
- /*
- * Clock frequency.
- * Hz
- * 4000000, 16000000, 25000000, 28800000
- */
u32 clk;
-
- /*
- * Spectrum inversion.
- */
bool spec_inv;
-
- /*
- */
u8 vtop;
-
- /*
- */
u8 krf;
-
- /*
- */
u8 agc_targ_val;
- /*
- */
struct dvb_frontend* (*get_dvb_frontend)(struct i2c_client *);
struct i2c_adapter* (*get_i2c_adapter)(struct i2c_client *);
int (*pid_filter)(struct dvb_frontend *, u8, u16, int);
--
http://palosaari.fi/
^ permalink raw reply related [flat|nested] 3+ messages in thread
* [PATCH 2/3] rtl2832: add kernel-doc comments for platform_data
2015-02-02 17:39 [PATCH 1/3] rtl2830: add kernel-doc comments for platform_data Antti Palosaari
@ 2015-02-02 17:39 ` Antti Palosaari
2015-02-02 17:39 ` [PATCH 3/3] rtl2832_sdr: " Antti Palosaari
1 sibling, 0 replies; 3+ messages in thread
From: Antti Palosaari @ 2015-02-02 17:39 UTC (permalink / raw)
To: linux-media; +Cc: Antti Palosaari
Add kernel-doc comments for platform_data configuration structure.
Signed-off-by: Antti Palosaari <crope@iki.fi>
---
drivers/media/dvb-frontends/rtl2832.h | 23 ++++++++++++-----------
1 file changed, 12 insertions(+), 11 deletions(-)
diff --git a/drivers/media/dvb-frontends/rtl2832.h b/drivers/media/dvb-frontends/rtl2832.h
index e5f67cf..a8e912e 100644
--- a/drivers/media/dvb-frontends/rtl2832.h
+++ b/drivers/media/dvb-frontends/rtl2832.h
@@ -25,16 +25,20 @@
#include <linux/dvb/frontend.h>
#include <linux/i2c-mux.h>
+/**
+ * struct rtl2832_platform_data - Platform data for the rtl2832 driver
+ * @clk: Clock frequency (4000000, 16000000, 25000000, 28800000).
+ * @tuner: Used tuner model.
+ * @get_dvb_frontend: Get DVB frontend.
+ * @get_i2c_adapter: Get I2C adapter.
+ * @enable_slave_ts: Enable slave TS IF.
+ * @pid_filter: Set PID to PID filter.
+ * @pid_filter_ctrl: Control PID filter.
+ */
+
struct rtl2832_platform_data {
- /*
- * Clock frequency.
- * Hz
- * 4000000, 16000000, 25000000, 28800000
- */
u32 clk;
-
/*
- * Tuner.
* XXX: This list must be kept sync with dvb_usb_rtl28xxu USB IF driver.
*/
#define RTL2832_TUNER_TUA9001 0x24
@@ -45,15 +49,12 @@ struct rtl2832_platform_data {
#define RTL2832_TUNER_R828D 0x2b
u8 tuner;
- /*
- * Callbacks.
- */
struct dvb_frontend* (*get_dvb_frontend)(struct i2c_client *);
struct i2c_adapter* (*get_i2c_adapter)(struct i2c_client *);
int (*enable_slave_ts)(struct i2c_client *);
int (*pid_filter)(struct dvb_frontend *, u8, u16, int);
int (*pid_filter_ctrl)(struct dvb_frontend *, int);
- /* Register access for SDR module */
+/* private: Register access for SDR module use only */
int (*bulk_read)(struct i2c_client *, unsigned int, void *, size_t);
int (*bulk_write)(struct i2c_client *, unsigned int, const void *, size_t);
int (*update_bits)(struct i2c_client *, unsigned int, unsigned int, unsigned int);
--
http://palosaari.fi/
^ permalink raw reply related [flat|nested] 3+ messages in thread
* [PATCH 3/3] rtl2832_sdr: add kernel-doc comments for platform_data
2015-02-02 17:39 [PATCH 1/3] rtl2830: add kernel-doc comments for platform_data Antti Palosaari
2015-02-02 17:39 ` [PATCH 2/3] rtl2832: " Antti Palosaari
@ 2015-02-02 17:39 ` Antti Palosaari
1 sibling, 0 replies; 3+ messages in thread
From: Antti Palosaari @ 2015-02-02 17:39 UTC (permalink / raw)
To: linux-media; +Cc: Antti Palosaari
Add kernel-doc comments for platform_data configuration structure.
Signed-off-by: Antti Palosaari <crope@iki.fi>
---
drivers/media/dvb-frontends/rtl2832_sdr.h | 20 +++++++++++++-------
1 file changed, 13 insertions(+), 7 deletions(-)
diff --git a/drivers/media/dvb-frontends/rtl2832_sdr.h b/drivers/media/dvb-frontends/rtl2832_sdr.h
index dd22e42..d259476 100644
--- a/drivers/media/dvb-frontends/rtl2832_sdr.h
+++ b/drivers/media/dvb-frontends/rtl2832_sdr.h
@@ -29,16 +29,22 @@
#include <media/v4l2-subdev.h>
#include "dvb_frontend.h"
+/**
+ * struct rtl2832_sdr_platform_data - Platform data for the rtl2832_sdr driver
+ * @clk: Clock frequency (4000000, 16000000, 25000000, 28800000).
+ * @tuner: Used tuner model.
+ * @i2c_client: rtl2832 demod driver I2C client.
+ * @bulk_read: rtl2832 driver private I/O interface.
+ * @bulk_write: rtl2832 driver private I/O interface.
+ * @update_bits: rtl2832 driver private I/O interface.
+ * @dvb_frontend: rtl2832 DVB frontend.
+ * @v4l2_subdev: Tuner v4l2 controls.
+ * @dvb_usb_device: DVB USB interface for USB streaming.
+ */
+
struct rtl2832_sdr_platform_data {
- /*
- * Clock frequency.
- * Hz
- * 4000000, 16000000, 25000000, 28800000
- */
u32 clk;
-
/*
- * Tuner.
* XXX: This list must be kept sync with dvb_usb_rtl28xxu USB IF driver.
*/
#define RTL2832_SDR_TUNER_TUA9001 0x24
--
http://palosaari.fi/
^ permalink raw reply related [flat|nested] 3+ messages in thread
end of thread, other threads:[~2015-02-02 17:39 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2015-02-02 17:39 [PATCH 1/3] rtl2830: add kernel-doc comments for platform_data Antti Palosaari
2015-02-02 17:39 ` [PATCH 2/3] rtl2832: " Antti Palosaari
2015-02-02 17:39 ` [PATCH 3/3] rtl2832_sdr: " Antti Palosaari
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).