Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: media: st,stmipid02: Convert the text bindings to YAML
Convert the text STMIPID02 DT bindings to YAML DT format to permit
validation of DTs using this I2C CSI-2 to CPI bridge.
Reviewed-by: Benjamin Mugnier <benjamin.mugnier@foss.st.com>
Signed-off-by: Marek Vasut <marex@denx.de>
Reviewed-by: Rob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20220929145416.16336-1-marex@denx.de
Signed-off-by: Rob Herring <robh@kernel.org>
authored by
Marek Vasut
and committed by
Rob Herring
c2741cbe
26c9134a
+177
-83
-82
Documentation/devicetree/bindings/media/i2c/st,st-mipid02.txt
-82
Documentation/devicetree/bindings/media/i2c/st,st-mipid02.txt
···
1
-
STMicroelectronics MIPID02 CSI-2 to PARALLEL bridge
2
-
3
-
MIPID02 has two CSI-2 input ports, only one of those ports can be active at a
4
-
time. Active port input stream will be de-serialized and its content outputted
5
-
through PARALLEL output port.
6
-
CSI-2 first input port is a dual lane 800Mbps per lane whereas CSI-2 second
7
-
input port is a single lane 800Mbps. Both ports support clock and data lane
8
-
polarity swap. First port also supports data lane swap.
9
-
PARALLEL output port has a maximum width of 12 bits.
10
-
Supported formats are RAW6, RAW7, RAW8, RAW10, RAW12, RGB565, RGB888, RGB444,
11
-
YUV420 8-bit, YUV422 8-bit and YUV420 10-bit.
12
-
13
-
Required Properties:
14
-
- compatible: shall be "st,st-mipid02"
15
-
- clocks: reference to the xclk input clock.
16
-
- clock-names: shall be "xclk".
17
-
- VDDE-supply: sensor digital IO supply. Must be 1.8 volts.
18
-
- VDDIN-supply: sensor internal regulator supply. Must be 1.8 volts.
19
-
20
-
Optional Properties:
21
-
- reset-gpios: reference to the GPIO connected to the xsdn pin, if any.
22
-
This is an active low signal to the mipid02.
23
-
24
-
Required subnodes:
25
-
- ports: A ports node with one port child node per device input and output
26
-
port, in accordance with the video interface bindings defined in
27
-
Documentation/devicetree/bindings/media/video-interfaces.txt. The
28
-
port nodes are numbered as follows:
29
-
30
-
Port Description
31
-
-----------------------------
32
-
0 CSI-2 first input port
33
-
1 CSI-2 second input port
34
-
2 PARALLEL output
35
-
36
-
Endpoint node required property for CSI-2 connection is:
37
-
- data-lanes: shall be <1> for Port 1. for Port 0 dual-lane operation shall be
38
-
<1 2> or <2 1>. For Port 0 single-lane operation shall be <1> or <2>.
39
-
Endpoint node optional property for CSI-2 connection is:
40
-
- lane-polarities: any lane can be inverted or not.
41
-
42
-
Endpoint node required property for PARALLEL connection is:
43
-
- bus-width: shall be set to <6>, <7>, <8>, <10> or <12>.
44
-
Endpoint node optional properties for PARALLEL connection are:
45
-
- hsync-active: active state of the HSYNC signal, 0/1 for LOW/HIGH respectively.
46
-
LOW being the default.
47
-
- vsync-active: active state of the VSYNC signal, 0/1 for LOW/HIGH respectively.
48
-
LOW being the default.
49
-
50
-
Example:
51
-
52
-
mipid02: csi2rx@14 {
53
-
compatible = "st,st-mipid02";
54
-
reg = <0x14>;
55
-
status = "okay";
56
-
clocks = <&clk_ext_camera_12>;
57
-
clock-names = "xclk";
58
-
VDDE-supply = <&vdd>;
59
-
VDDIN-supply = <&vdd>;
60
-
ports {
61
-
#address-cells = <1>;
62
-
#size-cells = <0>;
63
-
port@0 {
64
-
reg = <0>;
65
-
66
-
ep0: endpoint {
67
-
data-lanes = <1 2>;
68
-
remote-endpoint = <&mipi_csi2_in>;
69
-
};
70
-
};
71
-
port@2 {
72
-
reg = <2>;
73
-
74
-
ep2: endpoint {
75
-
bus-width = <8>;
76
-
hsync-active = <0>;
77
-
vsync-active = <0>;
78
-
remote-endpoint = <¶llel_out>;
79
-
};
80
-
};
81
-
};
82
-
};
+176
Documentation/devicetree/bindings/media/i2c/st,st-mipid02.yaml
+176
Documentation/devicetree/bindings/media/i2c/st,st-mipid02.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/media/i2c/st,st-mipid02.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: STMicroelectronics MIPID02 CSI-2 to PARALLEL bridge
8
+
9
+
maintainers:
10
+
- Benjamin Mugnier <benjamin.mugnier@foss.st.com>
11
+
- Sylvain Petinot <sylvain.petinot@foss.st.com>
12
+
13
+
description:
14
+
MIPID02 has two CSI-2 input ports, only one of those ports can be
15
+
active at a time. Active port input stream will be de-serialized
16
+
and its content outputted through PARALLEL output port.
17
+
CSI-2 first input port is a dual lane 800Mbps per lane whereas CSI-2
18
+
second input port is a single lane 800Mbps. Both ports support clock
19
+
and data lane polarity swap. First port also supports data lane swap.
20
+
PARALLEL output port has a maximum width of 12 bits.
21
+
Supported formats are RAW6, RAW7, RAW8, RAW10, RAW12, RGB565, RGB888,
22
+
RGB444, YUV420 8-bit, YUV422 8-bit and YUV420 10-bit.
23
+
24
+
properties:
25
+
compatible:
26
+
const: st,st-mipid02
27
+
28
+
reg:
29
+
maxItems: 1
30
+
31
+
clocks:
32
+
maxItems: 1
33
+
34
+
clock-names:
35
+
const: xclk
36
+
37
+
VDDE-supply:
38
+
description:
39
+
Sensor digital IO supply. Must be 1.8 volts.
40
+
41
+
VDDIN-supply:
42
+
description:
43
+
Sensor internal regulator supply. Must be 1.8 volts.
44
+
45
+
reset-gpios:
46
+
description:
47
+
Reference to the GPIO connected to the xsdn pin, if any.
48
+
This is an active low signal to the mipid02.
49
+
50
+
ports:
51
+
$ref: /schemas/graph.yaml#/properties/ports
52
+
properties:
53
+
port@0:
54
+
$ref: /schemas/graph.yaml#/$defs/port-base
55
+
unevaluatedProperties: false
56
+
description: CSI-2 first input port
57
+
properties:
58
+
endpoint:
59
+
$ref: /schemas/media/video-interfaces.yaml#
60
+
unevaluatedProperties: false
61
+
62
+
properties:
63
+
data-lanes:
64
+
description:
65
+
Single-lane operation shall be <1> or <2> .
66
+
Dual-lane operation shall be <1 2> or <2 1> .
67
+
minItems: 1
68
+
maxItems: 2
69
+
70
+
lane-polarities:
71
+
description:
72
+
Any lane can be inverted or not.
73
+
minItems: 1
74
+
maxItems: 2
75
+
76
+
required:
77
+
- data-lanes
78
+
79
+
port@1:
80
+
$ref: /schemas/graph.yaml#/$defs/port-base
81
+
unevaluatedProperties: false
82
+
description: CSI-2 second input port
83
+
properties:
84
+
endpoint:
85
+
$ref: /schemas/media/video-interfaces.yaml#
86
+
unevaluatedProperties: false
87
+
88
+
properties:
89
+
data-lanes:
90
+
description:
91
+
Single-lane operation shall be <1> or <2> .
92
+
maxItems: 1
93
+
94
+
lane-polarities:
95
+
description:
96
+
Any lane can be inverted or not.
97
+
maxItems: 1
98
+
99
+
required:
100
+
- data-lanes
101
+
102
+
port@2:
103
+
$ref: /schemas/graph.yaml#/$defs/port-base
104
+
unevaluatedProperties: false
105
+
description: Output port
106
+
properties:
107
+
endpoint:
108
+
$ref: /schemas/media/video-interfaces.yaml#
109
+
unevaluatedProperties: false
110
+
111
+
properties:
112
+
bus-width:
113
+
enum: [6, 7, 8, 10, 12]
114
+
115
+
required:
116
+
- bus-width
117
+
118
+
anyOf:
119
+
- required:
120
+
- port@0
121
+
- required:
122
+
- port@1
123
+
124
+
required:
125
+
- port@2
126
+
127
+
additionalProperties: false
128
+
129
+
required:
130
+
- compatible
131
+
- reg
132
+
- clocks
133
+
- clock-names
134
+
- VDDE-supply
135
+
- VDDIN-supply
136
+
- ports
137
+
138
+
examples:
139
+
- |
140
+
i2c {
141
+
#address-cells = <1>;
142
+
#size-cells = <0>;
143
+
mipid02: csi2rx@14 {
144
+
compatible = "st,st-mipid02";
145
+
reg = <0x14>;
146
+
status = "okay";
147
+
clocks = <&clk_ext_camera_12>;
148
+
clock-names = "xclk";
149
+
VDDE-supply = <&vdd>;
150
+
VDDIN-supply = <&vdd>;
151
+
ports {
152
+
#address-cells = <1>;
153
+
#size-cells = <0>;
154
+
port@0 {
155
+
reg = <0>;
156
+
157
+
ep0: endpoint {
158
+
data-lanes = <1 2>;
159
+
remote-endpoint = <&mipi_csi2_in>;
160
+
};
161
+
};
162
+
port@2 {
163
+
reg = <2>;
164
+
165
+
ep2: endpoint {
166
+
bus-width = <8>;
167
+
hsync-active = <0>;
168
+
vsync-active = <0>;
169
+
remote-endpoint = <¶llel_out>;
170
+
};
171
+
};
172
+
};
173
+
};
174
+
};
175
+
176
+
...
+1
-1
MAINTAINERS
+1
-1
MAINTAINERS
···
19476
19476
L: linux-media@vger.kernel.org
19477
19477
S: Maintained
19478
19478
T: git git://linuxtv.org/media_tree.git
19479
-
F: Documentation/devicetree/bindings/media/i2c/st,st-mipid02.txt
19479
+
F: Documentation/devicetree/bindings/media/i2c/st,st-mipid02.yaml
19480
19480
F: drivers/media/i2c/st-mipid02.c
19481
19481
19482
19482
ST STM32 I2C/SMBUS DRIVER