xref: /freebsd/sys/contrib/device-tree/Bindings/media/samsung,exynos4210-csis.yaml (revision 031beb4e239bfce798af17f5fe8dba8bcaf13d99) 
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 <krzysztof.kozlowski@linaro.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    };
171