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