[PATCH 1/3] dt-bindings: pwm: qcom: add Shikra PWM controller
From: Taniya Das
Date: Mon Nov 16 2026 - 02:08:57 EST
Document the Pulse Width Modulation (PWM) controller on Qualcomm Shikra
SoCs. The controller has a shared enable register, ten independently
addressed frame blocks, and shared AHB and PWM core clocks.
Describe the frame child-node address mapping and the consumer PWM
specifier needed to select each hardware frame.
Signed-off-by: Taniya Das <taniya.das@xxxxxxxxxxxxxxxx>
---
.../devicetree/bindings/pwm/qcom,shikra-pwm.yaml | 127 +++++++++++++++++++++
1 file changed, 127 insertions(+)
diff --git a/Documentation/devicetree/bindings/pwm/qcom,shikra-pwm.yaml b/Documentation/devicetree/bindings/pwm/qcom,shikra-pwm.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..d7f2bdab68f68b822fc93ecabd628ab53d408249
--- /dev/null
+++ b/Documentation/devicetree/bindings/pwm/qcom,shikra-pwm.yaml
@@ -0,0 +1,127 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/pwm/qcom,shikra-pwm.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Qualcomm Shikra PWM controller
+
+maintainers:
+ - Taniya Das <taniya.das@xxxxxxxxxxxxxxxx>
+
+description: |
+ The Qualcomm PWM (Pulse Width Modulation) block on Shikra contains
+ up to 10 independent PWM frame channels. Each frame is a child node of
+ the PWM controller node and owns its own register range. All frames
+ share a single PWM core clock owned by the parent node. Child frame reg
+ properties use the parent SoC address space through an empty identity
+ ranges mapping.
+
+ The PWM source input clock, pwm_core, is given by:
+
+ F_PWM_CLK = 19.2 MHz / N
+
+ where N is an integer from 1 through 512. The output frequency range
+ for a given PWM source clock is:
+
+ f_out(max) = F_PWM_CLK / 2
+ f_out(min) = F_PWM_CLK / 65536
+
+allOf:
+ - $ref: pwm.yaml#
+
+properties:
+ compatible:
+ const: qcom,shikra-pwm
+
+ reg:
+ maxItems: 1
+
+ clocks:
+ items:
+ - description: AHB bus clock for the PWM block.
+ - description: Gate clock shared by every frame (pwm_core).
+
+ clock-names:
+ items:
+ - const: ahb
+ - const: core
+
+ "#pwm-cells":
+ const: 3
+
+ "#address-cells":
+ const: 2
+
+ "#size-cells":
+ const: 2
+
+ ranges: true
+
+patternProperties:
+ "^pwm@[0-9a-f]+$":
+ type: object
+ description: Per-frame PWM channel sub-node.
+
+ properties:
+ reg:
+ maxItems: 1
+ description: This frame's own absolute register range.
+
+ qcom,frame-index:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ description:
+ Hardware frame index within the PWM block. It is the PWM index
+ used in the first cell of a consumer PWM specifier and selects
+ the corresponding enable bit in PWM_TOPCTL0.
+ maximum: 9
+
+ required:
+ - reg
+ - qcom,frame-index
+
+ additionalProperties: false
+
+required:
+ - compatible
+ - reg
+ - clocks
+ - clock-names
+ - "#pwm-cells"
+ - "#address-cells"
+ - "#size-cells"
+ - ranges
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/clock/qcom,shikra-gcc.h>
+
+ / {
+ #address-cells = <2>;
+ #size-cells = <2>;
+
+ pwm: pwm@4700000 {
+ compatible = "qcom,shikra-pwm";
+ reg = <0x0 0x04700000 0x0 0x10>;
+ clocks = <&gcc GCC_PDM_AHB_CLK>, <&gcc GCC_PWM0_XO512_CLK>;
+ clock-names = "ahb", "core";
+ assigned-clocks = <&gcc GCC_PWM0_XO512_CLK>;
+ assigned-clock-rates = <9600000>;
+ #pwm-cells = <3>;
+ #address-cells = <2>;
+ #size-cells = <2>;
+ ranges;
+
+ pwm@4701000 {
+ reg = <0x0 0x04701000 0x0 0x1c>;
+ qcom,frame-index = <0>;
+ };
+
+ pwm@4702000 {
+ reg = <0x0 0x04702000 0x0 0x1c>;
+ qcom,frame-index = <1>;
+ };
+ };
+ };
--
2.34.1