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     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
  66 required:
  67   - compatible
  68   - "#phy-cells"
  69
  70 allOf:
  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
  95 additionalProperties: false
  96
  97 examples:
  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     };