2009-08-12 15:15:43 -05:00
|
|
|
/*
|
|
|
|
* Copyright (C) 2008 The Android Open Source Project
|
|
|
|
*
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
* you may not use this file except in compliance with the License.
|
|
|
|
* You may obtain a copy of the License at
|
|
|
|
*
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
*
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*/
|
|
|
|
|
|
|
|
package com.android.server;
|
|
|
|
|
2010-01-25 11:33:03 -05:00
|
|
|
import android.content.ContentResolver;
|
2009-08-12 15:15:43 -05:00
|
|
|
import android.content.Context;
|
|
|
|
import android.content.Intent;
|
2010-02-20 01:04:57 -05:00
|
|
|
import android.media.AudioManager;
|
2010-01-25 11:33:03 -05:00
|
|
|
import android.media.Ringtone;
|
|
|
|
import android.media.RingtoneManager;
|
|
|
|
import android.net.Uri;
|
2009-08-12 15:15:43 -05:00
|
|
|
import android.os.Handler;
|
|
|
|
import android.os.Message;
|
Power manager rewrite.
The major goal of this rewrite is to make it easier to implement
power management policies correctly. According, the new
implementation primarily uses state-based rather than event-based
triggers for applying changes to the current power state.
For example, when an application requests that the proximity
sensor be used to manage the screen state (by way of a wake lock),
the power manager makes note of the fact that the set of
wake locks changed. Then it executes a common update function
that recalculates the entire state, first looking at wake locks,
then considering user activity, and eventually determining whether
the screen should be turned on or off. At this point it may
make a request to a component called the DisplayPowerController
to asynchronously update the display's powe state. Likewise,
DisplayPowerController makes note of the updated power request
and schedules its own update function to figure out what needs
to be changed.
The big benefit of this approach is that it's easy to mutate
multiple properties of the power state simultaneously then
apply their joint effects together all at once. Transitions
between states are detected and resolved by the update in
a consistent manner.
The new power manager service has is implemented as a set of
loosely coupled components. For the most part, information
only flows one way through these components (by issuing a
request to that component) although some components support
sending a message back to indicate when the work has been
completed. For example, the DisplayPowerController posts
a callback runnable asynchronously to tell the PowerManagerService
when the display is ready. An important feature of this
approach is that each component neatly encapsulates its
state and maintains its own invariants. Moreover, we do
not need to worry about deadlocks or awkward mutual exclusion
semantics because most of the requests are asynchronous.
The benefits of this design are especially apparent in
the implementation of the screen on / off and brightness
control animations which are able to take advantage of
framework features like properties, ObjectAnimator
and Choreographer.
The screen on / off animation is now the responsibility
of the power manager (instead of surface flinger). This change
makes it much easier to ensure that the animation is properly
coordinated with other power state changes and eliminates
the cause of race conditions in the older implementation.
The because of the userActivity() function has been changed
so that it never wakes the device from sleep. This change
removes ambiguity around forcing or disabling user activity
for various purposes. To wake the device, use wakeUp().
To put it to sleep, use goToSleep(). Simple.
The power manager service interface and API has been significantly
simplified and consolidated. Also fixed some inconsistencies
related to how the minimum and maximum screen brightness setting
was presented in brightness control widgets and enforced behind
the scenes.
At present the following features are implemented:
- Wake locks.
- User activity.
- Wake up / go to sleep.
- Power state broadcasts.
- Battery stats and event log notifications.
- Dreams.
- Proximity screen off.
- Animated screen on / off transitions.
- Auto-dimming.
- Auto-brightness control for the screen backlight with
different timeouts for ramping up versus ramping down.
- Auto-on when plugged or unplugged.
- Stay on when plugged.
- Device administration maximum user activity timeout.
- Application controlled brightness via window manager.
The following features are not yet implemented:
- Reduced user activity timeout for the key guard.
- Reduced user activity timeout for the phone application.
- Coordinating screen on barriers with the window manager.
- Preventing auto-rotation during power state changes.
- Auto-brightness adjustment setting (feature was disabled
in previous version of the power manager service pending
an improved UI design so leaving it out for now).
- Interpolated brightness control (a proposed new scheme
for more compactly specifying auto-brightness levels
in config.xml).
- Button / keyboard backlight control.
- Change window manager to associated WorkSource with
KEEP_SCREEN_ON_FLAG wake lock instead of talking
directly to the battery stats service.
- Optionally support animating screen brightness when
turning on/off instead of playing electron beam animation
(config_animateScreenLights).
Change-Id: I1d7a52e98f0449f76d70bf421f6a7f245957d1d7
2012-07-27 15:51:34 -07:00
|
|
|
import android.os.PowerManager;
|
2009-09-10 18:37:37 -05:00
|
|
|
import android.os.SystemClock;
|
2009-08-12 15:15:43 -05:00
|
|
|
import android.os.UEventObserver;
|
2012-08-29 18:32:08 -07:00
|
|
|
import android.os.UserHandle;
|
2009-10-02 10:44:41 -07:00
|
|
|
import android.provider.Settings;
|
2009-08-12 15:15:43 -05:00
|
|
|
import android.util.Log;
|
2010-02-26 18:56:32 -08:00
|
|
|
import android.util.Slog;
|
2009-08-12 15:15:43 -05:00
|
|
|
|
|
|
|
import java.io.FileNotFoundException;
|
2009-12-02 17:28:38 -08:00
|
|
|
import java.io.FileReader;
|
2009-08-12 15:15:43 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* <p>DockObserver monitors for a docking station.
|
|
|
|
*/
|
2012-08-20 20:15:34 -07:00
|
|
|
final class DockObserver extends UEventObserver {
|
2009-08-12 15:15:43 -05:00
|
|
|
private static final String TAG = DockObserver.class.getSimpleName();
|
|
|
|
|
|
|
|
private static final String DOCK_UEVENT_MATCH = "DEVPATH=/devices/virtual/switch/dock";
|
|
|
|
private static final String DOCK_STATE_PATH = "/sys/class/switch/dock/state";
|
|
|
|
|
2012-08-20 20:15:34 -07:00
|
|
|
private static final int MSG_DOCK_STATE_CHANGED = 0;
|
|
|
|
|
|
|
|
private final Object mLock = new Object();
|
2010-02-10 17:39:51 +01:00
|
|
|
|
2009-08-27 16:19:07 -07:00
|
|
|
private int mDockState = Intent.EXTRA_DOCK_STATE_UNDOCKED;
|
2010-01-25 11:33:03 -05:00
|
|
|
private int mPreviousDockState = Intent.EXTRA_DOCK_STATE_UNDOCKED;
|
|
|
|
|
2009-08-27 16:19:07 -07:00
|
|
|
private boolean mSystemReady;
|
2009-08-12 15:15:43 -05:00
|
|
|
|
|
|
|
private final Context mContext;
|
2012-09-26 01:30:41 -07:00
|
|
|
private final PowerManager mPowerManager;
|
|
|
|
private final PowerManager.WakeLock mWakeLock;
|
2009-08-12 15:15:43 -05:00
|
|
|
|
Power manager rewrite.
The major goal of this rewrite is to make it easier to implement
power management policies correctly. According, the new
implementation primarily uses state-based rather than event-based
triggers for applying changes to the current power state.
For example, when an application requests that the proximity
sensor be used to manage the screen state (by way of a wake lock),
the power manager makes note of the fact that the set of
wake locks changed. Then it executes a common update function
that recalculates the entire state, first looking at wake locks,
then considering user activity, and eventually determining whether
the screen should be turned on or off. At this point it may
make a request to a component called the DisplayPowerController
to asynchronously update the display's powe state. Likewise,
DisplayPowerController makes note of the updated power request
and schedules its own update function to figure out what needs
to be changed.
The big benefit of this approach is that it's easy to mutate
multiple properties of the power state simultaneously then
apply their joint effects together all at once. Transitions
between states are detected and resolved by the update in
a consistent manner.
The new power manager service has is implemented as a set of
loosely coupled components. For the most part, information
only flows one way through these components (by issuing a
request to that component) although some components support
sending a message back to indicate when the work has been
completed. For example, the DisplayPowerController posts
a callback runnable asynchronously to tell the PowerManagerService
when the display is ready. An important feature of this
approach is that each component neatly encapsulates its
state and maintains its own invariants. Moreover, we do
not need to worry about deadlocks or awkward mutual exclusion
semantics because most of the requests are asynchronous.
The benefits of this design are especially apparent in
the implementation of the screen on / off and brightness
control animations which are able to take advantage of
framework features like properties, ObjectAnimator
and Choreographer.
The screen on / off animation is now the responsibility
of the power manager (instead of surface flinger). This change
makes it much easier to ensure that the animation is properly
coordinated with other power state changes and eliminates
the cause of race conditions in the older implementation.
The because of the userActivity() function has been changed
so that it never wakes the device from sleep. This change
removes ambiguity around forcing or disabling user activity
for various purposes. To wake the device, use wakeUp().
To put it to sleep, use goToSleep(). Simple.
The power manager service interface and API has been significantly
simplified and consolidated. Also fixed some inconsistencies
related to how the minimum and maximum screen brightness setting
was presented in brightness control widgets and enforced behind
the scenes.
At present the following features are implemented:
- Wake locks.
- User activity.
- Wake up / go to sleep.
- Power state broadcasts.
- Battery stats and event log notifications.
- Dreams.
- Proximity screen off.
- Animated screen on / off transitions.
- Auto-dimming.
- Auto-brightness control for the screen backlight with
different timeouts for ramping up versus ramping down.
- Auto-on when plugged or unplugged.
- Stay on when plugged.
- Device administration maximum user activity timeout.
- Application controlled brightness via window manager.
The following features are not yet implemented:
- Reduced user activity timeout for the key guard.
- Reduced user activity timeout for the phone application.
- Coordinating screen on barriers with the window manager.
- Preventing auto-rotation during power state changes.
- Auto-brightness adjustment setting (feature was disabled
in previous version of the power manager service pending
an improved UI design so leaving it out for now).
- Interpolated brightness control (a proposed new scheme
for more compactly specifying auto-brightness levels
in config.xml).
- Button / keyboard backlight control.
- Change window manager to associated WorkSource with
KEEP_SCREEN_ON_FLAG wake lock instead of talking
directly to the battery stats service.
- Optionally support animating screen brightness when
turning on/off instead of playing electron beam animation
(config_animateScreenLights).
Change-Id: I1d7a52e98f0449f76d70bf421f6a7f245957d1d7
2012-07-27 15:51:34 -07:00
|
|
|
public DockObserver(Context context) {
|
2009-08-12 15:15:43 -05:00
|
|
|
mContext = context;
|
2010-02-09 23:09:17 +01:00
|
|
|
|
2012-09-26 01:30:41 -07:00
|
|
|
mPowerManager = (PowerManager)mContext.getSystemService(Context.POWER_SERVICE);
|
|
|
|
mWakeLock = mPowerManager.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, TAG);
|
|
|
|
|
|
|
|
init(); // set initial status
|
2009-08-27 16:19:07 -07:00
|
|
|
startObserving(DOCK_UEVENT_MATCH);
|
2009-08-12 15:15:43 -05:00
|
|
|
}
|
|
|
|
|
|
|
|
@Override
|
|
|
|
public void onUEvent(UEventObserver.UEvent event) {
|
|
|
|
if (Log.isLoggable(TAG, Log.VERBOSE)) {
|
2010-02-26 18:56:32 -08:00
|
|
|
Slog.v(TAG, "Dock UEVENT: " + event.toString());
|
2009-08-12 15:15:43 -05:00
|
|
|
}
|
|
|
|
|
2012-08-20 20:15:34 -07:00
|
|
|
synchronized (mLock) {
|
2009-08-27 16:19:07 -07:00
|
|
|
try {
|
|
|
|
int newState = Integer.parseInt(event.get("SWITCH_STATE"));
|
|
|
|
if (newState != mDockState) {
|
2010-01-25 11:33:03 -05:00
|
|
|
mPreviousDockState = mDockState;
|
2009-08-27 16:19:07 -07:00
|
|
|
mDockState = newState;
|
|
|
|
if (mSystemReady) {
|
2012-09-26 01:30:41 -07:00
|
|
|
// Wake up immediately when docked or undocked.
|
|
|
|
mPowerManager.wakeUp(SystemClock.uptimeMillis());
|
|
|
|
|
2012-08-20 20:15:34 -07:00
|
|
|
updateLocked();
|
2009-08-27 16:19:07 -07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
} catch (NumberFormatException e) {
|
2010-02-26 18:56:32 -08:00
|
|
|
Slog.e(TAG, "Could not parse switch state from event " + event);
|
2009-08-27 16:19:07 -07:00
|
|
|
}
|
2009-08-12 15:15:43 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2012-08-20 20:15:34 -07:00
|
|
|
private void init() {
|
|
|
|
synchronized (mLock) {
|
|
|
|
try {
|
|
|
|
char[] buffer = new char[1024];
|
|
|
|
FileReader file = new FileReader(DOCK_STATE_PATH);
|
|
|
|
try {
|
|
|
|
int len = file.read(buffer, 0, 1024);
|
|
|
|
mDockState = Integer.valueOf((new String(buffer, 0, len)).trim());
|
|
|
|
mPreviousDockState = mDockState;
|
|
|
|
} finally {
|
|
|
|
file.close();
|
|
|
|
}
|
|
|
|
} catch (FileNotFoundException e) {
|
|
|
|
Slog.w(TAG, "This kernel does not have dock station support");
|
|
|
|
} catch (Exception e) {
|
|
|
|
Slog.e(TAG, "" , e);
|
|
|
|
}
|
2009-08-12 15:15:43 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2009-08-27 16:19:07 -07:00
|
|
|
void systemReady() {
|
2012-08-20 20:15:34 -07:00
|
|
|
synchronized (mLock) {
|
2009-08-27 16:19:07 -07:00
|
|
|
// don't bother broadcasting undocked here
|
|
|
|
if (mDockState != Intent.EXTRA_DOCK_STATE_UNDOCKED) {
|
2012-08-20 20:15:34 -07:00
|
|
|
updateLocked();
|
2009-08-27 16:19:07 -07:00
|
|
|
}
|
|
|
|
mSystemReady = true;
|
2009-08-12 15:15:43 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2012-08-20 20:15:34 -07:00
|
|
|
private void updateLocked() {
|
2012-09-26 01:30:41 -07:00
|
|
|
mWakeLock.acquire();
|
2012-08-20 20:15:34 -07:00
|
|
|
mHandler.sendEmptyMessage(MSG_DOCK_STATE_CHANGED);
|
2009-08-12 15:15:43 -05:00
|
|
|
}
|
|
|
|
|
2012-08-20 20:15:34 -07:00
|
|
|
private void handleDockStateChange() {
|
|
|
|
synchronized (mLock) {
|
|
|
|
Slog.i(TAG, "Dock state changed: " + mDockState);
|
2012-08-08 11:40:20 -04:00
|
|
|
|
2012-09-26 01:30:41 -07:00
|
|
|
// Skip the dock intent if not yet provisioned.
|
2012-08-20 20:15:34 -07:00
|
|
|
final ContentResolver cr = mContext.getContentResolver();
|
2012-09-25 15:03:20 -07:00
|
|
|
if (Settings.Global.getInt(cr,
|
|
|
|
Settings.Global.DEVICE_PROVISIONED, 0) == 0) {
|
2012-08-20 20:15:34 -07:00
|
|
|
Slog.i(TAG, "Device not provisioned, skipping dock broadcast");
|
|
|
|
return;
|
|
|
|
}
|
2010-01-25 11:33:03 -05:00
|
|
|
|
2012-08-20 20:15:34 -07:00
|
|
|
// Pack up the values and broadcast them to everyone
|
|
|
|
Intent intent = new Intent(Intent.ACTION_DOCK_EVENT);
|
|
|
|
intent.addFlags(Intent.FLAG_RECEIVER_REPLACE_PENDING);
|
|
|
|
intent.putExtra(Intent.EXTRA_DOCK_STATE, mDockState);
|
|
|
|
|
2012-09-26 01:30:41 -07:00
|
|
|
// Play a sound to provide feedback to confirm dock connection.
|
|
|
|
// Particularly useful for flaky contact pins...
|
2012-09-25 15:03:20 -07:00
|
|
|
if (Settings.Global.getInt(cr,
|
|
|
|
Settings.Global.DOCK_SOUNDS_ENABLED, 1) == 1) {
|
2012-08-20 20:15:34 -07:00
|
|
|
String whichSound = null;
|
|
|
|
if (mDockState == Intent.EXTRA_DOCK_STATE_UNDOCKED) {
|
|
|
|
if ((mPreviousDockState == Intent.EXTRA_DOCK_STATE_DESK) ||
|
|
|
|
(mPreviousDockState == Intent.EXTRA_DOCK_STATE_LE_DESK) ||
|
|
|
|
(mPreviousDockState == Intent.EXTRA_DOCK_STATE_HE_DESK)) {
|
2012-09-25 15:03:20 -07:00
|
|
|
whichSound = Settings.Global.DESK_UNDOCK_SOUND;
|
2012-08-20 20:15:34 -07:00
|
|
|
} else if (mPreviousDockState == Intent.EXTRA_DOCK_STATE_CAR) {
|
2012-09-25 15:03:20 -07:00
|
|
|
whichSound = Settings.Global.CAR_UNDOCK_SOUND;
|
2012-08-20 20:15:34 -07:00
|
|
|
}
|
|
|
|
} else {
|
|
|
|
if ((mDockState == Intent.EXTRA_DOCK_STATE_DESK) ||
|
|
|
|
(mDockState == Intent.EXTRA_DOCK_STATE_LE_DESK) ||
|
|
|
|
(mDockState == Intent.EXTRA_DOCK_STATE_HE_DESK)) {
|
2012-09-25 15:03:20 -07:00
|
|
|
whichSound = Settings.Global.DESK_DOCK_SOUND;
|
2012-08-20 20:15:34 -07:00
|
|
|
} else if (mDockState == Intent.EXTRA_DOCK_STATE_CAR) {
|
2012-09-25 15:03:20 -07:00
|
|
|
whichSound = Settings.Global.CAR_DOCK_SOUND;
|
2012-08-20 20:15:34 -07:00
|
|
|
}
|
|
|
|
}
|
2010-01-25 11:33:03 -05:00
|
|
|
|
2012-08-20 20:15:34 -07:00
|
|
|
if (whichSound != null) {
|
2012-09-25 15:03:20 -07:00
|
|
|
final String soundPath = Settings.Global.getString(cr, whichSound);
|
2012-08-20 20:15:34 -07:00
|
|
|
if (soundPath != null) {
|
|
|
|
final Uri soundUri = Uri.parse("file://" + soundPath);
|
|
|
|
if (soundUri != null) {
|
|
|
|
final Ringtone sfx = RingtoneManager.getRingtone(mContext, soundUri);
|
|
|
|
if (sfx != null) {
|
|
|
|
sfx.setStreamType(AudioManager.STREAM_SYSTEM);
|
|
|
|
sfx.play();
|
2010-01-25 11:33:03 -05:00
|
|
|
}
|
|
|
|
}
|
2012-08-20 20:15:34 -07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2010-02-10 17:39:51 +01:00
|
|
|
|
2012-09-26 01:30:41 -07:00
|
|
|
// Send the dock event intent.
|
|
|
|
// There are many components in the system watching for this so as to
|
|
|
|
// adjust audio routing, screen orientation, etc.
|
|
|
|
mContext.sendStickyBroadcastAsUser(intent, UserHandle.ALL);
|
2012-08-20 20:15:34 -07:00
|
|
|
|
2012-09-26 01:30:41 -07:00
|
|
|
// Release the wake lock that was acquired when the message was posted.
|
|
|
|
mWakeLock.release();
|
|
|
|
}
|
2012-08-20 20:15:34 -07:00
|
|
|
}
|
|
|
|
|
2012-08-25 12:29:46 -07:00
|
|
|
private final Handler mHandler = new Handler(true /*async*/) {
|
2012-08-20 20:15:34 -07:00
|
|
|
@Override
|
|
|
|
public void handleMessage(Message msg) {
|
|
|
|
switch (msg.what) {
|
|
|
|
case MSG_DOCK_STATE_CHANGED:
|
|
|
|
handleDockStateChange();
|
2010-02-10 17:39:51 +01:00
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
2010-02-09 23:09:17 +01:00
|
|
|
};
|
2009-08-12 15:15:43 -05:00
|
|
|
}
|