xref: /freebsd/sys/contrib/device-tree/Bindings/soc/qcom/qcom,spm.yaml (revision ebacd8013fe5f7fdf9f6a5b286f6680dd2891036)
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: "http://devicetree.org/schemas/soc/qcom/qcom,spm.yaml#"
5$schema: "http://devicetree.org/meta-schemas/core.yaml#"
6
7title: Qualcomm Subsystem Power Manager binding
8
9maintainers:
10  - Andy Gross <agross@kernel.org>
11  - Bjorn Andersson <bjorn.andersson@linaro.org>
12
13description: |
14  This binding describes the Qualcomm Subsystem Power Manager, used to control
15  the peripheral logic surrounding the application cores in Qualcomm platforms.
16
17properties:
18  compatible:
19    items:
20      - enum:
21          - qcom,sdm660-gold-saw2-v4.1-l2
22          - qcom,sdm660-silver-saw2-v4.1-l2
23          - qcom,msm8998-gold-saw2-v4.1-l2
24          - qcom,msm8998-silver-saw2-v4.1-l2
25          - qcom,msm8909-saw2-v3.0-cpu
26          - qcom,msm8916-saw2-v3.0-cpu
27          - qcom,msm8226-saw2-v2.1-cpu
28          - qcom,msm8974-saw2-v2.1-cpu
29          - qcom,apq8084-saw2-v2.1-cpu
30          - qcom,apq8064-saw2-v1.1-cpu
31      - const: qcom,saw2
32
33  reg:
34    description: Base address and size of the SPM register region
35    maxItems: 1
36
37required:
38  - compatible
39  - reg
40
41additionalProperties: false
42
43examples:
44  - |
45
46    /* Example 1: SoC using SAW2 and kpss-acc-v2 CPUIdle */
47    cpus {
48        #address-cells = <1>;
49        #size-cells = <0>;
50
51        cpu@0 {
52            compatible = "qcom,kryo";
53            device_type = "cpu";
54            enable-method = "qcom,kpss-acc-v2";
55            qcom,saw = <&saw0>;
56            reg = <0x0>;
57            operating-points-v2 = <&cpu_opp_table>;
58        };
59    };
60
61    saw0: power-manager@f9089000 {
62        compatible = "qcom,msm8974-saw2-v2.1-cpu", "qcom,saw2";
63        reg = <0xf9089000 0x1000>;
64    };
65
66  - |
67
68    /*
69     * Example 2: New-gen multi cluster SoC using SAW only for L2;
70     * This does not require any cpuidle driver, nor any cpu phandle.
71     */
72    power-manager@17812000 {
73        compatible = "qcom,msm8998-gold-saw2-v4.1-l2", "qcom,saw2";
74        reg = <0x17812000 0x1000>;
75    };
76
77    power-manager@17912000 {
78        compatible = "qcom,msm8998-silver-saw2-v4.1-l2", "qcom,saw2";
79        reg = <0x17912000 0x1000>;
80    };
81
82...
83