diff mbox series

[108/110] doc: Document OPAL_CONFIG_CPU_IDLE_STATE

Message ID 20190531061351.22973-109-stewart@linux.ibm.com
State Accepted
Headers show
Series Big documentation cleanup/expansion | expand

Checks

Context Check Description
snowpatch_ozlabs/apply_patch success Successfully applied on branch master (76f7316bc8fc8a18fdbfcbc0e1fe1bb992d2a7d7)
snowpatch_ozlabs/snowpatch_job_snowpatch-skiboot fail Test snowpatch/job/snowpatch-skiboot on branch master
snowpatch_ozlabs/snowpatch_job_snowpatch-skiboot-dco success Signed-off-by present

Commit Message

Stewart Smith May 31, 2019, 6:13 a.m. UTC 
Signed-off-by: Stewart Smith <stewart@linux.ibm.com>
---
 .../opal-config-cpu-idle-state-99.rst         | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 doc/opal-api/opal-config-cpu-idle-state-99.rst
diff mbox series

Patch

diff --git a/doc/opal-api/opal-config-cpu-idle-state-99.rst b/doc/opal-api/opal-config-cpu-idle-state-99.rst
new file mode 100644
index 000000000000..787d2cae9067
--- /dev/null
+++ b/doc/opal-api/opal-config-cpu-idle-state-99.rst
@@ -0,0 +1,32 @@ 
+.. _OPAL_CONFIG_CPU_IDLE_STATE:
+
+OPAL_CONFIG_CPU_IDLE_STATE
+==========================
+
+.. code-block:: c
+
+   #define OPAL_CONFIG_CPU_IDLE_STATE		99
+
+   /*
+    * Setup and cleanup method for fast-sleep workarounds
+    * state = 1 fast-sleep
+    * enter = 1 Enter state
+    * exit  = 0 Exit state
+    */
+
+   #define OPAL_PM_SLEEP_ENABLED_ER1	0x00080000 /* with workaround */
+
+   int64_t opal_config_cpu_idle_state(uint64_t state, uint64_t enter);
+
+If the `OPAL_PM_SLEEP_ENABLED_ER1` bit is set on a stop state, then this OPAL
+call needs to be made upon entry and exit of stop state.
+This is currently needed for the `fastsleep_` idle state, present on POWER8
+systems.
+
+Returns
+-------
+
+:ref:`OPAL_SUCCESS`
+     Applied workaround
+:ref:`OPAL_PARAMETER`
+     Invalid state or enter/exit.