[PATCH 3/4] dt-bindings: clock: ipq9650-apss-clk: Add IPQ9650 apss clock controller

From: Kathiravan Thirumoorthy

Date: Wed Oct 07 2026 - 02:52:43 EST


The APSS clock controller on IPQ9650 provides the CPU and L3 clocks and
has a register space separate from the GCC. The four Cortex-A55 cores,
the Cortex-A78 core and the L3 are each clocked by their own Zonda PLL,
selected through a glitch-free mux whose parents are XO, GPLL0 and the
corresponding PLL. The L3 needs to be scaled along with the CPUs, so the
controller is also an interconnect provider.

Add the binding, the clock indices for the Cortex-A78 (gold) cluster to
the shared APSS header, and the interconnect IDs for the CPU and L3
nodes.

Signed-off-by: Kathiravan Thirumoorthy <kathiravan.thirumoorthy@xxxxxxxxxxxxxxxx>
---
.../bindings/clock/qcom,ipq9650-apss-clk.yaml | 58 ++++++++++++++++++++++
include/dt-bindings/clock/qcom,apss-ipq.h | 5 ++
include/dt-bindings/interconnect/qcom,ipq9650.h | 4 ++
3 files changed, 67 insertions(+)

diff --git a/Documentation/devicetree/bindings/clock/qcom,ipq9650-apss-clk.yaml b/Documentation/devicetree/bindings/clock/qcom,ipq9650-apss-clk.yaml
new file mode 100644
index 000000000000..6b47183edd56
--- /dev/null
+++ b/Documentation/devicetree/bindings/clock/qcom,ipq9650-apss-clk.yaml
@@ -0,0 +1,58 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/clock/qcom,ipq9650-apss-clk.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Qualcomm APSS IPQ9650 Clock Controller
+
+maintainers:
+ - Kathiravan Thirumoorthy <kathiravan.thirumoorthy@xxxxxxxxxxxxxxxx>
+
+description:
+ The APSS clock controller provides the CPU and L3 clocks on IPQ9650 and
+ has a register space separate from the GCC. The four Cortex-A55 cores,
+ the Cortex-A78 core and the L3 are each clocked by their own Zonda PLL.
+ Each clock is selected through a glitch-free mux (GFM) whose parents are
+ XO, GPLL0 and the corresponding PLL.
+
+properties:
+ compatible:
+ enum:
+ - qcom,ipq9650-apss-clk
+
+ reg:
+ maxItems: 1
+
+ clocks:
+ items:
+ - description: Reference to the XO clock.
+ - description: Reference to the GPLL0 clock.
+
+ '#clock-cells':
+ const: 1
+
+ '#interconnect-cells':
+ const: 1
+
+required:
+ - compatible
+ - reg
+ - clocks
+ - '#clock-cells'
+ - '#interconnect-cells'
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/clock/qcom,ipq9650-gcc.h>
+
+ apss_clk: clock-controller@fa80000 {
+ compatible = "qcom,ipq9650-apss-clk";
+ reg = <0x0fa80000 0x30000>;
+ clocks = <&xo_board>,
+ <&gcc GPLL0>;
+ #clock-cells = <1>;
+ #interconnect-cells = <1>;
+ };
diff --git a/include/dt-bindings/clock/qcom,apss-ipq.h b/include/dt-bindings/clock/qcom,apss-ipq.h
index 0bb41e5efdef..c9b04f2dbb6c 100644
--- a/include/dt-bindings/clock/qcom,apss-ipq.h
+++ b/include/dt-bindings/clock/qcom,apss-ipq.h
@@ -15,4 +15,9 @@
#define L3_CLK_SRC 6
#define L3_CORE_CLK 7

+/* IPQ9650 Gold cluster clock indices */
+#define APSS_GOLD_PLL 8
+#define APSS_GOLD_PLL_POSTDIV 9
+#define APSS_GOLD_CORE_CLK 10
+
#endif
diff --git a/include/dt-bindings/interconnect/qcom,ipq9650.h b/include/dt-bindings/interconnect/qcom,ipq9650.h
index 023a3878cc08..1a77609de832 100644
--- a/include/dt-bindings/interconnect/qcom,ipq9650.h
+++ b/include/dt-bindings/interconnect/qcom,ipq9650.h
@@ -25,4 +25,8 @@
#define MASTER_SNOC_USB 20
#define SLAVE_SNOC_USB 21

+#define MASTER_CPU_SILVER 0
+#define SLAVE_L3 1
+#define MASTER_CPU_GOLD 2
+
#endif /* INTERCONNECT_QCOM_IPQ9650_H */

--
2.34.1