[PATCH 1/3] dt-bindings: power: spacemit: Add power domain controller
From: Yixun Lan
Date: Thu Sep 17 2026 - 22:41:25 EST
Add initial power domain driver support for SpacemiT K1/K3 SoC, The Power
Domain Controller is SoC internal module which is part of APMU (Advanced
Power Management Unit), it is responsible for managing power across multi
power domains, which includes power on/off, isolation, power-on sequence.
Signed-off-by: Yixun Lan <dlan@xxxxxxxxxx>
---
.../bindings/power/spacemit,power-controller.yaml | 43 ++++++++++++++++++++++
include/dt-bindings/power/spacemit,k1-power.h | 14 +++++++
include/dt-bindings/power/spacemit,k3-power.h | 12 ++++++
3 files changed, 69 insertions(+)
diff --git a/Documentation/devicetree/bindings/power/spacemit,power-controller.yaml b/Documentation/devicetree/bindings/power/spacemit,power-controller.yaml
new file mode 100644
index 000000000000..f869285f84da
--- /dev/null
+++ b/Documentation/devicetree/bindings/power/spacemit,power-controller.yaml
@@ -0,0 +1,43 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/power/spacemit,power-controller.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: SpacemiT Power Domains Controller
+
+maintainers:
+ - Yixun Lan <dlan@xxxxxxxxxx>
+
+description: |
+ SpacemiT processors include support for multiple power domains which can be
+ powered on/off by software based on different application scenes to save power.
+
+properties:
+ compatible:
+ enum:
+ - spacemit,k1-power-controller
+ - spacemit,k3-power-controller
+
+ '#power-domain-cells':
+ const: 1
+
+ spacemit,apmu:
+ $ref: /schemas/types.yaml#/definitions/phandle
+ description:
+ A phandle to APMU syscon to control registers for power domain
+
+required:
+ - compatible
+ - '#power-domain-cells'
+ - spacemit,apmu
+
+additionalProperties: false
+
+examples:
+ - |
+ power-controller {
+ compatible = "spacemit,k1-power-controller";
+ spacemit,apmu = <&syscon_apmu>;
+ #power-domain-cells = <1>;
+ };
diff --git a/include/dt-bindings/power/spacemit,k1-power.h b/include/dt-bindings/power/spacemit,k1-power.h
new file mode 100644
index 000000000000..41ef540b5c44
--- /dev/null
+++ b/include/dt-bindings/power/spacemit,k1-power.h
@@ -0,0 +1,14 @@
+/* SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) */
+
+#ifndef _DT_BINDINGS_SPACEMIT_K1_POWER_H_
+#define _DT_BINDINGS_SPACEMIT_K1_POWER_H_
+
+#define K1_PMDOMAIN_VPU 0
+#define K1_PMDOMAIN_GPU 1
+#define K1_PMDOMAIN_LCD 2
+#define K1_PMDOMAIN_ISP 3
+#define K1_PMDOMAIN_AUDIO 4
+#define K1_PMDOMAIN_GNSS 5
+#define K1_PMDOMAIN_HDMI 6
+
+#endif
diff --git a/include/dt-bindings/power/spacemit,k3-power.h b/include/dt-bindings/power/spacemit,k3-power.h
new file mode 100644
index 000000000000..54b39f2f0936
--- /dev/null
+++ b/include/dt-bindings/power/spacemit,k3-power.h
@@ -0,0 +1,12 @@
+// SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+
+#ifndef _DT_BINDINGS_SPACEMIT_K3_POWER_H_
+#define _DT_BINDINGS_SPACEMIT_K3_POWER_H_
+
+#define K3_PMDOMAIN_VPU 0
+#define K3_PMDOMAIN_GPU 1
+#define K3_PMDOMAIN_AUDIO 2
+#define K3_PMDOMAIN_LCD0 3
+#define K3_PMDOMAIN_LCD1 4
+
+#endif
--
2.55.0