ti,cal.yaml

  1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/media/ti,cal.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Texas Instruments DRA72x CAMERA ADAPTATION LAYER (CAL)
  8
  9maintainers:
 10  - Benoit Parrot <bparrot@ti.com>
 11
 12description: |-
 13  The Camera Adaptation Layer (CAL) is a key component for image capture
 14  applications. The capture module provides the system interface and the
 15  processing capability to connect CSI2 image-sensor modules to the
 16  DRA72x device.
 17
 18  CAL supports 2 camera port nodes on MIPI bus.
 19
 20properties:
 21  compatible:
 22    enum:
 23      # for DRA72 controllers
 24      - ti,dra72-cal
 25      # for DRA72 controllers pre ES2.0
 26      - ti,dra72-pre-es2-cal
 27      # for DRA76 controllers
 28      - ti,dra76-cal
 29      # for AM654 controllers
 30      - ti,am654-cal
 31
 32  reg:
 33    minItems: 2
 34    items:
 35      - description: The CAL main register region
 36      - description: The RX Core0 (DPHY0) register region
 37      - description: The RX Core1 (DPHY1) register region
 38
 39  reg-names:
 40    minItems: 2
 41    items:
 42      - const: cal_top
 43      - const: cal_rx_core0
 44      - const: cal_rx_core1
 45
 46  interrupts:
 47    maxItems: 1
 48
 49  ti,camerrx-control:
 50    $ref: /schemas/types.yaml#/definitions/phandle-array
 51    items:
 52      - items:
 53          - description: phandle to device control module
 54          - description: offset to the control_camerarx_core register
 55    description:
 56      phandle to the device control module and offset to the
 57      control_camerarx_core register
 58
 59  clocks:
 60    maxItems: 1
 61
 62  clock-names:
 63    const: fck
 64
 65  power-domains:
 66    description:
 67      List of phandle and PM domain specifier as documented in
 68      Documentation/devicetree/bindings/power/power_domain.txt
 69    maxItems: 1
 70
 71  ports:
 72    $ref: /schemas/graph.yaml#/properties/ports
 73
 74    properties:
 75      port@0:
 76        $ref: /schemas/graph.yaml#/$defs/port-base
 77        unevaluatedProperties: false
 78        description: 'CSI2 Port #0'
 79
 80        properties:
 81          endpoint:
 82            $ref: video-interfaces.yaml#
 83            unevaluatedProperties: false
 84
 85            properties:
 86              clock-lanes:
 87                maxItems: 1
 88
 89              data-lanes:
 90                minItems: 1
 91                maxItems: 4
 92
 93      port@1:
 94        $ref: /schemas/graph.yaml#/$defs/port-base
 95        unevaluatedProperties: false
 96        description: 'CSI2 Port #1'
 97
 98        properties:
 99          endpoint:
100            $ref: video-interfaces.yaml#
101            unevaluatedProperties: false
102
103            properties:
104              clock-lanes:
105                maxItems: 1
106
107              data-lanes:
108                minItems: 1
109                maxItems: 4
110
111    required:
112      - port@0
113
114required:
115  - compatible
116  - reg
117  - reg-names
118  - interrupts
119  - ti,camerrx-control
120
121additionalProperties: false
122
123examples:
124  - |
125    #include <dt-bindings/interrupt-controller/arm-gic.h>
126
127    cal: cal@4845b000 {
128        compatible = "ti,dra72-cal";
129        reg = <0x4845B000 0x400>,
130              <0x4845B800 0x40>,
131              <0x4845B900 0x40>;
132        reg-names = "cal_top",
133                    "cal_rx_core0",
134                    "cal_rx_core1";
135        interrupts = <GIC_SPI 119 IRQ_TYPE_LEVEL_HIGH>;
136        ti,camerrx-control = <&scm_conf 0xE94>;
137
138        ports {
139              #address-cells = <1>;
140              #size-cells = <0>;
141
142              csi2_0: port@0 {
143                    reg = <0>;
144                    csi2_phy0: endpoint {
145                           remote-endpoint = <&csi2_cam0>;
146                           clock-lanes = <0>;
147                           data-lanes = <1 2>;
148                    };
149              };
150        };
151    };
152
153    i2c {
154        clock-frequency = <400000>;
155        #address-cells = <1>;
156        #size-cells = <0>;
157
158        camera-sensor@3c {
159               compatible = "ovti,ov5640";
160               reg = <0x3c>;
161               AVDD-supply = <&reg_2p8v>;
162               DOVDD-supply = <&reg_1p8v>;
163               DVDD-supply = <&reg_1p5v>;
164               clocks = <&clk_ov5640_fixed>;
165               clock-names = "xclk";
166
167               port {
168                    csi2_cam0: endpoint {
169                            remote-endpoint = <&csi2_phy0>;
170                            clock-lanes = <0>;
171                            data-lanes = <1 2>;
172                    };
173               };
174        };
175    };
176
177...