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