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