Documentation/devicetree/bindings/phy/samsung,mipi-video-phy.yaml

   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
   7 title: Samsung S5P/Exynos SoC MIPI CSIS/DSIM DPHY
   8
   9 maintainers:
  10   - Krzysztof Kozlowski <krzk@kernel.org>
  11   - Marek Szyprowski <m.szyprowski@samsung.com>
  12   - Sylwester Nawrocki <s.nawrocki@samsung.com>
  13
  14 description: |
  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
  26 properties:
  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     deprecated: true
  39     description:
  40       Phandle to PMU system controller interface, valid only for
  41       samsung,s5pv210-mipi-video-phy and samsung,exynos5420-mipi-video-phy (if
  42       not a child of PMU).
  43
  44   samsung,pmu-syscon:
  45     $ref: /schemas/types.yaml#/definitions/phandle
  46     deprecated: true
  47     description:
  48       Phandle to PMU system controller interface, valid for
  49       samsung,exynos5433-mipi-video-phy (if not a child of PMU).
  50
  51   samsung,disp-sysreg:
  52     $ref: /schemas/types.yaml#/definitions/phandle
  53     description:
  54       Phandle to DISP system controller interface, valid for
  55       samsung,exynos5433-mipi-video-phy.
  56
  57   samsung,cam0-sysreg:
  58     $ref: /schemas/types.yaml#/definitions/phandle
  59     description:
  60       Phandle to CAM0 system controller interface, valid for
  61       samsung,exynos5433-mipi-video-phy.
  62
  63   samsung,cam1-sysreg:
  64     $ref: /schemas/types.yaml#/definitions/phandle
  65     description:
  66       Phandle to CAM1 system controller interface, valid for
  67       samsung,exynos5433-mipi-video-phy.
  68
  69 required:
  70   - compatible
  71   - "#phy-cells"
  72
  73 allOf:
  74   - if:
  75       properties:
  76         compatible:
  77           contains:
  78             enum:
  79               - samsung,s5pv210-mipi-video-phy
  80               - samsung,exynos5420-mipi-video-phy
  81     then:
  82       properties:
  83         samsung,pmu-syscon: false
  84         samsung,disp-sysreg: false
  85         samsung,cam0-sysreg: false
  86         samsung,cam1-sysreg: false
  87     else:
  88       properties:
  89         syscon: false
  90       required:
  91         - samsung,disp-sysreg
  92         - samsung,cam0-sysreg
  93         - samsung,cam1-sysreg
  94
  95 additionalProperties: false
  96
  97 examples:
  98   - |
  99     phy {
 100         compatible = "samsung,exynos5433-mipi-video-phy";
 101         #phy-cells = <1>;
 102         samsung,cam0-sysreg = <&syscon_cam0>;
 103         samsung,cam1-sysreg = <&syscon_cam1>;
 104         samsung,disp-sysreg = <&syscon_disp>;
 105     };
 106
 107   - |
 108     phy {
 109         compatible = "samsung,s5pv210-mipi-video-phy";
 110         syscon = <&pmu_system_controller>;
 111         #phy-cells = <1>;
 112     };