xref: /freebsd/sys/contrib/device-tree/Bindings/soc/qcom/qcom,spm.yaml (revision 8ddb146abcdf061be9f2c0db7e391697dafad85c)
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,msm8916-saw2-v3.0-cpu
26          - qcom,msm8226-saw2-v2.1-cpu
27          - qcom,msm8974-saw2-v2.1-cpu
28          - qcom,apq8084-saw2-v2.1-cpu
29          - qcom,apq8064-saw2-v1.1-cpu
30      - const: qcom,saw2
31
32  reg:
33    description: Base address and size of the SPM register region
34    maxItems: 1
35
36required:
37  - compatible
38  - reg
39
40additionalProperties: false
41
42examples:
43  - |
44
45    /* Example 1: SoC using SAW2 and kpss-acc-v2 CPUIdle */
46    cpus {
47        #address-cells = <1>;
48        #size-cells = <0>;
49
50        cpu@0 {
51            compatible = "qcom,kryo";
52            device_type = "cpu";
53            enable-method = "qcom,kpss-acc-v2";
54            qcom,saw = <&saw0>;
55            reg = <0x0>;
56            operating-points-v2 = <&cpu_opp_table>;
57        };
58    };
59
60    saw0: power-manager@f9089000 {
61        compatible = "qcom,msm8974-saw2-v2.1-cpu", "qcom,saw2";
62        reg = <0xf9089000 0x1000>;
63    };
64
65  - |
66
67    /*
68     * Example 2: New-gen multi cluster SoC using SAW only for L2;
69     * This does not require any cpuidle driver, nor any cpu phandle.
70     */
71    power-manager@17812000 {
72        compatible = "qcom,msm8998-gold-saw2-v4.1-l2", "qcom,saw2";
73        reg = <0x17812000 0x1000>;
74    };
75
76    power-manager@17912000 {
77        compatible = "qcom,msm8998-silver-saw2-v4.1-l2", "qcom,saw2";
78        reg = <0x17912000 0x1000>;
79    };
80
81...
82