Documentation/devicetree/bindings/display/msm/mdp5.txt

   1 Qualcomm adreno/snapdragon MDP5 display controller
   2
   3 Description:
   4
   5 This is the bindings documentation for the Mobile Display Subsytem(MDSS) that
   6 encapsulates sub-blocks like MDP5, DSI, HDMI, eDP etc, and the MDP5 display
   7 controller found in SoCs like MSM8974, APQ8084, MSM8916, MSM8994 and MSM8996.
   8
   9 MDSS:
  10 Required properties:
  11 - compatible:
  12   * "qcom,mdss" - MDSS
  13 - reg: Physical base address and length of the controller's registers.
  14 - reg-names: The names of register regions. The following regions are required:
  15   * "mdss_phys"
  16   * "vbif_phys"
  17 - interrupts: The interrupt signal from MDSS.
  18 - interrupt-controller: identifies the node as an interrupt controller.
  19 - #interrupt-cells: specifies the number of cells needed to encode an interrupt
  20   source, should be 1.
  21 - power-domains: a power domain consumer specifier according to
  22   Documentation/devicetree/bindings/power/power_domain.txt
  23 - clocks: device clocks. See ../clocks/clock-bindings.txt for details.
  24 - clock-names: the following clocks are required.
  25   * "iface"
  26   * "bus"
  27   * "vsync"
  28 - #address-cells: number of address cells for the MDSS children. Should be 1.
  29 - #size-cells: Should be 1.
  30 - ranges: parent bus address space is the same as the child bus address space.
  31
  32 Optional properties:
  33 - clock-names: the following clocks are optional:
  34   * "lut"
  35
  36 MDP5:
  37 Required properties:
  38 - compatible:
  39   * "qcom,mdp5" - MDP5
  40 - reg: Physical base address and length of the controller's registers.
  41 - reg-names: The names of register regions. The following regions are required:
  42   * "mdp_phys"
  43 - interrupts: Interrupt line from MDP5 to MDSS interrupt controller.
  44 - interrupt-parent: phandle to the MDSS block
  45   through MDP block
  46 - clocks: device clocks. See ../clocks/clock-bindings.txt for details.
  47 - clock-names: the following clocks are required.
  48 -   * "bus"
  49 -   * "iface"
  50 -   * "core"
  51 -   * "vsync"
  52 - ports: contains the list of output ports from MDP. These connect to interfaces
  53   that are external to the MDP hardware, such as HDMI, DSI, EDP etc (LVDS is a
  54   special case since it is a part of the MDP block itself).
  55
  56   Each output port contains an endpoint that describes how it is connected to an
  57   external interface. These are described by the standard properties documented
  58   here:
  59         Documentation/devicetree/bindings/graph.txt
  60         Documentation/devicetree/bindings/media/video-interfaces.txt
  61
  62   The availability of output ports can vary across SoC revisions:
  63
  64   For MSM8974 and APQ8084:
  65          Port 0 -> MDP_INTF0 (eDP)
  66          Port 1 -> MDP_INTF1 (DSI1)
  67          Port 2 -> MDP_INTF2 (DSI2)
  68          Port 3 -> MDP_INTF3 (HDMI)
  69
  70   For MSM8916:
  71          Port 0 -> MDP_INTF1 (DSI1)
  72
  73   For MSM8994 and MSM8996:
  74          Port 0 -> MDP_INTF1 (DSI1)
  75          Port 1 -> MDP_INTF2 (DSI2)
  76          Port 2 -> MDP_INTF3 (HDMI)
  77
  78 Optional properties:
  79 - clock-names: the following clocks are optional:
  80   * "lut"
  81
  82 Example:
  83
  84 / {
  85         ...
  86
  87         mdss: mdss@1a00000 {
  88                 compatible = "qcom,mdss";
  89                 reg = <0x1a00000 0x1000>,
  90                       <0x1ac8000 0x3000>;
  91                 reg-names = "mdss_phys", "vbif_phys";
  92
  93                 power-domains = <&gcc MDSS_GDSC>;
  94
  95                 clocks = <&gcc GCC_MDSS_AHB_CLK>,
  96                          <&gcc GCC_MDSS_AXI_CLK>,
  97                          <&gcc GCC_MDSS_VSYNC_CLK>;
  98                 clock-names = "iface",
  99                               "bus",
 100                               "vsync"
 101
 102                 interrupts = <0 72 0>;
 103
 104                 interrupt-controller;
 105                 #interrupt-cells = <1>;
 106
 107                 #address-cells = <1>;
 108                 #size-cells = <1>;
 109                 ranges;
 110
 111                 mdp: mdp@1a01000 {
 112                         compatible = "qcom,mdp5";
 113                         reg = <0x1a01000 0x90000>;
 114                         reg-names = "mdp_phys";
 115
 116                         interrupt-parent = <&mdss>;
 117                         interrupts = <0 0>;
 118
 119                         clocks = <&gcc GCC_MDSS_AHB_CLK>,
 120                                  <&gcc GCC_MDSS_AXI_CLK>,
 121                                  <&gcc GCC_MDSS_MDP_CLK>,
 122                                  <&gcc GCC_MDSS_VSYNC_CLK>;
 123                         clock-names = "iface",
 124                                       "bus",
 125                                       "core",
 126                                       "vsync";
 127
 128                         ports {
 129                                 #address-cells = <1>;
 130                                 #size-cells = <0>;
 131
 132                                 port@0 {
 133                                         reg = <0>;
 134                                         mdp5_intf1_out: endpoint {
 135                                                 remote-endpoint = <&dsi0_in>;
 136                                         };
 137                                 };
 138                         };
 139                 };
 140
 141                 dsi0: dsi@1a98000 {
 142                         ...
 143                         ports {
 144                                 ...
 145                                 port@0 {
 146                                         reg = <0>;
 147                                         dsi0_in: endpoint {
 148                                                 remote-endpoint = <&mdp5_intf1_out>;
 149                                         };
 150                                 };
 151                                 ...
 152                         };
 153                         ...
 154                 };
 155
 156                 dsi_phy0: dsi-phy@1a98300 {
 157                         ...
 158                 };
 159         };
 160 };