mirror of
https://github.com/torvalds/linux.git
synced 2024-12-23 19:31:53 +00:00
e1cd3b361a
The PSCI v0.2+ spec defines standard values for PSCI function IDs. Add a new binding entry so that pre v0.2 implementations can use DT entries for function IDs and v0.2+ implementations use standard entries as defined by the PSCIv0.2 specification. Signed-off-by: Ashwin Chaugule <ashwin.chaugule@linaro.org> Reviewed-by: Mark Rutland <mark.rutland@arm.com> Acked-by: Rob Herring <robh@kernel.org> Acked-by: Catalin Marinas <catalin.marinas@arm.com>
91 lines
2.5 KiB
Plaintext
91 lines
2.5 KiB
Plaintext
* Power State Coordination Interface (PSCI)
|
|
|
|
Firmware implementing the PSCI functions described in ARM document number
|
|
ARM DEN 0022A ("Power State Coordination Interface System Software on ARM
|
|
processors") can be used by Linux to initiate various CPU-centric power
|
|
operations.
|
|
|
|
Issue A of the specification describes functions for CPU suspend, hotplug
|
|
and migration of secure software.
|
|
|
|
Functions are invoked by trapping to the privilege level of the PSCI
|
|
firmware (specified as part of the binding below) and passing arguments
|
|
in a manner similar to that specified by AAPCS:
|
|
|
|
r0 => 32-bit Function ID / return value
|
|
{r1 - r3} => Parameters
|
|
|
|
Note that the immediate field of the trapping instruction must be set
|
|
to #0.
|
|
|
|
|
|
Main node required properties:
|
|
|
|
- compatible : should contain at least one of:
|
|
|
|
* "arm,psci" : for implementations complying to PSCI versions prior to
|
|
0.2. For these cases function IDs must be provided.
|
|
|
|
* "arm,psci-0.2" : for implementations complying to PSCI 0.2. Function
|
|
IDs are not required and should be ignored by an OS with PSCI 0.2
|
|
support, but are permitted to be present for compatibility with
|
|
existing software when "arm,psci" is later in the compatible list.
|
|
|
|
- method : The method of calling the PSCI firmware. Permitted
|
|
values are:
|
|
|
|
"smc" : SMC #0, with the register assignments specified
|
|
in this binding.
|
|
|
|
"hvc" : HVC #0, with the register assignments specified
|
|
in this binding.
|
|
|
|
Main node optional properties:
|
|
|
|
- cpu_suspend : Function ID for CPU_SUSPEND operation
|
|
|
|
- cpu_off : Function ID for CPU_OFF operation
|
|
|
|
- cpu_on : Function ID for CPU_ON operation
|
|
|
|
- migrate : Function ID for MIGRATE operation
|
|
|
|
|
|
Example:
|
|
|
|
Case 1: PSCI v0.1 only.
|
|
|
|
psci {
|
|
compatible = "arm,psci";
|
|
method = "smc";
|
|
cpu_suspend = <0x95c10000>;
|
|
cpu_off = <0x95c10001>;
|
|
cpu_on = <0x95c10002>;
|
|
migrate = <0x95c10003>;
|
|
};
|
|
|
|
|
|
Case 2: PSCI v0.2 only
|
|
|
|
psci {
|
|
compatible = "arm,psci-0.2";
|
|
method = "smc";
|
|
};
|
|
|
|
Case 3: PSCI v0.2 and PSCI v0.1.
|
|
|
|
A DTB may provide IDs for use by kernels without PSCI 0.2 support,
|
|
enabling firmware and hypervisors to support existing and new kernels.
|
|
These IDs will be ignored by kernels with PSCI 0.2 support, which will
|
|
use the standard PSCI 0.2 IDs exclusively.
|
|
|
|
psci {
|
|
compatible = "arm,psci-0.2", "arm,psci";
|
|
method = "hvc";
|
|
|
|
cpu_on = < arbitrary value >;
|
|
cpu_off = < arbitrary value >;
|
|
|
|
...
|
|
};
|