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