tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
media: admin-guide: Add starfive_camss.rst for Starfive Camera Subsystem
Add starfive_camss.rst file that documents the Starfive Camera
Subsystem driver which is used for handing image sensor data.
Signed-off-by: Jack Zhu <jack.zhu@starfivetech.com>
Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
authored by
Jack Zhu
and committed by
Hans Verkuil
f72f8055
f5502cd2
+86
+72
Documentation/admin-guide/media/starfive_camss.rst
+72
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.
+12
Documentation/admin-guide/media/starfive_camss_graph.dot
+12
Documentation/admin-guide/media/starfive_camss_graph.dot
···
1
+
digraph board {
2
+
rankdir=TB
3
+
n00000001 [label="{{<port0> 0} | stf_isp\n/dev/v4l-subdev0 | {<port1> 1}}", shape=Mrecord, style=filled, fillcolor=green]
4
+
n00000001:port1 -> n00000008 [style=dashed]
5
+
n00000004 [label="capture_raw\n/dev/video0", shape=box, style=filled, fillcolor=yellow]
6
+
n00000008 [label="capture_yuv\n/dev/video1", shape=box, style=filled, fillcolor=yellow]
7
+
n0000000e [label="{{<port0> 0} | cdns_csi2rx.19800000.csi-bridge\n | {<port1> 1 | <port2> 2 | <port3> 3 | <port4> 4}}", shape=Mrecord, style=filled, fillcolor=green]
8
+
n0000000e:port1 -> n00000001:port0 [style=dashed]
9
+
n0000000e:port1 -> n00000004 [style=dashed]
10
+
n00000018 [label="{{} | imx219 6-0010\n/dev/v4l-subdev1 | {<port0> 0}}", shape=Mrecord, style=filled, fillcolor=green]
11
+
n00000018:port0 -> n0000000e:port0 [style=bold]
12
+
}
+1
Documentation/admin-guide/media/v4l-drivers.rst
+1
Documentation/admin-guide/media/v4l-drivers.rst
+1
MAINTAINERS
+1
MAINTAINERS
···
20643
20643
M: Changhuang Liang <changhuang.liang@starfivetech.com>
20644
20644
L: linux-media@vger.kernel.org
20645
20645
S: Maintained
20646
+
F: Documentation/admin-guide/media/starfive_camss.rst
20646
20647
F: Documentation/devicetree/bindings/media/starfive,jh7110-camss.yaml
20647
20648
20648
20649
STARFIVE CRYPTO DRIVER