rockchip/rkisp1/rkisp1-common.h

1 /* SPDX-License-Identifier: (GPL-2.0+ OR MIT) */
3  * Rockchip ISP1 Driver - Common definitions
17 #include <linux/rkisp1-config.h>
18 #include <media/media-device.h>
19 #include <media/media-entity.h>
20 #include <media/v4l2-ctrls.h>
21 #include <media/v4l2-device.h>
22 #include <media/videobuf2-v4l2.h>
24 #include "rkisp1-regs.h"
64 /* IRQ lines */
86 /* enum for the capture id */
110  * enum rkisp1_feature - ISP features
112  * @RKISP1_FEATURE_MIPI_CSI2: The ISP has an internal MIPI CSI-2 receiver
123  * struct rkisp1_info - Model-specific ISP Information
145  * struct rkisp1_sensor_async - A container for the v4l2_async_subdev to add to the notifier
146  *				of the v4l2-async API
154  * @sd:			a pointer to v4l2_subdev struct of the sensor
165 	struct v4l2_subdev *sd;  member
171  * struct rkisp1_csi - CSI receiver subdev
176  * @sd: v4l2_subdev variable
178  * @source: source in-use, set when starting streaming
184 	struct v4l2_subdev sd;  member
190  * struct rkisp1_isp - ISP subdev entity
192  * @sd:				v4l2_subdev variable
199 	struct v4l2_subdev sd;  member
207  * struct rkisp1_vdev_node - Container for the video nodes: params, stats, mainpath, selfpath
222  * struct rkisp1_buffer - A container for the vb2 buffers used by the video devices:
227  * @buff_addr:	dma addresses of each plane, used only by the capture devices: selfpath, mainpath
236  * struct rkisp1_dummy_buffer - A buffer to write the next frame to in case
252  * struct rkisp1_capture - ISP capture video device
256  * @id:		  id of the capture, one of RKISP1_SELFPATH, RKISP1_MAINPATH
257  * @ops:	  list of callbacks to configure the capture device.
258  * @config:	  a pointer to the list of registers to configure the capture format.
314  * struct rkisp1_stats - ISP Statistics device
356  * struct rkisp1_params - ISP input parameters device
360  * @ops:		pointer to the variant-specific operations
382  * struct rkisp1_resizer - Resizer subdev
384  * @sd:	       v4l2_subdev variable
392 	struct v4l2_subdev sd;  member
401  * struct rkisp1_debug - Values to be exposed on debugfs.
412  * @stop_timeout:		  upon stream stop, the capture waits 1 second for the isr to stop
432  * struct rkisp1_device - ISP platform device
440  * @notifier:	   a notifier to register on the v4l2-async API to be notified on the sensor
441  * @source:        source subdev in-use, set when starting streaming
442  * @csi:	   internal CSI-2 receiver
443  * @isp:	   ISP sub-device
444  * @resizer_devs:  resizer sub-devices
445  * @capture_devs:  capture devices
446  * @stats:	   ISP statistics metadata capture device
449  * @stream_lock:   serializes {start/stop}_streaming callbacks between the capture devices.
451  * @info:	   version-specific ISP information
471 	struct mutex stream_lock; /* serialize {start/stop}_streaming cb between capture devices */
479  * struct rkisp1_mbus_info - ISP media bus info, Translates media bus code to hardware
503 	writel(val, rkisp1->base_addr + addr);  in rkisp1_write()
508 	return readl(rkisp1->base_addr + addr);  in rkisp1_read()
512  * rkisp1_cap_enum_mbus_codes - A helper function that return the i'th supported mbus code
513  *				of the capture entity. This is used to enumerate the supported
516  * @cap:  the capture entity
517  * @code: the mbus code, the function reads the code->index and fills the code->code
523  * rkisp1_mbus_info_get_by_index - Retrieve the ith supported mbus info
530  * rkisp1_sd_adjust_crop_rect - adjust a rectangle to fit into another rectangle.
539  * rkisp1_sd_adjust_crop - adjust a rectangle to fit into media bus format
548  * rkisp1_mbus_info_get_by_code - get the isp info of the media bus code
555  * rkisp1_params_pre_configure - Configure the params before stream start
572  * rkisp1_params_post_configure - Configure the params after stream start
581 /* rkisp1_params_disable - disable all parameters.