Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

devicetree: bindings: Update qcom,saw2 node bindings

Update qcom,saw2 node bindings with compatible strings to identify nodes
that provides cpuidle functionality for a particular SoC. Remove
unused compatible strings.

Update examples for different SAW nodes.

Signed-off-by: Lina Iyer <lina.iyer@linaro.org>
Signed-off-by: Kumar Gala <galak@codeaurora.org>
Signed-off-by: Olof Johansson <olof@lixom.net>

authored by

Lina Iyer and committed by
Olof Johansson
005c5dc9 83bd1479

+31 -9
+31 -9
Documentation/devicetree/bindings/arm/msm/qcom,saw2.txt
··· 2 2 3 3 The SAW2 is a wrapper around the Subsystem Power Manager (SPM) and the 4 4 Adaptive Voltage Scaling (AVS) hardware. The SPM is a programmable 5 - micro-controller that transitions a piece of hardware (like a processor or 5 + power-controller that transitions a piece of hardware (like a processor or 6 6 subsystem) into and out of low power modes via a direct connection to 7 7 the PMIC. It can also be wired up to interact with other processors in the 8 8 system, notifying them when a low power state is entered or exited. 9 + 10 + Multiple revisions of the SAW hardware are supported using these Device Nodes. 11 + SAW2 revisions differ in the register offset and configuration data. Also, the 12 + same revision of the SAW in different SoCs may have different configuration 13 + data due the the differences in hardware capabilities. Hence the SoC name, the 14 + version of the SAW hardware in that SoC and the distinction between cpu (big 15 + or Little) or cache, may be needed to uniquely identify the SAW register 16 + configuration and initialization data. The compatible string is used to 17 + indicate this parameter. 9 18 10 19 PROPERTIES 11 20 12 21 - compatible: 13 22 Usage: required 14 23 Value type: <string> 15 - Definition: shall contain "qcom,saw2". A more specific value should be 16 - one of: 17 - "qcom,saw2-v1" 18 - "qcom,saw2-v1.1" 19 - "qcom,saw2-v2" 20 - "qcom,saw2-v2.1" 24 + Definition: Must have 25 + "qcom,saw2" 26 + A more specific value could be one of: 27 + "qcom,apq8064-saw2-v1.1-cpu" 28 + "qcom,msm8974-saw2-v2.1-cpu" 29 + "qcom,apq8084-saw2-v2.1-cpu" 21 30 22 31 - reg: 23 32 Usage: required ··· 35 26 the register region. An optional second element specifies 36 27 the base address and size of the alias register region. 37 28 29 + - regulator: 30 + Usage: optional 31 + Value type: boolean 32 + Definition: Indicates that this SPM device acts as a regulator device 33 + device for the core (CPU or Cache) the SPM is attached 34 + to. 38 35 39 - Example: 36 + Example 1: 40 37 41 - regulator@2099000 { 38 + power-controller@2099000 { 42 39 compatible = "qcom,saw2"; 43 40 reg = <0x02099000 0x1000>, <0x02009000 0x1000>; 41 + regulator; 42 + }; 43 + 44 + Example 2: 45 + saw0: power-controller@f9089000 { 46 + compatible = "qcom,apq8084-saw2-v2.1-cpu", "qcom,saw2"; 47 + reg = <0xf9089000 0x1000>, <0xf9009000 0x1000>; 44 48 };