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