admin-guide/media/rkisp1.rst

1 .. SPDX-License-Identifier: GPL-2.0
14 rkisp1 and uses the Media-Controller API.
27 - RKISP1_V10: used at least in rk3288 and rk3399
28 - RKISP1_V11: declared in the original vendor code, but not used
29 - RKISP1_V12: used at least in rk3326 and px30
30 - RKISP1_V13: used at least in rk1808
36 .. kernel-figure:: rkisp1.dot
43 - rkisp1_mainpath: capture device for retrieving images, usually in higher
45 - rkisp1_selfpath: capture device for retrieving images.
46 - rkisp1_stats: a metadata capture device that sends statistics.
47 - rkisp1_params: a metadata output device that receives parameters
52 - rkisp1_resizer_mainpath: used to resize and downsample frames for the
54 - rkisp1_resizer_selfpath: used to resize and downsample frames for the
56 - rkisp1_isp: is connected to the sensor and is responsible for all the isp
60 rkisp1_mainpath, rkisp1_selfpath - Frames Capture Video Nodes
61 -------------------------------------------------------------
70 the ``V4L2_CAP_IO_MC`` :ref:`capability <device-capabilities>`.
73 rkisp1_resizer_mainpath, rkisp1_resizer_selfpath - Resizers Subdevices Nodes
74 ----------------------------------------------------------------------------
77 YUV4:2:2 -> YUV4:2:0). They also have cropping capability on the sink pad.
81 case the resizer of the mainpath is set to 'bypass' mode - it just forward the
84 rkisp1_isp - Image Signal Processing Subdevice Node
85 ---------------------------------------------------
86 This is the isp entity. It is connected to the sensor on sink pad 0 and
87 receives the frames using the CSI-2 protocol. It is responsible of configuring
88 the CSI-2 protocol. It has a cropping capability on sink pad 0 that is
89 connected to the sensor and on source pad 2 connected to the resizer entities.
90 Cropping on sink pad 0 defines the image region from the sensor.
95 rkisp1_stats - Statistics Video Node
96 ------------------------------------
97 The statistics video node outputs the 3A (auto focus, auto exposure and auto
100 Using these data, applications can implement algorithms and re-parameterize
101 the driver through the rkisp_params node to improve image quality during a
105 :ref:`V4L2_META_FMT_RK_ISP1_STAT_3A <v4l2-meta-fmt-rk-isp1-stat-3a>` as the
110 rkisp1_params - Parameters Video Node
111 -------------------------------------
112 The rkisp1_params video node receives a set of parameters from userspace
122 :ref:`V4L2_META_FMT_RK_ISP1_PARAMS <v4l2-meta-fmt-rk-isp1-params>` as the
127 :ref:`V4L2_META_FMT_RK_ISP1_EXT_PARAMS <v4l2-meta-fmt-rk-isp1-ext-params>` as
133 In the following example, the sensor connected to pad 0 of 'rkisp1_isp' is
137 node with dimension 900x800 planar format YUV 4:2:2. It uses all cropping
140 .. code-block:: bash
143 	"media-ctl" "-d" "platform:rkisp1" "-r"
144 	"media-ctl" "-d" "platform:rkisp1" "-l" "'imx219 4-0010':0 -> 'rkisp1_isp':0 [1]"
145 	"media-ctl" "-d" "platform:rkisp1" "-l" "'rkisp1_isp':2 -> 'rkisp1_resizer_selfpath':0 [1]"
146 	"media-ctl" "-d" "platform:rkisp1" "-l" "'rkisp1_isp':2 -> 'rkisp1_resizer_mainpath':0 [0]"
148 	# set format for imx219 4-0010:0
149 	"media-ctl" "-d" "platform:rkisp1" "--set-v4l2" '"imx219 4-0010":0 [fmt:SRGGB10_1X10/1640x1232]'
152 …"media-ctl" "-d" "platform:rkisp1" "--set-v4l2" '"rkisp1_isp":0 [fmt:SRGGB10_1X10/1640x1232 crop: …
153 …"media-ctl" "-d" "platform:rkisp1" "--set-v4l2" '"rkisp1_isp":2 [fmt:YUYV8_2X8/1600x1200 crop: (0,…
156 …"media-ctl" "-d" "platform:rkisp1" "--set-v4l2" '"rkisp1_resizer_selfpath":0 [fmt:YUYV8_2X8/1500x1…
157 …"media-ctl" "-d" "platform:rkisp1" "--set-v4l2" '"rkisp1_resizer_selfpath":1 [fmt:YUYV8_2X8/900x80…
160 	"v4l2-ctl" "-z" "platform:rkisp1" "-d" "rkisp1_selfpath" "-v" "width=900,height=800,"
161 	"v4l2-ctl" "-z" "platform:rkisp1" "-d" "rkisp1_selfpath" "-v" "pixelformat=422P"
164 	v4l2-ctl "-z" "platform:rkisp1" "-d" "rkisp1_selfpath" "--stream-mmap" "--stream-count" "10"
167 In the above example the sensor is configured to bayer format:
169 same mbus format and dimensions as the sensor, otherwise streaming will fail
186 Note that the above example does not uses the stats-params control loop.