PowerManagerService.java revision 4590e52f3d0558e01322fe4dd55bb612afdfb079
1413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber/*
2413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber * Copyright (C) 2007 The Android Open Source Project
3413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber *
4413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber * Licensed under the Apache License, Version 2.0 (the "License");
5413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber * you may not use this file except in compliance with the License.
6413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber * You may obtain a copy of the License at
7413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber *
8413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber *      http://www.apache.org/licenses/LICENSE-2.0
9413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber *
10413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber * Unless required by applicable law or agreed to in writing, software
11413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber * distributed under the License is distributed on an "AS IS" BASIS,
12413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber * See the License for the specific language governing permissions and
14413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber * limitations under the License.
15413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber */
16413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
17413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberpackage com.android.server.power;
18413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
191f7d356fa094b975ad2ebf9217be6abba2c70825Mathias Agopianimport com.android.internal.app.IAppOpsService;
20413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport com.android.internal.app.IBatteryStats;
21413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport com.android.server.BatteryService;
22413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport com.android.server.EventLogTags;
23413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport com.android.server.LocalServices;
24413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport com.android.server.ServiceThread;
25413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport com.android.server.lights.Light;
26413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport com.android.server.lights.LightsManager;
27413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport com.android.server.twilight.TwilightManager;
28413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport com.android.server.Watchdog;
29413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
30413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.Manifest;
31413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.content.BroadcastReceiver;
32413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.content.ContentResolver;
33413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.content.Context;
34413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.content.Intent;
35413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.content.IntentFilter;
36413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.content.pm.PackageManager;
37413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.content.res.Resources;
38413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.database.ContentObserver;
39413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.hardware.SensorManager;
40413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.hardware.SystemSensorManager;
41413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.hardware.display.DisplayManagerInternal;
42413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.net.Uri;
43413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.BatteryManager;
44413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.Binder;
45413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.Handler;
46413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.IBinder;
47413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.IPowerManager;
48413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.Looper;
49413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.Message;
50413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.PowerManager;
51413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.PowerManagerInternal;
52413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.Process;
53413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.RemoteException;
54413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.SystemClock;
55413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.SystemProperties;
56413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.SystemService;
57413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.UserHandle;
58413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.os.WorkSource;
59413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.provider.Settings;
60413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.service.dreams.DreamManagerInternal;
61413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.util.EventLog;
62413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.util.Log;
63413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.util.Slog;
64413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huberimport android.util.TimeUtils;
657188e55f54a43c55fd6b96454720c447f1dc454eJeff Brownimport android.view.WindowManagerPolicy;
66413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
67b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissenimport java.io.FileDescriptor;
68b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissenimport java.io.PrintWriter;
69b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissenimport java.util.ArrayList;
70b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen
71b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissenimport libcore.util.Objects;
72b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen
73b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen/**
74b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen * The power manager service is responsible for coordinating power management
75b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen * functions on the device.
76b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen */
77b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissenpublic final class PowerManagerService extends com.android.server.SystemService
78b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen        implements Watchdog.Monitor {
79413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final String TAG = "PowerManagerService";
80413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
81b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    private static final boolean DEBUG = false;
82b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    private static final boolean DEBUG_SPEW = DEBUG && true;
83b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen
84b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    // Message: Sent when a user activity timeout occurs to update the power state.
85153cefdf4acab25355f590d7760ebf73ef6096a9Marco Nelissen    private static final int MSG_USER_ACTIVITY_TIMEOUT = 1;
86b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    // Message: Sent when the device enters or exits a dreaming or dozing state.
87b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    private static final int MSG_SANDMAN = 2;
88413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Message: Sent when the screen on blocker is released.
89413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int MSG_SCREEN_ON_BLOCKER_RELEASED = 3;
90413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Message: Sent to poll whether the boot animation has terminated.
91413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int MSG_CHECK_IF_BOOT_ANIMATION_FINISHED = 4;
92413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
93413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Dirty bit: mWakeLocks changed
94413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int DIRTY_WAKE_LOCKS = 1 << 0;
95413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Dirty bit: mWakefulness changed
96413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int DIRTY_WAKEFULNESS = 1 << 1;
97413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Dirty bit: user activity was poked or may have timed out
98413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int DIRTY_USER_ACTIVITY = 1 << 2;
99413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Dirty bit: actual display power state was updated asynchronously
100413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int DIRTY_ACTUAL_DISPLAY_POWER_STATE_UPDATED = 1 << 3;
101413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Dirty bit: mBootCompleted changed
102413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int DIRTY_BOOT_COMPLETED = 1 << 4;
103413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Dirty bit: settings changed
104413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int DIRTY_SETTINGS = 1 << 5;
105413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Dirty bit: mIsPowered changed
106413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int DIRTY_IS_POWERED = 1 << 6;
107413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Dirty bit: mStayOn changed
108413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int DIRTY_STAY_ON = 1 << 7;
109413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Dirty bit: battery state changed
110413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int DIRTY_BATTERY_STATE = 1 << 8;
111413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Dirty bit: proximity state changed
112413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int DIRTY_PROXIMITY_POSITIVE = 1 << 9;
113413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Dirty bit: screen on blocker state became held or unheld
114413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int DIRTY_SCREEN_ON_BLOCKER_RELEASED = 1 << 10;
115413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Dirty bit: dock state changed
116413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int DIRTY_DOCK_STATE = 1 << 11;
117413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
118413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Wakefulness: The device is asleep and can only be awoken by a call to wakeUp().
119413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // The screen should be off or in the process of being turned off by the display controller.
120413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // The device typically passes through the dozing state first.
121413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int WAKEFULNESS_ASLEEP = 0;
122413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Wakefulness: The device is fully awake.  It can be put to sleep by a call to goToSleep().
123413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // When the user activity timeout expires, the device may start dreaming or go to sleep.
124413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int WAKEFULNESS_AWAKE = 1;
125413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Wakefulness: The device is dreaming.  It can be awoken by a call to wakeUp(),
126413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // which ends the dream.  The device goes to sleep when goToSleep() is called, when
127413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // the dream ends or when unplugged.
128413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // User activity may brighten the screen but does not end the dream.
129413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int WAKEFULNESS_DREAMING = 2;
130413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Wakefulness: The device is dozing.  It is almost asleep but is allowing a special
131413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // low-power "doze" dream to run which keeps the display on but lets the application
132413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // processor be suspended.  It can be awoken by a call to wakeUp() which ends the dream.
133413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // The device fully goes to sleep if the dream cannot be started or ends on its own.
134413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int WAKEFULNESS_DOZING = 3;
135413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
136413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Summarizes the state of all active wakelocks.
137413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int WAKE_LOCK_CPU = 1 << 0;
138413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int WAKE_LOCK_SCREEN_BRIGHT = 1 << 1;
139413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int WAKE_LOCK_SCREEN_DIM = 1 << 2;
140413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int WAKE_LOCK_BUTTON_BRIGHT = 1 << 3;
141413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int WAKE_LOCK_PROXIMITY_SCREEN_OFF = 1 << 4;
142413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int WAKE_LOCK_STAY_AWAKE = 1 << 5; // only set if already awake
143413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int WAKE_LOCK_DOZE = 1 << 6;
144413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
14590bebef5669a9385c706b042d146a31dca2e5d9bGlenn Kasten    // Summarizes the user activity state.
146413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int USER_ACTIVITY_SCREEN_BRIGHT = 1 << 0;
147413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int USER_ACTIVITY_SCREEN_DIM = 1 << 1;
148413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
149413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Default and minimum screen off timeout in milliseconds.
15090bebef5669a9385c706b042d146a31dca2e5d9bGlenn Kasten    private static final int DEFAULT_SCREEN_OFF_TIMEOUT = 15 * 1000;
151413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int MINIMUM_SCREEN_OFF_TIMEOUT = 10 * 1000;
152413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
153413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // The screen dim duration, in milliseconds.
154413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // This is subtracted from the end of the screen off timeout so the
155413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // minimum screen off timeout should be longer than this.
156413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int SCREEN_DIM_DURATION = 7 * 1000;
157413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
158413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // The maximum screen dim time expressed as a ratio relative to the screen
159413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // off timeout.  If the screen off timeout is very short then we want the
160413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // dim timeout to also be quite short so that most of the time is spent on.
161413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Otherwise the user won't get much screen on time before dimming occurs.
162413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final float MAXIMUM_SCREEN_DIM_RATIO = 0.2f;
163413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
164413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // The name of the boot animation service in init.rc.
165413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final String BOOT_ANIMATION_SERVICE = "bootanim";
166413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
167413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Poll interval in milliseconds for watching boot animation finished.
168413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private static final int BOOT_ANIMATION_POLL_INTERVAL = 200;
169413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
170413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private final Context mContext;
171413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private LightsManager mLightsManager;
172413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private BatteryService mBatteryService;
173413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private DisplayManagerInternal mDisplayManagerInternal;
174413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private IBatteryStats mBatteryStats;
175413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private IAppOpsService mAppOps;
17683bc7f3cf78b28a818417f40a4f0c00593993366Glenn Kasten    private ServiceThread mHandlerThread;
177413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private PowerManagerHandler mHandler;
178413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private WindowManagerPolicy mPolicy;
179413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private Notifier mNotifier;
180413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private DisplayPowerController mDisplayPowerController;
181413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private WirelessChargerDetector mWirelessChargerDetector;
182413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private SettingsObserver mSettingsObserver;
183413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private DreamManagerInternal mDreamManager;
18490bebef5669a9385c706b042d146a31dca2e5d9bGlenn Kasten    private Light mAttentionLight;
185413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
186413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private final Object mLock = new Object();
187413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
188413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // A bitfield that indicates what parts of the power state have
189413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // changed and need to be recalculated.
190413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private int mDirty;
191413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
192413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Indicates whether the device is awake or asleep or somewhere in between.
193413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // This is distinct from the screen power state, which is managed separately.
194413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private int mWakefulness;
195413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
196413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // True if the sandman has just been summoned for the first time since entering the
197413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // dreaming or dozing state.  Indicates whether a new dream should begin.
198413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private boolean mSandmanSummoned;
199413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
200413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // True if MSG_SANDMAN has been scheduled.
201413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private boolean mSandmanScheduled;
202b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen
203b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    // Table of all suspend blockers.
204b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    // There should only be a few of these.
205413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private final ArrayList<SuspendBlocker> mSuspendBlockers = new ArrayList<SuspendBlocker>();
206b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen
207b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    // Table of all wake locks acquired by applications.
208b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    private final ArrayList<WakeLock> mWakeLocks = new ArrayList<WakeLock>();
209b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen
210b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    // A bitfield that summarizes the state of all active wakelocks.
211b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    private int mWakeLockSummary;
212b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen
213b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    // If true, instructs the display controller to wait for the proximity sensor to
214b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    // go negative before turning the screen on.
215b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    private boolean mRequestWaitForNegativeProximity;
2167188e55f54a43c55fd6b96454720c447f1dc454eJeff Brown
2177188e55f54a43c55fd6b96454720c447f1dc454eJeff Brown    // Timestamp of the last time the device was awoken or put to sleep.
218b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen    private long mLastWakeTime;
2197188e55f54a43c55fd6b96454720c447f1dc454eJeff Brown    private long mLastSleepTime;
220b5c3107262fdf82aef4bd5ee8b8c60dd3e4725feMarco Nelissen
221413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // True if we need to send a wake up or go to sleep finished notification
222413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // when the display is ready.
223413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private boolean mSendWakeUpFinishedNotificationWhenReady;
224413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private boolean mSendGoToSleepFinishedNotificationWhenReady;
225413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
226413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // Timestamp of the last call to user activity.
227413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private long mLastUserActivityTime;
228413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    private long mLastUserActivityTimeNoChangeLights;
229413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber
230413f523afe96aff02d2b0a7459127b8f67b2b43cAndreas Huber    // A bitfield that summarizes the effect of the user activity timer.
231    // A zero value indicates that the user activity timer has expired.
232    private int mUserActivitySummary;
233
234    // The desired display power state.  The actual state may lag behind the
235    // requested because it is updated asynchronously by the display power controller.
236    private final DisplayPowerRequest mDisplayPowerRequest = new DisplayPowerRequest();
237
238    // True if the display power state has been fully applied, which means the display
239    // is actually on or actually off or whatever was requested.
240    private boolean mDisplayReady;
241
242    // The suspend blocker used to keep the CPU alive when an application has acquired
243    // a wake lock.
244    private final SuspendBlocker mWakeLockSuspendBlocker;
245
246    // True if the wake lock suspend blocker has been acquired.
247    private boolean mHoldingWakeLockSuspendBlocker;
248
249    // The suspend blocker used to keep the CPU alive when the display is on, the
250    // display is getting ready or there is user activity (in which case the display
251    // must be on).
252    private final SuspendBlocker mDisplaySuspendBlocker;
253
254    // True if the display suspend blocker has been acquired.
255    private boolean mHoldingDisplaySuspendBlocker;
256
257    // The screen on blocker used to keep the screen from turning on while the lock
258    // screen is coming up.
259    private final ScreenOnBlockerImpl mScreenOnBlocker;
260
261    // The display blanker used to turn the screen on or off.
262    private final DisplayBlankerImpl mDisplayBlanker;
263
264    // True if systemReady() has been called.
265    private boolean mSystemReady;
266
267    // True if boot completed occurred.  We keep the screen on until this happens.
268    private boolean mBootCompleted;
269
270    // True if auto-suspend mode is enabled.
271    // Refer to autosuspend.h.
272    private boolean mAutoSuspendModeEnabled;
273
274    // True if interactive mode is enabled.
275    // Refer to power.h.
276    private boolean mInteractiveModeEnabled;
277
278    // True if the device is plugged into a power source.
279    private boolean mIsPowered;
280
281    // The current plug type, such as BatteryManager.BATTERY_PLUGGED_WIRELESS.
282    private int mPlugType;
283
284    // The current battery level percentage.
285    private int mBatteryLevel;
286
287    // The battery level percentage at the time the dream started.
288    // This is used to terminate a dream and go to sleep if the battery is
289    // draining faster than it is charging and the user activity timeout has expired.
290    private int mBatteryLevelWhenDreamStarted;
291
292    // The current dock state.
293    private int mDockState = Intent.EXTRA_DOCK_STATE_UNDOCKED;
294
295    // True to decouple auto-suspend mode from the display state.
296    private boolean mDecoupleAutoSuspendModeFromDisplayConfig;
297
298    // True to decouple interactive mode from the display state.
299    private boolean mDecoupleInteractiveModeFromDisplayConfig;
300
301    // True if the device should wake up when plugged or unplugged.
302    private boolean mWakeUpWhenPluggedOrUnpluggedConfig;
303
304    // True if the device should suspend when the screen is off due to proximity.
305    private boolean mSuspendWhenScreenOffDueToProximityConfig;
306
307    // True if dreams are supported on this device.
308    private boolean mDreamsSupportedConfig;
309
310    // Default value for dreams enabled
311    private boolean mDreamsEnabledByDefaultConfig;
312
313    // Default value for dreams activate-on-sleep
314    private boolean mDreamsActivatedOnSleepByDefaultConfig;
315
316    // Default value for dreams activate-on-dock
317    private boolean mDreamsActivatedOnDockByDefaultConfig;
318
319    // True if dreams can run while not plugged in.
320    private boolean mDreamsEnabledOnBatteryConfig;
321
322    // Minimum battery level to allow dreaming when powered.
323    // Use -1 to disable this safety feature.
324    private int mDreamsBatteryLevelMinimumWhenPoweredConfig;
325
326    // Minimum battery level to allow dreaming when not powered.
327    // Use -1 to disable this safety feature.
328    private int mDreamsBatteryLevelMinimumWhenNotPoweredConfig;
329
330    // If the battery level drops by this percentage and the user activity timeout
331    // has expired, then assume the device is receiving insufficient current to charge
332    // effectively and terminate the dream.  Use -1 to disable this safety feature.
333    private int mDreamsBatteryLevelDrainCutoffConfig;
334
335    // True if dreams are enabled by the user.
336    private boolean mDreamsEnabledSetting;
337
338    // True if dreams should be activated on sleep.
339    private boolean mDreamsActivateOnSleepSetting;
340
341    // True if dreams should be activated on dock.
342    private boolean mDreamsActivateOnDockSetting;
343
344    // The screen off timeout setting value in milliseconds.
345    private int mScreenOffTimeoutSetting;
346
347    // The maximum allowable screen off timeout according to the device
348    // administration policy.  Overrides other settings.
349    private int mMaximumScreenOffTimeoutFromDeviceAdmin = Integer.MAX_VALUE;
350
351    // The stay on while plugged in setting.
352    // A bitfield of battery conditions under which to make the screen stay on.
353    private int mStayOnWhilePluggedInSetting;
354
355    // True if the device should stay on.
356    private boolean mStayOn;
357
358    // True if the proximity sensor reads a positive result.
359    private boolean mProximityPositive;
360
361    // Screen brightness setting limits.
362    private int mScreenBrightnessSettingMinimum;
363    private int mScreenBrightnessSettingMaximum;
364    private int mScreenBrightnessSettingDefault;
365
366    // The screen brightness setting, from 0 to 255.
367    // Use -1 if no value has been set.
368    private int mScreenBrightnessSetting;
369
370    // The screen auto-brightness adjustment setting, from -1 to 1.
371    // Use 0 if there is no adjustment.
372    private float mScreenAutoBrightnessAdjustmentSetting;
373
374    // The screen brightness mode.
375    // One of the Settings.System.SCREEN_BRIGHTNESS_MODE_* constants.
376    private int mScreenBrightnessModeSetting;
377
378    // The screen brightness setting override from the window manager
379    // to allow the current foreground activity to override the brightness.
380    // Use -1 to disable.
381    private int mScreenBrightnessOverrideFromWindowManager = -1;
382
383    // The user activity timeout override from the window manager
384    // to allow the current foreground activity to override the user activity timeout.
385    // Use -1 to disable.
386    private long mUserActivityTimeoutOverrideFromWindowManager = -1;
387
388    // The screen brightness setting override from the settings application
389    // to temporarily adjust the brightness until next updated,
390    // Use -1 to disable.
391    private int mTemporaryScreenBrightnessSettingOverride = -1;
392
393    // The screen brightness adjustment setting override from the settings
394    // application to temporarily adjust the auto-brightness adjustment factor
395    // until next updated, in the range -1..1.
396    // Use NaN to disable.
397    private float mTemporaryScreenAutoBrightnessAdjustmentSettingOverride = Float.NaN;
398
399    // Time when we last logged a warning about calling userActivity() without permission.
400    private long mLastWarningAboutUserActivityPermission = Long.MIN_VALUE;
401
402    private native void nativeInit();
403
404    private static native void nativeSetPowerState(boolean screenOn, boolean screenBright);
405    private static native void nativeAcquireSuspendBlocker(String name);
406    private static native void nativeReleaseSuspendBlocker(String name);
407    private static native void nativeSetInteractive(boolean enable);
408    private static native void nativeSetAutoSuspend(boolean enable);
409
410    public PowerManagerService(Context context) {
411        super(context);
412        mContext = context;
413        synchronized (mLock) {
414            mWakeLockSuspendBlocker = createSuspendBlockerLocked("PowerManagerService.WakeLocks");
415            mDisplaySuspendBlocker = createSuspendBlockerLocked("PowerManagerService.Display");
416            mDisplaySuspendBlocker.acquire();
417            mHoldingDisplaySuspendBlocker = true;
418
419            mScreenOnBlocker = new ScreenOnBlockerImpl();
420            mDisplayBlanker = new DisplayBlankerImpl();
421            mWakefulness = WAKEFULNESS_AWAKE;
422        }
423
424        nativeInit();
425        nativeSetPowerState(true, true);
426    }
427
428    @Override
429    public void onStart() {
430        publishBinderService(Context.POWER_SERVICE, new BinderService());
431        publishLocalService(PowerManagerInternal.class, new LocalService());
432    }
433
434    /**
435     * Initialize the power manager.
436     * Must be called before any other functions within the power manager are called.
437     */
438    public void init(LightsManager ls,
439            BatteryService bs, IBatteryStats bss,
440            IAppOpsService appOps) {
441        mLightsManager = ls;
442        mBatteryService = bs;
443        mBatteryStats = bss;
444        mAppOps = appOps;
445        mDisplayManagerInternal = getLocalService(DisplayManagerInternal.class);
446        mHandlerThread = new ServiceThread(TAG,
447                Process.THREAD_PRIORITY_DISPLAY, false /*allowIo*/);
448        mHandlerThread.start();
449        mHandler = new PowerManagerHandler(mHandlerThread.getLooper());
450
451        Watchdog.getInstance().addMonitor(this);
452        Watchdog.getInstance().addThread(mHandler);
453
454        // Forcibly turn the screen on at boot so that it is in a known power state.
455        // We do this in init() rather than in the constructor because setting the
456        // screen state requires a call into surface flinger which then needs to call back
457        // into the activity manager to check permissions.  Unfortunately the
458        // activity manager is not running when the constructor is called, so we
459        // have to defer setting the screen state until this point.
460        mDisplayBlanker.unblankAllDisplays();
461    }
462
463    void setPolicy(WindowManagerPolicy policy) {
464        synchronized (mLock) {
465            mPolicy = policy;
466        }
467    }
468
469    public void systemReady() {
470        synchronized (mLock) {
471            mSystemReady = true;
472            mDreamManager = LocalServices.getService(DreamManagerInternal.class);
473
474            PowerManager pm = (PowerManager) mContext.getSystemService(Context.POWER_SERVICE);
475            mScreenBrightnessSettingMinimum = pm.getMinimumScreenBrightnessSetting();
476            mScreenBrightnessSettingMaximum = pm.getMaximumScreenBrightnessSetting();
477            mScreenBrightnessSettingDefault = pm.getDefaultScreenBrightnessSetting();
478
479            SensorManager sensorManager = new SystemSensorManager(mContext, mHandler.getLooper());
480
481            // The notifier runs on the system server's main looper so as not to interfere
482            // with the animations and other critical functions of the power manager.
483            mNotifier = new Notifier(Looper.getMainLooper(), mContext, mBatteryStats,
484                    mAppOps, createSuspendBlockerLocked("PowerManagerService.Broadcasts"),
485                    mScreenOnBlocker, mPolicy);
486
487            // The display power controller runs on the power manager service's
488            // own handler thread to ensure timely operation.
489            mDisplayPowerController = new DisplayPowerController(mHandler.getLooper(),
490                    mContext, mNotifier, mLightsManager,
491                    LocalServices.getService(TwilightManager.class), sensorManager,
492                    mDisplaySuspendBlocker, mDisplayBlanker,
493                    mDisplayPowerControllerCallbacks, mHandler);
494
495            mWirelessChargerDetector = new WirelessChargerDetector(sensorManager,
496                    createSuspendBlockerLocked("PowerManagerService.WirelessChargerDetector"),
497                    mHandler);
498            mSettingsObserver = new SettingsObserver(mHandler);
499            mAttentionLight = mLightsManager.getLight(LightsManager.LIGHT_ID_ATTENTION);
500
501            // Register for broadcasts from other components of the system.
502            IntentFilter filter = new IntentFilter();
503            filter.addAction(Intent.ACTION_BATTERY_CHANGED);
504            mContext.registerReceiver(new BatteryReceiver(), filter, null, mHandler);
505
506            filter = new IntentFilter();
507            filter.addAction(Intent.ACTION_BOOT_COMPLETED);
508            mContext.registerReceiver(new BootCompletedReceiver(), filter, null, mHandler);
509
510            filter = new IntentFilter();
511            filter.addAction(Intent.ACTION_DREAMING_STARTED);
512            filter.addAction(Intent.ACTION_DREAMING_STOPPED);
513            mContext.registerReceiver(new DreamReceiver(), filter, null, mHandler);
514
515            filter = new IntentFilter();
516            filter.addAction(Intent.ACTION_USER_SWITCHED);
517            mContext.registerReceiver(new UserSwitchedReceiver(), filter, null, mHandler);
518
519            filter = new IntentFilter();
520            filter.addAction(Intent.ACTION_DOCK_EVENT);
521            mContext.registerReceiver(new DockReceiver(), filter, null, mHandler);
522
523            // Register for settings changes.
524            final ContentResolver resolver = mContext.getContentResolver();
525            resolver.registerContentObserver(Settings.Secure.getUriFor(
526                    Settings.Secure.SCREENSAVER_ENABLED),
527                    false, mSettingsObserver, UserHandle.USER_ALL);
528            resolver.registerContentObserver(Settings.Secure.getUriFor(
529                    Settings.Secure.SCREENSAVER_ACTIVATE_ON_SLEEP),
530                    false, mSettingsObserver, UserHandle.USER_ALL);
531            resolver.registerContentObserver(Settings.Secure.getUriFor(
532                    Settings.Secure.SCREENSAVER_ACTIVATE_ON_DOCK),
533                    false, mSettingsObserver, UserHandle.USER_ALL);
534            resolver.registerContentObserver(Settings.System.getUriFor(
535                    Settings.System.SCREEN_OFF_TIMEOUT),
536                    false, mSettingsObserver, UserHandle.USER_ALL);
537            resolver.registerContentObserver(Settings.Global.getUriFor(
538                    Settings.Global.STAY_ON_WHILE_PLUGGED_IN),
539                    false, mSettingsObserver, UserHandle.USER_ALL);
540            resolver.registerContentObserver(Settings.System.getUriFor(
541                    Settings.System.SCREEN_BRIGHTNESS),
542                    false, mSettingsObserver, UserHandle.USER_ALL);
543            resolver.registerContentObserver(Settings.System.getUriFor(
544                    Settings.System.SCREEN_BRIGHTNESS_MODE),
545                    false, mSettingsObserver, UserHandle.USER_ALL);
546
547            // Go.
548            readConfigurationLocked();
549            updateSettingsLocked();
550            mDirty |= DIRTY_BATTERY_STATE;
551            updatePowerStateLocked();
552        }
553    }
554
555    private void readConfigurationLocked() {
556        final Resources resources = mContext.getResources();
557
558        mDecoupleAutoSuspendModeFromDisplayConfig = resources.getBoolean(
559                com.android.internal.R.bool.config_powerDecoupleAutoSuspendModeFromDisplay);
560        mDecoupleInteractiveModeFromDisplayConfig = resources.getBoolean(
561                com.android.internal.R.bool.config_powerDecoupleInteractiveModeFromDisplay);
562        mWakeUpWhenPluggedOrUnpluggedConfig = resources.getBoolean(
563                com.android.internal.R.bool.config_unplugTurnsOnScreen);
564        mSuspendWhenScreenOffDueToProximityConfig = resources.getBoolean(
565                com.android.internal.R.bool.config_suspendWhenScreenOffDueToProximity);
566        mDreamsSupportedConfig = resources.getBoolean(
567                com.android.internal.R.bool.config_dreamsSupported);
568        mDreamsEnabledByDefaultConfig = resources.getBoolean(
569                com.android.internal.R.bool.config_dreamsEnabledByDefault);
570        mDreamsActivatedOnSleepByDefaultConfig = resources.getBoolean(
571                com.android.internal.R.bool.config_dreamsActivatedOnSleepByDefault);
572        mDreamsActivatedOnDockByDefaultConfig = resources.getBoolean(
573                com.android.internal.R.bool.config_dreamsActivatedOnDockByDefault);
574        mDreamsEnabledOnBatteryConfig = resources.getBoolean(
575                com.android.internal.R.bool.config_dreamsEnabledOnBattery);
576        mDreamsBatteryLevelMinimumWhenPoweredConfig = resources.getInteger(
577                com.android.internal.R.integer.config_dreamsBatteryLevelMinimumWhenPowered);
578        mDreamsBatteryLevelMinimumWhenNotPoweredConfig = resources.getInteger(
579                com.android.internal.R.integer.config_dreamsBatteryLevelMinimumWhenNotPowered);
580        mDreamsBatteryLevelDrainCutoffConfig = resources.getInteger(
581                com.android.internal.R.integer.config_dreamsBatteryLevelDrainCutoff);
582    }
583
584    private void updateSettingsLocked() {
585        final ContentResolver resolver = mContext.getContentResolver();
586
587        mDreamsEnabledSetting = (Settings.Secure.getIntForUser(resolver,
588                Settings.Secure.SCREENSAVER_ENABLED,
589                mDreamsEnabledByDefaultConfig ? 1 : 0,
590                UserHandle.USER_CURRENT) != 0);
591        mDreamsActivateOnSleepSetting = (Settings.Secure.getIntForUser(resolver,
592                Settings.Secure.SCREENSAVER_ACTIVATE_ON_SLEEP,
593                mDreamsActivatedOnSleepByDefaultConfig ? 1 : 0,
594                UserHandle.USER_CURRENT) != 0);
595        mDreamsActivateOnDockSetting = (Settings.Secure.getIntForUser(resolver,
596                Settings.Secure.SCREENSAVER_ACTIVATE_ON_DOCK,
597                mDreamsActivatedOnDockByDefaultConfig ? 1 : 0,
598                UserHandle.USER_CURRENT) != 0);
599        mScreenOffTimeoutSetting = Settings.System.getIntForUser(resolver,
600                Settings.System.SCREEN_OFF_TIMEOUT, DEFAULT_SCREEN_OFF_TIMEOUT,
601                UserHandle.USER_CURRENT);
602        mStayOnWhilePluggedInSetting = Settings.Global.getInt(resolver,
603                Settings.Global.STAY_ON_WHILE_PLUGGED_IN, BatteryManager.BATTERY_PLUGGED_AC);
604
605        final int oldScreenBrightnessSetting = mScreenBrightnessSetting;
606        mScreenBrightnessSetting = Settings.System.getIntForUser(resolver,
607                Settings.System.SCREEN_BRIGHTNESS, mScreenBrightnessSettingDefault,
608                UserHandle.USER_CURRENT);
609        if (oldScreenBrightnessSetting != mScreenBrightnessSetting) {
610            mTemporaryScreenBrightnessSettingOverride = -1;
611        }
612
613        final float oldScreenAutoBrightnessAdjustmentSetting =
614                mScreenAutoBrightnessAdjustmentSetting;
615        mScreenAutoBrightnessAdjustmentSetting = Settings.System.getFloatForUser(resolver,
616                Settings.System.SCREEN_AUTO_BRIGHTNESS_ADJ, 0.0f,
617                UserHandle.USER_CURRENT);
618        if (oldScreenAutoBrightnessAdjustmentSetting != mScreenAutoBrightnessAdjustmentSetting) {
619            mTemporaryScreenAutoBrightnessAdjustmentSettingOverride = Float.NaN;
620        }
621
622        mScreenBrightnessModeSetting = Settings.System.getIntForUser(resolver,
623                Settings.System.SCREEN_BRIGHTNESS_MODE,
624                Settings.System.SCREEN_BRIGHTNESS_MODE_MANUAL, UserHandle.USER_CURRENT);
625
626        mDirty |= DIRTY_SETTINGS;
627    }
628
629    private void handleSettingsChangedLocked() {
630        updateSettingsLocked();
631        updatePowerStateLocked();
632    }
633
634    private void acquireWakeLockInternal(IBinder lock, int flags, String tag, String packageName,
635            WorkSource ws, String historyTag, int uid, int pid) {
636        synchronized (mLock) {
637            if (DEBUG_SPEW) {
638                Slog.d(TAG, "acquireWakeLockInternal: lock=" + Objects.hashCode(lock)
639                        + ", flags=0x" + Integer.toHexString(flags)
640                        + ", tag=\"" + tag + "\", ws=" + ws + ", uid=" + uid + ", pid=" + pid);
641            }
642
643            WakeLock wakeLock;
644            int index = findWakeLockIndexLocked(lock);
645            if (index >= 0) {
646                wakeLock = mWakeLocks.get(index);
647                if (!wakeLock.hasSameProperties(flags, tag, ws, uid, pid)) {
648                    // Update existing wake lock.  This shouldn't happen but is harmless.
649                    notifyWakeLockChangingLocked(wakeLock, flags, tag, packageName,
650                            uid, pid, ws, historyTag);
651                    wakeLock.updateProperties(flags, tag, packageName, ws, historyTag, uid, pid);
652                }
653            } else {
654                wakeLock = new WakeLock(lock, flags, tag, packageName, ws, historyTag, uid, pid);
655                try {
656                    lock.linkToDeath(wakeLock, 0);
657                } catch (RemoteException ex) {
658                    throw new IllegalArgumentException("Wake lock is already dead.");
659                }
660                notifyWakeLockAcquiredLocked(wakeLock);
661                mWakeLocks.add(wakeLock);
662            }
663
664            applyWakeLockFlagsOnAcquireLocked(wakeLock);
665            mDirty |= DIRTY_WAKE_LOCKS;
666            updatePowerStateLocked();
667        }
668    }
669
670    @SuppressWarnings("deprecation")
671    private static boolean isScreenLock(final WakeLock wakeLock) {
672        switch (wakeLock.mFlags & PowerManager.WAKE_LOCK_LEVEL_MASK) {
673            case PowerManager.FULL_WAKE_LOCK:
674            case PowerManager.SCREEN_BRIGHT_WAKE_LOCK:
675            case PowerManager.SCREEN_DIM_WAKE_LOCK:
676                return true;
677        }
678        return false;
679    }
680
681    private void applyWakeLockFlagsOnAcquireLocked(WakeLock wakeLock) {
682        if ((wakeLock.mFlags & PowerManager.ACQUIRE_CAUSES_WAKEUP) != 0
683                && isScreenLock(wakeLock)) {
684            wakeUpNoUpdateLocked(SystemClock.uptimeMillis());
685        }
686    }
687
688    private void releaseWakeLockInternal(IBinder lock, int flags) {
689        synchronized (mLock) {
690            int index = findWakeLockIndexLocked(lock);
691            if (index < 0) {
692                if (DEBUG_SPEW) {
693                    Slog.d(TAG, "releaseWakeLockInternal: lock=" + Objects.hashCode(lock)
694                            + " [not found], flags=0x" + Integer.toHexString(flags));
695                }
696                return;
697            }
698
699            WakeLock wakeLock = mWakeLocks.get(index);
700            if (DEBUG_SPEW) {
701                Slog.d(TAG, "releaseWakeLockInternal: lock=" + Objects.hashCode(lock)
702                        + " [" + wakeLock.mTag + "], flags=0x" + Integer.toHexString(flags));
703            }
704
705            mWakeLocks.remove(index);
706            notifyWakeLockReleasedLocked(wakeLock);
707            wakeLock.mLock.unlinkToDeath(wakeLock, 0);
708
709            if ((flags & PowerManager.WAIT_FOR_PROXIMITY_NEGATIVE) != 0) {
710                mRequestWaitForNegativeProximity = true;
711            }
712
713            applyWakeLockFlagsOnReleaseLocked(wakeLock);
714            mDirty |= DIRTY_WAKE_LOCKS;
715            updatePowerStateLocked();
716        }
717    }
718
719    private void handleWakeLockDeath(WakeLock wakeLock) {
720        synchronized (mLock) {
721            if (DEBUG_SPEW) {
722                Slog.d(TAG, "handleWakeLockDeath: lock=" + Objects.hashCode(wakeLock.mLock)
723                        + " [" + wakeLock.mTag + "]");
724            }
725
726            int index = mWakeLocks.indexOf(wakeLock);
727            if (index < 0) {
728                return;
729            }
730
731            mWakeLocks.remove(index);
732            notifyWakeLockReleasedLocked(wakeLock);
733
734            applyWakeLockFlagsOnReleaseLocked(wakeLock);
735            mDirty |= DIRTY_WAKE_LOCKS;
736            updatePowerStateLocked();
737        }
738    }
739
740    private void applyWakeLockFlagsOnReleaseLocked(WakeLock wakeLock) {
741        if ((wakeLock.mFlags & PowerManager.ON_AFTER_RELEASE) != 0
742                && isScreenLock(wakeLock)) {
743            userActivityNoUpdateLocked(SystemClock.uptimeMillis(),
744                    PowerManager.USER_ACTIVITY_EVENT_OTHER,
745                    PowerManager.USER_ACTIVITY_FLAG_NO_CHANGE_LIGHTS,
746                    wakeLock.mOwnerUid);
747        }
748    }
749
750    private void updateWakeLockWorkSourceInternal(IBinder lock, WorkSource ws, String historyTag) {
751        synchronized (mLock) {
752            int index = findWakeLockIndexLocked(lock);
753            if (index < 0) {
754                if (DEBUG_SPEW) {
755                    Slog.d(TAG, "updateWakeLockWorkSourceInternal: lock=" + Objects.hashCode(lock)
756                            + " [not found], ws=" + ws);
757                }
758                throw new IllegalArgumentException("Wake lock not active");
759            }
760
761            WakeLock wakeLock = mWakeLocks.get(index);
762            if (DEBUG_SPEW) {
763                Slog.d(TAG, "updateWakeLockWorkSourceInternal: lock=" + Objects.hashCode(lock)
764                        + " [" + wakeLock.mTag + "], ws=" + ws);
765            }
766
767            if (!wakeLock.hasSameWorkSource(ws)) {
768                notifyWakeLockChangingLocked(wakeLock, wakeLock.mFlags, wakeLock.mTag,
769                        wakeLock.mPackageName, wakeLock.mOwnerUid, wakeLock.mOwnerPid,
770                        ws, historyTag);
771                wakeLock.mHistoryTag = historyTag;
772                wakeLock.updateWorkSource(ws);
773            }
774        }
775    }
776
777    private int findWakeLockIndexLocked(IBinder lock) {
778        final int count = mWakeLocks.size();
779        for (int i = 0; i < count; i++) {
780            if (mWakeLocks.get(i).mLock == lock) {
781                return i;
782            }
783        }
784        return -1;
785    }
786
787    private void notifyWakeLockAcquiredLocked(WakeLock wakeLock) {
788        if (mSystemReady) {
789            wakeLock.mNotifiedAcquired = true;
790            mNotifier.onWakeLockAcquired(wakeLock.mFlags, wakeLock.mTag, wakeLock.mPackageName,
791                    wakeLock.mOwnerUid, wakeLock.mOwnerPid, wakeLock.mWorkSource,
792                    wakeLock.mHistoryTag);
793        }
794    }
795
796    private void notifyWakeLockChangingLocked(WakeLock wakeLock, int flags, String tag,
797            String packageName, int uid, int pid, WorkSource ws, String historyTag) {
798        if (mSystemReady && wakeLock.mNotifiedAcquired) {
799            mNotifier.onWakeLockChanging(wakeLock.mFlags, wakeLock.mTag, wakeLock.mPackageName,
800                    wakeLock.mOwnerUid, wakeLock.mOwnerPid, wakeLock.mWorkSource,
801                    wakeLock.mHistoryTag, flags, tag, packageName, uid, pid, ws, historyTag);
802        }
803    }
804
805    private void notifyWakeLockReleasedLocked(WakeLock wakeLock) {
806        if (mSystemReady && wakeLock.mNotifiedAcquired) {
807            wakeLock.mNotifiedAcquired = false;
808            mNotifier.onWakeLockReleased(wakeLock.mFlags, wakeLock.mTag, wakeLock.mPackageName,
809                    wakeLock.mOwnerUid, wakeLock.mOwnerPid, wakeLock.mWorkSource);
810        }
811    }
812
813    @SuppressWarnings("deprecation")
814    private boolean isWakeLockLevelSupportedInternal(int level) {
815        synchronized (mLock) {
816            switch (level) {
817                case PowerManager.PARTIAL_WAKE_LOCK:
818                case PowerManager.SCREEN_DIM_WAKE_LOCK:
819                case PowerManager.SCREEN_BRIGHT_WAKE_LOCK:
820                case PowerManager.FULL_WAKE_LOCK:
821                case PowerManager.DOZE_WAKE_LOCK:
822                    return true;
823
824                case PowerManager.PROXIMITY_SCREEN_OFF_WAKE_LOCK:
825                    return mSystemReady && mDisplayPowerController.isProximitySensorAvailable();
826
827                default:
828                    return false;
829            }
830        }
831    }
832
833    // Called from native code.
834    private void userActivityFromNative(long eventTime, int event, int flags) {
835        userActivityInternal(eventTime, event, flags, Process.SYSTEM_UID);
836    }
837
838    private void userActivityInternal(long eventTime, int event, int flags, int uid) {
839        synchronized (mLock) {
840            if (userActivityNoUpdateLocked(eventTime, event, flags, uid)) {
841                updatePowerStateLocked();
842            }
843        }
844    }
845
846    private boolean userActivityNoUpdateLocked(long eventTime, int event, int flags, int uid) {
847        if (DEBUG_SPEW) {
848            Slog.d(TAG, "userActivityNoUpdateLocked: eventTime=" + eventTime
849                    + ", event=" + event + ", flags=0x" + Integer.toHexString(flags)
850                    + ", uid=" + uid);
851        }
852
853        if (eventTime < mLastSleepTime || eventTime < mLastWakeTime
854                || mWakefulness == WAKEFULNESS_ASLEEP || mWakefulness == WAKEFULNESS_DOZING
855                || !mBootCompleted || !mSystemReady) {
856            return false;
857        }
858
859        mNotifier.onUserActivity(event, uid);
860
861        if ((flags & PowerManager.USER_ACTIVITY_FLAG_NO_CHANGE_LIGHTS) != 0) {
862            if (eventTime > mLastUserActivityTimeNoChangeLights
863                    && eventTime > mLastUserActivityTime) {
864                mLastUserActivityTimeNoChangeLights = eventTime;
865                mDirty |= DIRTY_USER_ACTIVITY;
866                return true;
867            }
868        } else {
869            if (eventTime > mLastUserActivityTime) {
870                mLastUserActivityTime = eventTime;
871                mDirty |= DIRTY_USER_ACTIVITY;
872                return true;
873            }
874        }
875        return false;
876    }
877
878    // Called from native code.
879    private void wakeUpFromNative(long eventTime) {
880        wakeUpInternal(eventTime);
881    }
882
883    private void wakeUpInternal(long eventTime) {
884        synchronized (mLock) {
885            if (wakeUpNoUpdateLocked(eventTime)) {
886                updatePowerStateLocked();
887            }
888        }
889    }
890
891    private boolean wakeUpNoUpdateLocked(long eventTime) {
892        if (DEBUG_SPEW) {
893            Slog.d(TAG, "wakeUpNoUpdateLocked: eventTime=" + eventTime);
894        }
895
896        if (eventTime < mLastSleepTime || mWakefulness == WAKEFULNESS_AWAKE
897                || !mBootCompleted || !mSystemReady) {
898            return false;
899        }
900
901        switch (mWakefulness) {
902            case WAKEFULNESS_ASLEEP:
903                Slog.i(TAG, "Waking up from sleep...");
904                break;
905            case WAKEFULNESS_DREAMING:
906                Slog.i(TAG, "Waking up from dream...");
907                break;
908            case WAKEFULNESS_DOZING:
909                Slog.i(TAG, "Waking up from dozing...");
910                break;
911        }
912
913        if (mWakefulness != WAKEFULNESS_DREAMING) {
914            sendPendingNotificationsLocked();
915            mNotifier.onWakeUpStarted();
916            mSendWakeUpFinishedNotificationWhenReady = true;
917        }
918
919        mLastWakeTime = eventTime;
920        mWakefulness = WAKEFULNESS_AWAKE;
921        mDirty |= DIRTY_WAKEFULNESS;
922
923        userActivityNoUpdateLocked(
924                eventTime, PowerManager.USER_ACTIVITY_EVENT_OTHER, 0, Process.SYSTEM_UID);
925        return true;
926    }
927
928    // Called from native code.
929    private void goToSleepFromNative(long eventTime, int reason) {
930        goToSleepInternal(eventTime, reason);
931    }
932
933    private void goToSleepInternal(long eventTime, int reason) {
934        synchronized (mLock) {
935            if (goToSleepNoUpdateLocked(eventTime, reason)) {
936                updatePowerStateLocked();
937            }
938        }
939    }
940
941    // This method is called goToSleep for historical reasons but we actually start
942    // dozing before really going to sleep.
943    @SuppressWarnings("deprecation")
944    private boolean goToSleepNoUpdateLocked(long eventTime, int reason) {
945        if (DEBUG_SPEW) {
946            Slog.d(TAG, "goToSleepNoUpdateLocked: eventTime=" + eventTime + ", reason=" + reason);
947        }
948
949        if (eventTime < mLastWakeTime
950                || mWakefulness == WAKEFULNESS_ASLEEP
951                || mWakefulness == WAKEFULNESS_DOZING
952                || !mBootCompleted || !mSystemReady) {
953            return false;
954        }
955
956        switch (reason) {
957            case PowerManager.GO_TO_SLEEP_REASON_DEVICE_ADMIN:
958                Slog.i(TAG, "Going to sleep due to device administration policy...");
959                break;
960            case PowerManager.GO_TO_SLEEP_REASON_TIMEOUT:
961                Slog.i(TAG, "Going to sleep due to screen timeout...");
962                break;
963            default:
964                Slog.i(TAG, "Going to sleep by user request...");
965                reason = PowerManager.GO_TO_SLEEP_REASON_USER;
966                break;
967        }
968
969        sendPendingNotificationsLocked();
970        mNotifier.onGoToSleepStarted(reason);
971        mSendGoToSleepFinishedNotificationWhenReady = true;
972
973        mLastSleepTime = eventTime;
974        mDirty |= DIRTY_WAKEFULNESS;
975        mWakefulness = WAKEFULNESS_DOZING;
976        mSandmanSummoned = true;
977
978        // Report the number of wake locks that will be cleared by going to sleep.
979        int numWakeLocksCleared = 0;
980        final int numWakeLocks = mWakeLocks.size();
981        for (int i = 0; i < numWakeLocks; i++) {
982            final WakeLock wakeLock = mWakeLocks.get(i);
983            switch (wakeLock.mFlags & PowerManager.WAKE_LOCK_LEVEL_MASK) {
984                case PowerManager.FULL_WAKE_LOCK:
985                case PowerManager.SCREEN_BRIGHT_WAKE_LOCK:
986                case PowerManager.SCREEN_DIM_WAKE_LOCK:
987                    numWakeLocksCleared += 1;
988                    break;
989            }
990        }
991        EventLog.writeEvent(EventLogTags.POWER_SLEEP_REQUESTED, numWakeLocksCleared);
992        return true;
993    }
994
995    private void napInternal(long eventTime) {
996        synchronized (mLock) {
997            if (napNoUpdateLocked(eventTime)) {
998                updatePowerStateLocked();
999            }
1000        }
1001    }
1002
1003    private boolean napNoUpdateLocked(long eventTime) {
1004        if (DEBUG_SPEW) {
1005            Slog.d(TAG, "napNoUpdateLocked: eventTime=" + eventTime);
1006        }
1007
1008        if (eventTime < mLastWakeTime || mWakefulness != WAKEFULNESS_AWAKE
1009                || !mBootCompleted || !mSystemReady) {
1010            return false;
1011        }
1012
1013        Slog.i(TAG, "Nap time...");
1014
1015        mDirty |= DIRTY_WAKEFULNESS;
1016        mWakefulness = WAKEFULNESS_DREAMING;
1017        mSandmanSummoned = true;
1018        return true;
1019    }
1020
1021    // Done dozing, drop everything and go to sleep.
1022    private boolean reallyGoToSleepNoUpdateLocked(long eventTime) {
1023        if (DEBUG_SPEW) {
1024            Slog.d(TAG, "reallyGoToSleepNoUpdateLocked: eventTime=" + eventTime);
1025        }
1026
1027        if (eventTime < mLastWakeTime || mWakefulness == WAKEFULNESS_ASLEEP
1028                || !mBootCompleted || !mSystemReady) {
1029            return false;
1030        }
1031
1032        Slog.i(TAG, "Sleeping...");
1033
1034        mDirty |= DIRTY_WAKEFULNESS;
1035        mWakefulness = WAKEFULNESS_ASLEEP;
1036        return true;
1037    }
1038
1039    /**
1040     * Updates the global power state based on dirty bits recorded in mDirty.
1041     *
1042     * This is the main function that performs power state transitions.
1043     * We centralize them here so that we can recompute the power state completely
1044     * each time something important changes, and ensure that we do it the same
1045     * way each time.  The point is to gather all of the transition logic here.
1046     */
1047    private void updatePowerStateLocked() {
1048        if (!mSystemReady || mDirty == 0) {
1049            return;
1050        }
1051        if (!Thread.holdsLock(mLock)) {
1052            Slog.wtf(TAG, "Power manager lock was not held when calling updatePowerStateLocked");
1053        }
1054
1055        // Phase 0: Basic state updates.
1056        updateIsPoweredLocked(mDirty);
1057        updateStayOnLocked(mDirty);
1058
1059        // Phase 1: Update wakefulness.
1060        // Loop because the wake lock and user activity computations are influenced
1061        // by changes in wakefulness.
1062        final long now = SystemClock.uptimeMillis();
1063        int dirtyPhase2 = 0;
1064        for (;;) {
1065            int dirtyPhase1 = mDirty;
1066            dirtyPhase2 |= dirtyPhase1;
1067            mDirty = 0;
1068
1069            updateWakeLockSummaryLocked(dirtyPhase1);
1070            updateUserActivitySummaryLocked(now, dirtyPhase1);
1071            if (!updateWakefulnessLocked(dirtyPhase1)) {
1072                break;
1073            }
1074        }
1075
1076        // Phase 2: Update dreams and display power state.
1077        updateDreamLocked(dirtyPhase2);
1078        updateDisplayPowerStateLocked(dirtyPhase2);
1079
1080        // Phase 3: Send notifications, if needed.
1081        if (mDisplayReady) {
1082            sendPendingNotificationsLocked();
1083        }
1084
1085        // Phase 4: Update suspend blocker.
1086        // Because we might release the last suspend blocker here, we need to make sure
1087        // we finished everything else first!
1088        updateSuspendBlockerLocked();
1089    }
1090
1091    private void sendPendingNotificationsLocked() {
1092        if (mSendWakeUpFinishedNotificationWhenReady) {
1093            mSendWakeUpFinishedNotificationWhenReady = false;
1094            mNotifier.onWakeUpFinished();
1095        }
1096        if (mSendGoToSleepFinishedNotificationWhenReady) {
1097            mSendGoToSleepFinishedNotificationWhenReady = false;
1098            mNotifier.onGoToSleepFinished();
1099        }
1100    }
1101
1102    /**
1103     * Updates the value of mIsPowered.
1104     * Sets DIRTY_IS_POWERED if a change occurred.
1105     */
1106    private void updateIsPoweredLocked(int dirty) {
1107        if ((dirty & DIRTY_BATTERY_STATE) != 0) {
1108            final boolean wasPowered = mIsPowered;
1109            final int oldPlugType = mPlugType;
1110            mIsPowered = mBatteryService.isPowered(BatteryManager.BATTERY_PLUGGED_ANY);
1111            mPlugType = mBatteryService.getPlugType();
1112            mBatteryLevel = mBatteryService.getBatteryLevel();
1113
1114            if (DEBUG_SPEW) {
1115                Slog.d(TAG, "updateIsPoweredLocked: wasPowered=" + wasPowered
1116                        + ", mIsPowered=" + mIsPowered
1117                        + ", oldPlugType=" + oldPlugType
1118                        + ", mPlugType=" + mPlugType
1119                        + ", mBatteryLevel=" + mBatteryLevel);
1120            }
1121
1122            if (wasPowered != mIsPowered || oldPlugType != mPlugType) {
1123                mDirty |= DIRTY_IS_POWERED;
1124
1125                // Update wireless dock detection state.
1126                final boolean dockedOnWirelessCharger = mWirelessChargerDetector.update(
1127                        mIsPowered, mPlugType, mBatteryLevel);
1128
1129                // Treat plugging and unplugging the devices as a user activity.
1130                // Users find it disconcerting when they plug or unplug the device
1131                // and it shuts off right away.
1132                // Some devices also wake the device when plugged or unplugged because
1133                // they don't have a charging LED.
1134                final long now = SystemClock.uptimeMillis();
1135                if (shouldWakeUpWhenPluggedOrUnpluggedLocked(wasPowered, oldPlugType,
1136                        dockedOnWirelessCharger)) {
1137                    wakeUpNoUpdateLocked(now);
1138                }
1139                userActivityNoUpdateLocked(
1140                        now, PowerManager.USER_ACTIVITY_EVENT_OTHER, 0, Process.SYSTEM_UID);
1141
1142                // Tell the notifier whether wireless charging has started so that
1143                // it can provide feedback to the user.
1144                if (dockedOnWirelessCharger) {
1145                    mNotifier.onWirelessChargingStarted();
1146                }
1147            }
1148        }
1149    }
1150
1151    private boolean shouldWakeUpWhenPluggedOrUnpluggedLocked(
1152            boolean wasPowered, int oldPlugType, boolean dockedOnWirelessCharger) {
1153        // Don't wake when powered unless configured to do so.
1154        if (!mWakeUpWhenPluggedOrUnpluggedConfig) {
1155            return false;
1156        }
1157
1158        // Don't wake when undocked from wireless charger.
1159        // See WirelessChargerDetector for justification.
1160        if (wasPowered && !mIsPowered
1161                && oldPlugType == BatteryManager.BATTERY_PLUGGED_WIRELESS) {
1162            return false;
1163        }
1164
1165        // Don't wake when docked on wireless charger unless we are certain of it.
1166        // See WirelessChargerDetector for justification.
1167        if (!wasPowered && mIsPowered
1168                && mPlugType == BatteryManager.BATTERY_PLUGGED_WIRELESS
1169                && !dockedOnWirelessCharger) {
1170            return false;
1171        }
1172
1173        // If already dreaming and becoming powered, then don't wake.
1174        if (mIsPowered && mWakefulness == WAKEFULNESS_DREAMING) {
1175            return false;
1176        }
1177
1178        // Otherwise wake up!
1179        return true;
1180    }
1181
1182    /**
1183     * Updates the value of mStayOn.
1184     * Sets DIRTY_STAY_ON if a change occurred.
1185     */
1186    private void updateStayOnLocked(int dirty) {
1187        if ((dirty & (DIRTY_BATTERY_STATE | DIRTY_SETTINGS)) != 0) {
1188            final boolean wasStayOn = mStayOn;
1189            if (mStayOnWhilePluggedInSetting != 0
1190                    && !isMaximumScreenOffTimeoutFromDeviceAdminEnforcedLocked()) {
1191                mStayOn = mBatteryService.isPowered(mStayOnWhilePluggedInSetting);
1192            } else {
1193                mStayOn = false;
1194            }
1195
1196            if (mStayOn != wasStayOn) {
1197                mDirty |= DIRTY_STAY_ON;
1198            }
1199        }
1200    }
1201
1202    /**
1203     * Updates the value of mWakeLockSummary to summarize the state of all active wake locks.
1204     * Note that most wake-locks are ignored when the system is asleep.
1205     *
1206     * This function must have no other side-effects.
1207     */
1208    @SuppressWarnings("deprecation")
1209    private void updateWakeLockSummaryLocked(int dirty) {
1210        if ((dirty & (DIRTY_WAKE_LOCKS | DIRTY_WAKEFULNESS)) != 0) {
1211            mWakeLockSummary = 0;
1212
1213            final int numWakeLocks = mWakeLocks.size();
1214            for (int i = 0; i < numWakeLocks; i++) {
1215                final WakeLock wakeLock = mWakeLocks.get(i);
1216                switch (wakeLock.mFlags & PowerManager.WAKE_LOCK_LEVEL_MASK) {
1217                    case PowerManager.PARTIAL_WAKE_LOCK:
1218                        mWakeLockSummary |= WAKE_LOCK_CPU;
1219                        break;
1220                    case PowerManager.FULL_WAKE_LOCK:
1221                        if (mWakefulness == WAKEFULNESS_AWAKE
1222                                || mWakefulness == WAKEFULNESS_DREAMING) {
1223                            mWakeLockSummary |= WAKE_LOCK_CPU
1224                                    | WAKE_LOCK_SCREEN_BRIGHT | WAKE_LOCK_BUTTON_BRIGHT;
1225                        }
1226                        if (mWakefulness == WAKEFULNESS_AWAKE) {
1227                            mWakeLockSummary |= WAKE_LOCK_STAY_AWAKE;
1228                        }
1229                        break;
1230                    case PowerManager.SCREEN_BRIGHT_WAKE_LOCK:
1231                        if (mWakefulness == WAKEFULNESS_AWAKE
1232                                || mWakefulness == WAKEFULNESS_DREAMING) {
1233                            mWakeLockSummary |= WAKE_LOCK_CPU | WAKE_LOCK_SCREEN_BRIGHT;
1234                        }
1235                        if (mWakefulness == WAKEFULNESS_AWAKE) {
1236                            mWakeLockSummary |= WAKE_LOCK_STAY_AWAKE;
1237                        }
1238                        break;
1239                    case PowerManager.SCREEN_DIM_WAKE_LOCK:
1240                        if (mWakefulness == WAKEFULNESS_AWAKE
1241                                || mWakefulness == WAKEFULNESS_DREAMING) {
1242                            mWakeLockSummary |= WAKE_LOCK_CPU | WAKE_LOCK_SCREEN_DIM;
1243                        }
1244                        if (mWakefulness == WAKEFULNESS_AWAKE) {
1245                            mWakeLockSummary |= WAKE_LOCK_STAY_AWAKE;
1246                        }
1247                        break;
1248                    case PowerManager.PROXIMITY_SCREEN_OFF_WAKE_LOCK:
1249                        if (mWakefulness == WAKEFULNESS_AWAKE
1250                                || mWakefulness == WAKEFULNESS_DREAMING
1251                                || mWakefulness == WAKEFULNESS_DOZING) {
1252                            mWakeLockSummary |= WAKE_LOCK_PROXIMITY_SCREEN_OFF;
1253                        }
1254                        break;
1255                    case PowerManager.DOZE_WAKE_LOCK:
1256                        if (mWakefulness == WAKEFULNESS_DOZING) {
1257                            mWakeLockSummary |= WAKE_LOCK_DOZE;
1258                        }
1259                        break;
1260                }
1261            }
1262
1263            if (DEBUG_SPEW) {
1264                Slog.d(TAG, "updateWakeLockSummaryLocked: mWakefulness="
1265                        + wakefulnessToString(mWakefulness)
1266                        + ", mWakeLockSummary=0x" + Integer.toHexString(mWakeLockSummary));
1267            }
1268        }
1269    }
1270
1271    /**
1272     * Updates the value of mUserActivitySummary to summarize the user requested
1273     * state of the system such as whether the screen should be bright or dim.
1274     * Note that user activity is ignored when the system is asleep.
1275     *
1276     * This function must have no other side-effects.
1277     */
1278    private void updateUserActivitySummaryLocked(long now, int dirty) {
1279        // Update the status of the user activity timeout timer.
1280        if ((dirty & (DIRTY_USER_ACTIVITY | DIRTY_WAKEFULNESS | DIRTY_SETTINGS)) != 0) {
1281            mHandler.removeMessages(MSG_USER_ACTIVITY_TIMEOUT);
1282
1283            long nextTimeout = 0;
1284            if (mWakefulness == WAKEFULNESS_AWAKE
1285                    || mWakefulness == WAKEFULNESS_DREAMING) {
1286                final int screenOffTimeout = getScreenOffTimeoutLocked();
1287                final int screenDimDuration = getScreenDimDurationLocked(screenOffTimeout);
1288
1289                mUserActivitySummary = 0;
1290                if (mLastUserActivityTime >= mLastWakeTime) {
1291                    nextTimeout = mLastUserActivityTime
1292                            + screenOffTimeout - screenDimDuration;
1293                    if (now < nextTimeout) {
1294                        mUserActivitySummary |= USER_ACTIVITY_SCREEN_BRIGHT;
1295                    } else {
1296                        nextTimeout = mLastUserActivityTime + screenOffTimeout;
1297                        if (now < nextTimeout) {
1298                            mUserActivitySummary |= USER_ACTIVITY_SCREEN_DIM;
1299                        }
1300                    }
1301                }
1302                if (mUserActivitySummary == 0
1303                        && mLastUserActivityTimeNoChangeLights >= mLastWakeTime) {
1304                    nextTimeout = mLastUserActivityTimeNoChangeLights + screenOffTimeout;
1305                    if (now < nextTimeout
1306                            && mDisplayPowerRequest.wantScreenOnNormal()) {
1307                        mUserActivitySummary = mDisplayPowerRequest.screenState
1308                                == DisplayPowerRequest.SCREEN_STATE_BRIGHT ?
1309                                USER_ACTIVITY_SCREEN_BRIGHT : USER_ACTIVITY_SCREEN_DIM;
1310                    }
1311                }
1312                if (mUserActivitySummary != 0) {
1313                    Message msg = mHandler.obtainMessage(MSG_USER_ACTIVITY_TIMEOUT);
1314                    msg.setAsynchronous(true);
1315                    mHandler.sendMessageAtTime(msg, nextTimeout);
1316                }
1317            } else {
1318                mUserActivitySummary = 0;
1319            }
1320
1321            if (DEBUG_SPEW) {
1322                Slog.d(TAG, "updateUserActivitySummaryLocked: mWakefulness="
1323                        + wakefulnessToString(mWakefulness)
1324                        + ", mUserActivitySummary=0x" + Integer.toHexString(mUserActivitySummary)
1325                        + ", nextTimeout=" + TimeUtils.formatUptime(nextTimeout));
1326            }
1327        }
1328    }
1329
1330    /**
1331     * Called when a user activity timeout has occurred.
1332     * Simply indicates that something about user activity has changed so that the new
1333     * state can be recomputed when the power state is updated.
1334     *
1335     * This function must have no other side-effects besides setting the dirty
1336     * bit and calling update power state.  Wakefulness transitions are handled elsewhere.
1337     */
1338    private void handleUserActivityTimeout() { // runs on handler thread
1339        synchronized (mLock) {
1340            if (DEBUG_SPEW) {
1341                Slog.d(TAG, "handleUserActivityTimeout");
1342            }
1343
1344            mDirty |= DIRTY_USER_ACTIVITY;
1345            updatePowerStateLocked();
1346        }
1347    }
1348
1349    private int getScreenOffTimeoutLocked() {
1350        int timeout = mScreenOffTimeoutSetting;
1351        if (isMaximumScreenOffTimeoutFromDeviceAdminEnforcedLocked()) {
1352            timeout = Math.min(timeout, mMaximumScreenOffTimeoutFromDeviceAdmin);
1353        }
1354        if (mUserActivityTimeoutOverrideFromWindowManager >= 0) {
1355            timeout = (int)Math.min(timeout, mUserActivityTimeoutOverrideFromWindowManager);
1356        }
1357        return Math.max(timeout, MINIMUM_SCREEN_OFF_TIMEOUT);
1358    }
1359
1360    private int getScreenDimDurationLocked(int screenOffTimeout) {
1361        return Math.min(SCREEN_DIM_DURATION,
1362                (int)(screenOffTimeout * MAXIMUM_SCREEN_DIM_RATIO));
1363    }
1364
1365    /**
1366     * Updates the wakefulness of the device.
1367     *
1368     * This is the function that decides whether the device should start dreaming
1369     * based on the current wake locks and user activity state.  It may modify mDirty
1370     * if the wakefulness changes.
1371     *
1372     * Returns true if the wakefulness changed and we need to restart power state calculation.
1373     */
1374    private boolean updateWakefulnessLocked(int dirty) {
1375        boolean changed = false;
1376        if ((dirty & (DIRTY_WAKE_LOCKS | DIRTY_USER_ACTIVITY | DIRTY_BOOT_COMPLETED
1377                | DIRTY_WAKEFULNESS | DIRTY_STAY_ON | DIRTY_PROXIMITY_POSITIVE
1378                | DIRTY_DOCK_STATE)) != 0) {
1379            if (mWakefulness == WAKEFULNESS_AWAKE && isItBedTimeYetLocked()) {
1380                if (DEBUG_SPEW) {
1381                    Slog.d(TAG, "updateWakefulnessLocked: Bed time...");
1382                }
1383                final long time = SystemClock.uptimeMillis();
1384                if (shouldNapAtBedTimeLocked()) {
1385                    changed = napNoUpdateLocked(time);
1386                } else {
1387                    changed = goToSleepNoUpdateLocked(time,
1388                            PowerManager.GO_TO_SLEEP_REASON_TIMEOUT);
1389                }
1390            }
1391        }
1392        return changed;
1393    }
1394
1395    /**
1396     * Returns true if the device should automatically nap and start dreaming when the user
1397     * activity timeout has expired and it's bedtime.
1398     */
1399    private boolean shouldNapAtBedTimeLocked() {
1400        return mDreamsActivateOnSleepSetting
1401                || (mDreamsActivateOnDockSetting
1402                        && mDockState != Intent.EXTRA_DOCK_STATE_UNDOCKED);
1403    }
1404
1405    /**
1406     * Returns true if the device should go to sleep now.
1407     * Also used when exiting a dream to determine whether we should go back
1408     * to being fully awake or else go to sleep for good.
1409     */
1410    private boolean isItBedTimeYetLocked() {
1411        return mBootCompleted && !isBeingKeptAwakeLocked();
1412    }
1413
1414    /**
1415     * Returns true if the device is being kept awake by a wake lock, user activity
1416     * or the stay on while powered setting.  We also keep the phone awake when
1417     * the proximity sensor returns a positive result so that the device does not
1418     * lock while in a phone call.  This function only controls whether the device
1419     * will go to sleep or dream which is independent of whether it will be allowed
1420     * to suspend.
1421     */
1422    private boolean isBeingKeptAwakeLocked() {
1423        return mStayOn
1424                || mProximityPositive
1425                || (mWakeLockSummary & WAKE_LOCK_STAY_AWAKE) != 0
1426                || (mUserActivitySummary & (USER_ACTIVITY_SCREEN_BRIGHT
1427                        | USER_ACTIVITY_SCREEN_DIM)) != 0;
1428    }
1429
1430    /**
1431     * Determines whether to post a message to the sandman to update the dream state.
1432     */
1433    private void updateDreamLocked(int dirty) {
1434        if ((dirty & (DIRTY_WAKEFULNESS
1435                | DIRTY_USER_ACTIVITY
1436                | DIRTY_WAKE_LOCKS
1437                | DIRTY_BOOT_COMPLETED
1438                | DIRTY_SETTINGS
1439                | DIRTY_IS_POWERED
1440                | DIRTY_STAY_ON
1441                | DIRTY_PROXIMITY_POSITIVE
1442                | DIRTY_BATTERY_STATE)) != 0) {
1443            scheduleSandmanLocked();
1444        }
1445    }
1446
1447    private void scheduleSandmanLocked() {
1448        if (!mSandmanScheduled) {
1449            mSandmanScheduled = true;
1450            Message msg = mHandler.obtainMessage(MSG_SANDMAN);
1451            msg.setAsynchronous(true);
1452            mHandler.sendMessage(msg);
1453        }
1454    }
1455
1456    /**
1457     * Called when the device enters or exits a dreaming or dozing state.
1458     *
1459     * We do this asynchronously because we must call out of the power manager to start
1460     * the dream and we don't want to hold our lock while doing so.  There is a risk that
1461     * the device will wake or go to sleep in the meantime so we have to handle that case.
1462     */
1463    private void handleSandman() { // runs on handler thread
1464        // Handle preconditions.
1465        final boolean startDreaming;
1466        final int wakefulness;
1467        synchronized (mLock) {
1468            mSandmanScheduled = false;
1469            wakefulness = mWakefulness;
1470            if (mSandmanSummoned) {
1471                startDreaming = ((wakefulness == WAKEFULNESS_DREAMING && canDreamLocked())
1472                        || wakefulness == WAKEFULNESS_DOZING);
1473                mSandmanSummoned = false;
1474            } else {
1475                startDreaming = false;
1476            }
1477        }
1478
1479        // Start dreaming if needed.
1480        // We only control the dream on the handler thread, so we don't need to worry about
1481        // concurrent attempts to start or stop the dream.
1482        final boolean isDreaming;
1483        if (mDreamManager != null) {
1484            // Restart the dream whenever the sandman is summoned.
1485            if (startDreaming) {
1486                mDreamManager.stopDream();
1487                mDreamManager.startDream(wakefulness == WAKEFULNESS_DOZING);
1488            }
1489            isDreaming = mDreamManager.isDreaming();
1490        } else {
1491            isDreaming = false;
1492        }
1493
1494        // Update dream state.
1495        synchronized (mLock) {
1496            // Remember the initial battery level when the dream started.
1497            if (startDreaming && isDreaming) {
1498                mBatteryLevelWhenDreamStarted = mBatteryLevel;
1499                if (wakefulness == WAKEFULNESS_DOZING) {
1500                    Slog.i(TAG, "Dozing...");
1501                } else {
1502                    Slog.i(TAG, "Dreaming...");
1503                }
1504            }
1505
1506            // If preconditions changed, wait for the next iteration to determine
1507            // whether the dream should continue (or be restarted).
1508            if (mSandmanSummoned || mWakefulness != wakefulness) {
1509                return; // wait for next cycle
1510            }
1511
1512            // Determine whether the dream should continue.
1513            if (wakefulness == WAKEFULNESS_DREAMING) {
1514                if (isDreaming && canDreamLocked()) {
1515                    if (mDreamsBatteryLevelDrainCutoffConfig >= 0
1516                            && mBatteryLevel < mBatteryLevelWhenDreamStarted
1517                                    - mDreamsBatteryLevelDrainCutoffConfig
1518                            && !isBeingKeptAwakeLocked()) {
1519                        // If the user activity timeout expired and the battery appears
1520                        // to be draining faster than it is charging then stop dreaming
1521                        // and go to sleep.
1522                        Slog.i(TAG, "Stopping dream because the battery appears to "
1523                                + "be draining faster than it is charging.  "
1524                                + "Battery level when dream started: "
1525                                + mBatteryLevelWhenDreamStarted + "%.  "
1526                                + "Battery level now: " + mBatteryLevel + "%.");
1527                    } else {
1528                        return; // continue dreaming
1529                    }
1530                }
1531
1532                // Dream has ended or will be stopped.  Update the power state.
1533                if (isItBedTimeYetLocked()) {
1534                    goToSleepNoUpdateLocked(SystemClock.uptimeMillis(),
1535                            PowerManager.GO_TO_SLEEP_REASON_TIMEOUT);
1536                    updatePowerStateLocked();
1537                } else {
1538                    wakeUpNoUpdateLocked(SystemClock.uptimeMillis());
1539                    updatePowerStateLocked();
1540                }
1541            } else if (wakefulness == WAKEFULNESS_DOZING) {
1542                if (isDreaming) {
1543                    return; // continue dozing
1544                }
1545
1546                // Doze has ended or will be stopped.  Update the power state.
1547                reallyGoToSleepNoUpdateLocked(SystemClock.uptimeMillis());
1548                updatePowerStateLocked();
1549            }
1550        }
1551
1552        // Stop dream.
1553        if (isDreaming) {
1554            mDreamManager.stopDream();
1555        }
1556    }
1557
1558    /**
1559     * Returns true if the device is allowed to dream in its current state.
1560     * This function is not called when dozing.
1561     */
1562    private boolean canDreamLocked() {
1563        if (mWakefulness != WAKEFULNESS_DREAMING
1564                || !mDreamsSupportedConfig
1565                || !mDreamsEnabledSetting
1566                || !mDisplayPowerRequest.wantScreenOnNormal()
1567                || !mBootCompleted) {
1568            return false;
1569        }
1570        if (!isBeingKeptAwakeLocked()) {
1571            if (!mIsPowered && !mDreamsEnabledOnBatteryConfig) {
1572                return false;
1573            }
1574            if (!mIsPowered
1575                    && mDreamsBatteryLevelMinimumWhenNotPoweredConfig >= 0
1576                    && mBatteryLevel < mDreamsBatteryLevelMinimumWhenNotPoweredConfig) {
1577                return false;
1578            }
1579            if (mIsPowered
1580                    && mDreamsBatteryLevelMinimumWhenPoweredConfig >= 0
1581                    && mBatteryLevel < mDreamsBatteryLevelMinimumWhenPoweredConfig) {
1582                return false;
1583            }
1584        }
1585        return true;
1586    }
1587
1588    private void handleScreenOnBlockerReleased() {
1589        synchronized (mLock) {
1590            mDirty |= DIRTY_SCREEN_ON_BLOCKER_RELEASED;
1591            updatePowerStateLocked();
1592        }
1593    }
1594
1595    /**
1596     * Updates the display power state asynchronously.
1597     * When the update is finished, mDisplayReady will be set to true.  The display
1598     * controller posts a message to tell us when the actual display power state
1599     * has been updated so we come back here to double-check and finish up.
1600     *
1601     * This function recalculates the display power state each time.
1602     */
1603    private void updateDisplayPowerStateLocked(int dirty) {
1604        if ((dirty & (DIRTY_WAKE_LOCKS | DIRTY_USER_ACTIVITY | DIRTY_WAKEFULNESS
1605                | DIRTY_ACTUAL_DISPLAY_POWER_STATE_UPDATED | DIRTY_BOOT_COMPLETED
1606                | DIRTY_SETTINGS | DIRTY_SCREEN_ON_BLOCKER_RELEASED)) != 0) {
1607            final int newScreenState = getDesiredScreenPowerStateLocked();
1608            mDisplayPowerRequest.screenState = newScreenState;
1609            nativeSetPowerState(isScreenOnLocked(),
1610                    newScreenState == DisplayPowerRequest.SCREEN_STATE_BRIGHT);
1611
1612            int screenBrightness = mScreenBrightnessSettingDefault;
1613            float screenAutoBrightnessAdjustment = 0.0f;
1614            boolean autoBrightness = (mScreenBrightnessModeSetting ==
1615                    Settings.System.SCREEN_BRIGHTNESS_MODE_AUTOMATIC);
1616            if (isValidBrightness(mScreenBrightnessOverrideFromWindowManager)) {
1617                screenBrightness = mScreenBrightnessOverrideFromWindowManager;
1618                autoBrightness = false;
1619            } else if (isValidBrightness(mTemporaryScreenBrightnessSettingOverride)) {
1620                screenBrightness = mTemporaryScreenBrightnessSettingOverride;
1621            } else if (isValidBrightness(mScreenBrightnessSetting)) {
1622                screenBrightness = mScreenBrightnessSetting;
1623            }
1624            if (autoBrightness) {
1625                screenBrightness = mScreenBrightnessSettingDefault;
1626                if (isValidAutoBrightnessAdjustment(
1627                        mTemporaryScreenAutoBrightnessAdjustmentSettingOverride)) {
1628                    screenAutoBrightnessAdjustment =
1629                            mTemporaryScreenAutoBrightnessAdjustmentSettingOverride;
1630                } else if (isValidAutoBrightnessAdjustment(
1631                        mScreenAutoBrightnessAdjustmentSetting)) {
1632                    screenAutoBrightnessAdjustment = mScreenAutoBrightnessAdjustmentSetting;
1633                }
1634            }
1635            screenBrightness = Math.max(Math.min(screenBrightness,
1636                    mScreenBrightnessSettingMaximum), mScreenBrightnessSettingMinimum);
1637            screenAutoBrightnessAdjustment = Math.max(Math.min(
1638                    screenAutoBrightnessAdjustment, 1.0f), -1.0f);
1639            mDisplayPowerRequest.screenBrightness = screenBrightness;
1640            mDisplayPowerRequest.screenAutoBrightnessAdjustment =
1641                    screenAutoBrightnessAdjustment;
1642            mDisplayPowerRequest.useAutoBrightness = autoBrightness;
1643
1644            mDisplayPowerRequest.useProximitySensor = shouldUseProximitySensorLocked();
1645
1646            mDisplayPowerRequest.blockScreenOn = mScreenOnBlocker.isHeld();
1647
1648            mDisplayReady = mDisplayPowerController.requestPowerState(mDisplayPowerRequest,
1649                    mRequestWaitForNegativeProximity);
1650            mRequestWaitForNegativeProximity = false;
1651
1652            if (DEBUG_SPEW) {
1653                Slog.d(TAG, "updateScreenStateLocked: mDisplayReady=" + mDisplayReady
1654                        + ", newScreenState=" + newScreenState
1655                        + ", mWakefulness=" + mWakefulness
1656                        + ", mWakeLockSummary=0x" + Integer.toHexString(mWakeLockSummary)
1657                        + ", mUserActivitySummary=0x" + Integer.toHexString(mUserActivitySummary)
1658                        + ", mBootCompleted=" + mBootCompleted);
1659            }
1660        }
1661    }
1662
1663    private static boolean isValidBrightness(int value) {
1664        return value >= 0 && value <= 255;
1665    }
1666
1667    private static boolean isValidAutoBrightnessAdjustment(float value) {
1668        // Handles NaN by always returning false.
1669        return value >= -1.0f && value <= 1.0f;
1670    }
1671
1672    private int getDesiredScreenPowerStateLocked() {
1673        if (mWakefulness == WAKEFULNESS_ASLEEP) {
1674            return DisplayPowerRequest.SCREEN_STATE_OFF;
1675        }
1676
1677        if ((mWakeLockSummary & WAKE_LOCK_DOZE) != 0) {
1678            return DisplayPowerRequest.SCREEN_STATE_DOZE;
1679        }
1680
1681        if ((mWakeLockSummary & WAKE_LOCK_SCREEN_BRIGHT) != 0
1682                || (mUserActivitySummary & USER_ACTIVITY_SCREEN_BRIGHT) != 0
1683                || !mBootCompleted) {
1684            return DisplayPowerRequest.SCREEN_STATE_BRIGHT;
1685        }
1686
1687        return DisplayPowerRequest.SCREEN_STATE_DIM;
1688    }
1689
1690    private final DisplayPowerController.Callbacks mDisplayPowerControllerCallbacks =
1691            new DisplayPowerController.Callbacks() {
1692        @Override
1693        public void onStateChanged() {
1694            synchronized (mLock) {
1695                mDirty |= DIRTY_ACTUAL_DISPLAY_POWER_STATE_UPDATED;
1696                updatePowerStateLocked();
1697            }
1698        }
1699
1700        @Override
1701        public void onProximityPositive() {
1702            synchronized (mLock) {
1703                mProximityPositive = true;
1704                mDirty |= DIRTY_PROXIMITY_POSITIVE;
1705                updatePowerStateLocked();
1706            }
1707        }
1708
1709        @Override
1710        public void onProximityNegative() {
1711            synchronized (mLock) {
1712                mProximityPositive = false;
1713                mDirty |= DIRTY_PROXIMITY_POSITIVE;
1714                userActivityNoUpdateLocked(SystemClock.uptimeMillis(),
1715                        PowerManager.USER_ACTIVITY_EVENT_OTHER, 0, Process.SYSTEM_UID);
1716                updatePowerStateLocked();
1717            }
1718        }
1719    };
1720
1721    private boolean shouldUseProximitySensorLocked() {
1722        return (mWakeLockSummary & WAKE_LOCK_PROXIMITY_SCREEN_OFF) != 0;
1723    }
1724
1725    /**
1726     * Updates the suspend blocker that keeps the CPU alive.
1727     *
1728     * This function must have no other side-effects.
1729     */
1730    private void updateSuspendBlockerLocked() {
1731        final boolean needWakeLockSuspendBlocker = ((mWakeLockSummary & WAKE_LOCK_CPU) != 0);
1732        final boolean needDisplaySuspendBlocker = needDisplaySuspendBlockerLocked();
1733        final boolean autoSuspend = !needDisplaySuspendBlocker;
1734
1735        // Disable auto-suspend if needed.
1736        if (!autoSuspend) {
1737            if (mDecoupleAutoSuspendModeFromDisplayConfig) {
1738                setAutoSuspendModeLocked(false);
1739            }
1740            if (mDecoupleInteractiveModeFromDisplayConfig) {
1741                setInteractiveModeLocked(true);
1742            }
1743        }
1744
1745        // First acquire suspend blockers if needed.
1746        if (needWakeLockSuspendBlocker && !mHoldingWakeLockSuspendBlocker) {
1747            mWakeLockSuspendBlocker.acquire();
1748            mHoldingWakeLockSuspendBlocker = true;
1749        }
1750        if (needDisplaySuspendBlocker && !mHoldingDisplaySuspendBlocker) {
1751            mDisplaySuspendBlocker.acquire();
1752            mHoldingDisplaySuspendBlocker = true;
1753        }
1754
1755        // Then release suspend blockers if needed.
1756        if (!needWakeLockSuspendBlocker && mHoldingWakeLockSuspendBlocker) {
1757            mWakeLockSuspendBlocker.release();
1758            mHoldingWakeLockSuspendBlocker = false;
1759        }
1760        if (!needDisplaySuspendBlocker && mHoldingDisplaySuspendBlocker) {
1761            mDisplaySuspendBlocker.release();
1762            mHoldingDisplaySuspendBlocker = false;
1763        }
1764
1765        // Enable auto-suspend if needed.
1766        if (autoSuspend) {
1767            if (mDecoupleInteractiveModeFromDisplayConfig) {
1768                setInteractiveModeLocked(false);
1769            }
1770            if (mDecoupleAutoSuspendModeFromDisplayConfig) {
1771                setAutoSuspendModeLocked(true);
1772            }
1773        }
1774    }
1775
1776    /**
1777     * Return true if we must keep a suspend blocker active on behalf of the display.
1778     * We do so if the screen is on or is in transition between states.
1779     */
1780    private boolean needDisplaySuspendBlockerLocked() {
1781        if (!mDisplayReady) {
1782            return true;
1783        }
1784        if (mDisplayPowerRequest.wantScreenOnNormal()) {
1785            // If we asked for the screen to be on but it is off due to the proximity
1786            // sensor then we may suspend but only if the configuration allows it.
1787            // On some hardware it may not be safe to suspend because the proximity
1788            // sensor may not be correctly configured as a wake-up source.
1789            if (!mDisplayPowerRequest.useProximitySensor || !mProximityPositive
1790                    || !mSuspendWhenScreenOffDueToProximityConfig) {
1791                return true;
1792            }
1793        }
1794        // Let the system suspend if the screen is off or dozing.
1795        return false;
1796    }
1797
1798    private void setAutoSuspendModeLocked(boolean enable) {
1799        if (enable != mAutoSuspendModeEnabled) {
1800            if (DEBUG) {
1801                Slog.d(TAG, "Setting auto-suspend mode to " + enable);
1802            }
1803            mAutoSuspendModeEnabled = enable;
1804            nativeSetAutoSuspend(enable);
1805        }
1806    }
1807
1808    private void setInteractiveModeLocked(boolean enable) {
1809        if (enable != mInteractiveModeEnabled) {
1810            if (DEBUG) {
1811                Slog.d(TAG, "Setting interactive mode to " + enable);
1812            }
1813            mInteractiveModeEnabled = enable;
1814            nativeSetInteractive(enable);
1815        }
1816    }
1817
1818    private boolean isScreenOnInternal() {
1819        synchronized (mLock) {
1820            // XXX This is a temporary hack to let certain parts of the system pretend the
1821            // screen is still on even when dozing and we would normally want to report
1822            // screen off.  Will be removed when the window manager is modified to use
1823            // the true blanking state of the display.
1824            return isScreenOnLocked()
1825                    || mWakefulness == WAKEFULNESS_DOZING;
1826        }
1827    }
1828
1829    private boolean isScreenOnLocked() {
1830        return mWakefulness == WAKEFULNESS_AWAKE
1831                || mWakefulness == WAKEFULNESS_DREAMING;
1832    }
1833
1834    private void handleBatteryStateChangedLocked() {
1835        mDirty |= DIRTY_BATTERY_STATE;
1836        updatePowerStateLocked();
1837    }
1838
1839    private void startWatchingForBootAnimationFinished() {
1840        mHandler.sendEmptyMessage(MSG_CHECK_IF_BOOT_ANIMATION_FINISHED);
1841    }
1842
1843    private void checkIfBootAnimationFinished() {
1844        if (DEBUG) {
1845            Slog.d(TAG, "Check if boot animation finished...");
1846        }
1847
1848        if (SystemService.isRunning(BOOT_ANIMATION_SERVICE)) {
1849            mHandler.sendEmptyMessageDelayed(MSG_CHECK_IF_BOOT_ANIMATION_FINISHED,
1850                    BOOT_ANIMATION_POLL_INTERVAL);
1851            return;
1852        }
1853
1854        synchronized (mLock) {
1855            if (!mBootCompleted) {
1856                Slog.i(TAG, "Boot animation finished.");
1857                handleBootCompletedLocked();
1858            }
1859        }
1860    }
1861
1862    private void handleBootCompletedLocked() {
1863        final long now = SystemClock.uptimeMillis();
1864        mBootCompleted = true;
1865        mDirty |= DIRTY_BOOT_COMPLETED;
1866        userActivityNoUpdateLocked(
1867                now, PowerManager.USER_ACTIVITY_EVENT_OTHER, 0, Process.SYSTEM_UID);
1868        updatePowerStateLocked();
1869    }
1870
1871    private void shutdownOrRebootInternal(final boolean shutdown, final boolean confirm,
1872            final String reason, boolean wait) {
1873        if (mHandler == null || !mSystemReady) {
1874            throw new IllegalStateException("Too early to call shutdown() or reboot()");
1875        }
1876
1877        Runnable runnable = new Runnable() {
1878            @Override
1879            public void run() {
1880                synchronized (this) {
1881                    if (shutdown) {
1882                        ShutdownThread.shutdown(mContext, confirm);
1883                    } else {
1884                        ShutdownThread.reboot(mContext, reason, confirm);
1885                    }
1886                }
1887            }
1888        };
1889
1890        // ShutdownThread must run on a looper capable of displaying the UI.
1891        Message msg = Message.obtain(mHandler, runnable);
1892        msg.setAsynchronous(true);
1893        mHandler.sendMessage(msg);
1894
1895        // PowerManager.reboot() is documented not to return so just wait for the inevitable.
1896        if (wait) {
1897            synchronized (runnable) {
1898                while (true) {
1899                    try {
1900                        runnable.wait();
1901                    } catch (InterruptedException e) {
1902                    }
1903                }
1904            }
1905        }
1906    }
1907
1908    private void crashInternal(final String message) {
1909        Thread t = new Thread("PowerManagerService.crash()") {
1910            @Override
1911            public void run() {
1912                throw new RuntimeException(message);
1913            }
1914        };
1915        try {
1916            t.start();
1917            t.join();
1918        } catch (InterruptedException e) {
1919            Log.wtf(TAG, e);
1920        }
1921    }
1922
1923    private void setStayOnSettingInternal(int val) {
1924        Settings.Global.putInt(mContext.getContentResolver(),
1925                Settings.Global.STAY_ON_WHILE_PLUGGED_IN, val);
1926    }
1927
1928    private void setMaximumScreenOffTimeoutFromDeviceAdminInternal(int timeMs) {
1929        synchronized (mLock) {
1930            mMaximumScreenOffTimeoutFromDeviceAdmin = timeMs;
1931            mDirty |= DIRTY_SETTINGS;
1932            updatePowerStateLocked();
1933        }
1934    }
1935
1936    private boolean isMaximumScreenOffTimeoutFromDeviceAdminEnforcedLocked() {
1937        return mMaximumScreenOffTimeoutFromDeviceAdmin >= 0
1938                && mMaximumScreenOffTimeoutFromDeviceAdmin < Integer.MAX_VALUE;
1939    }
1940
1941    private void setAttentionLightInternal(boolean on, int color) {
1942        Light light;
1943        synchronized (mLock) {
1944            if (!mSystemReady) {
1945                return;
1946            }
1947            light = mAttentionLight;
1948        }
1949
1950        // Control light outside of lock.
1951        light.setFlashing(color, Light.LIGHT_FLASH_HARDWARE, (on ? 3 : 0), 0);
1952    }
1953
1954    private void setScreenBrightnessOverrideFromWindowManagerInternal(int brightness) {
1955        synchronized (mLock) {
1956            if (mScreenBrightnessOverrideFromWindowManager != brightness) {
1957                mScreenBrightnessOverrideFromWindowManager = brightness;
1958                mDirty |= DIRTY_SETTINGS;
1959                updatePowerStateLocked();
1960            }
1961        }
1962    }
1963
1964    private void setUserActivityTimeoutOverrideFromWindowManagerInternal(long timeoutMillis) {
1965        synchronized (mLock) {
1966            if (mUserActivityTimeoutOverrideFromWindowManager != timeoutMillis) {
1967                mUserActivityTimeoutOverrideFromWindowManager = timeoutMillis;
1968                mDirty |= DIRTY_SETTINGS;
1969                updatePowerStateLocked();
1970            }
1971        }
1972    }
1973
1974    private void setTemporaryScreenBrightnessSettingOverrideInternal(int brightness) {
1975        synchronized (mLock) {
1976            if (mTemporaryScreenBrightnessSettingOverride != brightness) {
1977                mTemporaryScreenBrightnessSettingOverride = brightness;
1978                mDirty |= DIRTY_SETTINGS;
1979                updatePowerStateLocked();
1980            }
1981        }
1982    }
1983
1984    private void setTemporaryScreenAutoBrightnessAdjustmentSettingOverrideInternal(float adj) {
1985        synchronized (mLock) {
1986            // Note: This condition handles NaN because NaN is not equal to any other
1987            // value, including itself.
1988            if (mTemporaryScreenAutoBrightnessAdjustmentSettingOverride != adj) {
1989                mTemporaryScreenAutoBrightnessAdjustmentSettingOverride = adj;
1990                mDirty |= DIRTY_SETTINGS;
1991                updatePowerStateLocked();
1992            }
1993        }
1994    }
1995
1996    /**
1997     * Low-level function turn the device off immediately, without trying
1998     * to be clean.  Most people should use {@link ShutdownThread} for a clean shutdown.
1999     */
2000    public static void lowLevelShutdown() {
2001        SystemProperties.set("sys.powerctl", "shutdown");
2002    }
2003
2004    /**
2005     * Low-level function to reboot the device. On success, this
2006     * function doesn't return. If more than 20 seconds passes from
2007     * the time a reboot is requested (120 seconds for reboot to
2008     * recovery), this method returns.
2009     *
2010     * @param reason code to pass to the kernel (e.g. "recovery"), or null.
2011     */
2012    public static void lowLevelReboot(String reason) {
2013        if (reason == null) {
2014            reason = "";
2015        }
2016        long duration;
2017        if (reason.equals(PowerManager.REBOOT_RECOVERY)) {
2018            // If we are rebooting to go into recovery, instead of
2019            // setting sys.powerctl directly we'll start the
2020            // pre-recovery service which will do some preparation for
2021            // recovery and then reboot for us.
2022            //
2023            // This preparation can take more than 20 seconds if
2024            // there's a very large update package, so lengthen the
2025            // timeout.
2026            SystemProperties.set("ctl.start", "pre-recovery");
2027            duration = 120 * 1000L;
2028        } else {
2029            SystemProperties.set("sys.powerctl", "reboot," + reason);
2030            duration = 20 * 1000L;
2031        }
2032        try {
2033            Thread.sleep(duration);
2034        } catch (InterruptedException e) {
2035            Thread.currentThread().interrupt();
2036        }
2037    }
2038
2039    @Override // Watchdog.Monitor implementation
2040    public void monitor() {
2041        // Grab and release lock for watchdog monitor to detect deadlocks.
2042        synchronized (mLock) {
2043        }
2044    }
2045
2046    private void dumpInternal(PrintWriter pw) {
2047        pw.println("POWER MANAGER (dumpsys power)\n");
2048
2049        final DisplayPowerController dpc;
2050        final WirelessChargerDetector wcd;
2051        synchronized (mLock) {
2052            pw.println("Power Manager State:");
2053            pw.println("  mDirty=0x" + Integer.toHexString(mDirty));
2054            pw.println("  mWakefulness=" + wakefulnessToString(mWakefulness));
2055            pw.println("  mIsPowered=" + mIsPowered);
2056            pw.println("  mPlugType=" + mPlugType);
2057            pw.println("  mBatteryLevel=" + mBatteryLevel);
2058            pw.println("  mBatteryLevelWhenDreamStarted=" + mBatteryLevelWhenDreamStarted);
2059            pw.println("  mDockState=" + mDockState);
2060            pw.println("  mStayOn=" + mStayOn);
2061            pw.println("  mProximityPositive=" + mProximityPositive);
2062            pw.println("  mBootCompleted=" + mBootCompleted);
2063            pw.println("  mSystemReady=" + mSystemReady);
2064            pw.println("  mAutoSuspendModeEnabled=" + mAutoSuspendModeEnabled);
2065            pw.println("  mInteactiveModeEnabled=" + mInteractiveModeEnabled);
2066            pw.println("  mWakeLockSummary=0x" + Integer.toHexString(mWakeLockSummary));
2067            pw.println("  mUserActivitySummary=0x" + Integer.toHexString(mUserActivitySummary));
2068            pw.println("  mRequestWaitForNegativeProximity=" + mRequestWaitForNegativeProximity);
2069            pw.println("  mSandmanScheduled=" + mSandmanScheduled);
2070            pw.println("  mSandmanSummoned=" + mSandmanSummoned);
2071            pw.println("  mLastWakeTime=" + TimeUtils.formatUptime(mLastWakeTime));
2072            pw.println("  mLastSleepTime=" + TimeUtils.formatUptime(mLastSleepTime));
2073            pw.println("  mSendWakeUpFinishedNotificationWhenReady="
2074                    + mSendWakeUpFinishedNotificationWhenReady);
2075            pw.println("  mSendGoToSleepFinishedNotificationWhenReady="
2076                    + mSendGoToSleepFinishedNotificationWhenReady);
2077            pw.println("  mLastUserActivityTime=" + TimeUtils.formatUptime(mLastUserActivityTime));
2078            pw.println("  mLastUserActivityTimeNoChangeLights="
2079                    + TimeUtils.formatUptime(mLastUserActivityTimeNoChangeLights));
2080            pw.println("  mDisplayReady=" + mDisplayReady);
2081            pw.println("  mHoldingWakeLockSuspendBlocker=" + mHoldingWakeLockSuspendBlocker);
2082            pw.println("  mHoldingDisplaySuspendBlocker=" + mHoldingDisplaySuspendBlocker);
2083
2084            pw.println();
2085            pw.println("Settings and Configuration:");
2086            pw.println("  mDecoupleAutoSuspendModeFromDisplayConfig="
2087                    + mDecoupleAutoSuspendModeFromDisplayConfig);
2088            pw.println("  mDecoupleInteractiveModeFromDisplayConfig="
2089                    + mDecoupleInteractiveModeFromDisplayConfig);
2090            pw.println("  mWakeUpWhenPluggedOrUnpluggedConfig="
2091                    + mWakeUpWhenPluggedOrUnpluggedConfig);
2092            pw.println("  mSuspendWhenScreenOffDueToProximityConfig="
2093                    + mSuspendWhenScreenOffDueToProximityConfig);
2094            pw.println("  mDreamsSupportedConfig=" + mDreamsSupportedConfig);
2095            pw.println("  mDreamsEnabledByDefaultConfig=" + mDreamsEnabledByDefaultConfig);
2096            pw.println("  mDreamsActivatedOnSleepByDefaultConfig="
2097                    + mDreamsActivatedOnSleepByDefaultConfig);
2098            pw.println("  mDreamsActivatedOnDockByDefaultConfig="
2099                    + mDreamsActivatedOnDockByDefaultConfig);
2100            pw.println("  mDreamsEnabledOnBatteryConfig="
2101                    + mDreamsEnabledOnBatteryConfig);
2102            pw.println("  mDreamsBatteryLevelMinimumWhenPoweredConfig="
2103                    + mDreamsBatteryLevelMinimumWhenPoweredConfig);
2104            pw.println("  mDreamsBatteryLevelMinimumWhenNotPoweredConfig="
2105                    + mDreamsBatteryLevelMinimumWhenNotPoweredConfig);
2106            pw.println("  mDreamsBatteryLevelDrainCutoffConfig="
2107                    + mDreamsBatteryLevelDrainCutoffConfig);
2108            pw.println("  mDreamsEnabledSetting=" + mDreamsEnabledSetting);
2109            pw.println("  mDreamsActivateOnSleepSetting=" + mDreamsActivateOnSleepSetting);
2110            pw.println("  mDreamsActivateOnDockSetting=" + mDreamsActivateOnDockSetting);
2111            pw.println("  mScreenOffTimeoutSetting=" + mScreenOffTimeoutSetting);
2112            pw.println("  mMaximumScreenOffTimeoutFromDeviceAdmin="
2113                    + mMaximumScreenOffTimeoutFromDeviceAdmin + " (enforced="
2114                    + isMaximumScreenOffTimeoutFromDeviceAdminEnforcedLocked() + ")");
2115            pw.println("  mStayOnWhilePluggedInSetting=" + mStayOnWhilePluggedInSetting);
2116            pw.println("  mScreenBrightnessSetting=" + mScreenBrightnessSetting);
2117            pw.println("  mScreenAutoBrightnessAdjustmentSetting="
2118                    + mScreenAutoBrightnessAdjustmentSetting);
2119            pw.println("  mScreenBrightnessModeSetting=" + mScreenBrightnessModeSetting);
2120            pw.println("  mScreenBrightnessOverrideFromWindowManager="
2121                    + mScreenBrightnessOverrideFromWindowManager);
2122            pw.println("  mUserActivityTimeoutOverrideFromWindowManager="
2123                    + mUserActivityTimeoutOverrideFromWindowManager);
2124            pw.println("  mTemporaryScreenBrightnessSettingOverride="
2125                    + mTemporaryScreenBrightnessSettingOverride);
2126            pw.println("  mTemporaryScreenAutoBrightnessAdjustmentSettingOverride="
2127                    + mTemporaryScreenAutoBrightnessAdjustmentSettingOverride);
2128            pw.println("  mScreenBrightnessSettingMinimum=" + mScreenBrightnessSettingMinimum);
2129            pw.println("  mScreenBrightnessSettingMaximum=" + mScreenBrightnessSettingMaximum);
2130            pw.println("  mScreenBrightnessSettingDefault=" + mScreenBrightnessSettingDefault);
2131
2132            final int screenOffTimeout = getScreenOffTimeoutLocked();
2133            final int screenDimDuration = getScreenDimDurationLocked(screenOffTimeout);
2134            pw.println();
2135            pw.println("Screen off timeout: " + screenOffTimeout + " ms");
2136            pw.println("Screen dim duration: " + screenDimDuration + " ms");
2137
2138            pw.println();
2139            pw.println("Wake Locks: size=" + mWakeLocks.size());
2140            for (WakeLock wl : mWakeLocks) {
2141                pw.println("  " + wl);
2142            }
2143
2144            pw.println();
2145            pw.println("Suspend Blockers: size=" + mSuspendBlockers.size());
2146            for (SuspendBlocker sb : mSuspendBlockers) {
2147                pw.println("  " + sb);
2148            }
2149
2150            pw.println();
2151            pw.println("Screen On Blocker: " + mScreenOnBlocker);
2152
2153            pw.println();
2154            pw.println("Display Blanker: " + mDisplayBlanker);
2155
2156            dpc = mDisplayPowerController;
2157            wcd = mWirelessChargerDetector;
2158        }
2159
2160        if (dpc != null) {
2161            dpc.dump(pw);
2162        }
2163
2164        if (wcd != null) {
2165            wcd.dump(pw);
2166        }
2167    }
2168
2169    private SuspendBlocker createSuspendBlockerLocked(String name) {
2170        SuspendBlocker suspendBlocker = new SuspendBlockerImpl(name);
2171        mSuspendBlockers.add(suspendBlocker);
2172        return suspendBlocker;
2173    }
2174
2175    private static String wakefulnessToString(int wakefulness) {
2176        switch (wakefulness) {
2177            case WAKEFULNESS_ASLEEP:
2178                return "Asleep";
2179            case WAKEFULNESS_AWAKE:
2180                return "Awake";
2181            case WAKEFULNESS_DREAMING:
2182                return "Dreaming";
2183            case WAKEFULNESS_DOZING:
2184                return "Dozing";
2185            default:
2186                return Integer.toString(wakefulness);
2187        }
2188    }
2189
2190    private static WorkSource copyWorkSource(WorkSource workSource) {
2191        return workSource != null ? new WorkSource(workSource) : null;
2192    }
2193
2194    private final class BatteryReceiver extends BroadcastReceiver {
2195        @Override
2196        public void onReceive(Context context, Intent intent) {
2197            synchronized (mLock) {
2198                handleBatteryStateChangedLocked();
2199            }
2200        }
2201    }
2202
2203    private final class BootCompletedReceiver extends BroadcastReceiver {
2204        @Override
2205        public void onReceive(Context context, Intent intent) {
2206            // This is our early signal that the system thinks it has finished booting.
2207            // However, the boot animation may still be running for a few more seconds
2208            // since it is ultimately in charge of when it terminates.
2209            // Defer transitioning into the boot completed state until the animation exits.
2210            // We do this so that the screen does not start to dim prematurely before
2211            // the user has actually had a chance to interact with the device.
2212            startWatchingForBootAnimationFinished();
2213        }
2214    }
2215
2216    private final class DreamReceiver extends BroadcastReceiver {
2217        @Override
2218        public void onReceive(Context context, Intent intent) {
2219            synchronized (mLock) {
2220                scheduleSandmanLocked();
2221            }
2222        }
2223    }
2224
2225    private final class UserSwitchedReceiver extends BroadcastReceiver {
2226        @Override
2227        public void onReceive(Context context, Intent intent) {
2228            synchronized (mLock) {
2229                handleSettingsChangedLocked();
2230            }
2231        }
2232    }
2233
2234    private final class DockReceiver extends BroadcastReceiver {
2235        @Override
2236        public void onReceive(Context context, Intent intent) {
2237            synchronized (mLock) {
2238                int dockState = intent.getIntExtra(Intent.EXTRA_DOCK_STATE,
2239                        Intent.EXTRA_DOCK_STATE_UNDOCKED);
2240                if (mDockState != dockState) {
2241                    mDockState = dockState;
2242                    mDirty |= DIRTY_DOCK_STATE;
2243                    updatePowerStateLocked();
2244                }
2245            }
2246        }
2247    }
2248
2249    private final class SettingsObserver extends ContentObserver {
2250        public SettingsObserver(Handler handler) {
2251            super(handler);
2252        }
2253
2254        @Override
2255        public void onChange(boolean selfChange, Uri uri) {
2256            synchronized (mLock) {
2257                handleSettingsChangedLocked();
2258            }
2259        }
2260    }
2261
2262    /**
2263     * Handler for asynchronous operations performed by the power manager.
2264     */
2265    private final class PowerManagerHandler extends Handler {
2266        public PowerManagerHandler(Looper looper) {
2267            super(looper, null, true /*async*/);
2268        }
2269
2270        @Override
2271        public void handleMessage(Message msg) {
2272            switch (msg.what) {
2273                case MSG_USER_ACTIVITY_TIMEOUT:
2274                    handleUserActivityTimeout();
2275                    break;
2276                case MSG_SANDMAN:
2277                    handleSandman();
2278                    break;
2279                case MSG_SCREEN_ON_BLOCKER_RELEASED:
2280                    handleScreenOnBlockerReleased();
2281                    break;
2282                case MSG_CHECK_IF_BOOT_ANIMATION_FINISHED:
2283                    checkIfBootAnimationFinished();
2284                    break;
2285            }
2286        }
2287    }
2288
2289    /**
2290     * Represents a wake lock that has been acquired by an application.
2291     */
2292    private final class WakeLock implements IBinder.DeathRecipient {
2293        public final IBinder mLock;
2294        public int mFlags;
2295        public String mTag;
2296        public final String mPackageName;
2297        public WorkSource mWorkSource;
2298        public String mHistoryTag;
2299        public final int mOwnerUid;
2300        public final int mOwnerPid;
2301        public boolean mNotifiedAcquired;
2302
2303        public WakeLock(IBinder lock, int flags, String tag, String packageName,
2304                WorkSource workSource, String historyTag, int ownerUid, int ownerPid) {
2305            mLock = lock;
2306            mFlags = flags;
2307            mTag = tag;
2308            mPackageName = packageName;
2309            mWorkSource = copyWorkSource(workSource);
2310            mHistoryTag = historyTag;
2311            mOwnerUid = ownerUid;
2312            mOwnerPid = ownerPid;
2313        }
2314
2315        @Override
2316        public void binderDied() {
2317            PowerManagerService.this.handleWakeLockDeath(this);
2318        }
2319
2320        public boolean hasSameProperties(int flags, String tag, WorkSource workSource,
2321                int ownerUid, int ownerPid) {
2322            return mFlags == flags
2323                    && mTag.equals(tag)
2324                    && hasSameWorkSource(workSource)
2325                    && mOwnerUid == ownerUid
2326                    && mOwnerPid == ownerPid;
2327        }
2328
2329        public void updateProperties(int flags, String tag, String packageName,
2330                WorkSource workSource, String historyTag, int ownerUid, int ownerPid) {
2331            if (!mPackageName.equals(packageName)) {
2332                throw new IllegalStateException("Existing wake lock package name changed: "
2333                        + mPackageName + " to " + packageName);
2334            }
2335            if (mOwnerUid != ownerUid) {
2336                throw new IllegalStateException("Existing wake lock uid changed: "
2337                        + mOwnerUid + " to " + ownerUid);
2338            }
2339            if (mOwnerPid != ownerPid) {
2340                throw new IllegalStateException("Existing wake lock pid changed: "
2341                        + mOwnerPid + " to " + ownerPid);
2342            }
2343            mFlags = flags;
2344            mTag = tag;
2345            updateWorkSource(workSource);
2346            mHistoryTag = historyTag;
2347        }
2348
2349        public boolean hasSameWorkSource(WorkSource workSource) {
2350            return Objects.equal(mWorkSource, workSource);
2351        }
2352
2353        public void updateWorkSource(WorkSource workSource) {
2354            mWorkSource = copyWorkSource(workSource);
2355        }
2356
2357        @Override
2358        public String toString() {
2359            return getLockLevelString()
2360                    + " '" + mTag + "'" + getLockFlagsString()
2361                    + " (uid=" + mOwnerUid + ", pid=" + mOwnerPid + ", ws=" + mWorkSource + ")";
2362        }
2363
2364        @SuppressWarnings("deprecation")
2365        private String getLockLevelString() {
2366            switch (mFlags & PowerManager.WAKE_LOCK_LEVEL_MASK) {
2367                case PowerManager.FULL_WAKE_LOCK:
2368                    return "FULL_WAKE_LOCK                ";
2369                case PowerManager.SCREEN_BRIGHT_WAKE_LOCK:
2370                    return "SCREEN_BRIGHT_WAKE_LOCK       ";
2371                case PowerManager.SCREEN_DIM_WAKE_LOCK:
2372                    return "SCREEN_DIM_WAKE_LOCK          ";
2373                case PowerManager.PARTIAL_WAKE_LOCK:
2374                    return "PARTIAL_WAKE_LOCK             ";
2375                case PowerManager.PROXIMITY_SCREEN_OFF_WAKE_LOCK:
2376                    return "PROXIMITY_SCREEN_OFF_WAKE_LOCK";
2377                case PowerManager.DOZE_WAKE_LOCK:
2378                    return "DOZE_WAKE_LOCK                ";
2379                default:
2380                    return "???                           ";
2381            }
2382        }
2383
2384        private String getLockFlagsString() {
2385            String result = "";
2386            if ((mFlags & PowerManager.ACQUIRE_CAUSES_WAKEUP) != 0) {
2387                result += " ACQUIRE_CAUSES_WAKEUP";
2388            }
2389            if ((mFlags & PowerManager.ON_AFTER_RELEASE) != 0) {
2390                result += " ON_AFTER_RELEASE";
2391            }
2392            return result;
2393        }
2394    }
2395
2396    private final class SuspendBlockerImpl implements SuspendBlocker {
2397        private final String mName;
2398        private int mReferenceCount;
2399
2400        public SuspendBlockerImpl(String name) {
2401            mName = name;
2402        }
2403
2404        @Override
2405        protected void finalize() throws Throwable {
2406            try {
2407                if (mReferenceCount != 0) {
2408                    Log.wtf(TAG, "Suspend blocker \"" + mName
2409                            + "\" was finalized without being released!");
2410                    mReferenceCount = 0;
2411                    nativeReleaseSuspendBlocker(mName);
2412                }
2413            } finally {
2414                super.finalize();
2415            }
2416        }
2417
2418        @Override
2419        public void acquire() {
2420            synchronized (this) {
2421                mReferenceCount += 1;
2422                if (mReferenceCount == 1) {
2423                    if (DEBUG_SPEW) {
2424                        Slog.d(TAG, "Acquiring suspend blocker \"" + mName + "\".");
2425                    }
2426                    nativeAcquireSuspendBlocker(mName);
2427                }
2428            }
2429        }
2430
2431        @Override
2432        public void release() {
2433            synchronized (this) {
2434                mReferenceCount -= 1;
2435                if (mReferenceCount == 0) {
2436                    if (DEBUG_SPEW) {
2437                        Slog.d(TAG, "Releasing suspend blocker \"" + mName + "\".");
2438                    }
2439                    nativeReleaseSuspendBlocker(mName);
2440                } else if (mReferenceCount < 0) {
2441                    Log.wtf(TAG, "Suspend blocker \"" + mName
2442                            + "\" was released without being acquired!", new Throwable());
2443                    mReferenceCount = 0;
2444                }
2445            }
2446        }
2447
2448        @Override
2449        public String toString() {
2450            synchronized (this) {
2451                return mName + ": ref count=" + mReferenceCount;
2452            }
2453        }
2454    }
2455
2456    private final class ScreenOnBlockerImpl implements ScreenOnBlocker {
2457        private int mNestCount;
2458
2459        public boolean isHeld() {
2460            synchronized (this) {
2461                return mNestCount != 0;
2462            }
2463        }
2464
2465        @Override
2466        public void acquire() {
2467            synchronized (this) {
2468                mNestCount += 1;
2469                if (DEBUG) {
2470                    Slog.d(TAG, "Screen on blocked: mNestCount=" + mNestCount);
2471                }
2472            }
2473        }
2474
2475        @Override
2476        public void release() {
2477            synchronized (this) {
2478                mNestCount -= 1;
2479                if (mNestCount < 0) {
2480                    Log.wtf(TAG, "Screen on blocker was released without being acquired!",
2481                            new Throwable());
2482                    mNestCount = 0;
2483                }
2484                if (mNestCount == 0) {
2485                    mHandler.sendEmptyMessage(MSG_SCREEN_ON_BLOCKER_RELEASED);
2486                }
2487                if (DEBUG) {
2488                    Slog.d(TAG, "Screen on unblocked: mNestCount=" + mNestCount);
2489                }
2490            }
2491        }
2492
2493        @Override
2494        public String toString() {
2495            synchronized (this) {
2496                return "held=" + (mNestCount != 0) + ", mNestCount=" + mNestCount;
2497            }
2498        }
2499    }
2500
2501    private final class DisplayBlankerImpl implements DisplayBlanker {
2502        private boolean mBlanked;
2503
2504        @Override
2505        public void blankAllDisplays() {
2506            synchronized (this) {
2507                mBlanked = true;
2508                mDisplayManagerInternal.blankAllDisplaysFromPowerManager();
2509                if (!mDecoupleInteractiveModeFromDisplayConfig) {
2510                    setInteractiveModeLocked(false);
2511                }
2512                if (!mDecoupleAutoSuspendModeFromDisplayConfig) {
2513                    setAutoSuspendModeLocked(true);
2514                }
2515            }
2516        }
2517
2518        @Override
2519        public void unblankAllDisplays() {
2520            synchronized (this) {
2521                if (!mDecoupleAutoSuspendModeFromDisplayConfig) {
2522                    setAutoSuspendModeLocked(false);
2523                }
2524                if (!mDecoupleInteractiveModeFromDisplayConfig) {
2525                    setInteractiveModeLocked(true);
2526                }
2527                mDisplayManagerInternal.unblankAllDisplaysFromPowerManager();
2528                mBlanked = false;
2529            }
2530        }
2531
2532        @Override
2533        public String toString() {
2534            synchronized (this) {
2535                return "blanked=" + mBlanked;
2536            }
2537        }
2538    }
2539
2540    private final class BinderService extends IPowerManager.Stub {
2541        @Override // Binder call
2542        public void acquireWakeLockWithUid(IBinder lock, int flags, String tag,
2543                String packageName, int uid) {
2544            acquireWakeLock(lock, flags, tag, packageName, new WorkSource(uid), null);
2545        }
2546
2547        @Override // Binder call
2548        public void acquireWakeLock(IBinder lock, int flags, String tag, String packageName,
2549                WorkSource ws, String historyTag) {
2550            if (lock == null) {
2551                throw new IllegalArgumentException("lock must not be null");
2552            }
2553            if (packageName == null) {
2554                throw new IllegalArgumentException("packageName must not be null");
2555            }
2556            PowerManager.validateWakeLockParameters(flags, tag);
2557
2558            mContext.enforceCallingOrSelfPermission(android.Manifest.permission.WAKE_LOCK, null);
2559            if (ws != null && ws.size() != 0) {
2560                mContext.enforceCallingOrSelfPermission(
2561                        android.Manifest.permission.UPDATE_DEVICE_STATS, null);
2562            } else {
2563                ws = null;
2564            }
2565
2566            final int uid = Binder.getCallingUid();
2567            final int pid = Binder.getCallingPid();
2568            final long ident = Binder.clearCallingIdentity();
2569            try {
2570                acquireWakeLockInternal(lock, flags, tag, packageName, ws, historyTag, uid, pid);
2571            } finally {
2572                Binder.restoreCallingIdentity(ident);
2573            }
2574        }
2575
2576        @Override // Binder call
2577        public void releaseWakeLock(IBinder lock, int flags) {
2578            if (lock == null) {
2579                throw new IllegalArgumentException("lock must not be null");
2580            }
2581
2582            mContext.enforceCallingOrSelfPermission(android.Manifest.permission.WAKE_LOCK, null);
2583
2584            final long ident = Binder.clearCallingIdentity();
2585            try {
2586                releaseWakeLockInternal(lock, flags);
2587            } finally {
2588                Binder.restoreCallingIdentity(ident);
2589            }
2590        }
2591
2592        @Override // Binder call
2593        public void updateWakeLockUids(IBinder lock, int[] uids) {
2594            WorkSource ws = null;
2595
2596            if (uids != null) {
2597                ws = new WorkSource();
2598                // XXX should WorkSource have a way to set uids as an int[] instead of adding them
2599                // one at a time?
2600                for (int i = 0; i < uids.length; i++) {
2601                    ws.add(uids[i]);
2602                }
2603            }
2604            updateWakeLockWorkSource(lock, ws, null);
2605        }
2606
2607        @Override // Binder call
2608        public void updateWakeLockWorkSource(IBinder lock, WorkSource ws, String historyTag) {
2609            if (lock == null) {
2610                throw new IllegalArgumentException("lock must not be null");
2611            }
2612
2613            mContext.enforceCallingOrSelfPermission(android.Manifest.permission.WAKE_LOCK, null);
2614            if (ws != null && ws.size() != 0) {
2615                mContext.enforceCallingOrSelfPermission(
2616                        android.Manifest.permission.UPDATE_DEVICE_STATS, null);
2617            } else {
2618                ws = null;
2619            }
2620
2621            final long ident = Binder.clearCallingIdentity();
2622            try {
2623                updateWakeLockWorkSourceInternal(lock, ws, historyTag);
2624            } finally {
2625                Binder.restoreCallingIdentity(ident);
2626            }
2627        }
2628
2629        @Override // Binder call
2630        public boolean isWakeLockLevelSupported(int level) {
2631            final long ident = Binder.clearCallingIdentity();
2632            try {
2633                return isWakeLockLevelSupportedInternal(level);
2634            } finally {
2635                Binder.restoreCallingIdentity(ident);
2636            }
2637        }
2638
2639        @Override // Binder call
2640        public void userActivity(long eventTime, int event, int flags) {
2641            final long now = SystemClock.uptimeMillis();
2642            if (mContext.checkCallingOrSelfPermission(android.Manifest.permission.DEVICE_POWER)
2643                    != PackageManager.PERMISSION_GRANTED) {
2644                // Once upon a time applications could call userActivity().
2645                // Now we require the DEVICE_POWER permission.  Log a warning and ignore the
2646                // request instead of throwing a SecurityException so we don't break old apps.
2647                synchronized (mLock) {
2648                    if (now >= mLastWarningAboutUserActivityPermission + (5 * 60 * 1000)) {
2649                        mLastWarningAboutUserActivityPermission = now;
2650                        Slog.w(TAG, "Ignoring call to PowerManager.userActivity() because the "
2651                                + "caller does not have DEVICE_POWER permission.  "
2652                                + "Please fix your app!  "
2653                                + " pid=" + Binder.getCallingPid()
2654                                + " uid=" + Binder.getCallingUid());
2655                    }
2656                }
2657                return;
2658            }
2659
2660            if (eventTime > SystemClock.uptimeMillis()) {
2661                throw new IllegalArgumentException("event time must not be in the future");
2662            }
2663
2664            final int uid = Binder.getCallingUid();
2665            final long ident = Binder.clearCallingIdentity();
2666            try {
2667                userActivityInternal(eventTime, event, flags, uid);
2668            } finally {
2669                Binder.restoreCallingIdentity(ident);
2670            }
2671        }
2672
2673        @Override // Binder call
2674        public void wakeUp(long eventTime) {
2675            if (eventTime > SystemClock.uptimeMillis()) {
2676                throw new IllegalArgumentException("event time must not be in the future");
2677            }
2678
2679            mContext.enforceCallingOrSelfPermission(
2680                    android.Manifest.permission.DEVICE_POWER, null);
2681
2682            final long ident = Binder.clearCallingIdentity();
2683            try {
2684                wakeUpInternal(eventTime);
2685            } finally {
2686                Binder.restoreCallingIdentity(ident);
2687            }
2688        }
2689
2690        @Override // Binder call
2691        public void goToSleep(long eventTime, int reason) {
2692            if (eventTime > SystemClock.uptimeMillis()) {
2693                throw new IllegalArgumentException("event time must not be in the future");
2694            }
2695
2696            mContext.enforceCallingOrSelfPermission(
2697                    android.Manifest.permission.DEVICE_POWER, null);
2698
2699            final long ident = Binder.clearCallingIdentity();
2700            try {
2701                goToSleepInternal(eventTime, reason);
2702            } finally {
2703                Binder.restoreCallingIdentity(ident);
2704            }
2705        }
2706
2707        @Override // Binder call
2708        public void nap(long eventTime) {
2709            if (eventTime > SystemClock.uptimeMillis()) {
2710                throw new IllegalArgumentException("event time must not be in the future");
2711            }
2712
2713            mContext.enforceCallingOrSelfPermission(
2714                    android.Manifest.permission.DEVICE_POWER, null);
2715
2716            final long ident = Binder.clearCallingIdentity();
2717            try {
2718                napInternal(eventTime);
2719            } finally {
2720                Binder.restoreCallingIdentity(ident);
2721            }
2722        }
2723
2724        @Override // Binder call
2725        public boolean isScreenOn() {
2726            final long ident = Binder.clearCallingIdentity();
2727            try {
2728                return isScreenOnInternal();
2729            } finally {
2730                Binder.restoreCallingIdentity(ident);
2731            }
2732        }
2733
2734        /**
2735         * Reboots the device.
2736         *
2737         * @param confirm If true, shows a reboot confirmation dialog.
2738         * @param reason The reason for the reboot, or null if none.
2739         * @param wait If true, this call waits for the reboot to complete and does not return.
2740         */
2741        @Override // Binder call
2742        public void reboot(boolean confirm, String reason, boolean wait) {
2743            mContext.enforceCallingOrSelfPermission(android.Manifest.permission.REBOOT, null);
2744            if (PowerManager.REBOOT_RECOVERY.equals(reason)) {
2745                mContext.enforceCallingOrSelfPermission(android.Manifest.permission.RECOVERY, null);
2746            }
2747
2748            final long ident = Binder.clearCallingIdentity();
2749            try {
2750                shutdownOrRebootInternal(false, confirm, reason, wait);
2751            } finally {
2752                Binder.restoreCallingIdentity(ident);
2753            }
2754        }
2755
2756        /**
2757         * Shuts down the device.
2758         *
2759         * @param confirm If true, shows a shutdown confirmation dialog.
2760         * @param wait If true, this call waits for the shutdown to complete and does not return.
2761         */
2762        @Override // Binder call
2763        public void shutdown(boolean confirm, boolean wait) {
2764            mContext.enforceCallingOrSelfPermission(android.Manifest.permission.REBOOT, null);
2765
2766            final long ident = Binder.clearCallingIdentity();
2767            try {
2768                shutdownOrRebootInternal(true, confirm, null, wait);
2769            } finally {
2770                Binder.restoreCallingIdentity(ident);
2771            }
2772        }
2773
2774        /**
2775         * Crash the runtime (causing a complete restart of the Android framework).
2776         * Requires REBOOT permission.  Mostly for testing.  Should not return.
2777         */
2778        @Override // Binder call
2779        public void crash(String message) {
2780            mContext.enforceCallingOrSelfPermission(android.Manifest.permission.REBOOT, null);
2781
2782            final long ident = Binder.clearCallingIdentity();
2783            try {
2784                crashInternal(message);
2785            } finally {
2786                Binder.restoreCallingIdentity(ident);
2787            }
2788        }
2789
2790        /**
2791         * Set the setting that determines whether the device stays on when plugged in.
2792         * The argument is a bit string, with each bit specifying a power source that,
2793         * when the device is connected to that source, causes the device to stay on.
2794         * See {@link android.os.BatteryManager} for the list of power sources that
2795         * can be specified. Current values include
2796         * {@link android.os.BatteryManager#BATTERY_PLUGGED_AC}
2797         * and {@link android.os.BatteryManager#BATTERY_PLUGGED_USB}
2798         *
2799         * Used by "adb shell svc power stayon ..."
2800         *
2801         * @param val an {@code int} containing the bits that specify which power sources
2802         * should cause the device to stay on.
2803         */
2804        @Override // Binder call
2805        public void setStayOnSetting(int val) {
2806            mContext.enforceCallingOrSelfPermission(
2807                    android.Manifest.permission.WRITE_SETTINGS, null);
2808
2809            final long ident = Binder.clearCallingIdentity();
2810            try {
2811                setStayOnSettingInternal(val);
2812            } finally {
2813                Binder.restoreCallingIdentity(ident);
2814            }
2815        }
2816
2817        /**
2818         * Used by device administration to set the maximum screen off timeout.
2819         *
2820         * This method must only be called by the device administration policy manager.
2821         */
2822        @Override // Binder call
2823        public void setMaximumScreenOffTimeoutFromDeviceAdmin(int timeMs) {
2824            final long ident = Binder.clearCallingIdentity();
2825            try {
2826                setMaximumScreenOffTimeoutFromDeviceAdminInternal(timeMs);
2827            } finally {
2828                Binder.restoreCallingIdentity(ident);
2829            }
2830        }
2831
2832        /**
2833         * Used by the settings application and brightness control widgets to
2834         * temporarily override the current screen brightness setting so that the
2835         * user can observe the effect of an intended settings change without applying
2836         * it immediately.
2837         *
2838         * The override will be canceled when the setting value is next updated.
2839         *
2840         * @param brightness The overridden brightness.
2841         *
2842         * @see android.provider.Settings.System#SCREEN_BRIGHTNESS
2843         */
2844        @Override // Binder call
2845        public void setTemporaryScreenBrightnessSettingOverride(int brightness) {
2846            mContext.enforceCallingOrSelfPermission(
2847                    android.Manifest.permission.DEVICE_POWER, null);
2848
2849            final long ident = Binder.clearCallingIdentity();
2850            try {
2851                setTemporaryScreenBrightnessSettingOverrideInternal(brightness);
2852            } finally {
2853                Binder.restoreCallingIdentity(ident);
2854            }
2855        }
2856
2857        /**
2858         * Used by the settings application and brightness control widgets to
2859         * temporarily override the current screen auto-brightness adjustment setting so that the
2860         * user can observe the effect of an intended settings change without applying
2861         * it immediately.
2862         *
2863         * The override will be canceled when the setting value is next updated.
2864         *
2865         * @param adj The overridden brightness, or Float.NaN to disable the override.
2866         *
2867         * @see Settings.System#SCREEN_AUTO_BRIGHTNESS_ADJ
2868         */
2869        @Override // Binder call
2870        public void setTemporaryScreenAutoBrightnessAdjustmentSettingOverride(float adj) {
2871            mContext.enforceCallingOrSelfPermission(
2872                    android.Manifest.permission.DEVICE_POWER, null);
2873
2874            final long ident = Binder.clearCallingIdentity();
2875            try {
2876                setTemporaryScreenAutoBrightnessAdjustmentSettingOverrideInternal(adj);
2877            } finally {
2878                Binder.restoreCallingIdentity(ident);
2879            }
2880        }
2881
2882        /**
2883         * Used by the phone application to make the attention LED flash when ringing.
2884         */
2885        @Override // Binder call
2886        public void setAttentionLight(boolean on, int color) {
2887            mContext.enforceCallingOrSelfPermission(
2888                    android.Manifest.permission.DEVICE_POWER, null);
2889
2890            final long ident = Binder.clearCallingIdentity();
2891            try {
2892                setAttentionLightInternal(on, color);
2893            } finally {
2894                Binder.restoreCallingIdentity(ident);
2895            }
2896        }
2897
2898        @Override // Binder call
2899        protected void dump(FileDescriptor fd, PrintWriter pw, String[] args) {
2900            if (mContext.checkCallingOrSelfPermission(Manifest.permission.DUMP)
2901                    != PackageManager.PERMISSION_GRANTED) {
2902                pw.println("Permission Denial: can't dump PowerManager from from pid="
2903                        + Binder.getCallingPid()
2904                        + ", uid=" + Binder.getCallingUid());
2905                return;
2906            }
2907
2908            final long ident = Binder.clearCallingIdentity();
2909            try {
2910                dumpInternal(pw);
2911            } finally {
2912                Binder.restoreCallingIdentity(ident);
2913            }
2914        }
2915    }
2916
2917    private final class LocalService extends PowerManagerInternal {
2918        /**
2919         * Used by the window manager to override the screen brightness based on the
2920         * current foreground activity.
2921         *
2922         * This method must only be called by the window manager.
2923         *
2924         * @param brightness The overridden brightness, or -1 to disable the override.
2925         */
2926        @Override
2927        public void setScreenBrightnessOverrideFromWindowManager(int brightness) {
2928            mContext.enforceCallingOrSelfPermission(
2929                    android.Manifest.permission.DEVICE_POWER, null);
2930
2931            final long ident = Binder.clearCallingIdentity();
2932            try {
2933                setScreenBrightnessOverrideFromWindowManagerInternal(brightness);
2934            } finally {
2935                Binder.restoreCallingIdentity(ident);
2936            }
2937        }
2938
2939        /**
2940         * Used by the window manager to override the button brightness based on the
2941         * current foreground activity.
2942         *
2943         * This method must only be called by the window manager.
2944         *
2945         * @param brightness The overridden brightness, or -1 to disable the override.
2946         */
2947        @Override
2948        public void setButtonBrightnessOverrideFromWindowManager(int brightness) {
2949            // Do nothing.
2950            // Button lights are not currently supported in the new implementation.
2951            mContext.enforceCallingOrSelfPermission(
2952                    android.Manifest.permission.DEVICE_POWER, null);
2953        }
2954
2955        /**
2956         * Used by the window manager to override the user activity timeout based on the
2957         * current foreground activity.  It can only be used to make the timeout shorter
2958         * than usual, not longer.
2959         *
2960         * This method must only be called by the window manager.
2961         *
2962         * @param timeoutMillis The overridden timeout, or -1 to disable the override.
2963         */
2964        @Override
2965        public void setUserActivityTimeoutOverrideFromWindowManager(long timeoutMillis) {
2966            mContext.enforceCallingOrSelfPermission(
2967                    android.Manifest.permission.DEVICE_POWER, null);
2968
2969            final long ident = Binder.clearCallingIdentity();
2970            try {
2971                setUserActivityTimeoutOverrideFromWindowManagerInternal(timeoutMillis);
2972            } finally {
2973                Binder.restoreCallingIdentity(ident);
2974            }
2975        }
2976
2977        @Override
2978        public void setPolicy(WindowManagerPolicy policy) {
2979            PowerManagerService.this.setPolicy(policy);
2980        }
2981    }
2982}
2983