iv/linux
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

media: cx25840: add kernel-doc description of struct cx25840_state

Browse Source 
This commit describes a device instance private data of the driver
(struct cx25840_state) in a kernel-doc style comment.

Signed-off-by: Maciej S. Szmigiero <mail@maciej.szmigiero.name>
Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
This commit is contained in:
Maciej S. Szmigiero 2018-07-02 17:23:22 -04:00 committed by Mauro Carvalho Chehab
parent c928d45475
commit af16d0a132
1 changed files with 31 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
drivers/media/i2c/cx25840/cx25840-core.h
View File

@ -45,6 +45,35 @@ enum cx25840_media_pads {
CX25840_NUM_PADS CX25840_NUM_PADS
}; };
/**
* struct cx25840_state - a device instance private data
* @c: i2c_client struct representing this device
* @sd: our V4L2 sub-device
* @hdl: our V4L2 control handler
* @volume: audio volume V4L2 control (non-cx2583x devices only)
* @mute: audio mute V4L2 control (non-cx2583x devices only)
* @pvr150_workaround: whether we enable workaround for Hauppauge PVR150
* hardware bug (audio dropping out)
* @radio: set if we are currently in the radio mode, otherwise
* the current mode is non-radio (that is, video)
* @std: currently set video standard
* @vid_input: currently set video input
* @aud_input: currently set audio input
* @audclk_freq: currently set audio sample rate
* @audmode: currently set audio mode (when in non-radio mode)
* @vbi_line_offset: vbi line number offset
* @id: exact device model
* @rev: raw device id read from the chip
* @is_initialized: whether we have already loaded firmware into the chip
* and initialized it
* @vbi_regs_offset: offset of vbi regs
* @fw_wait: wait queue to wake an initalization function up when
* firmware loading (on a separate workqueue) finishes
* @fw_work: a work that actually loads the firmware on a separate
* workqueue
* @ir_state: a pointer to chip IR controller private data
* @pads: array of supported chip pads (currently only a stub)
*/
struct cx25840_state { struct cx25840_state {
struct i2c_client *c; struct i2c_client *c;
struct v4l2_subdev sd; struct v4l2_subdev sd;
@ -66,8 +95,8 @@ struct cx25840_state {
u32 rev; u32 rev;
int is_initialized; int is_initialized;
unsigned vbi_regs_offset; unsigned vbi_regs_offset;
wait_queue_head_t fw_wait; /* wake up when the fw load is finished */ wait_queue_head_t fw_wait;
struct work_struct fw_work; /* work entry for fw load */ struct work_struct fw_work;
struct cx25840_ir_state *ir_state; struct cx25840_ir_state *ir_state;
#if defined(CONFIG_MEDIA_CONTROLLER) #if defined(CONFIG_MEDIA_CONTROLLER)
struct media_pad pads[CX25840_NUM_PADS]; struct media_pad pads[CX25840_NUM_PADS];