35efa5413f338ae909b27959daee485e052990b5
[openwrt/staging/blocktrron.git] /
1 From f3dbbaa2a6c8ddfc22feac62e1fea6310a4fd659 Mon Sep 17 00:00:00 2001
2 From: Naushir Patuck <naush@raspberrypi.com>
3 Date: Fri, 31 Mar 2023 11:52:25 +0100
4 Subject: [PATCH] dt-bindings: media: i2c: Replace IMX708 sensor
5 binding documentation file
6
7 Replace the existing imx708.yaml file with sony,imx708.yaml that follows
8 the latest devicetree conventions for camera sensors.
9
10 Signed-off-by: Naushir Patuck <naush@raspberrypi.com>
11 ---
12 .../devicetree/bindings/media/i2c/imx708.yaml | 119 ----------------
13 .../bindings/media/i2c/sony,imx708.yaml | 128 ++++++++++++++++++
14 MAINTAINERS | 2 +-
15 3 files changed, 129 insertions(+), 120 deletions(-)
16 delete mode 100644 Documentation/devicetree/bindings/media/i2c/imx708.yaml
17 create mode 100644 Documentation/devicetree/bindings/media/i2c/sony,imx708.yaml
18
19 --- a/Documentation/devicetree/bindings/media/i2c/imx708.yaml
20 +++ /dev/null
21 @@ -1,119 +0,0 @@
22 -# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
23 -%YAML 1.2
24 ----
25 -$id: http://devicetree.org/schemas/media/i2c/imx708.yaml#
26 -$schema: http://devicetree.org/meta-schemas/core.yaml#
27 -
28 -title: Sony 1/2.3-Inch 12Mpixel CMOS Digital Image Sensor
29 -
30 -maintainers:
31 - - Naushir Patuck <naush@raspberypi.com>
32 -
33 -description: |-
34 - The Sony IMX708 is a 1/2.3-inch CMOS active pixel digital image sensor
35 - with an active array size of 4608H x 2592V. It is programmable through
36 - I2C interface. The I2C address is fixed to 0x1A as per sensor data sheet.
37 - Image data is sent through MIPI CSI-2, which is configured as either 2 or
38 - 4 data lanes.
39 -
40 -properties:
41 - compatible:
42 - const: sony,imx708
43 -
44 - reg:
45 - description: I2C device address
46 - maxItems: 1
47 -
48 - clocks:
49 - maxItems: 1
50 -
51 - VDIG-supply:
52 - description:
53 - Digital I/O voltage supply, 1.1 volts
54 -
55 - VANA1-supply:
56 - description:
57 - Analog1 voltage supply, 2.8 volts
58 -
59 - VANA2-supply:
60 - description:
61 - Analog2 voltage supply, 1.8 volts
62 -
63 - VDDL-supply:
64 - description:
65 - Digital core voltage supply, 1.8 volts
66 -
67 - reset-gpios:
68 - description: |-
69 - Reference to the GPIO connected to the xclr pin, if any.
70 - Must be released (set high) after all supplies and INCK are applied.
71 -
72 - # See ../video-interfaces.txt for more details
73 - port:
74 - type: object
75 - properties:
76 - endpoint:
77 - type: object
78 - properties:
79 - data-lanes:
80 - description: |-
81 - The sensor supports either two-lane, or four-lane operation.
82 - For two-lane operation the property must be set to <1 2>.
83 - items:
84 - - const: 1
85 - - const: 2
86 -
87 - clock-noncontinuous:
88 - type: boolean
89 - description: |-
90 - MIPI CSI-2 clock is non-continuous if this property is present,
91 - otherwise it's continuous.
92 -
93 - link-frequencies:
94 - allOf:
95 - - $ref: /schemas/types.yaml#/definitions/uint64-array
96 - description:
97 - Allowed data bus frequencies.
98 -
99 - required:
100 - - link-frequencies
101 -
102 -required:
103 - - compatible
104 - - reg
105 - - clocks
106 - - VANA1-supply
107 - - VANA2-supply
108 - - VDIG-supply
109 - - VDDL-supply
110 - - port
111 -
112 -additionalProperties: false
113 -
114 -examples:
115 - - |
116 - i2c0 {
117 - #address-cells = <1>;
118 - #size-cells = <0>;
119 -
120 - imx708: sensor@1a {
121 - compatible = "sony,imx708";
122 - reg = <0x1a>;
123 - clocks = <&imx708_clk>;
124 - VANA1-supply = <&imx708_vana1>; /* 1.8v */
125 - VANA2-supply = <&imx708_vana2>; /* 2.8v */
126 - VDIG-supply = <&imx708_vdig>; /* 1.1v */
127 - VDDL-supply = <&imx708_vddl>; /* 1.8v */
128 -
129 - port {
130 - imx708_0: endpoint {
131 - remote-endpoint = <&csi1_ep>;
132 - data-lanes = <1 2>;
133 - clock-noncontinuous;
134 - link-frequencies = /bits/ 64 <450000000>;
135 - };
136 - };
137 - };
138 - };
139 -
140 -...
141 --- /dev/null
142 +++ b/Documentation/devicetree/bindings/media/i2c/sony,imx708.yaml
143 @@ -0,0 +1,128 @@
144 +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
145 +%YAML 1.2
146 +---
147 +$id: http://devicetree.org/schemas/media/i2c/sony,imx708.yaml#
148 +$schema: http://devicetree.org/meta-schemas/core.yaml#
149 +
150 +title: Sony 1/2.3-Inch 12Mpixel CMOS Digital Image Sensor
151 +
152 +maintainers:
153 + - Raspberry Pi Kernel Maintenance <kernel-list@raspberrypi.com>
154 +
155 +description: |-
156 + The Sony IMX708 is a 1/2.3-inch CMOS active pixel digital image sensor
157 + with an active array size of 4608H x 2592V. It is programmable through
158 + I2C interface. The I2C address is fixed to 0x1A as per sensor data sheet.
159 + Image data is sent through MIPI CSI-2, which is configured as either 2 or
160 + 4 data lanes.
161 +
162 +properties:
163 + compatible:
164 + const: sony,imx708
165 +
166 + reg:
167 + maxItems: 1
168 +
169 + clocks:
170 + maxItems: 1
171 +
172 + clock-names:
173 + description: Input clock (6 to 27 MHz)
174 + items:
175 + - const: inck
176 +
177 + vdig-supply:
178 + description:
179 + Digital I/O voltage supply, 1.1 volts
180 +
181 + vana1-supply:
182 + description:
183 + Analog1 voltage supply, 2.8 volts
184 +
185 + vana2-supply:
186 + description:
187 + Analog2 voltage supply, 1.8 volts
188 +
189 + vddl-supply:
190 + description:
191 + Digital core voltage supply, 1.8 volts
192 +
193 + reset-gpios:
194 + description: Sensor reset (XCLR) GPIO
195 + maxItems: 1
196 +
197 + port:
198 + $ref: /schemas/graph.yaml#/$defs/port-base
199 + description: |
200 + Video output port
201 +
202 + properties:
203 + endpoint:
204 + $ref: /schemas/media/video-interfaces.yaml#
205 + unevaluatedProperties: false
206 +
207 + properties:
208 + data-lanes:
209 + anyOf:
210 + - items:
211 + - const: 1
212 + - const: 2
213 + - items:
214 + - const: 1
215 + - const: 2
216 + - const: 3
217 + - const: 4
218 +
219 + link-frequencies: true
220 +
221 + required:
222 + - data-lanes
223 + - link-frequencies
224 +
225 + additionalProperties: false
226 +
227 +required:
228 + - compatible
229 + - reg
230 + - clocks
231 + - clock-names
232 + - vdig-supply
233 + - vana1-supply
234 + - vana2-supply
235 + - vddl-supply
236 + - port
237 +
238 +additionalProperties: false
239 +
240 +examples:
241 + - |
242 + #include <dt-bindings/gpio/gpio.h>
243 +
244 + i2c {
245 + #address-cells = <1>;
246 + #size-cells = <0>;
247 +
248 + imx708: camera-sensor@1a {
249 + compatible = "sony,imx708";
250 + reg = <0x1a>;
251 +
252 + clocks = <&clk 90>;
253 + clock-names = "inck";
254 +
255 + vdig-supply = <&camera_vdig>;
256 + vana1-supply = <&camera_vana1>;
257 + vana2-supply = <&camera_vana2>;
258 + vddl-supply = <&camera_vddl>;
259 +
260 + reset-gpios = <&gpio 35 GPIO_ACTIVE_LOW>;
261 +
262 + port {
263 + imx708_ep: endpoint {
264 + data-lanes = <1 2>;
265 + link-frequencies = /bits/ 64 <450000000>;
266 + remote-endpoint = <&csi_ep>;
267 + };
268 + };
269 + };
270 + };
271 +...
272 --- a/MAINTAINERS
273 +++ b/MAINTAINERS
274 @@ -19342,7 +19342,7 @@ M: Raspberry Pi Kernel Maintenance <kern
275 L: linux-media@vger.kernel.org
276 S: Maintained
277 T: git git://linuxtv.org/media_tree.git
278 -F: Documentation/devicetree/bindings/media/i2c/imx708.yaml
279 +F: Documentation/devicetree/bindings/media/i2c/sony,imx708.yaml
280 F: drivers/media/i2c/imx708.c
281
282 SONY MEMORYSTICK SUBSYSTEM