tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2# Copyright (c) 2024 STMicroelectronics SA.
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/media/i2c/st,vd56g3.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: STMicroelectronics VD56G3 Global Shutter Image Sensor
9
10maintainers:
11 - Benjamin Mugnier <benjamin.mugnier@foss.st.com>
12 - Sylvain Petinot <sylvain.petinot@foss.st.com>
13
14description: |-
15 The STMicroelectronics VD56G3 is a 1.5 M pixel global shutter image sensor
16 with an active array size of 1124 x 1364 (portrait orientation). It is
17 programmable through I2C, the address is fixed to 0x10. The sensor output is
18 available via CSI-2, which is configured as either 1 or 2 data lanes. The
19 sensor provides 8 GPIOS that can be used for external LED signal
20 (synchronized with sensor integration periods)
21
22allOf:
23 - $ref: /schemas/media/video-interface-devices.yaml#
24
25properties:
26 compatible:
27 enum:
28 - st,vd56g3
29 - st,vd66gy
30 description:
31 Two variants are availables; VD56G3 is a monochrome sensor while VD66GY
32 is a colour variant.
33
34 reg:
35 maxItems: 1
36
37 clocks:
38 maxItems: 1
39
40 vcore-supply:
41 description: Digital core power supply (1.15V)
42
43 vddio-supply:
44 description: Digital IO power supply (1.8V)
45
46 vana-supply:
47 description: Analog power supply (2.8V)
48
49 reset-gpios:
50 description: Sensor reset active low GPIO (XSHUTDOWN)
51 maxItems: 1
52
53 st,leds:
54 description:
55 List sensor's GPIOs used to control strobe light sources during exposure
56 time. The numbers identify the sensor pin on which the illumination system
57 is connected. GPIOs are active-high.
58 $ref: /schemas/types.yaml#/definitions/uint32-array
59 minItems: 1
60 maxItems: 8
61 items:
62 minimum: 0
63 maximum: 7
64
65 port:
66 $ref: /schemas/graph.yaml#/$defs/port-base
67 additionalProperties: false
68
69 properties:
70 endpoint:
71 $ref: /schemas/media/video-interfaces.yaml#
72 unevaluatedProperties: false
73
74 properties:
75 data-lanes:
76 minItems: 1
77 maxItems: 2
78 items:
79 enum: [1, 2]
80
81 link-frequencies:
82 maxItems: 1
83 items:
84 enum: [402000000, 750000000]
85
86 lane-polarities:
87 minItems: 1
88 maxItems: 3
89 description: Any lane can be inverted or not.
90
91 required:
92 - data-lanes
93 - link-frequencies
94
95required:
96 - compatible
97 - reg
98 - clocks
99 - vcore-supply
100 - vddio-supply
101 - vana-supply
102 - reset-gpios
103 - port
104
105unevaluatedProperties: false
106
107examples:
108 - |
109 #include <dt-bindings/gpio/gpio.h>
110
111 i2c {
112 #address-cells = <1>;
113 #size-cells = <0>;
114
115 camera-sensor@10 {
116 compatible = "st,vd56g3";
117 reg = <0x10>;
118
119 clocks = <&camera_clk_12M>;
120
121 vcore-supply = <&camera_vcore_v1v15>;
122 vddio-supply = <&camera_vddio_v1v8>;
123 vana-supply = <&camera_vana_v2v8>;
124
125 reset-gpios = <&gpio 5 GPIO_ACTIVE_LOW>;
126 st,leds = <6>;
127
128 orientation = <2>;
129 rotation = <0>;
130
131 port {
132 endpoint {
133 data-lanes = <1 2>;
134 link-frequencies = /bits/ 64 <402000000>;
135 remote-endpoint = <&csiphy0_ep>;
136 };
137 };
138 };
139 };