mipi-ccs.yaml

  1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2# Copyright (C) 2014--2020 Intel Corporation
  3%YAML 1.2
  4---
  5$id: http://devicetree.org/schemas/media/i2c/mipi-ccs.yaml#
  6$schema: http://devicetree.org/meta-schemas/core.yaml#
  7
  8title: MIPI CCS, SMIA++ and SMIA compliant camera sensors
  9
 10maintainers:
 11  - Sakari Ailus <sakari.ailus@linux.intel.com>
 12
 13description:
 14
 15  CCS (Camera Command Set) is a raw Bayer camera sensor standard defined by the
 16  MIPI Alliance; see
 17  <URL:https://www.mipi.org/specifications/camera-command-set>.
 18
 19  SMIA (Standard Mobile Imaging Architecture) is an image sensor standard
 20  defined jointly by Nokia and ST. SMIA++, defined by Nokia, is an extension of
 21  that.
 22
 23  More detailed documentation can be found in
 24  Documentation/devicetree/bindings/media/video-interfaces.txt .
 25
 26allOf:
 27  - $ref: /schemas/media/video-interface-devices.yaml#
 28
 29properties:
 30  compatible:
 31    oneOf:
 32      - items:
 33          - const: mipi-ccs-1.1
 34          - const: mipi-ccs
 35      - items:
 36          - const: mipi-ccs-1.0
 37          - const: mipi-ccs
 38      - const: nokia,smia
 39
 40  reg:
 41    maxItems: 1
 42
 43  vana-supply:
 44    description: Analogue voltage supply (VANA), sensor dependent.
 45
 46  vcore-supply:
 47    description: Core voltage supply (VCore), sensor dependent.
 48
 49  vio-supply:
 50    description: I/O voltage supply (VIO), sensor dependent.
 51
 52  clocks:
 53    description: External clock to the sensor.
 54    maxItems: 1
 55
 56  clock-frequency:
 57    description: Frequency of the external clock to the sensor in Hz.
 58    deprecated: true
 59
 60  reset-gpios:
 61    description: Reset GPIO. Also commonly called XSHUTDOWN in hardware
 62      documentation.
 63    maxItems: 1
 64
 65  flash-leds: true
 66  lens-focus: true
 67
 68  rotation:
 69    enum: [ 0, 180 ]
 70
 71  port:
 72    $ref: /schemas/graph.yaml#/$defs/port-base
 73    additionalProperties: false
 74
 75    properties:
 76      endpoint:
 77        $ref: /schemas/media/video-interfaces.yaml#
 78        unevaluatedProperties: false
 79
 80        properties:
 81          link-frequencies: true
 82          data-lanes: true
 83          bus-type:
 84            enum:
 85              - 1 # CSI-2 C-PHY
 86              - 3 # CCP2
 87              - 4 # CSI-2 D-PHY
 88
 89        required:
 90          - link-frequencies
 91          - data-lanes
 92          - bus-type
 93
 94required:
 95  - compatible
 96  - reg
 97  - clocks
 98
 99additionalProperties: false
100
101examples:
102  - |
103    #include <dt-bindings/gpio/gpio.h>
104    #include <dt-bindings/media/video-interfaces.h>
105
106    i2c {
107        #address-cells = <1>;
108        #size-cells = <0>;
109
110        clock-frequency = <400000>;
111
112        camera-sensor@10 {
113            compatible = "mipi-ccs-1.0", "mipi-ccs";
114            reg = <0x10>;
115            reset-gpios = <&gpio3 20 GPIO_ACTIVE_LOW>;
116            vana-supply = <&vaux3>;
117
118            clocks = <&omap3_isp 0>;
119            assigned-clocks = <&omap3_isp 0>;
120            assigned-clock-rates = <9600000>;
121
122            port {
123                ccs_ep: endpoint {
124                    data-lanes = <1 2>;
125                    remote-endpoint = <&csi2a_ep>;
126                    link-frequencies = /bits/ 64 <199200000 210000000
127                                                  499200000>;
128                    bus-type = <MEDIA_BUS_TYPE_CSI2_DPHY>;
129                };
130            };
131        };
132    };
133...