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"
38  * model-specific and stored in the rkisp1_info structure.
66 /* IRQ lines */
88 /* enum for the capture id */
112  * enum rkisp1_feature - ISP features
114  * @RKISP1_FEATURE_MIPI_CSI2: The ISP has an internal MIPI CSI-2 receiver
118  * @RKISP1_FEATURE_DMA_34BIT: The ISP uses 34-bit DMA addresses
137 	((rkisp1)->info->features & RKISP1_FEATURE_##feature)
140  * struct rkisp1_info - Model-specific ISP Information
166  * struct rkisp1_sensor_async - A container for the v4l2_async_subdev to add to the notifier
167  *				of the v4l2-async API
175  * @sd:			a pointer to v4l2_subdev struct of the sensor
186 	struct v4l2_subdev *sd;  member
192  * struct rkisp1_csi - CSI receiver subdev
197  * @sd: v4l2_subdev variable
199  * @source: source in-use, set when starting streaming
205 	struct v4l2_subdev sd;  member
211  * struct rkisp1_isp - ISP subdev entity
213  * @sd:				v4l2_subdev variable
220 	struct v4l2_subdev sd;  member
228  * struct rkisp1_vdev_node - Container for the video nodes: params, stats, mainpath, selfpath
243  * struct rkisp1_buffer - A container for the vb2 buffers used by the video devices:
248  * @buff_addr:	dma addresses of each plane, used only by the capture devices: selfpath, mainpath
257  * struct rkisp1_params_buffer - A container for the vb2 buffers used by the
277  * struct rkisp1_dummy_buffer - A buffer to write the next frame to in case
293  * struct rkisp1_capture - ISP capture video device
297  * @id:		  id of the capture, one of RKISP1_SELFPATH, RKISP1_MAINPATH
298  * @ops:	  list of callbacks to configure the capture device.
299  * @config:	  a pointer to the list of registers to configure the capture format.
355  * struct rkisp1_stats - ISP Statistics device
397  * struct rkisp1_params - ISP input parameters device
401  * @ops:		pointer to the variant-specific operations
428  * struct rkisp1_resizer - Resizer subdev
430  * @sd:	       v4l2_subdev variable
438 	struct v4l2_subdev sd;  member
447  * struct rkisp1_debug - Values to be exposed on debugfs.
458  * @stop_timeout:		  upon stream stop, the capture waits 1 second for the isr to stop
478  * struct rkisp1_device - ISP platform device
484  * @gasket:	   the gasket - i.MX8MP only
485  * @gasket_id:	   the gasket ID (0 or 1) - i.MX8MP only
488  * @notifier:	   a notifier to register on the v4l2-async API to be notified on the sensor
489  * @source:        source subdev in-use, set when starting streaming
490  * @csi:	   internal CSI-2 receiver
491  * @isp:	   ISP sub-device
492  * @resizer_devs:  resizer sub-devices
493  * @capture_devs:  capture devices
494  * @stats:	   ISP statistics metadata capture device
497  * @stream_lock:   serializes {start/stop}_streaming callbacks between the capture devices.
499  * @info:	   version-specific ISP information
521 	struct mutex stream_lock; /* serialize {start/stop}_streaming cb between capture devices */
529  * struct rkisp1_mbus_info - ISP media bus info, Translates media bus code to hardware
553 	writel(val, rkisp1->base_addr + addr);  in rkisp1_write()
558 	return readl(rkisp1->base_addr + addr);  in rkisp1_read()
562  * rkisp1_cap_enum_mbus_codes - A helper function that return the i'th supported mbus code
563  *				of the capture entity. This is used to enumerate the supported
566  * @cap:  the capture entity
567  * @code: the mbus code, the function reads the code->index and fills the code->code
573  * rkisp1_mbus_info_get_by_index - Retrieve the ith supported mbus info
580  * rkisp1_path_count - Return the number of paths supported by the device
593  * rkisp1_sd_adjust_crop_rect - adjust a rectangle to fit into another rectangle.
602  * rkisp1_sd_adjust_crop - adjust a rectangle to fit into media bus format
614  * rkisp1_mbus_info_get_by_code - get the isp info of the media bus code
621  * rkisp1_params_pre_configure - Configure the params before stream start
638  * rkisp1_params_post_configure - Configure the params after stream start
647 /* rkisp1_params_disable - disable all parameters.