summaryrefslogtreecommitdiff
path: root/core/java/android/os/PowerManager.java
diff options
context:
space:
mode:
authorRobert Horvath <robhor@google.com>2021-02-02 13:55:57 +0100
committerRobert Horvath <robhor@google.com>2021-02-02 16:57:47 +0100
commitddb768648ffea9614b96eaaaac4b10f294d63569 (patch)
tree1a54ef1abc10e66e721ec0f058aba34a217450f2 /core/java/android/os/PowerManager.java
parentd8343be5ac67d80d8dcaf294d38cdb21ea5fcd6d (diff)
Document behaviour of "quiescent" reboot reason
On Android TV, adding ",quiescent" to the reboot reason performs a quiescent boot, during which the screen stays off. Bug: 178802099 Test: Still compiles Change-Id: Ib593ba863a718f869bbd04ff24593d0e0a384d99
Diffstat (limited to 'core/java/android/os/PowerManager.java')
-rw-r--r--core/java/android/os/PowerManager.java6
1 files changed, 6 insertions, 0 deletions
diff --git a/core/java/android/os/PowerManager.java b/core/java/android/os/PowerManager.java
index 059e932a9da9..eb4ed3564536 100644
--- a/core/java/android/os/PowerManager.java
+++ b/core/java/android/os/PowerManager.java
@@ -1629,6 +1629,12 @@ public final class PowerManager {
* <p>
* Requires the {@link android.Manifest.permission#REBOOT} permission.
* </p>
+ * <p>
+ * If the {@code reason} string contains ",quiescent", then the screen stays off during reboot
+ * and is not turned on again until the user triggers the device to wake up (for example,
+ * by pressing the power key).
+ * This behavior applies to Android TV devices launched on Android 11 (API level 30) or higher.
+ * </p>
*
* @param reason code to pass to the kernel (e.g., "recovery") to
* request special boot modes, or null.