media: venus: core: Fix kerneldoc warnings (c9072b67) · Commits · EulixOS / Software / Kernel

drivers/media/platform/qcom/venus/core.h

+31 −9

Original line number	Diff line number	Diff line
		@@ -90,18 +90,25 @@ struct venus_format {
		* struct venus_core - holds core parameters valid for all instances
		*
		* @base: IO memory base address
		* @vbif_base IO memory vbif base address
		* @cpu_base IO memory cpu base address
		* @cpu_cs_base IO memory cpu_cs base address
		* @cpu_ic_base IO memory cpu_ic base address
		* @wrapper_base IO memory wrapper base address
		* @wrapper_base IO memory wrapper TZ base address
		* @aon_base AON base address
		* @vbif_base: IO memory vbif base address
		* @cpu_base: IO memory cpu base address
		* @cpu_cs_base: IO memory cpu_cs base address
		* @cpu_ic_base: IO memory cpu_ic base address
		* @wrapper_base: IO memory wrapper base address
		* @wrapper_tz_base: IO memory wrapper TZ base address
		* @aon_base: AON base address
		* @irq: Venus irq
		* @clks: an array of struct clk pointers
		* @vcodec0_clks: an array of vcodec0 struct clk pointers
		* @vcodec1_clks: an array of vcodec1 struct clk pointers
		* @video_path: an interconnect handle to video to/from memory path
		* @cpucfg_path: an interconnect handle to cpu configuration path
		* @opp_table: an device OPP table handle
		* @has_opp_table: does OPP table exist
		* @pmdomains: an array of pmdomains struct device pointers
		* @opp_dl_venus: an device-link for device OPP
		* @opp_pmdomain: an OPP power-domain
		* @resets: an array of reset signals
		* @vdev_dec: a reference to video device structure for decoder instances
		* @vdev_enc: a reference to video device structure for encoder instances
		* @v4l2_dev: a holder for v4l2 device structure
		@@ -110,6 +117,7 @@ struct venus_format {
		* @dev_dec: convenience struct device pointer for decoder device
		* @dev_enc: convenience struct device pointer for encoder device
		* @use_tz: a flag that suggests presence of trustzone
		* @fw: structure of firmware parameters
		* @lock: a lock for this strucure
		* @instances: a list_head of all instances
		* @insts_count: num of instances
		@@ -118,6 +126,7 @@ struct venus_format {
		* @error: an error returned during last HFI sync operations
		* @sys_error: an error flag that signal system error event
		* @core_ops: the core operations
		* @pm_ops: a pointer to pm operations
		* @pm_lock: a lock for PM operations
		* @enc_codecs: encoders supported by this core
		* @dec_codecs: decoders supported by this core
		@@ -125,6 +134,10 @@ struct venus_format {
		* @priv: a private filed for HFI operations
		* @ops: the core HFI operations
		* @work: a delayed work for handling system fatal error
		* @caps: an array of supported HFI capabilities
		* @codecs_count: platform codecs count
		* @core0_usage_count: usage counter for core0
		* @core1_usage_count: usage counter for core1
		* @root: debugfs root directory
		*/
		struct venus_core {
		@@ -309,10 +322,11 @@ struct venus_ts_metadata {
		* @list: used for attach an instance to the core
		* @lock: instance lock
		* @core: a reference to the core struct
		* @clk_data: clock data per core ID
		* @dpbbufs: a list of decoded picture buffers
		* @internalbufs: a list of internal bufferes
		* @registeredbufs: a list of registered capture bufferes
		* @delayed_process a list of delayed buffers
		* @delayed_process: a list of delayed buffers
		* @delayed_process_work: a work_struct for process delayed buffers
		* @ctrl_handler: v4l control handler
		* @controls: a union of decoder and encoder control parameters
		@@ -321,22 +335,26 @@ struct venus_ts_metadata {
		* @streamon_out: stream on flag for output queue
		* @width: current capture width
		* @height: current capture height
		* @crop: current crop rectangle
		* @out_width: current output width
		* @out_height: current output height
		* @colorspace: current color space
		* @ycbcr_enc: current YCbCr encoding
		* @quantization: current quantization
		* @xfer_func: current xfer function
		* @codec_state: current codec API state (see DEC/ENC_STATE_)
		* @reconf_wait: wait queue for resolution change event
		* @subscriptions: used to hold current events subscriptions
		* @buf_count: used to count number of buffers (reqbuf(0))
		* @tss: timestamp metadata
		* @payloads: cache plane payload to use it for clock/BW scaling
		* @fps: holds current FPS
		* @timeperframe: holds current time per frame structure
		* @fmt_out: a reference to output format structure
		* @fmt_cap: a reference to capture format structure
		* @num_input_bufs: holds number of input buffers
		* @num_output_bufs: holds number of output buffers
		* @input_buf_size holds input buffer size
		* @input_buf_size: holds input buffer size
		* @output_buf_size: holds output buffer size
		* @output2_buf_size: holds secondary decoder output buffer size
		* @dpb_buftype: decoded picture buffer type
		@@ -357,7 +375,11 @@ struct venus_ts_metadata {
		* @priv: a private for HFI operations callbacks
		* @session_type: the type of the session (decoder or encoder)
		* @hprop: a union used as a holder by get property
		* @core_acquired: the Core has been acquired
		* @bit_depth: current bitstream bit-depth
		* @pic_struct: bitstream progressive vs interlaced
		* @next_buf_last: a flag to mark next queued capture buffer as last
		* @drain_active: Drain sequence is in progress
		*/
		struct venus_inst {
		struct list_head list;