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