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