xref: /freebsd/sys/contrib/device-tree/Bindings/media/i2c/ovti,ov02a10.yaml (revision 8d13bc63c0e1d50bc9e47ac1f26329c999bfecf0) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2# Copyright (c) 2020 MediaTek Inc.
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/media/i2c/ovti,ov02a10.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Omnivision OV02A10 CMOS Sensor
9
10maintainers:
11  - Dongchun Zhu <dongchun.zhu@mediatek.com>
12
13description: |-
14  The Omnivision OV02A10 is a low-cost, high performance, 1/5-inch, 2 megapixel
15  image sensor, which is the latest production derived from Omnivision's CMOS
16  image sensor technology. Ihis chip supports high frame rate speeds up to 30fps
17  @ 1600x1200 (UXGA) resolution transferred over a 1-lane MIPI interface. The
18  sensor output is available via CSI-2 serial data output.
19
20allOf:
21  - $ref: /schemas/media/video-interface-devices.yaml#
22
23properties:
24  compatible:
25    const: ovti,ov02a10
26
27  reg:
28    maxItems: 1
29
30  clocks:
31    maxItems: 1
32
33  clock-names:
34    description:
35      External clock for the sensor.
36    items:
37      - const: eclk
38
39  clock-frequency:
40    description:
41      Frequency of the eclk clock in Hz.
42
43  dovdd-supply:
44    description:
45      Definition of the regulator used as Digital I/O voltage supply.
46
47  avdd-supply:
48    description:
49      Definition of the regulator used as Analog voltage supply.
50
51  dvdd-supply:
52    description:
53      Definition of the regulator used as Digital core voltage supply.
54
55  powerdown-gpios:
56    description:
57      Must be the device tree identifier of the GPIO connected to the
58      PD_PAD pin. This pin is used to place the OV02A10 into standby mode
59      or shutdown mode. As the line needs to be high for the powerdown mode
60      to be active, it should be marked GPIO_ACTIVE_HIGH.
61    maxItems: 1
62
63  reset-gpios:
64    description:
65      Must be the device tree identifier of the GPIO connected to the
66      RST_PD pin. If specified, it will be asserted during driver probe.
67      As the line needs to be low for the reset to be active, it should be
68      marked GPIO_ACTIVE_LOW.
69    maxItems: 1
70
71  port:
72    $ref: /schemas/graph.yaml#/$defs/port-base
73    additionalProperties: false
74    description:
75      Output port node, single endpoint describing the CSI-2 transmitter.
76
77    properties:
78      endpoint:
79        $ref: /schemas/media/video-interfaces.yaml#
80        unevaluatedProperties: false
81
82        properties:
83          link-frequencies: true
84          ovti,mipi-clock-voltage:
85            $ref: /schemas/types.yaml#/definitions/uint32
86            description:
87              Definition of MIPI clock voltage unit. This entry corresponds to
88              the link speed defined by the 'link-frequencies' property.
89              If present, the value shall be in the range of 0-4.
90            default: 4
91
92        required:
93          - link-frequencies
94
95    required:
96      - endpoint
97
98required:
99  - compatible
100  - reg
101  - clocks
102  - clock-names
103  - clock-frequency
104  - dovdd-supply
105  - avdd-supply
106  - dvdd-supply
107  - powerdown-gpios
108  - reset-gpios
109  - port
110
111unevaluatedProperties: false
112
113examples:
114  - |
115    #include <dt-bindings/gpio/gpio.h>
116
117    i2c {
118        #address-cells = <1>;
119        #size-cells = <0>;
120
121        ov02a10: camera-sensor@3d {
122            compatible = "ovti,ov02a10";
123            reg = <0x3d>;
124
125            powerdown-gpios = <&pio 107 GPIO_ACTIVE_HIGH>;
126            reset-gpios = <&pio 109 GPIO_ACTIVE_LOW>;
127
128            clocks = <&ov02a10_clk>;
129            clock-names = "eclk";
130            clock-frequency = <24000000>;
131
132            rotation = <180>;
133
134            dovdd-supply = <&ov02a10_dovdd>;
135            avdd-supply = <&ov02a10_avdd>;
136            dvdd-supply = <&ov02a10_dvdd>;
137
138            port {
139                wcam_out: endpoint {
140                    link-frequencies = /bits/ 64 <390000000>;
141                    ovti,mipi-clock-voltage = <3>;
142                    remote-endpoint = <&mipi_in_wcam>;
143                };
144            };
145        };
146    };
147
148...
149