Documentation/media/v4l-drivers/imx7.rst

   1 .. SPDX-License-Identifier: GPL-2.0
   2
   3 i.MX7 Video Capture Driver
   4 ==========================
   5
   6 Introduction
   7 ------------
   8
   9 The i.MX7 contrary to the i.MX5/6 family does not contain an Image Processing
  10 Unit (IPU); because of that the capabilities to perform operations or
  11 manipulation of the capture frames are less feature rich.
  12
  13 For image capture the i.MX7 has three units:
  14 - CMOS Sensor Interface (CSI)
  15 - Video Multiplexer
  16 - MIPI CSI-2 Receiver
  17
  18 .. code-block:: none
  19
  20    MIPI Camera Input ---> MIPI CSI-2 --- > |\
  21                                            | \
  22                                            |  \
  23                                            | M |
  24                                            | U | ------>  CSI ---> Capture
  25                                            | X |
  26                                            |  /
  27    Parallel Camera Input ----------------> | /
  28                                            |/
  29
  30 For additional information, please refer to the latest versions of the i.MX7
  31 reference manual [#f1]_.
  32
  33 Entities
  34 --------
  35
  36 imx7-mipi-csi2
  37 --------------
  38
  39 This is the MIPI CSI-2 receiver entity. It has one sink pad to receive the pixel
  40 data from MIPI CSI-2 camera sensor. It has one source pad, corresponding to the
  41 virtual channel 0. This module is compliant to previous version of Samsung
  42 D-phy, and supports two D-PHY Rx Data lanes.
  43
  44 csi_mux
  45 -------
  46
  47 This is the video multiplexer. It has two sink pads to select from either camera
  48 sensor with a parallel interface or from MIPI CSI-2 virtual channel 0.  It has
  49 a single source pad that routes to the CSI.
  50
  51 csi
  52 ---
  53
  54 The CSI enables the chip to connect directly to external CMOS image sensor. CSI
  55 can interface directly with Parallel and MIPI CSI-2 buses. It has 256 x 64 FIFO
  56 to store received image pixel data and embedded DMA controllers to transfer data
  57 from the FIFO through AHB bus.
  58
  59 This entity has one sink pad that receives from the csi_mux entity and a single
  60 source pad that routes video frames directly to memory buffers. This pad is
  61 routed to a capture device node.
  62
  63 Usage Notes
  64 -----------
  65
  66 To aid in configuration and for backward compatibility with V4L2 applications
  67 that access controls only from video device nodes, the capture device interfaces
  68 inherit controls from the active entities in the current pipeline, so controls
  69 can be accessed either directly from the subdev or from the active capture
  70 device interface. For example, the sensor controls are available either from the
  71 sensor subdevs or from the active capture device.
  72
  73 Warp7 with OV2680
  74 -----------------
  75
  76 On this platform an OV2680 MIPI CSI-2 module is connected to the internal MIPI
  77 CSI-2 receiver. The following example configures a video capture pipeline with
  78 an output of 800x600, and BGGR 10 bit bayer format:
  79
  80 .. code-block:: none
  81
  82    # Setup links
  83    media-ctl -l "'ov2680 1-0036':0 -> 'imx7-mipi-csis.0':0[1]"
  84    media-ctl -l "'imx7-mipi-csis.0':1 -> 'csi_mux':1[1]"
  85    media-ctl -l "'csi_mux':2 -> 'csi':0[1]"
  86    media-ctl -l "'csi':1 -> 'csi capture':0[1]"
  87
  88    # Configure pads for pipeline
  89    media-ctl -V "'ov2680 1-0036':0 [fmt:SBGGR10_1X10/800x600 field:none]"
  90    media-ctl -V "'csi_mux':1 [fmt:SBGGR10_1X10/800x600 field:none]"
  91    media-ctl -V "'csi_mux':2 [fmt:SBGGR10_1X10/800x600 field:none]"
  92    media-ctl -V "'imx7-mipi-csis.0':0 [fmt:SBGGR10_1X10/800x600 field:none]"
  93    media-ctl -V "'csi':0 [fmt:SBGGR10_1X10/800x600 field:none]"
  94
  95 After this streaming can start. The v4l2-ctl tool can be used to select any of
  96 the resolutions supported by the sensor.
  97
  98 .. code-block:: none
  99
 100     root@imx7s-warp:~# media-ctl -p
 101     Media controller API version 4.17.0
 102
 103     Media device information
 104     ------------------------
 105     driver          imx-media
 106     model           imx-media
 107     serial
 108     bus info
 109     hw revision     0x0
 110     driver version  4.17.0
 111
 112     Device topology
 113     - entity 1: csi (2 pads, 2 links)
 114                 type V4L2 subdev subtype Unknown flags 0
 115                 device node name /dev/v4l-subdev0
 116             pad0: Sink
 117                     [fmt:SBGGR10_1X10/800x600 field:none]
 118                     <- "csi_mux":2 [ENABLED]
 119             pad1: Source
 120                     [fmt:SBGGR10_1X10/800x600 field:none]
 121                     -> "csi capture":0 [ENABLED]
 122
 123     - entity 4: csi capture (1 pad, 1 link)
 124                 type Node subtype V4L flags 0
 125                 device node name /dev/video0
 126             pad0: Sink
 127                     <- "csi":1 [ENABLED]
 128
 129     - entity 10: csi_mux (3 pads, 2 links)
 130                 type V4L2 subdev subtype Unknown flags 0
 131                 device node name /dev/v4l-subdev1
 132             pad0: Sink
 133                     [fmt:unknown/0x0]
 134             pad1: Sink
 135                     [fmt:unknown/800x600 field:none]
 136                     <- "imx7-mipi-csis.0":1 [ENABLED]
 137             pad2: Source
 138                     [fmt:unknown/800x600 field:none]
 139                     -> "csi":0 [ENABLED]
 140
 141     - entity 14: imx7-mipi-csis.0 (2 pads, 2 links)
 142                 type V4L2 subdev subtype Unknown flags 0
 143                 device node name /dev/v4l-subdev2
 144             pad0: Sink
 145                     [fmt:SBGGR10_1X10/800x600 field:none]
 146                     <- "ov2680 1-0036":0 [ENABLED]
 147             pad1: Source
 148                     [fmt:SBGGR10_1X10/800x600 field:none]
 149                     -> "csi_mux":1 [ENABLED]
 150
 151     - entity 17: ov2680 1-0036 (1 pad, 1 link)
 152                 type V4L2 subdev subtype Sensor flags 0
 153                 device node name /dev/v4l-subdev3
 154             pad0: Source
 155                     [fmt:SBGGR10_1X10/800x600 field:none]
 156                     -> "imx7-mipi-csis.0":0 [ENABLED]
 157
 158
 159 References
 160 ----------
 161
 162 .. [#f1] https://www.nxp.com/docs/en/reference-manual/IMX7SRM.pdf