[PATCH 01/10] dt-bindings: clock: gcc-msm8917: Split to separate schema

Barnabás Czémán
2025-02-11T22:38:15Z

From: Daniil Titov <daniilt971@gmail.com>

The Qualcomm MSM8917 Global Clock controller after adding support for new
SoCs has different clock inputs, thus existing qcom,gcc-msm8909.yaml was
not describing it fully. Move the binding to it's own schema file and
document the clocks based on DTS. Add driver contributors as it's
maintainers.

Signed-off-by: Daniil Titov <daniilt971@gmail.com>
Signed-off-by: Barnabás Czémán <barnabas.czeman@mainlining.org>
---
.../bindings/clock/qcom,gcc-msm8909.yaml | 10 ++--
.../bindings/clock/qcom,gcc-msm8917.yaml | 59 ++++++++++++++++++++++
2 files changed, 62 insertions(+), 7 deletions(-)

diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-msm8909.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8909.yaml
index ce1f5a60bd8c9dfe60a791881868337d3e1723df..5a4ff4f78d4e1d9ecdc06ec171f9b126194e3bc4 100644
--- a/Documentation/devicetree/bindings/clock/qcom,gcc-msm8909.yaml
+++ b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8909.yaml
@@ -4,25 +4,21 @@
$id: http://devicetree.org/schemas/clock/qcom,gcc-msm8909.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

-title: Qualcomm Global Clock & Reset Controller on MSM8909, MSM8917 and QM215
+title: Qualcomm Global Clock & Reset Controller on MSM8909

maintainers:
- Stephan Gerhold <stephan@gerhold.net>

description: |
Qualcomm global clock control module provides the clocks, resets and power
- domains on MSM8909, MSM8917 or QM215.
+ domains on MSM8909.

- See also::
- include/dt-bindings/clock/qcom,gcc-msm8909.h
- include/dt-bindings/clock/qcom,gcc-msm8917.h
+ See also:: include/dt-bindings/clock/qcom,gcc-msm8909.h

properties:
compatible:
enum:
- qcom,gcc-msm8909
- - qcom,gcc-msm8917
- - qcom,gcc-qm215

clocks:
items:
diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-msm8917.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8917.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..6e567b2a5153af9bb32958154633d6da5fd1cd50
--- /dev/null
+++ b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8917.yaml
@@ -0,0 +1,59 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/clock/qcom,gcc-msm8917.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Qualcomm Global Clock & Reset Controller on MSM8917 and QM215
+
+maintainers:
+ - Otto Pflüger <otto.pflueger@abscue.de>
+
+description: |
+ Qualcomm global clock control module provides the clocks, resets and power
+ domains on MSM8917 or QM215.
+
+ See also:: include/dt-bindings/clock/qcom,gcc-msm8917.h
+
+properties:
+ compatible:
+ enum:
+ - qcom,gcc-msm8917
+ - qcom,gcc-qm215
+
+ clocks:
+ items:
+ - description: XO source
+ - description: Sleep clock source
+ - description: DSI phy instance 0 dsi clock
+ - description: DSI phy instance 0 byte clock
+
+ clock-names:
+ items:
+ - const: xo
+ - const: sleep_clk
+ - const: dsi0pll
+ - const: dsi0pllbyte
+
+required:
+ - compatible
+ - clocks
+ - clock-names
+
+allOf:
+ - $ref: qcom,gcc.yaml#
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ gcc: clock-controller@1800000 {
+ compatible = "qcom,gcc-msm8917";
+ reg = <0x01800000 0x80000>;
+ #clock-cells = <1>;
+ #reset-cells = <1>;
+ #power-domain-cells = <1>;
+ clocks = <&xo_board>, <&sleep_clk>, <&dsi0_phy 1>, <&dsi0_phy 0>;
+ clock-names = "xo", "sleep_clk", "dsi0pll", "dsi0pllbyte";
+ };
+...

--
2.48.1