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