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