Documentation/devicetree/bindings/media/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
   7 title: Texas Instruments DRA72x CAMERA ADAPTATION LAYER (CAL)
   8
   9 maintainers:
  10   - Benoit Parrot <bparrot@ti.com>
  11
  12 description: |-
  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
  20 properties:
  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
 114 required:
 115   - compatible
 116   - reg
 117   - reg-names
 118   - interrupts
 119   - ti,camerrx-control
 120
 121 additionalProperties: false
 122
 123 examples:
 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 ...