PowerManagerService分析(三)之WakeLock机制

《PowerManagerService分析(三)之WakeLock机制》
《PowerManagerService分析(三)之WakeLock机制》

极力推荐Android 开发大总结文章:欢迎收藏
程序员Android 力荐 ,Android 开发者需要的必备技能

《PowerManagerService分析(三)之WakeLock机制》

注:文章转于网络,点击查看原文

《PowerManagerService分析(三)之WakeLock机制》

PowerManagerService 之前系列文章请参考如下
1.PowerManagerService分析(一)之PMS启动
2.PowerManagerService分析(二)之updatePowerStateLocked()核心

WakeLock机制概述

** WakeLock** 是android系统中一种锁的机制,只要有进程持有这个锁,系统就无法进入休眠状态。应用程序要申请WakeLock时,需要在清单文件中配置android.Manifest.permission.WAKE_LOCK 权限。

根据作用时间WakeLock可以分为永久锁超时锁永久锁表示只要获取了WakeLock锁,必须显式的进行释放,否则系统会一直持有该锁;超时锁表示在到达给定时间后,自动释放WakeLock锁,其实现原理为方法内部维护了一个Handler

根据释放原则,WakeLock可以分为计数锁非计数锁,默认为计数锁,如果一个WakeLock对象为计数锁,则一次申请必须对应一次释放;如果为非计数锁,则不管申请多少次,一次就可以释放该WakeLock。以下代码为WakeLock申请释放示例,要申请WakeLock,必须有PowerManager实例,如下:

 PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
 PowerManager.WakeLock wl = pm.newWakeLock(PowerManager.SCREEN_DIM_WAKE_LOCK, "My Tag");
 wl.acquire();
 Wl.acquire(int timeout);//超时锁
 // ... do work...
 //释放锁
 wl.release();

Wakelock申请和释放流程如下:

《PowerManagerService分析(三)之WakeLock机制》

在整个WakeLock机制中,对应不同的范围,有三种表现形式:

  • 1.PowerManger.WakeLock:
    PowerManagerService和其他应用、服务交互的接口;
  • 2.PowerManagerService.WakeLock:
    PowerManager.WakeLock在PMS中的表现形式;
  • 3.SuspendBlocker:
    PowerManagerService.WakeLock在向底层节点操作时的表现形式。

下面开始对wakelock的详细分析。

1.PowerManager中的WakeLock

要获取、申请Wakelock时,直接通过PowerManager的WakeLock进行。它作为系统服务的接口来供应用调用。
1.1.获取WakeLock对象
获取WakeLock实例在PowerManager中进行。
在应用中获取WakeLock对象,方式如下:

 PowerManager.WakeLock mWakeLock = 
                mPowerManager.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, TAG);

应用中获取wakelock对象,获取的是位于PowerManager中的内部类——WakeLock的实例,在PowerManager中看看相关方法:

public WakeLock newWakeLock(int levelAndFlags, String tag) {
    validateWakeLockParameters(levelAndFlags, tag);
    return new WakeLock(levelAndFlags, tag, mContext.getOpPackageName());
}

在PowerManager的newWakeLock()方法中,首先进行了参数的校验,然后调用WakeLock构造方法获取实例,构造方法如下:

WakeLock(int flags, String tag, String packageName) {
//表示wakelock类型或等级
    mFlags = flags;
//一个tag,一般为当前类名
    mTag = tag;
//获取wakelock的包名
    mPackageName = packageName;
//一个Binder标记
    mToken = new Binder();
    mTraceName = "WakeLock (" + mTag + ")";
}

除了构造方法中必须要传入的参数之外,还有如下几个属性:

//表示内部计数
private int mInternalCount;
//表示内部计数
private int mExternalCount;
//表示是否是计数锁
private boolean mRefCounted = true;
//表示是否已经持有该锁
private boolean mHeld;
//表示和该wakelock相关联的工作源,这在当一个服务获取wakelock执行工作时很有用,以便计算工作成本
private WorkSource mWorkSource;
//表示一个历史标签
private String mHistoryTag;

1.2.WakeLock等级(类别)

Wakelock共有以下几种等级:

//如果持有该类型的wakelock锁,则按Power键灭屏后,即使允许屏幕、按键灯灭,也不会释放该锁,CPU不会进入休眠状态
public static final int PARTIAL_WAKE_LOCK;
//Deprecated,如果持有该类型的wakelock锁,则使屏幕保持亮/Dim的状态,键盘灯允许灭,按Power键灭屏后,会立即释放
public static final int SCREEN_DIM_WAKE_LOCK;
//Deprecated,如果持有该类型的wakelock锁,则使屏幕保持亮的状态,键盘灯允许灭,按Power键灭屏后,会立即释放
public static final int SCREEN_BRIGHT_WAKE_LOCK
//Deprecated,如果持有该类型的wakelock锁,则使屏幕、键盘灯都保持亮,按Power键灭屏后,会立即释放
public static final int FULL_WAKE_LOCK
//如果持有该锁,则当PSensor检测到有物体靠近时关闭屏幕,远离时又亮屏,该类型锁不会阻止系统进入睡眠状态,比如
//当到达休眠时间后会进入睡眠状态,但是如果当前屏幕由该wakelock关闭,则不会进入睡眠状态。
public static final int PROXIMITY_SCREEN_OFF_WAKE_LOCK
//如果持有该锁,则会使屏幕处于DOZE状态,同时允许CPU挂起,该锁用于DreamManager实现Doze模式,如SystemUI的DozeService
public static final int DOZE_WAKE_LOCK
//如果持有该锁,则会时设备保持唤醒状态,以进行绘制屏幕,该锁常用于WindowManager中,允许应用在系统处于Doze状态下时进行绘制
public static final int DRAW_WAKE_LOCK

这些值会在下面以图标的形式总结。除了等级之外,还有几个标记:

//该值为0x0000FFFF,用于根据flag判断Wakelock的级别,如:
//if((wakeLock.mFlags & PowerManager.WAKE_LOCK_LEVEL_MASK) == PowerManager.PARTIAL_WAKE_LOCK){}
public static final int WAKE_LOCK_LEVEL_MASK
//用于在申请锁时唤醒设备,一般情况下,申请wakelock锁时不会唤醒设备,它只会导致屏幕保持打开状态,如果带有这个flag,则会在申
//请wakelock时就点亮屏幕,如常见通知来时屏幕亮,该flag不能和PowerManager.PARTIAL_WAKE_LOCE一起使用。
public static final int ACQUIRE_CAUSES_WAKEUP
//在释放锁时,如果wakelock带有该标志,则会小亮一会再灭屏,该flag不能和PowerManager.PARTIAL_WAKE_LOCE一起使用。
public static final int ON_AFTER_RELEASE
//和其他标记不同,该标记是作为release()方法的参数,且仅仅用于释放PowerManager.PROXIMITY_SCREEN_OFF_WAKE_LOCK类型的
//锁,如果带有该参数,则会延迟释放锁,直到传感器不再感到对象接近
public static final int RELEASE_FLAG_WAIT_FOR_NO_PROXIMITY

申请WakeLock

当获取到WakeLock实例后,就可以申请WakeLock了。前面说过了,根据作用时间,WakeLock锁可以分为永久锁超时锁,根据释放原则,WakeLock可以分为计数锁非计数锁。申请方式如下:

 PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
 PowerManager.WakeLock wl = pm.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "My Tag");
 wl.acquire();//申请一个永久锁
 Wl.acquire(int timeout);//申请一个超时锁

acquire()方法源码如下:

public void acquire() {
    synchronized (mToken) {
        acquireLocked();
    }
}
public void acquire(long timeout) {
    synchronized (mToken) {
        acquireLocked();
        //申请锁之后,内部会维护一个Handler去完成自动释放锁
        mHandler.postDelayed(mReleaser, timeout);
    }
}

可以看到这两种方式申请方式完全一样,只不过如果是申请一个超时锁,则会通过Handler延时发送一个消息,到达时间后去自动释放锁。
到这一步,对于申请wakelock的应用或系统服务来说就完成了,具体的申请在PowerManager中进行,继续看看acquireLocked()方法:

private void acquireLocked() {
    //应用每次申请wakelock,内部计数和外部计数加1
    mInternalCount++;
    mExternalCount++;
    //如果是非计数锁或者内部计数值为1,即第一次申请该锁,才会真正去申请
    if (!mRefCounted || mInternalCount == 1) {
        mHandler.removeCallbacks(mReleaser);
        Trace.asyncTraceBegin(Trace.TRACE_TAG_POWER, mTraceName, 0);
        try {
            //向PowerManagerService申请锁
            mService.acquireWakeLock(mToken, mFlags, mTag, mPackageName, mWorkSource,
                    mHistoryTag);
        } catch (RemoteException e) {
            throw e.rethrowFromSystemServer();
        }
        //表示此时持有该锁
        mHeld = true;
    }
}

是否是计数锁可以通过setReferenceCount()来设置,默认为计数锁:

public void setReferenceCounted(boolean value) {
    synchronized (mToken) {
        mRefCounted = value;
    }
}

acquire()方法可以看出,对于计数锁来说,只会在第一次申请时向PowerManagerService去申请锁,当该wakelock实例第二次、第三次去申请时,如果没有进行过释放,则只会对计数引用加1,不会向PowerManagerService去申请。如果是非计数锁,则每次申请,都会调到PowerManagerService中去。

释放WakeLock锁

如果是通过acquire(long timeout)方法申请的超时锁,则会在到达时间后自动去释放,如果是通过acquire()方法申请的永久锁,则必须进行显式的释放,否则由于系统一直持有wakelock锁,将导致无法进入休眠状态,从而导致耗电过快等功耗问题。

在前面分析申请锁时已经说了,如果是超时锁,通过Handler.post(Runnable)的方式进行释放,该Runnable定义如下:

private final Runnable mReleaser = new Runnable() {
    public void run() {
        release(RELEASE_FLAG_TIMEOUT);
    }
};

RELEASE_FLAG_TIMEOUT是一个用于release()方法的flag,表示释放的为超时锁。
如果是永久锁,则必须通过调用release()方法进行释放了,该方法如下:

public void release() {
    release(0);
}

因此,不管是哪种锁的释放,其实都是在release(int)中进行的,只不过参数不同,该方法如下:

public void release(int flags) {
    synchronized (mToken) {
        //内部计数-1
        mInternalCount--;
        //如果释放超时锁,外部计数-1
        if ((flags & RELEASE_FLAG_TIMEOUT) == 0) {
            mExternalCount--;
        }
        //如果释放非计数锁或内部计数为0,并且该锁还在持有,则通过PowerManagerService去释放
        if (!mRefCounted || mInternalCount == 0) {
            mHandler.removeCallbacks(mReleaser);
            if (mHeld) {
                Trace.asyncTraceEnd(Trace.TRACE_TAG_POWER, mTraceName, 0);
                try {
                    mService.releaseWakeLock(mToken, flags);
                } catch (RemoteException e) {
                    throw e.rethrowFromSystemServer();
                }
                //表示不持有该锁
                mHeld = false;
            }
        }
        //如果时计数锁,并且外部计数小于0,则抛出异常
        if (mRefCounted && mExternalCount < 0) {
            throw new RuntimeException("WakeLock under-locked " + mTag);
        }
    }
}

对于计数锁的释放,每次都会对内部计数值减一,只有当你内部计数值减为0时,才会去调用PowerManagerService去真正的释放锁;如果释放非计数锁,则每次都会调用PowerManagerService进行释放。

WakeLock类型及其特点见下表:

LevelCPUScreenKeyboardPower Button备注
PARTIAL_WAKE_LOCKOnOn/OffOn/OffNo InfluenceCpu不受power键影响,一直运行直到所有锁被释放
FULL_WAKE_LOCKOnBrightBrightreleaseAPI17中已启用,改用WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON,当用户在不同的应用程序间切换时可以正确的管理,同时不需要权限
SCREEN_DIM_WAKE_LOCKOnDim/BrightOffrelease同上
SCREEN_BRIGHT_WAKE_LOCKOnBrightOffrelease同上
PROXIMITY_SCREEN_OFF_WAKE_LOCKOn/OffBright/offOffrelesase不能和ACQUIRE_CAUSES_WAKEUP一起使用
DOZE_WAKE_LOCKOn/OffOffOffrelease@hide,允许在doze状态下使cpu进入suspend状态,仅在doze状态下有效,需要android.Manifest.permission.DEVICE_POWER权限
DRAW_WAKE_LOCKOn/OffOffOffNo@hide,允许在doze状态下进行屏幕绘制,仅在doze状态下有效,需要DEVICE_POWER权限
ACQUIRE_CAUSES_WAKEUPWakelock 标记,一般情况下,获取wakelock并不能唤醒设备,加上这个标志后,申请wakelock后也会唤醒屏幕。如通知、闹钟… 不能和PARTIAL_WAKE_LOCK一起使用
ON_AFTER_RELEASEWakelock 标记,当释放该标记的锁时,会亮一小会再灭屏 同上

源码注释如下:

/**
 * The following wake lock levels are defined, with varying effects on system power.
 * <i>These levels are mutually exclusive - you may only specify one of them.</i>
 *
 * <table>
 *     <tr><th>Flag Value</th>
 *     <th>CPU</th> <th>Screen</th> <th>Keyboard</th></tr>
 *
 *     <tr><td>{@link #PARTIAL_WAKE_LOCK}</td>
 *         <td>On*</td> <td>Off</td> <td>Off</td>
 *     </tr>
 *
 *     <tr><td>{@link #SCREEN_DIM_WAKE_LOCK}</td>
 *         <td>On</td> <td>Dim</td> <td>Off</td>
 *     </tr>
 *
 *     <tr><td>{@link #SCREEN_BRIGHT_WAKE_LOCK}</td>
 *         <td>On</td> <td>Bright</td> <td>Off</td>
 *     </tr>
 *
 *     <tr><td>{@link #FULL_WAKE_LOCK}</td>
 *         <td>On</td> <td>Bright</td> <td>Bright</td>
 *     </tr>
 * </table>
 * </p><p>
 * *<i>If you hold a partial wake lock, the CPU will continue to run, regardless of any
 * display timeouts or the state of the screen and even after the user presses the power button.
 * In all other wake locks, the CPU will run, but the user can still put the device to sleep
 * using the power button.</i>
***/

对于开发者来说,只能申请非@hide的锁,即PARTIAL_WAKE_LOCKSCREEN_DIM_WAKE_LOCKSCREEN_BRIGHT_WAKE_LOCKFULL_WAKE_LOCK四类。

比如,我要获取一个wakelock类型为PARTIAL_WAKE_LOCKWakeLock锁,则在申请这个锁后,虽然屏幕、键盘灯可以关闭,但CPU将一直处于活动状态,不受power键的控制。获得WakeLock对象后,可以根据自己的需求来申请不同形式的锁。接下来我们继续分析在申请、释放锁时PowerManagerService中的流程。

PowerManagerService中的WakeLock

WakeLock申请

在申请WakeLock时,当应用层调用完acquire()方法后,由PowerManager去处理了。对于两种申请方式,最终都调用了acquireLocked()进行申请,acquireLocked()又向下调用,让mService去处理,我们通过上面的分析知道,这个mService就是PMS.BinderService,该方法如下:

private void acquireLocked() {
    if (!mRefCounted || mCount++ == 0) {
        mHandler.removeCallbacks(mReleaser);
        try {
            //向下调用PMS去处理
            mService.acquireWakeLock(mToken, mFlags, mTag, 
                         mPackageName, mWorkSource,mHistoryTag);
        } catch (RemoteException e) {
            throw e.rethrowFromSystemServer();
        }
        mHeld = true;//持有锁标记置为true
    }

其中mHeld是一个判断是否持有锁的标记,在应用中可以通过调用WakeLockisHeld()来判断是否持有WakeLock

PMS中的acquireWakeLock()方法如下:

@Override // Binder call
public void acquireWakeLock(IBinder lock, int flags, String tag, 
                     String packageName,WorkSource ws, String historyTag) {
    ......
    //检查wakelock级别
    PowerManager.validateWakeLockParameters(flags, tag);
    //检查WAKE_LOCK权限
mContext.enforceCallingOrSelfPermission(android.Manifest.permission.WAKE_LO   
                        CK, null);
    //如果是DOZE_WAKE_LOCK级别wakelock,还要检查DEVICE_POWER权限
    if ((flags & PowerManager.DOZE_WAKE_LOCK) != 0) {
        mContext.enforceCallingOrSelfPermission(
                android.Manifest.permission.DEVICE_POWER, null);
    }
    //ws = null
    ......
    //重置当前线程上传入的IPC标志
    final long ident = Binder.clearCallingIdentity();
    try {
        acquireWakeLockInternal(lock, flags, tag, packageName, ws, historyTag,
                  uid, pid);
    } finally {
        Binder.restoreCallingIdentity(ident);
    }
}

在这个方法中,首先进行了WakeLock类型检查,避免无效的WakeLock类型,然后进行权限的检查,WakeLock需要android.Manifest.permission.WAKE_LOCK权限,如果申请的WakeLock类型是DOZE_WAKE_LOCK,则还需要android.Manifest.permission.DEVICE_POWER权限(见上表),检查完毕后重置BinderIPC标志,然后调用下一个方法acquireWakeLockInternal()

private void acquireWakeLockInternal(IBinder lock, int flags, String tag, String packageName,
        WorkSource ws, String historyTag, int uid, int pid) {
    synchronized (mLock) {
        //PMS中的WakeLock类
        WakeLock wakeLock;
        //查找是否已存在该PM.WakeLock实例
        int index = findWakeLockIndexLocked(lock);
        boolean notifyAcquire;
        //是否存在wakelock
        if (index >= 0) {
            wakeLock = mWakeLocks.get(index);
            if (!wakeLock.hasSameProperties(flags, tag, ws, uid, pid)) {
                //更新wakelock
                notifyWakeLockChangingLocked(wakeLock, flags, tag, packageName,
                        uid, pid, ws, historyTag);
                wakeLock.updateProperties(flags, tag, packageName, 
                                ws, historyTag, uid, pid);
            }
            notifyAcquire = false;
        } else {
              //从SpareArray<UidState>中查找是否存在该uid
              UidState state = mUidState.get(uid);
              if (state == null) {
                  state = new UidState(uid);
                  //设置该Uid的进程状态
                  state.mProcState = ActivityManager.PROCESS_STATE_NONEXISTENT;
                  mUidState.put(uid, state);
              }
            //将该uid申请的WakeLock计数加1
            //创建新的PMS.WakeLock实例
            wakeLock = new WakeLock(lock, flags, tag, packageName, ws, 
                              historyTag, uid, pid);
            try {
                lock.linkToDeath(wakeLock, 0);
            } catch (RemoteException ex) {
                throw new IllegalArgumentException("Wake lock is already dead.");
            }
            //添加到wakelock集合中
            mWakeLocks.add(wakeLock);
            //用于设置PowerManger.PARTIAL_WAKE_LOCK能否可用
            //1.缓存的不活动进程不能持有wakelock锁               
            //2.如果处于idle模式,则会忽略掉所有未处于白名单中的应用申请的锁
            setWakeLockDisabledStateLocked(wakeLock);
            //表示有新的wakelock申请了
            notifyAcquire = true;
        }
        //判断是否直接点亮屏幕,如果带有点亮屏幕标志值,并且wakelock类型为
        //FULL_WAKE_LOCK,SCREEN_BRIGHT_WAKE_LOCK,SCREEN_DIM_WAKE_LOCK,则进行下 
        //步处理
        applyWakeLockFlagsOnAcquireLocked(wakeLock, uid);
        //更新标志位
        mDirty |= DIRTY_WAKE_LOCKS;
        updatePowerStateLocked();
        if (notifyAcquire) {
           //当申请了锁后,在该方法中进行长时锁的判断,通知BatteryStatsService      
           // 进行统计持锁时间等
            notifyWakeLockAcquiredLocked(wakeLock);
        }
    }
}

首先通过传入的第一个参数IBinder进行查找WakeLock是否已经存在,若存在,则不再进行实例化,在原有的WakeLock上更新其属性值;若不存在,则创建一个WakeLock对象,同时将该WakeLock保存到List中。此时已经获取到了WakeLock对象,这里需要注意的是,此处的WakeLock对象和PowerManager中获取的不是同一个WakeLock哦!

获取到WakeLock实例后,还通过setWakeLockDisabledStateLocked(wakeLock)进行了判断该WakeLock是否可用,主要有两种情况:

1.缓存的不活动进程不能持有WakeLock锁;
2.如果处于idle模式,则会忽略掉所有未处于白名单中的应用申请的锁。
根据情况会设置WakeLock实例的disable属性值表示该WakeLock是否不可用。

下一步进行判断是否直接点亮屏幕,如果获得的WakeLock带有ACQUIRE_CAUSES_WAKEUP标志,并且WakeLock类型为FULL_WAKE_LOCK,SCREEN_BRIGHT_WAKE_LOCK,SCREEN_DIM_WAKE_LOCK这三种其中之一(isScreenLock判断),则会直接唤醒屏幕,如下代码中的applyWakeLockFlagsOnAcquireLocked(wakeLock, uid)方法:

private void applyWakeLockFlagsOnAcquireLocked(WakeLock wakeLock, int uid) {
    if ((wakeLock.mFlags & PowerManager.ACQUIRE_CAUSES_WAKEUP) != 0
            && isScreenLock(wakeLock)) {
        ......
        wakeUpNoUpdateLocked(SystemClock.uptimeMillis(), wakeLock.mTag, opUid,
                opPackageName, opUid);
    }
}

在wakeUpNoUpdateLocked()中:

private boolean wakeUpNoUpdateLocked(long eventTime, String reason, int reasonUid,
        String opPackageName, int opUid) {
//如果eventTime<上次休眠时间、设备当前处于唤醒状态、没有启动完成、没有准备
//完成,则不需要更新,返回false
    if (eventTime < mLastSleepTime || mWakefulness == WAKEFULNESS_AWAKE
            || !mBootCompleted || !mSystemReady) {
        return false;
    }
        //更新最后一次唤醒时间值
        mLastWakeTime = eventTime;
   //设置wakefulness
        setWakefulnessLocked(WAKEFULNESS_AWAKE, 0);
        //通知BatteryStatsService/AppService屏幕状态发生改变
        mNotifier.onWakeUp(reason, reasonUid, opPackageName, opUid);
    //更新用户活动事件时间值
        userActivityNoUpdateLocked(
                eventTime, PowerManager.USER_ACTIVITY_EVENT_OTHER, 0, reasonUid);
    } finally {
        Trace.traceEnd(Trace.TRACE_TAG_POWER);
    }
    return true;
}

wakeUpNoUpdateLocked()方法是唤醒设备的主要方法。在这个方法中,首先更新了mLastWakeTime这个值,表示上次唤醒设备的时间,在系统超时休眠时用到这个值进行判断。现在,只需要知道每次亮屏,都走的是这个方法,关于具体是如何唤醒屏幕的,在第5节中进行分析。

现在我们继续回到acquireWakeLockInternal()方法的结尾处,当检查完WakeLockACQUIRE_CAUSES_WAKEUP标志后,更新mDirty,然后调用updatePowerStateLocked()方法,这个方法在第二篇文章中说过了,是整个PMS的核心方法,在这个方法中调用了几个关键方法,这些方法已经进行了分析,只剩一个WakeLock相关的updateSuspendBlockerLocked()没有分析,现在开始分析这个方法,该方法如下:

private void updateSuspendBlockerLocked() {
    //是否需要保持CPU活动状态的SuspendBlocker锁,具体表现为持有Partical WakeLock
final boolean needWakeLockSuspendBlocker = 
           ((mWakeLockSummary & WAKE_LOCK_CPU) != 0);
    //是否需要保持CPU活动状态的SuspendBlocker锁,具体表现保持屏幕亮
    final boolean needDisplaySuspendBlocker = needDisplaySuspendBlockerLocked();
    //是否自动挂起,如果不需要屏幕保持唤醒,则说明可以自动挂起CPU
    final boolean autoSuspend = !needDisplaySuspendBlocker;
    //是否处于交互模式,屏幕处于Bright或者Dim状态时为true
    final boolean interactive = mDisplayPowerRequest.isBrightOrDim();
    //mDecoupleHalAutoSuspendModeFromDisplayConfig:自动挂起模式和显示状态解偶
    if (!autoSuspend && mDecoupleHalAutoSuspendModeFromDisplayConfig) {
        //禁止CPU自动挂起模式
        setHalAutoSuspendModeLocked(false);
    }
    //如果存在PARTIAL_WAKE_LOCK类型的WakeLock,申请mWakeLockSuspendBlocker锁
    if (needWakeLockSuspendBlocker && !mHoldingWakeLockSuspendBlocker) {
        mWakeLockSuspendBlocker.acquire();
        mHoldingWakeLockSuspendBlocker = true;
    }
    //如果当前屏幕需要保持亮屏,申请mDisplaySuspendBlocker锁
    if (needDisplaySuspendBlocker && !mHoldingDisplaySuspendBlocker) {
        mDisplaySuspendBlocker.acquire();
        mHoldingDisplaySuspendBlocker = true;
    }
    //???
    if (mDecoupleHalInteractiveModeFromDisplayConfig) {
        //设置Hal层交互模式?
        if (interactive || mDisplayReady) {
            //???
            setHalInteractiveModeLocked(interactive);
        }
    }
    //如果不再持有PARTIAL_WAKELOCK类型的WakeLock锁,释放mWakeLockSuspendBlocker锁
    if (!needWakeLockSuspendBlocker && mHoldingWakeLockSuspendBlocker) {
        mWakeLockSuspendBlocker.release();
        mHoldingWakeLockSuspendBlocker = false;
    }
    //如果不再需要屏幕保持亮屏,释放mDisplaySuspendBlocker锁
    if (!needDisplaySuspendBlocker && mHoldingDisplaySuspendBlocker) {
        mDisplaySuspendBlocker.release();
        mHoldingDisplaySuspendBlocker = false;
    }
    //启动自动挂起模式
    if (autoSuspend && mDecoupleHalAutoSuspendModeFromDisplayConfig) {
        setHalAutoSuspendModeLocked(true);
    }
}

updateSuspendBlockerLocked()方法中,会根据当前系统是否持有PARTIAL_WAKELOCK类型的锁,来决定是否要申请或释放mWakeLockSuspendBlocker锁,然后会根据当前系统是否要屏幕亮屏来决定是否要申请或释放mDisplaySuspendBlocker锁。

我们在分析PMS的启动时提到过,在PMS的构造方法中创建了两个SuspendBlocker对象:mWakeLockSuspendBlockermDisplaySuspendBlocker,前者表示获取一个PARTIAL_WAKELOCK类型的WakeLock使CPU保持活动状态,后者表示当屏幕亮屏、用户活动时使CPU保持活动状态。因此实际上,上层PowerManager申请和释放锁,最终在PMS中都交给了SuspendBlocker去申请和释放锁。也可以说SuspendBlocker类的两个对象是WakeLock锁反映到底层的对象。只要持有二者任意锁,都会使得CPU处于活动状态。

NOTE 这里还有两个值含义很重要:
mDecoupleHalAutoSuspendModeFromDisplayConfig:
该值表示是否将自动挂起状态和设备的屏幕显示状态(开/关)进行解耦。如果为false,则autosuspend_disable()函数会在屏幕亮之前调用,autosuspend_enable()函数会在屏幕灭之后调用,这种模式为使用传统电源管理功能的设备(如提前暂停/延迟恢复)提供最佳兼容性。如果为true,则autosuspend_display()autosuspend_enable()将会被单独调用,不管屏幕正在亮或灭,这种模式使电源管理器可以在屏幕打开时挂起应用程序处理器。当指定了dozeComponent组件时,应将此资源设置为“true”,最大限度地节省电力,但并非所有设备都支持它。

mDecoupleHalInteractiveModeFromDisplayConfig:
表示是否将交互状态和设备的屏幕显示状态进行解耦。
如果为false,则当屏幕亮时调用setInteractive(…, true)函数,当屏幕灭时调用setInteractive(…, false)函数,此模式为希望将交互式状态绑定到显示状态的设备提供最佳兼容性。
如果为truesetInteractive()函数将会独立地调用,不管屏幕处于亮或灭,这种模式使电源管理器可以在显示器打开时减少时钟并禁用触摸控制器
再来看看needDisplaySuspendBlockerLocked()的实现:

    private boolean needDisplaySuspendBlockerLocked() {
        //mDisplayReady表示是否显示器准备完毕
        if (!mDisplayReady) {
            return true;
        }
        //请求Display策略状态为Bright或DIM,这个if语句用来判断当PSensor灭屏时是否需要Display锁
        if (mDisplayPowerRequest.isBrightOrDim()) {
            // If we asked for the screen to be on but it is off due to the proximity
            // sensor then we may suspend but only if the configuration allows it.
            // On some hardware it may not be safe to suspend because the proximity
            // sensor may not be correctly configured as a wake-up source.
            //如果没有PROXIMITY_SCREEN_OFF_WAKE_LOCK类型的WakeLock锁||PSensor正在处于远离状态
            //或在PSensor灭屏后不允许进入Suspend状态,满足之一,则申请misplaySuspendBlocker锁
            if (!mDisplayPowerRequest.useProximitySensor || !mProximityPositive
                    || !mSuspendWhenScreenOffDueToProximityConfig) {
                return true;
            }
        }
        if (mScreenBrightnessBoostInProgress) {
            return true;
        }
        // Let the system suspend if the screen is off or dozing.
        return false;
    }

SuspendBlocker是一个接口,并且只有acquire()release()两个方法,PMS.SuspendBlockerImpl实现了该接口,因此,最终申请流程执行到了PMS.SuspendBlockerImplacquire()中。

PMS.SuspendBlockerImpl.acquire()中进行申请时,首先将成员变量计数加1,然后调用到JNI层去进行申请,对应的JNI层文件路径为:frameworks\base\services\core\jni\com_android_server_power_PowerManagerService.cpp,具体代码如下:

@Override
public void acquire() {
    synchronized (this) {
        //引用计数
        mReferenceCount += 1;  
        if (mReferenceCount == 1) {
            nativeAcquireSuspendBlocker(mName);
        }
    }
}

这里使用了引用计数法,如果mReferenceCount >1,则不会进行锁的申请,而是仅仅将mReferenceCount +1,只有当没有申请的锁时,才会其正真执行申请锁操作,之后不管申请几次,都是mReferenceCount 加1.
在JNI层中可以明确的看到有一个申请锁的acquire_wake_lock()方法,代码如下:

static void nativeAcquireSuspendBlocker(JNIEnv *env, jclass /* clazz */, jstring nameStr) {
    ScopedUtfChars name(env, nameStr);
    acquire_wake_lock(PARTIAL_WAKE_LOCK, name.c_str());
}

这个方法位于HAL层,实现在/hardware/libhardware_legacy/power/power.c 中,先看看具体代码:

int acquire_wake_lock(int lock, const char* id)
{
    initialize_fds();
    ALOGI("acquire_wake_lock lock=%d id='%s'\n", lock, id);
    if (g_error) return g_error;
    int fd;
    size_t len;
    ssize_t ret;
    if (lock != PARTIAL_WAKE_LOCK) {
        return -EINVAL;
    }
    fd = g_fds[ACQUIRE_PARTIAL_WAKE_LOCK];
    ret = write(fd, id, strlen(id));
    if (ret < 0) {
        return -errno;
    }
    return ret;
}

在这里,向/sys/power/wake_lock文件写入了id,这个id就是我们上层中实例化SuspendBlocker时传入的String类型的name,这里在这个节点写入文件以后,就说明获得了wakelock。可通过adb命令查看该文件:

$ adb root
adbd is already running as root
$ adb remount
remount succeeded
$ adb shell cat /sys/power/wake_lock
PowerManagerService.Display
$ 

到这里,整个WakeLock的申请流程就结束了。

现在还有一点剩余代码需要看看,继续回到PMSacquireWakeLockInternal()方法中,当执行完updatePowerStateLocked()方法后,如果有新的WakeLock实例创建,则notifyAcquire值为true,通过以下这个方法通知NotifierNotifier中则会根据该锁申请的时间开始计时,并以此来判断是否是一个长时间持有的锁:

private void notifyWakeLockAcquiredLocked(WakeLock wakeLock) {
    if (mSystemReady && !wakeLock.mDisabled) {
        wakeLock.mNotifiedAcquired = true;
        wakeLock.mStartTimeStamp = SystemClock.elapsedRealtime();
        //Called when a wake lock is acquired.
        mNotifier.onWakeLockAcquired(wakeLock.mFlags, 
                        wakeLock.mTag, wakeLock.mPackageName,
                wakeLock.mOwnerUid, wakeLock.mOwnerPid, wakeLock.mWorkSource,
                wakeLock.mHistoryTag);
        ......
        //重新开始检查持锁时间
        restartNofifyLongTimerLocked(wakeLock);
    }
}

申请WakeLock时序图如下:

《PowerManagerService分析(三)之WakeLock机制》

WakeLock的释放

当应用持有WakeLock锁、更准确地说是PARTIAL_WAKELOCK类型的WakeLock锁,执行完相应的任务后,要及时对其进行释放,否则会导致设备一直处于唤醒状态,CPU无法休眠,造成电量消耗过快。WakeLock的释放流程和申请流程很类似,我们还是从应用层开始逐步分析.

应用中执行释放锁操作的前提是该应用当前持有一个锁,通过PowerManager.WakeLock调用release()进行释放,在对应用层开放的API中,有两种释放形式,除了最常用的直接调用release()方法,还有一种是调用release(int flag)方法,这个方法允许用户传入一个标志值,以达到修改释放行为的目的,目前而言(API 27),只支持一个值:

public static final int RELEASE_FLAG_WAIT_FOR_NO_PROXIMITY = 1;

表示延迟释放 PROXIMITY_SCREEN_OFF_WAKE_LOCK类型的WakeLock(该类型的WakeLock最常见于通话过程中,为了有更好的用户体验,在脸靠近屏幕时防止误触,屏幕会熄灭,远离屏幕时屏幕又会开启,就是使用了该WakeLock),传入0相当于调用release(),具体代码如下:

public void release() {
    release(0);
}
public void release(int flags) {
    synchronized (mToken) {
        if (!mRefCounted || --mCount == 0) {
            mHandler.removeCallbacks(mReleaser);
            if (mHeld) {
                try {
                    //PMS中进行处理
                    mService.releaseWakeLock(mToken, flags);
                } catch (RemoteException e) {
                }
                mHeld = false;
            }
        }
        if (mCount < 0) {
            throw new RuntimeException("WakeLock under-locked " + mTag);
        }
    }
}

release()中,向下调用了PMS.BinderServicereleaseWakeLock()方法:

@Override // Binder call
public void releaseWakeLock(IBinder lock, int flags) {
    if (lock == null) {
        throw new IllegalArgumentException("lock must not be null");
    }
    //检查权限
    mContext.enforceCallingOrSelfPermission(android.Manifest.permission.
         WAKE_LOCK, null);
    //重置当前线程的IPC标志
    final long ident = Binder.clearCallingIdentity();
    try {
        //去释放锁
        releaseWakeLockInternal(lock, flags);
    } finally {
        //设置新的IPC标志
        Binder.restoreCallingIdentity(ident);
    }
}

在这个方法中,进行了权限检查后,就交给下一个方法去处理了,具体代码如下:

private void releaseWakeLockInternal(IBinder lock, int flags) {
    synchronized (mLock) {
        //查找WakeLock是否存在
        int index = findWakeLockIndexLocked(lock);
        if (index < 0) {
            return;
        }
        WakeLock wakeLock = mWakeLocks.get(index);
            //该flag用来推迟释放PowerManager.PROXIMITY_SCREEN_OFF_WAKE_LOCK类型的锁,它会在传感器感觉不在靠近的时候才释放该锁
            if ((flags & PowerManager.RELEASE_FLAG_WAIT_FOR_NO_PROXIMITY) != 0) {
                //表示在点亮屏幕前需要等待PSensor返回负值
                mRequestWaitForNegativeProximity = true;
            }
        if ((flags & PowerManager.RELEASE_FLAG_WAIT_FOR_NO_PROXIMITY) != 0) {
            mRequestWaitForNegativeProximity = true;
        }
        //取消Binder讣告
        wakeLock.mLock.unlinkToDeath(wakeLock, 0);
        //释放锁
        removeWakeLockLocked(wakeLock, index);
    }
}

releaseWakeLockInternal()中处理时,首先查找WakeLock是否存在,若不存在,直接返回;然后检查是否带有影响释放行为的标志值,上面已经提到过,目前只有一个值,之后取消了Binder的死亡代理,最后调用了removeWakeLockLocked()方法:

private void removeWakeLockLocked(WakeLock wakeLock, int index) {
    //从List中移除
    mWakeLocks.remove(index);
    //得到该wakelock中的UidState属性
    UidState state = wakeLock.mUidState;
    state.mNumWakeLocks--;
    if (state.mNumWakeLocks <= 0 &&
            state.mProcState == ActivityManager.PROCESS_STATE_NONEXISTENT) {
        //从SpareArray<UidState>中移除该wakelock的UidState
        //注意,下面的mUidState是SpareArray<UidState>,而上面的mUidState是wakeLock.mUidState
        mUidState.remove(state.mUid);
    }
    //使用Notifier通知其他应用
    notifyWakeLockReleasedLocked(wakeLock);
    //对带有ON_AFTER_RELEASE标志的wakelock进行处理
    applyWakeLockFlagsOnReleaseLocked(wakeLock);
    mDirty |= DIRTY_WAKE_LOCKS;
    //更新电源状态信息
    updatePowerStateLocked();
}

removeWakeLockLocked()中,对带有ON_AFTER_RELEASE标志的wakelock进行处理,前面分析过了,该标志和用户体验相关,当有该标志时,释放锁后会亮一段时间后灭屏,这里来看看applyWakeLockFlagsOnReleaseLocked(wakeLock)方法:

    /**
     *如果当前释放的wakelock带有PowerManager.ON_AFTER_RELEASE标志,则会屏幕在灭屏时小亮一会儿才会熄灭
     */
    private void applyWakeLockFlagsOnReleaseLocked(WakeLock wakeLock) {
        if ((wakeLock.mFlags & PowerManager.ON_AFTER_RELEASE) != 0
                && isScreenLock(wakeLock)) {
            //更新用户活动时间,并带有PowerManager.USER_ACTIVITY_FLAG_NO_CHANGE_LIGHTS标志,用于延缓灭屏时间
            userActivityNoUpdateLocked(SystemClock.uptimeMillis(),
                    PowerManager.USER_ACTIVITY_EVENT_OTHER,
                    PowerManager.USER_ACTIVITY_FLAG_NO_CHANGE_LIGHTS,
                    wakeLock.mOwnerUid);
        }
    }

最后,又将调用updatePowerStateLocked(),其中和WakeLock申请和释放相关的都updateSuspendBlockerLocked()中,释放相关代码如下:

    //满足两个条件,释放"PowerManagerService.WakeLocks"锁
    if (!needWakeLockSuspendBlocker && mHoldingWakeLockSuspendBlocker) {
        mWakeLockSuspendBlocker.release();
        mHoldingWakeLockSuspendBlocker = false;
    }
    //释放"PowerManagerService.Display"锁
    if (!needDisplaySuspendBlocker && mHoldingDisplaySuspendBlocker) {
        mDisplaySuspendBlocker.release();
        mHoldingDisplaySuspendBlocker = false;
    }

如果满足条件,则释放SuspendBlocker锁。申请SuspendBlocker流程已经分析过了,接下来我们分析释放SuspendBlocker流程。在SuspendBlocker中释放锁如下:

@Override
public void release() {
    synchronized (this) {
        //计数-1
        mReferenceCount -= 1;
        if (mReferenceCount == 0) {
            //调用JNI层进行释放
            nativeReleaseSuspendBlocker(mName);
        } else if (mReferenceCount < 0) {
            mReferenceCount = 0;
        }
    }
}

在释放锁时,如果有多个锁,实际上是对锁计数的属性减1,直到剩余一个时才会调用JNI层执行释放操作。JNI层对应的文件也在com_android_server_power_PowerManagerService.cpp中,具体代码如下:

static void nativeReleaseSuspendBlocker(JNIEnv *env, jclass /* clazz */, jstring nameStr) {
    ScopedUtfChars name(env, nameStr);
    release_wake_lock(name.c_str());
}

在JNI层方法中,调用了HAL层的方法,通过文件描述符向/sys/power/wake_unlock中写值完成释放:

int release_wake_lock(const char* id)
{
    initialize_fds();
    //    ALOGI("release_wake_lock id='%s'\n", id);
    if (g_error) return g_error;
    ssize_t len = write(g_fds[RELEASE_WAKE_LOCK], id, strlen(id));
    if (len < 0) {
        return -errno;
    }
    return len;
}

到这里为止,WakeLock的释放流程也就分析完毕了。

通过对WakeLock锁的申请和释放流程分析,知道实际上通过操作/sys/power/wake_lock/sys/power/wake_unlock节点来控制设备的唤醒和休眠,当应用需要唤醒设备时,申请一个WakeLock锁,最终会在/sys/power/wake_lock 中写入SuspendBlocker锁名,从而保持了设备的唤醒;当应用执行完操作后,则释放WakeLock锁,最终会在/sys/power/wake_unlock 中写入SuspendBlocker锁名。
整个wakelock锁释放的时序图如下:

《PowerManagerService分析(三)之WakeLock机制》

再谈
WakeLock锁和
SuspendBlocker

通过对Wakelock锁的申请和释放,可以知道底层最终的锁都是SuspendBlocker锁,SuspendBlocker锁官方的解释是:SuspendBlocker相当于持有部分唤醒锁,该接口在内部使用,以避免在高级别唤醒锁机制上引入内部依赖关系。
当上层使用申请了wakelock锁后,最终反映在底层的都是SuspendBlocker锁,从PowerManager到PowerManagerService再到HAL层,其锁之间的关系如下图:

《PowerManagerService分析(三)之WakeLock机制》

再来看下在PMS中实例化的SuspendBloker:

//通过PARTIAL_WAKE_LOCK类型WakeLock锁使CPU激活
mWakeLockSuspendBlocker = createSuspendBlockerLocked("PowerManagerService.WakeLocks");
//通过屏幕亮屏使得CPU激活
mDisplaySuspendBlocker = createSuspendBlockerLocked("PowerManagerService.Display");
//防止在发送广播时CPU休眠
mNotifier = new Notifier(Looper.getMainLooper(), mContext, mBatteryStats,
        mAppOps, createSuspendBlockerLocked("PowerManagerService.Broadcasts"),
        mPolicy);

除了这三类锁,在通过adb命令查看/sys/power/wake_unlock还可以看得出其他两种SuspendBlocker锁:

$ adb shell cat /sys/power/wake_unlock
KeyEvents PowerManagerService.Broadcasts PowerManagerService.Display PowerManagerService.WakeLocks radio-interface
$

mWakeLockSuspendBlocker锁在updateSuspendBlockerLocked()方法中看出,mWakeLockSuspendBlocker申请的条件是:

final boolean needWakeLockSuspendBlocker = ((mWakeLockSummary & WAKE_LOCK_CPU) != 0);

mWakeLockSummary在第二篇文章中分析了,是一个汇总了所有WakeLock锁的二进制标志位,同时在第二篇文章的updateWakeLockSummaryLocked()方法中分析了,满足以下条件时,会将mWakeLockSummary置位为WAKE_LOCK_CPU

//updateWakeLockSummaryLocked()中:
case PowerManager.PARTIAL_WAKE_LOCK:
case PowerManager.DRAW_WAKE_LOCK:
    mWakeLockSummary |= WAKE_LOCK_DRAW;
if (mWakefulness == WAKEFULNESS_AWAKE) {
    mWakeLockSummary |= WAKE_LOCK_CPU | WAKE_LOCK_STAY_AWAKE;
} else if (mWakefulness == WAKEFULNESS_DREAMING) {
    mWakeLockSummary |= WAKE_LOCK_CPU;
}
if ((mWakeLockSummary & WAKE_LOCK_DRAW) != 0) {
    mWakeLockSummary |= WAKE_LOCK_CPU;
}

因此,当申请了PARTIAL_WAKE_LOCK 类型的WakeLock锁、DRAW_WAKE_LOCK类型的WakeLock锁(前提是处于Doze模式)、屏幕处于唤醒、屏保时,都会持有一个mWakeLockSuspendBlocker锁,会在/sys/power/wake_lock节点中写入”PowerManager.WakeLocks“,从而保持设备处于唤醒状态。

mDisplaySuspendBlocker锁

updateSuspendBlockerLocked()方法中,mDisplaySuspendBlocker申请的条件是:

final boolean needDisplaySuspendBlocker = needDisplaySuspendBlockerLocked();

private boolean needDisplaySuspendBlockerLocked() {
if (mDisplayPowerRequest.isBrightOrDim()) {//屏幕处于亮或Dim
    //没有使用PSensor || PSensor值为负值(靠近) || 配置PSensor灭屏时挂起CPU为false 
    if (!mDisplayPowerRequest.useProximitySensor || !mProximityPositive
            || !mSuspendWhenScreenOffDueToProximityConfig) {
        return true;
    }
}
......
return false;
}

因此,只要在屏幕处于亮或Dim状态时,满足其中之一项,就可以申请mDisplaySuspendBlocker锁,会向/sys/power/wake_lock中写入”PowerManagerService.Display“
当屏幕处于亮屏或Dim状态时,一定持有mDisplaySuspendBlocker

PowerManagerService.Broadcasts

这个类型的SuspendBlocker并没有在PMS中进行实例化,它以构造方法的形式传入了Notifier中,Notifier类相当于是PMS的”中介“,PMS中和其他服务的部分交互通过Notifier进行,还有比如亮屏广播、灭屏广播等,都是由PMS交给Notifier来发送,这点在下篇文章中进行分析。因此,如果CPU在广播发送过程中进入休眠,则广播无法发送完成,因此,需要一个锁来保证Notifier中广播的成功发送,这就是PowerManagerService.Broadcasts 锁的作用,当广播发送完毕后,该锁立即就释放了。

《PowerManagerService分析(三)之WakeLock机制》
《PowerManagerService分析(三)之WakeLock机制》 长按识别二维码,领福利

至此,本篇已结束,如有不对的地方,欢迎您的建议与指正。同时期待您的关注,感谢您的阅读,谢谢!

《PowerManagerService分析(三)之WakeLock机制》

如有侵权,请联系小编,小编对此深感抱歉,届时小编会删除文章,立即停止侵权行为,请您多多包涵。

《PowerManagerService分析(三)之WakeLock机制》

既然都看到这里,领两个红包在走吧!
以下两个红包每天都可以领取

1.支付宝搜索 522398497,或扫码支付宝红包海报。

《PowerManagerService分析(三)之WakeLock机制》 支付宝扫一扫,每天领取大红包

2.微信红包,微信扫一扫即可领取红包

《PowerManagerService分析(三)之WakeLock机制》 微信扫一扫,每天领取微信红包

    原文作者:ProgramAndroid
    原文地址: https://www.jianshu.com/p/11ec15c25790
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞