xref: /linux/Documentation/devicetree/bindings/phy/samsung,mipi-video-phy.yaml (revision a6f844da39af8046798ba5cadf92a0c54da80b26) 
1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/phy/samsung,mipi-video-phy.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Samsung S5P/Exynos SoC MIPI CSIS/DSIM DPHY
8
9maintainers:
10  - Krzysztof Kozlowski <krzk@kernel.org>
11  - Marek Szyprowski <m.szyprowski@samsung.com>
12  - Sylwester Nawrocki <s.nawrocki@samsung.com>
13
14description: |
15  For samsung,s5pv210-mipi-video-phy compatible PHYs the second cell in the
16  PHY specifier identifies the PHY and its meaning is as follows::
17    0 - MIPI CSIS 0,
18    1 - MIPI DSIM 0,
19    2 - MIPI CSIS 1,
20    3 - MIPI DSIM 1.
21
22  samsung,exynos5420-mipi-video-phy and samsung,exynos5433-mipi-video-phy
23  support additional fifth PHY::
24    4 - MIPI CSIS 2.
25
26properties:
27  compatible:
28    enum:
29      - samsung,s5pv210-mipi-video-phy
30      - samsung,exynos5420-mipi-video-phy
31      - samsung,exynos5433-mipi-video-phy
32
33  "#phy-cells":
34    const: 1
35
36  syscon:
37    $ref: /schemas/types.yaml#/definitions/phandle
38    description:
39      Phandle to PMU system controller interface, valid only for
40      samsung,s5pv210-mipi-video-phy and samsung,exynos5420-mipi-video-phy.
41
42  samsung,pmu-syscon:
43    $ref: /schemas/types.yaml#/definitions/phandle
44    description:
45      Phandle to PMU system controller interface, valid for
46      samsung,exynos5433-mipi-video-phy.
47
48  samsung,disp-sysreg:
49    $ref: /schemas/types.yaml#/definitions/phandle
50    description:
51      Phandle to DISP system controller interface, valid for
52      samsung,exynos5433-mipi-video-phy.
53
54  samsung,cam0-sysreg:
55    $ref: /schemas/types.yaml#/definitions/phandle
56    description:
57      Phandle to CAM0 system controller interface, valid for
58      samsung,exynos5433-mipi-video-phy.
59
60  samsung,cam1-sysreg:
61    $ref: /schemas/types.yaml#/definitions/phandle
62    description:
63      Phandle to CAM1 system controller interface, valid for
64      samsung,exynos5433-mipi-video-phy.
65
66required:
67  - compatible
68  - "#phy-cells"
69
70allOf:
71  - if:
72      properties:
73        compatible:
74          contains:
75            enum:
76              - samsung,s5pv210-mipi-video-phy
77              - samsung,exynos5420-mipi-video-phy
78    then:
79      properties:
80        samsung,pmu-syscon: false
81        samsung,disp-sysreg: false
82        samsung,cam0-sysreg: false
83        samsung,cam1-sysreg: false
84      required:
85        - syscon
86    else:
87      properties:
88        syscon: false
89      required:
90        - samsung,pmu-syscon
91        - samsung,disp-sysreg
92        - samsung,cam0-sysreg
93        - samsung,cam1-sysreg
94
95additionalProperties: false
96
97examples:
98  - |
99    phy {
100        compatible = "samsung,exynos5433-mipi-video-phy";
101        #phy-cells = <1>;
102        samsung,pmu-syscon = <&pmu_system_controller>;
103        samsung,cam0-sysreg = <&syscon_cam0>;
104        samsung,cam1-sysreg = <&syscon_cam1>;
105        samsung,disp-sysreg = <&syscon_disp>;
106    };
107
108  - |
109    phy {
110        compatible = "samsung,s5pv210-mipi-video-phy";
111        syscon = <&pmu_system_controller>;
112        #phy-cells = <1>;
113    };
114