Documentation/admin-guide/media/starfive_camss.rst

   1 .. SPDX-License-Identifier: GPL-2.0
   2
   3 .. include:: <isonum.txt>
   4
   5 ================================
   6 Starfive Camera Subsystem driver
   7 ================================
   8
   9 Introduction
  10 ------------
  11
  12 This file documents the driver for the Starfive Camera Subsystem found on
  13 Starfive JH7110 SoC. The driver is located under drivers/staging/media/starfive/
  14 camss.
  15
  16 The driver implements V4L2, Media controller and v4l2_subdev interfaces. Camera
  17 sensor using V4L2 subdev interface in the kernel is supported.
  18
  19 The driver has been successfully used on the Gstreamer 1.18.5 with v4l2src
  20 plugin.
  21
  22
  23 Starfive Camera Subsystem hardware
  24 ----------------------------------
  25
  26 The Starfive Camera Subsystem hardware consists of::
  27
  28                     |\         +---------------+      +-----------+
  29   +----------+      |  \       |               |      |           |
  30   |          |      |   |      |               |      |           |
  31   |   MIPI   |----->|   |----->|      ISP      |----->|           |
  32   |          |      |   |      |               |      |           |
  33   +----------+      |   |      |               |      |  Memory   |
  34                     |MUX|      +---------------+      | Interface |
  35   +----------+      |   |                             |           |
  36   |          |      |   |---------------------------->|           |
  37   | Parallel |----->|   |                             |           |
  38   |          |      |   |                             |           |
  39   +----------+      |  /                              |           |
  40                     |/                                +-----------+
  41
  42 - MIPI: The MIPI interface, receiving data from a MIPI CSI-2 camera sensor.
  43
  44 - Parallel: The parallel interface,  receiving data from a parallel sensor.
  45
  46 - ISP: The ISP, processing raw Bayer data from an image sensor and producing
  47   YUV frames.
  48
  49
  50 Topology
  51 --------
  52
  53 The media controller pipeline graph is as follows:
  54
  55 .. _starfive_camss_graph:
  56
  57 .. kernel-figure:: starfive_camss_graph.dot
  58     :alt:   starfive_camss_graph.dot
  59     :align: center
  60
  61 The driver has 2 video devices:
  62
  63 - capture_raw: The capture device, capturing image data directly from a sensor.
  64 - capture_yuv: The capture device, capturing YUV frame data processed by the
  65   ISP module
  66
  67 The driver has 3 subdevices:
  68
  69 - stf_isp: is responsible for all the isp operations, outputs YUV frames.
  70 - cdns_csi2rx: a CSI-2 bridge supporting up to 4 CSI lanes in input, and 4
  71   different pixel streams in output.
  72 - imx219: an image sensor, image data is sent through MIPI CSI-2.