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