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