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