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