Android WakeLock 介紹

Wake Lock是一種鎖的機制, 只要有人拿著這個鎖,系統就無法進入休眠，
可以被用戶態程序和內核獲得. 這個鎖可以是有超時的或者是沒有超時的,
超時的鎖會在時間過去以後自動解鎖. 如果沒有鎖了或者超時了, 內核就
會啟動休眠的那套機制來進入休眠.
(一).內核維護了:
1).兩個鏈表，active_wake_locks[WAKE_LOCK_TYPE_COUNT]
active_wake_locks[0]維護的是suspend lock.
active_wake_locks[1]維護的是idle lock.
2).一個鏈表，inactive_locks來記錄所有處於inactive狀態的鎖.

(二). 下面講述應用層申請的鎖怎麼傳到kernel下面的，來理解
整個wakelock的框架。
比如/sys/power/wake_lock 下面的PowerManagerService
的生成過程。

1). Android 提供了現成 android.os.PowerManager 類 ,類中
提供 newWakeLock(int flags, String tag)方法來取得相應
層次的鎖， 此函數的定義
frameworks/base/core/java/android/os/PowerManager.java
下面，應用程序在申請wake_lock時都會有調用。
實例：
PowerManager pm = (PowerManager)getSystemService(Context.POWER_SERVICE);
PowerManager.WakeLock wl = pm.newWakeLock
(PowerManager.SCREEN_DIM_WAKE_LOCK, “My Tag”);
wl.acquire();//申請鎖這個裡面會調用PowerManagerService裡面acquireWakeLock()

***********************
wl.release(); //釋放鎖，顯示的釋放，如果申請的鎖不在此釋放系統就不會進入休眠。


2). frameworks層
/frameworks/base/services/java/com/android/server/
PowerManagerService.java
這個類是來管理所有的應用程序申請的wakelock。比如音視
頻播放器，camera等申請的wakelock都是通過這個類來管理的。
static final String PARTIAL_NAME = "PowerManagerService"
Power.acquireWakeLock(Power.PARTIAL_WAKE_LOCK,
PARTIAL_NAME);
這個函數調用Power類裡面的acquireWakeLock()，此時的
PARTIAL_NAME作為參數傳遞到底層去。


/frameworks/base/core/java/android/os/Power.java
public static native void acquireWakeLock(int lock, String id);
注：native申明的方法在Power類中沒有實現，其實現體在
frameworks/base/core/jni/android_os_Power.cpp中，所
以調用Power類的acquireWakeLock()方法時會調用JNI
下的實現方法。



3).JNI層的實現
路徑：frameworks/base/core/jni/android_os_Power.cpp
static void acquireWakeLock(JNIEnv *env, jobject clazz,
jint lock, jstring idObj)
{
**************
const char *id = env->GetStringUTFChars(idObj, NULL);
acquire_wake_lock(lock, id);
env->ReleaseStringUTFChars(idObj, id);
}
注：在acquireWakeLock()中調用了
路徑下hardware/libhardware_legacy/power/power.c下面
的acquire_wake_lock(lock, id)


4).與kernel層的交互
在power.c下的acquire_wake_lock(lock, id)函數如下：
int acquire_wake_lock(int lock, const char* id)
{
**************
return write(fd, id, strlen(id));
}
注： fd就是文件描述符，在此表示”/sys/power/wake_lock”
id就是從PowerManagerService類中傳下來的參數即：
PARTIAL_NAME = "PowerManagerService"
到此就是通過文件系統來與kernel層交互的地方。