Documentation/devicetree/bindings/display/samsung/samsung,exynos5433-decon.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/display/samsung/samsung,exynos5433-decon.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Samsung Exynos5433 SoC Display and Enhancement Controller (DECON)
   8
   9 maintainers:
  10   - Inki Dae <inki.dae@samsung.com>
  11   - Seung-Woo Kim <sw0312.kim@samsung.com>
  12   - Kyungmin Park <kyungmin.park@samsung.com>
  13   - Krzysztof Kozlowski <krzk@kernel.org>
  14
  15 description: |
  16   DECON (Display and Enhancement Controller) is the Display Controller for the
  17   Exynos5433 series of SoCs which transfers the image data from a video memory
  18   buffer to an external LCD interface.
  19
  20 properties:
  21   compatible:
  22     enum:
  23       - samsung,exynos5433-decon
  24       - samsung,exynos5433-decon-tv
  25
  26   clocks:
  27     maxItems: 11
  28
  29   clock-names:
  30     items:
  31       - const: pclk
  32       - const: aclk_decon
  33       - const: aclk_smmu_decon0x
  34       - const: aclk_xiu_decon0x
  35       - const: pclk_smmu_decon0x
  36       - const: aclk_smmu_decon1x
  37       - const: aclk_xiu_decon1x
  38       - const: pclk_smmu_decon1x
  39       - const: sclk_decon_vclk
  40       - const: sclk_decon_eclk
  41       - const: dsd
  42
  43   interrupts:
  44     minItems: 3
  45     maxItems: 4
  46     description: |
  47       Interrupts depend on mode of work:
  48        - video mode: vsync
  49        - command mode: lcd_sys
  50        - command mode with software trigger: lcd_sys, te
  51
  52   interrupt-names:
  53     minItems: 3
  54     items:
  55       - const: fifo
  56       - const: vsync
  57       - const: lcd_sys
  58       - const: te
  59
  60   iommus:
  61     maxItems: 2
  62
  63   iommu-names:
  64     items:
  65       - const: m0
  66       - const: m1
  67
  68   ports:
  69     $ref: /schemas/graph.yaml#/properties/ports
  70     description:
  71       Contains a port which is connected to mic node.
  72
  73   power-domains:
  74     maxItems: 1
  75
  76   reg:
  77     maxItems: 1
  78
  79   samsung,disp-sysreg:
  80     $ref: /schemas/types.yaml#/definitions/phandle
  81     description:
  82       Phandle to DISP system controller interface.
  83
  84 required:
  85   - compatible
  86   - clocks
  87   - clock-names
  88   - interrupts
  89   - interrupt-names
  90   - ports
  91   - reg
  92
  93 additionalProperties: false
  94
  95 examples:
  96   - |
  97     #include <dt-bindings/clock/exynos5433.h>
  98     #include <dt-bindings/interrupt-controller/arm-gic.h>
  99
 100     display-controller@13800000 {
 101         compatible = "samsung,exynos5433-decon";
 102         reg = <0x13800000 0x2104>;
 103         clocks = <&cmu_disp CLK_PCLK_DECON>,
 104                  <&cmu_disp CLK_ACLK_DECON>,
 105                  <&cmu_disp CLK_ACLK_SMMU_DECON0X>,
 106                  <&cmu_disp CLK_ACLK_XIU_DECON0X>,
 107                  <&cmu_disp CLK_PCLK_SMMU_DECON0X>,
 108                  <&cmu_disp CLK_ACLK_SMMU_DECON1X>,
 109                  <&cmu_disp CLK_ACLK_XIU_DECON1X>,
 110                  <&cmu_disp CLK_PCLK_SMMU_DECON1X>,
 111                  <&cmu_disp CLK_SCLK_DECON_VCLK>,
 112                  <&cmu_disp CLK_SCLK_DECON_ECLK>,
 113                  <&cmu_disp CLK_SCLK_DSD>;
 114         clock-names = "pclk",
 115                       "aclk_decon",
 116                       "aclk_smmu_decon0x",
 117                       "aclk_xiu_decon0x",
 118                       "pclk_smmu_decon0x",
 119                       "aclk_smmu_decon1x",
 120                       "aclk_xiu_decon1x",
 121                       "pclk_smmu_decon1x",
 122                       "sclk_decon_vclk",
 123                       "sclk_decon_eclk",
 124                       "dsd";
 125         power-domains = <&pd_disp>;
 126         interrupt-names = "fifo", "vsync", "lcd_sys";
 127         interrupts = <GIC_SPI 201 IRQ_TYPE_LEVEL_HIGH>,
 128                      <GIC_SPI 202 IRQ_TYPE_LEVEL_HIGH>,
 129                      <GIC_SPI 203 IRQ_TYPE_LEVEL_HIGH>;
 130         samsung,disp-sysreg = <&syscon_disp>;
 131         iommus = <&sysmmu_decon0x>, <&sysmmu_decon1x>;
 132         iommu-names = "m0", "m1";
 133
 134         ports {
 135             #address-cells = <1>;
 136             #size-cells = <0>;
 137
 138             port@0 {
 139                 reg = <0>;
 140                 decon_to_mic: endpoint {
 141                     remote-endpoint = <&mic_to_decon>;
 142                 };
 143             };
 144         };
 145     };