dt-bindings: clock: document SM8550 DISPCC clock controller

Document device tree bindings for display clock controller for
Qualcomm SM8550 SoC.

Signed-off-by: Neil Armstrong <neil.armstrong@linaro.org>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Signed-off-by: Bjorn Andersson <andersson@kernel.org>
Link: https://lore.kernel.org/r/20230103-topic-sm8550-upstream-dispcc-v3-1-8a03d348c572@linaro.org

diff --git a/Documentation/devicetree/bindings/clock/qcom,sm8550-dispcc.yaml b/Documentation/devicetree/bindings/clock/qcom,sm8550-dispcc.yaml
new file mode 100644 (file)
index 0000000..ab25f7c
--- /dev/null
+++ b/Documentation/devicetree/bindings/clock/qcom,sm8550-dispcc.yaml
@@ -0,0 +1,105 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/clock/qcom,sm8550-dispcc.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Qualcomm Display Clock & Reset Controller for SM8550
+
+maintainers:
+  - Bjorn Andersson <andersson@kernel.org>
+  - Neil Armstrong <neil.armstrong@linaro.org>
+
+description: |
+  Qualcomm display clock control module provides the clocks, resets and power
+  domains on SM8550.
+
+  See also:: include/dt-bindings/clock/qcom,sm8550-dispcc.h
+
+properties:
+  compatible:
+    enum:
+      - qcom,sm8550-dispcc
+
+  clocks:
+    items:
+      - description: Board XO source
+      - description: Board Always On XO source
+      - description: Display's AHB clock
+      - description: sleep clock
+      - description: Byte clock from DSI PHY0
+      - description: Pixel clock from DSI PHY0
+      - description: Byte clock from DSI PHY1
+      - description: Pixel clock from DSI PHY1
+      - description: Link clock from DP PHY0
+      - description: VCO DIV clock from DP PHY0
+      - description: Link clock from DP PHY1
+      - description: VCO DIV clock from DP PHY1
+      - description: Link clock from DP PHY2
+      - description: VCO DIV clock from DP PHY2
+      - description: Link clock from DP PHY3
+      - description: VCO DIV clock from DP PHY3
+
+  '#clock-cells':
+    const: 1
+
+  '#reset-cells':
+    const: 1
+
+  '#power-domain-cells':
+    const: 1
+
+  reg:
+    maxItems: 1
+
+  power-domains:
+    description:
+      A phandle and PM domain specifier for the MMCX power domain.
+    maxItems: 1
+
+  required-opps:
+    description:
+      A phandle to an OPP node describing required MMCX performance point.
+    maxItems: 1
+
+required:
+  - compatible
+  - reg
+  - clocks
+  - '#clock-cells'
+  - '#reset-cells'
+  - '#power-domain-cells'
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/clock/qcom,sm8550-gcc.h>
+    #include <dt-bindings/clock/qcom,rpmh.h>
+    #include <dt-bindings/power/qcom-rpmpd.h>
+    clock-controller@af00000 {
+      compatible = "qcom,sm8550-dispcc";
+      reg = <0x0af00000 0x10000>;
+      clocks = <&rpmhcc RPMH_CXO_CLK>,
+               <&rpmhcc RPMH_CXO_CLK_A>,
+               <&gcc GCC_DISP_AHB_CLK>,
+               <&sleep_clk>,
+               <&dsi0_phy 0>,
+               <&dsi0_phy 1>,
+               <&dsi1_phy 0>,
+               <&dsi1_phy 1>,
+               <&dp0_phy 0>,
+               <&dp0_phy 1>,
+               <&dp1_phy 0>,
+               <&dp1_phy 1>,
+               <&dp2_phy 0>,
+               <&dp2_phy 1>,
+               <&dp3_phy 0>,
+               <&dp3_phy 1>;
+      #clock-cells = <1>;
+      #reset-cells = <1>;
+      #power-domain-cells = <1>;
+      power-domains = <&rpmhpd SM8550_MMCX>;
+      required-opps = <&rpmhpd_opp_low_svs>;
+    };
+...

diff --git a/include/dt-bindings/clock/qcom,sm8550-dispcc.h b/include/dt-bindings/clock/qcom,sm8550-dispcc.h
new file mode 100644 (file)
index 0000000..ed3094c
--- /dev/null
+++ b/include/dt-bindings/clock/qcom,sm8550-dispcc.h
@@ -0,0 +1,101 @@
+/* SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) */
+/*
+ * Copyright (c) 2022, The Linux Foundation. All rights reserved.
+ */
+
+#ifndef _DT_BINDINGS_CLK_QCOM_SM8550_DISP_CC_H
+#define _DT_BINDINGS_CLK_QCOM_SM8550_DISP_CC_H
+
+/* DISP_CC clocks */
+#define DISP_CC_MDSS_ACCU_CLK                                  0
+#define DISP_CC_MDSS_AHB1_CLK                                  1
+#define DISP_CC_MDSS_AHB_CLK                                   2
+#define DISP_CC_MDSS_AHB_CLK_SRC                               3
+#define DISP_CC_MDSS_BYTE0_CLK                                 4
+#define DISP_CC_MDSS_BYTE0_CLK_SRC                             5
+#define DISP_CC_MDSS_BYTE0_DIV_CLK_SRC                         6
+#define DISP_CC_MDSS_BYTE0_INTF_CLK                            7
+#define DISP_CC_MDSS_BYTE1_CLK                                 8
+#define DISP_CC_MDSS_BYTE1_CLK_SRC                             9
+#define DISP_CC_MDSS_BYTE1_DIV_CLK_SRC                         10
+#define DISP_CC_MDSS_BYTE1_INTF_CLK                            11
+#define DISP_CC_MDSS_DPTX0_AUX_CLK                             12
+#define DISP_CC_MDSS_DPTX0_AUX_CLK_SRC                         13
+#define DISP_CC_MDSS_DPTX0_CRYPTO_CLK                          14
+#define DISP_CC_MDSS_DPTX0_LINK_CLK                            15
+#define DISP_CC_MDSS_DPTX0_LINK_CLK_SRC                                16
+#define DISP_CC_MDSS_DPTX0_LINK_DIV_CLK_SRC                    17
+#define DISP_CC_MDSS_DPTX0_LINK_INTF_CLK                       18
+#define DISP_CC_MDSS_DPTX0_PIXEL0_CLK                          19
+#define DISP_CC_MDSS_DPTX0_PIXEL0_CLK_SRC                      20
+#define DISP_CC_MDSS_DPTX0_PIXEL1_CLK                          21
+#define DISP_CC_MDSS_DPTX0_PIXEL1_CLK_SRC                      22
+#define DISP_CC_MDSS_DPTX0_USB_ROUTER_LINK_INTF_CLK            23
+#define DISP_CC_MDSS_DPTX1_AUX_CLK                             24
+#define DISP_CC_MDSS_DPTX1_AUX_CLK_SRC                         25
+#define DISP_CC_MDSS_DPTX1_CRYPTO_CLK                          26
+#define DISP_CC_MDSS_DPTX1_LINK_CLK                            27
+#define DISP_CC_MDSS_DPTX1_LINK_CLK_SRC                                28
+#define DISP_CC_MDSS_DPTX1_LINK_DIV_CLK_SRC                    29
+#define DISP_CC_MDSS_DPTX1_LINK_INTF_CLK                       30
+#define DISP_CC_MDSS_DPTX1_PIXEL0_CLK                          31
+#define DISP_CC_MDSS_DPTX1_PIXEL0_CLK_SRC                      32
+#define DISP_CC_MDSS_DPTX1_PIXEL1_CLK                          33
+#define DISP_CC_MDSS_DPTX1_PIXEL1_CLK_SRC                      34
+#define DISP_CC_MDSS_DPTX1_USB_ROUTER_LINK_INTF_CLK            35
+#define DISP_CC_MDSS_DPTX2_AUX_CLK                             36
+#define DISP_CC_MDSS_DPTX2_AUX_CLK_SRC                         37
+#define DISP_CC_MDSS_DPTX2_CRYPTO_CLK                          38
+#define DISP_CC_MDSS_DPTX2_LINK_CLK                            39
+#define DISP_CC_MDSS_DPTX2_LINK_CLK_SRC                                40
+#define DISP_CC_MDSS_DPTX2_LINK_DIV_CLK_SRC                    41
+#define DISP_CC_MDSS_DPTX2_LINK_INTF_CLK                       42
+#define DISP_CC_MDSS_DPTX2_PIXEL0_CLK                          43
+#define DISP_CC_MDSS_DPTX2_PIXEL0_CLK_SRC                      44
+#define DISP_CC_MDSS_DPTX2_PIXEL1_CLK                          45
+#define DISP_CC_MDSS_DPTX2_PIXEL1_CLK_SRC                      46
+#define DISP_CC_MDSS_DPTX3_AUX_CLK                             47
+#define DISP_CC_MDSS_DPTX3_AUX_CLK_SRC                         48
+#define DISP_CC_MDSS_DPTX3_CRYPTO_CLK                          49
+#define DISP_CC_MDSS_DPTX3_LINK_CLK                            50
+#define DISP_CC_MDSS_DPTX3_LINK_CLK_SRC                                51
+#define DISP_CC_MDSS_DPTX3_LINK_DIV_CLK_SRC                    52
+#define DISP_CC_MDSS_DPTX3_LINK_INTF_CLK                       53
+#define DISP_CC_MDSS_DPTX3_PIXEL0_CLK                          54
+#define DISP_CC_MDSS_DPTX3_PIXEL0_CLK_SRC                      55
+#define DISP_CC_MDSS_ESC0_CLK                                  56
+#define DISP_CC_MDSS_ESC0_CLK_SRC                              57
+#define DISP_CC_MDSS_ESC1_CLK                                  58
+#define DISP_CC_MDSS_ESC1_CLK_SRC                              59
+#define DISP_CC_MDSS_MDP1_CLK                                  60
+#define DISP_CC_MDSS_MDP_CLK                                   61
+#define DISP_CC_MDSS_MDP_CLK_SRC                               62
+#define DISP_CC_MDSS_MDP_LUT1_CLK                              63
+#define DISP_CC_MDSS_MDP_LUT_CLK                               64
+#define DISP_CC_MDSS_NON_GDSC_AHB_CLK                          65
+#define DISP_CC_MDSS_PCLK0_CLK                                 66
+#define DISP_CC_MDSS_PCLK0_CLK_SRC                             67
+#define DISP_CC_MDSS_PCLK1_CLK                                 68
+#define DISP_CC_MDSS_PCLK1_CLK_SRC                             69
+#define DISP_CC_MDSS_RSCC_AHB_CLK                              70
+#define DISP_CC_MDSS_RSCC_VSYNC_CLK                            71
+#define DISP_CC_MDSS_VSYNC1_CLK                                        72
+#define DISP_CC_MDSS_VSYNC_CLK                                 73
+#define DISP_CC_MDSS_VSYNC_CLK_SRC                             74
+#define DISP_CC_PLL0                                           75
+#define DISP_CC_PLL1                                           76
+#define DISP_CC_SLEEP_CLK                                      77
+#define DISP_CC_SLEEP_CLK_SRC                                  78
+#define DISP_CC_XO_CLK                                         79
+#define DISP_CC_XO_CLK_SRC                                     80
+
+/* DISP_CC resets */
+#define DISP_CC_MDSS_CORE_BCR                                  0
+#define DISP_CC_MDSS_CORE_INT2_BCR                             1
+#define DISP_CC_MDSS_RSCC_BCR                                  2
+
+/* DISP_CC GDSCR */
+#define MDSS_GDSC                                              0
+#define MDSS_INT2_GDSC                                         1
+
+#endif