# Documentation/devicetree/bindings/soc/qcom/qcom,saw2.yaml -rw-r--r-- 2.4 KiB View raw
                                                                                
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
# SPDX-License-Identifier: GPL-2.0-only
%YAML 1.2
---
$id: "http://devicetree.org/schemas/soc/qcom/qcom,saw2.yaml#"
$schema: "http://devicetree.org/meta-schemas/core.yaml#"

title: Qualcomm SPM AVS Wrapper 2 (SAW2)

maintainers:
  - Bjorn Andersson <bjorn.andersson@linaro.org>

description: |
  The SAW2 is a wrapper around the Subsystem Power Manager (SPM) and the
  Adaptive Voltage Scaling (AVS) hardware. The SPM is a programmable
  power-controller that transitions a piece of hardware (like a processor or
  subsystem) into and out of low power modes via a direct connection to
  the PMIC. It can also be wired up to interact with other processors in the
  system, notifying them when a low power state is entered or exited.

  Multiple revisions of the SAW hardware are supported using these Device Nodes.
  SAW2 revisions differ in the register offset and configuration data. Also, the
  same revision of the SAW in different SoCs may have different configuration
  data due the differences in hardware capabilities. Hence the SoC name, the
  version of the SAW hardware in that SoC and the distinction between cpu (big
  or Little) or cache, may be needed to uniquely identify the SAW register
  configuration and initialization data. The compatible string is used to
  indicate this parameter.

properties:
  compatible:
    oneOf:
      - items:
          - enum:
              - qcom,apq8064-saw2-v1.1-cpu
              - qcom,msm8226-saw2-v2.1-cpu
              - qcom,msm8974-saw2-v2.1-cpu
              - qcom,apq8084-saw2-v2.1-cpu
          - const: qcom,saw2
      - items:
          const: qcom,saw2

  reg:
    minItems: 1
    items:
      - description: register region
      - description: alias register region

  regulator:
    type: boolean
    description: >
      Indicates that this SPM device acts as a regulator device
      device for the core (CPU or Cache) the SPM is attached to.

  '#power-domain-cells':
    const: 0

required:
  - compatible
  - reg

additionalProperties: false

examples:
  - |
    power-controller@2099000 {
        compatible = "qcom,saw2";
        reg = <0x02099000 0x1000>, <0x02009000 0x1000>;
        #power-domain-cells = <0>;
        regulator;
    };
  - |
    saw0: power-controller@f9089000 {
        compatible = "qcom,apq8084-saw2-v2.1-cpu", "qcom,saw2";
        reg = <0xf9089000 0x1000>, <0xf9009000 0x1000>;
        #power-domain-cells = <0>;
    };