aboutsummaryrefslogtreecommitdiff
path: root/docs/user-guide.md
diff options
context:
space:
mode:
authorAchin Gupta <achin.gupta@arm.com>2013-11-26 15:34:12 +0000
committerDan Handley <dan.handley@arm.com>2013-12-05 12:28:50 +0000
commitdc98e5370ac81965ebcc322a279b8aad51258d9a (patch)
tree3d7d49582edbfa40745dc6bf9127c09d6833bfb3 /docs/user-guide.md
parent0959db5c99b189a1b04515050ef64348de6a2503 (diff)
downloadarm-trusted-firmware-dc98e5370ac81965ebcc322a279b8aad51258d9a.tar.gz
psci: update docs with status of cpu_suspend api
This patch makes changes to the documents to reflect the current state of play of the psci cpu_suspend function. Change-Id: I086509fb75111b6e9f93b7f6dbcd33cc4591b9f3
Diffstat (limited to 'docs/user-guide.md')
-rw-r--r--docs/user-guide.md32
1 files changed, 24 insertions, 8 deletions
diff --git a/docs/user-guide.md b/docs/user-guide.md
index 476fc00..e7efc40 100644
--- a/docs/user-guide.md
+++ b/docs/user-guide.md
@@ -860,16 +860,32 @@ memory address populated by BL2.
- `PSCI_VERSION`
- `CPU_OFF`
- `CPU_ON`
+ - `CPU_SUSPEND`
- `AFFINITY_INFO`
- The `CPU_ON` and `CPU_OFF` functions implement the warm boot path in ARM
- Trusted Firmware. These are the only functions which have been tested.
- `AFFINITY_INFO` & `PSCI_VERSION` are present but completely untested in
- this version of the software.
-
- Unsupported PSCI functions that can return, return the `NOT_SUPPORTED`
- (`-1`) error code. Other unsupported PSCI functions that don't return,
- signal an assertion failure.
+ The `CPU_ON`, `CPU_OFF` and `CPU_SUSPEND` functions implement the warm boot
+ path in ARM Trusted Firmware. `CPU_ON` and `CPU_OFF` have undergone testing
+ on all the supported FVPs. `CPU_SUSPEND` & `AFFINITY_INFO` have undergone
+ testing only on the AEM v8 Base FVP. Support for `AFFINITY_INFO` is still
+ experimental. Support for `CPU_SUSPEND` is stable for entry into power down
+ states. Standby states are currently not supported. `PSCI_VERSION` is
+ present but completely untested in this version of the software.
+
+ Unsupported PSCI functions can be divided into ones that can return
+ execution to the caller and ones that cannot. The following functions
+ return with a error code as documented in the [Power State Coordination
+ Interface PDD] [PSCI].
+
+ - `MIGRATE` : -1 (NOT_SUPPORTED)
+ - `MIGRATE_INFO_TYPE` : 2 (Trusted OS is either not present or does not
+ require migration)
+ - `MIGRATE_INFO_UP_CPU` : 0 (Return value is UNDEFINED)
+
+ The following unsupported functions do not return and signal an assertion
+ failure if invoked.
+
+ - `SYSTEM_OFF`
+ - `SYSTEM_RESET`
BL3-1 returns the error code `-1` if an SMC is raised for any other runtime
service. This behavior is mandated by the [SMC calling convention PDD]