samsung,exynos4210-csis.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/samsung,exynos4210-csis.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Samsung S5P/Exynos SoC series MIPI CSI-2 receiver (MIPI CSIS)
  8
  9maintainers:
 10  - Krzysztof Kozlowski <krzk@kernel.org>
 11  - Sylwester Nawrocki <s.nawrocki@samsung.com>
 12
 13properties:
 14  compatible:
 15    enum:
 16      - samsung,s5pv210-csis
 17      - samsung,exynos4210-csis
 18      - samsung,exynos4212-csis
 19      - samsung,exynos5250-csis
 20
 21  reg:
 22    maxItems: 1
 23
 24  '#address-cells':
 25    const: 1
 26
 27  '#size-cells':
 28    const: 0
 29
 30  bus-width:
 31    $ref: /schemas/types.yaml#/definitions/uint32
 32    enum: [2, 4]
 33    description:
 34      Number of data lines supported.
 35
 36  clocks:
 37    maxItems: 2
 38
 39  clock-names:
 40    items:
 41      - const: csis
 42      - const: sclk_csis
 43
 44  clock-frequency:
 45    default: 166000000
 46    description:
 47      The IP's main (system bus) clock frequency in Hz.
 48
 49  interrupts:
 50    maxItems: 1
 51
 52  phys:
 53    maxItems: 1
 54
 55  phy-names:
 56    items:
 57      - const: csis
 58
 59  power-domains:
 60    maxItems: 1
 61
 62  vddio-supply:
 63    description: MIPI CSIS I/O and PLL voltage supply (e.g. 1.8V).
 64
 65  vddcore-supply:
 66    description: MIPI CSIS Core voltage supply (e.g. 1.1V).
 67
 68patternProperties:
 69  "^port@[34]$":
 70    $ref: /schemas/graph.yaml#/$defs/port-base
 71    additionalProperties: false
 72    description:
 73      Camera input port.
 74
 75    properties:
 76      reg:
 77        enum: [3, 4]
 78
 79      endpoint:
 80        $ref: video-interfaces.yaml#
 81        unevaluatedProperties: false
 82
 83        properties:
 84          data-lanes:
 85            minItems: 1
 86            maxItems: 4
 87
 88          samsung,csis-hs-settle:
 89            $ref: /schemas/types.yaml#/definitions/uint32
 90            description: Differential receiver (HS-RX) settle time.
 91
 92          samsung,csis-wclk:
 93            type: boolean
 94            description:
 95              CSI-2 wrapper clock selection. If this property is present external clock
 96              from CMU will be used, or the bus clock if it's not specified.
 97
 98        required:
 99          - data-lanes
100
101    required:
102      - reg
103
104required:
105  - compatible
106  - reg
107  - bus-width
108  - clocks
109  - clock-names
110  - interrupts
111  - vddio-supply
112  - vddcore-supply
113
114anyOf:
115  - required:
116      - port@3
117  - required:
118      - port@4
119
120allOf:
121  - if:
122      required:
123        - samsung,isp-wb
124    then:
125      required:
126        - samsung,sysreg
127
128additionalProperties: false
129
130examples:
131  - |
132    #include <dt-bindings/clock/exynos4.h>
133    #include <dt-bindings/interrupt-controller/arm-gic.h>
134
135    csis@11890000 {
136        compatible = "samsung,exynos4210-csis";
137        reg = <0x11890000 0x4000>;
138        clocks = <&clock CLK_CSIS1>,
139                 <&clock CLK_SCLK_CSIS1>;
140        clock-names = "csis", "sclk_csis";
141        assigned-clocks = <&clock CLK_MOUT_CSIS1>,
142                          <&clock CLK_SCLK_CSIS1>;
143        assigned-clock-parents = <&clock CLK_MOUT_MPLL_USER_T>;
144        assigned-clock-rates = <0>, <176000000>;
145
146        interrupts = <GIC_SPI 80 IRQ_TYPE_LEVEL_HIGH>;
147
148        bus-width = <2>;
149        power-domains = <&pd_cam>;
150        phys = <&mipi_phy 2>;
151        phy-names = "csis";
152
153        vddcore-supply = <&ldo8_reg>;
154        vddio-supply = <&ldo10_reg>;
155
156        #address-cells = <1>;
157        #size-cells = <0>;
158
159        /* Camera D (4) MIPI CSI-2 (CSIS1) */
160        port@4 {
161            reg = <4>;
162
163            endpoint {
164                remote-endpoint = <&is_s5k6a3_ep>;
165                data-lanes = <1>;
166                samsung,csis-hs-settle = <18>;
167                samsung,csis-wclk;
168            };
169        };
170    };