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