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