Documentation/devicetree/bindings/soc/qcom/qcom,spm.yaml

   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
   7 title: Qualcomm Subsystem Power Manager
   8
   9 maintainers:
  10   - Andy Gross <agross@kernel.org>
  11   - Bjorn Andersson <bjorn.andersson@linaro.org>
  12
  13 description: |
  14   This binding describes the Qualcomm Subsystem Power Manager, used to control
  15   the peripheral logic surrounding the application cores in Qualcomm platforms.
  16
  17 properties:
  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
  40 required:
  41   - compatible
  42   - reg
  43
  44 additionalProperties: false
  45
  46 examples:
  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 ...