ovti,ov02a10.yaml

  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    deprecated: true
 43
 44  dovdd-supply:
 45    description:
 46      Definition of the regulator used as Digital I/O voltage supply.
 47
 48  avdd-supply:
 49    description:
 50      Definition of the regulator used as Analog voltage supply.
 51
 52  dvdd-supply:
 53    description:
 54      Definition of the regulator used as Digital core voltage supply.
 55
 56  powerdown-gpios:
 57    description:
 58      Must be the device tree identifier of the GPIO connected to the
 59      PD_PAD pin. This pin is used to place the OV02A10 into standby mode
 60      or shutdown mode. As the line needs to be high for the powerdown mode
 61      to be active, it should be marked GPIO_ACTIVE_HIGH.
 62    maxItems: 1
 63
 64  reset-gpios:
 65    description:
 66      Must be the device tree identifier of the GPIO connected to the
 67      RST_PD pin. If specified, it will be asserted during driver probe.
 68      As the line needs to be low for the reset to be active, it should be
 69      marked GPIO_ACTIVE_LOW.
 70    maxItems: 1
 71
 72  port:
 73    $ref: /schemas/graph.yaml#/$defs/port-base
 74    additionalProperties: false
 75    description:
 76      Output port node, single endpoint describing the CSI-2 transmitter.
 77
 78    properties:
 79      endpoint:
 80        $ref: /schemas/media/video-interfaces.yaml#
 81        unevaluatedProperties: false
 82
 83        properties:
 84          link-frequencies: true
 85          ovti,mipi-clock-voltage:
 86            $ref: /schemas/types.yaml#/definitions/uint32
 87            description:
 88              Definition of MIPI clock voltage unit. This entry corresponds to
 89              the link speed defined by the 'link-frequencies' property.
 90              If present, the value shall be in the range of 0-4.
 91            default: 4
 92
 93        required:
 94          - link-frequencies
 95
 96    required:
 97      - endpoint
 98
 99required:
100  - compatible
101  - reg
102  - clocks
103  - clock-names
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
131            rotation = <180>;
132
133            dovdd-supply = <&ov02a10_dovdd>;
134            avdd-supply = <&ov02a10_avdd>;
135            dvdd-supply = <&ov02a10_dvdd>;
136
137            port {
138                wcam_out: endpoint {
139                    link-frequencies = /bits/ 64 <390000000>;
140                    ovti,mipi-clock-voltage = <3>;
141                    remote-endpoint = <&mipi_in_wcam>;
142                };
143            };
144        };
145    };
146
147...