[media] rtl2832: add kernel-doc comments for platform_data

Add kernel-doc comments for platform_data configuration structure.

Signed-off-by: Antti Palosaari <crope@iki.fi>
Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
This commit is contained in:
Antti Palosaari 2015-02-02 14:20:01 -03:00 committed by Mauro Carvalho Chehab
parent 61c309ffcd
commit 2f74b7c2f8
1 changed files with 13 additions and 12 deletions

View File

@ -25,16 +25,20 @@
#include <linux/dvb/frontend.h> #include <linux/dvb/frontend.h>
#include <linux/i2c-mux.h> #include <linux/i2c-mux.h>
struct rtl2832_platform_data { /**
/* * struct rtl2832_platform_data - Platform data for the rtl2832 driver
* Clock frequency. * @clk: Clock frequency (4000000, 16000000, 25000000, 28800000).
* Hz * @tuner: Used tuner model.
* 4000000, 16000000, 25000000, 28800000 * @get_dvb_frontend: Get DVB frontend.
*/ * @get_i2c_adapter: Get I2C adapter.
u32 clk; * @enable_slave_ts: Enable slave TS IF.
* @pid_filter: Set PID to PID filter.
* @pid_filter_ctrl: Control PID filter.
*/
struct rtl2832_platform_data {
u32 clk;
/* /*
* Tuner.
* XXX: This list must be kept sync with dvb_usb_rtl28xxu USB IF driver. * XXX: This list must be kept sync with dvb_usb_rtl28xxu USB IF driver.
*/ */
#define RTL2832_TUNER_TUA9001 0x24 #define RTL2832_TUNER_TUA9001 0x24
@ -45,15 +49,12 @@ struct rtl2832_platform_data {
#define RTL2832_TUNER_R828D 0x2b #define RTL2832_TUNER_R828D 0x2b
u8 tuner; u8 tuner;
/*
* Callbacks.
*/
struct dvb_frontend* (*get_dvb_frontend)(struct i2c_client *); struct dvb_frontend* (*get_dvb_frontend)(struct i2c_client *);
struct i2c_adapter* (*get_i2c_adapter)(struct i2c_client *); struct i2c_adapter* (*get_i2c_adapter)(struct i2c_client *);
int (*enable_slave_ts)(struct i2c_client *); int (*enable_slave_ts)(struct i2c_client *);
int (*pid_filter)(struct dvb_frontend *, u8, u16, int); int (*pid_filter)(struct dvb_frontend *, u8, u16, int);
int (*pid_filter_ctrl)(struct dvb_frontend *, 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_read)(struct i2c_client *, unsigned int, void *, size_t);
int (*bulk_write)(struct i2c_client *, unsigned int, const 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); int (*update_bits)(struct i2c_client *, unsigned int, unsigned int, unsigned int);