admin-guide/media/ipu6-isys.rst

1 .. SPDX-License-Identifier: GPL-2.0
9 Copyright |copy| 2023--2024 Intel Corporation
15 Input System (MIPI CSI2 receiver) drivers located under
26 Intel IPU6 is made up of two components - Input System (ISYS) and Processing
29 The Input System mainly works as MIPI CSI-2 receiver which receives and
32 There are 2 driver modules - intel-ipu6 and intel-ipu6-isys. intel-ipu6 is an
34 firmware authentication, DMA mapping and IPU-MMU (internal Memory mapping Unit)
36 sub-device interfaces. The IPU6 ISYS driver supports camera sensors connected
37 to the IPU6 ISYS through V4L2 sub-device sensor drivers.
39 .. Note:: See Documentation/driver-api/media/drivers/ipu6.rst for more
45 The Input System driver mainly configures CSI-2 D-PHY, constructs the firmware
48 several V4L2 sub-devices as well as video nodes.
50 .. kernel-figure::  ipu6_isys_graph.svg
57 .. code-block:: none
59    fdp -Gsplines=true -Tsvg < dot > dot.svg
62 -------------------------------
65 CSI2 ports. The supported input formats of ISYS are listed in table below:
69 .. flat-table::
70     :header-rows: 1
72     * - IPU6 ISYS supported input formats
74     * - RGB565, RGB888
76     * - UYVY8, YUYV8
78     * - RAW8, RAW10, RAW12
86 machine, ov01a10 sensor is connected to IPU ISYS CSI-2 port 2, which can
90 media-ctl [#f1]_ and yavta [#f2]_ to transmit frames to IPU6 ISYS.
92 .. code-block:: none
98     # Establish the link for the media devices using media-ctl
99     media-ctl -d $MDEV -l "\"ov01a10 3-0036\":0 -> \"Intel IPU6 CSI2 2\":0[1]"
102     media-ctl -d $MDEV -V "ov01a10:0 [fmt:SBGGR10/1280x800]"
103     media-ctl -d $MDEV -V "Intel IPU6 CSI2 2:0 [fmt:SBGGR10/1280x800]"
104     media-ctl -d $MDEV -V "Intel IPU6 CSI2 2:1 [fmt:SBGGR10/1280x800]"
111 .. code-block:: none
114     export SDEV=$(media-ctl -d $MDEV -e "ov01a10 3-0036")
116     yavta -w 0x009e0903 400 $SDEV
117     yavta -w 0x009e0913 1000 $SDEV
118     yavta -w 0x009e0911 2000 $SDEV
124 .. code-block:: none
126     yavta --data-prefix -u -c10 -n5 -I -s 1280x800 --file=/tmp/frame-#.bin \
127             -f SBGGR10 $(media-ctl -d $MDEV -e "Intel IPU6 ISYS Capture 0")
130 sBGGR10 format. The captured frames are available as /tmp/frame-#.bin files.
135 .. code-block:: none
137     media-ctl -l "\"ov2740 14-0036\":0 -> \"Intel IPU6 CSI2 1\":0[1]"
138     media-ctl -l "\"Intel IPU6 CSI2 1\":1 -> \"Intel IPU6 ISYS Capture 0\":0[1]"
139     media-ctl -l "\"Intel IPU6 CSI2 1\":2 -> \"Intel IPU6 ISYS Capture 1\":0[1]"
142     media-ctl -R "\"Intel IPU6 CSI2 1\" [0/0->1/0[1],0/1->2/1[1]]"
144     media-ctl -V "\"Intel IPU6 CSI2 1\":0/0 [fmt:SGRBG10/1932x1092]"
145     media-ctl -V "\"Intel IPU6 CSI2 1\":0/1 [fmt:GENERIC_8/97x1]"
146     media-ctl -V "\"Intel IPU6 CSI2 1\":1/0 [fmt:SGRBG10/1932x1092]"
147     media-ctl -V "\"Intel IPU6 CSI2 1\":2/1 [fmt:GENERIC_8/97x1]"
149     CAPTURE_DEV=$(media-ctl -e "Intel IPU6 ISYS Capture 0")
150     ./yavta --data-prefix -c100 -n5 -I -s1932x1092 --file=/tmp/frame-#.bin \
151         -f SGRBG10 ${CAPTURE_DEV}
153     CAPTURE_META=$(media-ctl -e "Intel IPU6 ISYS Capture 1")
154     ./yavta --data-prefix -c100 -n5 -I -s97x1 -B meta-capture \
155         --file=/tmp/meta-#.bin -f GENERIC_8 ${CAPTURE_META}
160 .. [#f1] https://git.ideasonboard.org/media-ctl.git