android 休眠喚醒機制分析(二) — early_suspend

本文轉自:http://blog.csdn.net/g_salamander/article/details/7982170linux

early_suspend是Android休眠流程的第一階段即淺度休眠,不會受到wake_lock的阻止,通常用於關閉lcd、tp等設備爲運行的應用節約電能。Android的PowerManagerService會根據用戶的操做狀況調整電源狀態,若是須要休眠則會調用到HAL層的set_screen_state()接口,在set_screen_state()中會向/sys/power/state節點寫入"mem"值讓驅動層開始進入休眠流程。android

1、休眠喚醒機制及其用戶空間接口緩存

Linux系統支持以下休眠喚醒等級函數

[cpp]  view plain copy
 
  1. const char *const pm_states[PM_SUSPEND_MAX] = {  
  2. #ifdef CONFIG_EARLYSUSPEND  
  3.     [PM_SUSPEND_ON]     = "on",  
  4. #endif  
  5.     [PM_SUSPEND_STANDBY]    = "standby",  
  6.     [PM_SUSPEND_MEM]    = "mem",  
  7. };  

但在Android中通常只支持"on"和"mem",其中"on"爲喚醒設備,"mem"爲休眠設備。/sys/power/state節點的讀寫操做以下:spa

[cpp]  view plain copy
 
  1. static ssize_t state_show(struct kobject *kobj, struct kobj_attribute *attr,  
  2.               char *buf)  
  3. {  
  4.     char *s = buf;  
  5. #ifdef CONFIG_SUSPEND  
  6.     int i;  
  7.   
  8.     for (i = 0; i < PM_SUSPEND_MAX; i++) {  
  9.         if (pm_states[i] && valid_state(i))  
  10.             s += sprintf(s,"%s ", pm_states[i]);  // 打印系統支持的休眠等級  
  11.     }  
  12. #endif  
  13. #ifdef CONFIG_HIBERNATION  
  14.     s += sprintf(s, "%s\n", "disk");  
  15. #else  
  16.     if (s != buf)  
  17.         /* convert the last space to a newline */  
  18.         *(s-1) = '\n';  
  19. #endif  
  20.     return (s - buf);  
  21. }  
  22.   
  23. static ssize_t state_store(struct kobject *kobj, struct kobj_attribute *attr,  
  24.                const char *buf, size_t n)  
  25. {  
  26. #ifdef CONFIG_SUSPEND  
  27. #ifdef CONFIG_EARLYSUSPEND  
  28.     suspend_state_t state = PM_SUSPEND_ON;  
  29. #else  
  30.     suspend_state_t state = PM_SUSPEND_STANDBY;  
  31. #endif  
  32.     const char * const *s;  
  33. #endif  
  34.     char *p;  
  35.     int len;  
  36.     int error = -EINVAL;  
  37.   
  38.     p = memchr(buf, '\n', n);  
  39.     len = p ? p - buf : n;  
  40.   
  41.     /* First, check if we are requested to hibernate */  
  42.     if (len == 4 && !strncmp(buf, "disk", len)) {  
  43.         error = hibernate();  
  44.   goto Exit;  
  45.     }  
  46.   
  47. #ifdef CONFIG_SUSPEND  
  48.     for (s = &pm_states[state]; state < PM_SUSPEND_MAX; s++, state++) {  
  49.         if (*s && len == strlen(*s) && !strncmp(buf, *s, len))  
  50.             break;  
  51.     }  
  52.     if (state < PM_SUSPEND_MAX && *s)  
  53. #ifdef CONFIG_EARLYSUSPEND  
  54.         if (state == PM_SUSPEND_ON || valid_state(state)) {  
  55.             error = 0;  
  56.             request_suspend_state(state);  // 請求進入android的休眠流程  
  57.         }  
  58. #else  
  59.         error = enter_state(state);  // linux的標準休眠流程  
  60. #endif  
  61. #endif  
  62.   
  63.  Exit:  
  64.     return error ? error : n;  
  65. }  
  66.   
  67. power_attr(state);  

其中state_show()爲節點的讀函數,主要打印出系統支持的休眠等級;state_store()爲節點的寫函數,根據參數請求休眠或者喚醒流程。節點的建立代碼以下:.net

 

[cpp]  view plain copy
 
  1. static struct attribute * g[] = {  
  2.     &state_attr.attr,        // state節點  
  3. #ifdef CONFIG_PM_TRACE  
  4.     &pm_trace_attr.attr,  
  5. #endif  
  6. #if defined(CONFIG_PM_SLEEP) && defined(CONFIG_PM_DEBUG)  
  7.     &pm_test_attr.attr,      // pm_test節點  
  8. #endif  
  9. #ifdef CONFIG_USER_WAKELOCK  
  10.     &wake_lock_attr.attr,    // wake_lock節點  
  11.     &wake_unlock_attr.attr,  // wake_unlock節點  
  12. #endif  
  13.     NULL,  
  14. };  
  15.   
  16. static struct attribute_group attr_group = {  
  17.     .attrs = g,  
  18. };  
  19.   
  20. static int __init pm_init(void)  
  21. {  
  22.     int error = pm_start_workqueue();  
  23.     if (error)  
  24.         return error;  
  25.     power_kobj = kobject_create_and_add("power", NULL);  // 建立power節點  
  26.     if (!power_kobj)  
  27.         return -ENOMEM;  
  28.     return sysfs_create_group(power_kobj, &attr_group);  // 建立一組屬性節點  
  29. }  
  30.   
  31. core_initcall(pm_init);  

2、early_suspend 實現hibernate

一、early_suspend 定義、接口及其用法線程

 

[cpp]  view plain copy
 
  1. enum {  
  2.     EARLY_SUSPEND_LEVEL_BLANK_SCREEN = 50,  
  3.     EARLY_SUSPEND_LEVEL_STOP_DRAWING = 100,  
  4.     EARLY_SUSPEND_LEVEL_DISABLE_FB = 150,  
  5. };  
  6. struct early_suspend {  
  7. #ifdef CONFIG_HAS_EARLYSUSPEND  
  8.     struct list_head link;  // 鏈表節點  
  9.     int level;              // 優先等級  
  10.     void (*suspend)(struct early_suspend *h);  
  11.     void (*resume)(struct early_suspend *h);  
  12. #endif  
  13. };  

能夠看到early_suspend由兩個函數指針、鏈表節點、優先等級組成;內核默認定義了3個優先等級,在suspend的時候先執行優先等級低的handler,在resume的時候則先執行等級高的handler,用戶能夠定義本身的優先等級;early_suspend向內核空間提供了2個接口用於註冊和註銷handler:debug

 

[cpp]  view plain copy
 
  1. void register_early_suspend(struct early_suspend *handler);  
  2. void unregister_early_suspend(struct early_suspend *handler);  

其中register_early_suspend()用於註冊,unregister_early_suspend用於註銷;通常early_suspend的使用方式以下:指針

 

 

[cpp]  view plain copy
 
  1. ts->earlysuspend.suspend = sitronix_i2c_suspend_early;  
  2. ts->earlysuspend.resume = sitronix_i2c_resume_late;  
  3. ts->earlysuspend.level = EARLY_SUSPEND_LEVEL_BLANK_SCREEN;  
  4. register_early_suspend(&ts->earlysuspend);  

設置好suspend和resume接口,定義優先等級,而後註冊結構便可。

 

二、初始化信息

咱們看一下early_suspend須要用到的一些數據:

 

[cpp]  view plain copy
 
  1. static DEFINE_MUTEX(early_suspend_lock);  
  2. static LIST_HEAD(early_suspend_handlers);  // 初始化淺度休眠鏈表  
  3. // 聲明3個工做隊列用於同步、淺度休眠和喚醒  
  4. static void early_sys_sync(struct work_struct *work);  
  5. static void early_suspend(struct work_struct *work);  
  6. static void late_resume(struct work_struct *work);  
  7. static DECLARE_WORK(early_sys_sync_work,early_sys_sync);  
  8. static DECLARE_WORK(early_suspend_work, early_suspend);  
  9. static DECLARE_WORK(late_resume_work, late_resume);  
  10. static DEFINE_SPINLOCK(state_lock);  
  11. enum {  
  12.     SUSPEND_REQUESTED = 0x1,  // 當前正在請求淺度休眠  
  13.     SUSPENDED = 0x2,          // 淺度休眠完成  
  14.     SUSPEND_REQUESTED_AND_SUSPENDED = SUSPEND_REQUESTED | SUSPENDED,  
  15. };  
  16. static int state;  

初始化了一個鏈表early_suspend_handlers用於管理early_suspend,還定義讀寫鏈表用到的互斥體;另外還聲明瞭3個工做隊列,分別用於緩存同步、淺度休眠和喚醒;還聲明瞭early_suspend操做的3個狀態。
三、register_early_suspend 和 unregister_early_suspend

 

 

[cpp]  view plain copy
 
  1. void register_early_suspend(struct early_suspend *handler)  
  2. {  
  3.     struct list_head *pos;  
  4.   
  5.     mutex_lock(&early_suspend_lock);  
  6.     // 遍歷淺度休眠鏈表  
  7.     list_for_each(pos, &early_suspend_handlers) {  
  8.         struct early_suspend *e;  
  9.         e = list_entry(pos, struct early_suspend, link);  
  10.         // 判斷當前節點的優先等級是否大於handler的優先等級  
  11.         // 以此決定handler在鏈表中的順序  
  12.         if (e->level > handler->level)  
  13.             break;  
  14.     }  
  15.     // 將handler加入當前節點以前,優先等級越低越靠前  
  16.     list_add_tail(&handler->link, pos);  
  17.     if ((state & SUSPENDED) && handler->suspend)  
  18.         handler->suspend(handler);  
  19.     mutex_unlock(&early_suspend_lock);  
  20. }  
  21. EXPORT_SYMBOL(register_early_suspend);  

註冊的流程比較簡單,首先遍歷鏈表,依次比較每一個節點的優先等級,若是遇到優先等級比新節點優先等級高則跳出,而後將新節點加入優先等級較高的節點前面,這樣就確保了鏈表是優先等級低在前高在後的順序;在將節點加入鏈表後查看當前狀態是否爲淺度休眠完成狀態,若是是則執行handler的suspend函數。

 

 

[cpp]  view plain copy
 
  1. void unregister_early_suspend(struct early_suspend *handler)  
  2. {  
  3.     mutex_lock(&early_suspend_lock);  
  4.     list_del(&handler->link);  
  5.     mutex_unlock(&early_suspend_lock);  
  6. }  
  7. EXPORT_SYMBOL(unregister_early_suspend);  

註銷流程則只是將節點從鏈表中移除。
四、request_suspend_state

 

前面咱們看到用戶空間在寫/sys/power/state節點的時候會執行request_suspend_state()函數,該函數代碼以下:

 

[cpp]  view plain copy
 
  1. void request_suspend_state(suspend_state_t new_state)  
  2. {  
  3.     unsigned long irqflags;  
  4.     int old_sleep;  
  5.   
  6.     spin_lock_irqsave(&state_lock, irqflags);  
  7.     old_sleep = state & SUSPEND_REQUESTED;  
  8.     // 打印當前狀態  
  9.     if (debug_mask & DEBUG_USER_STATE) {  
  10.         struct timespec ts;  
  11.         struct rtc_time tm;  
  12.         getnstimeofday(&ts);  
  13.         rtc_time_to_tm(ts.tv_sec, &tm);  
  14.         pr_info("request_suspend_state: %s (%d->%d) at %lld "  
  15.             "(%d-%02d-%02d %02d:%02d:%02d.%09lu UTC)\n",  
  16.             new_state != PM_SUSPEND_ON ? "sleep" : "wakeup",  
  17.             requested_suspend_state, new_state,  
  18.             ktime_to_ns(ktime_get()),  
  19.             tm.tm_year + 1900, tm.tm_mon + 1, tm.tm_mday,  
  20.             tm.tm_hour, tm.tm_min, tm.tm_sec, ts.tv_nsec);  
  21.     }  
  22.     // 若是新狀態是休眠狀態  
  23.     if (!old_sleep && new_state != PM_SUSPEND_ON) {  
  24.         state |= SUSPEND_REQUESTED;  
  25.         pr_info("sys_sync_work_queue early_sys_sync_work.\n");  
  26.         // 執行緩存同步與淺度休眠的工做隊列  
  27.         queue_work(sys_sync_work_queue, &early_sys_sync_work);  
  28.         queue_work(suspend_work_queue, &early_suspend_work);  
  29.     } else if (old_sleep && new_state == PM_SUSPEND_ON) {  
  30.     // 若是新狀態是喚醒狀態  
  31.         state &= ~SUSPEND_REQUESTED;  
  32.         // 激活內核鎖  
  33.         wake_lock(&main_wake_lock);  
  34.         // 執行淺度喚醒的工做隊列  
  35.         queue_work(suspend_work_queue, &late_resume_work);  
  36.     }  
  37.     // 更新全局狀態  
  38.     requested_suspend_state = new_state;  
  39.     spin_unlock_irqrestore(&state_lock, irqflags);  
  40. }  

函數首先打印出當前狀態變化的log,而後判斷新狀態,若是是休眠狀態則置位SUSPEND_REQUESTED標誌,而後將同步緩存、淺度休眠工做隊列加入相應的內核線程執行;若是新狀態是喚醒則首先將main_wake_lock激活,而後再將淺度喚醒工做隊列加入內核線程執行;最後更新全局狀態變量,由於提供了一個內核空間接口用於獲取當前休眠喚醒狀態:

 

 

[cpp]  view plain copy
 
  1. // 返回系統狀態值  
  2. suspend_state_t get_suspend_state(void)  
  3. {  
  4.     return requested_suspend_state;  
  5. }  

五、early_suspend_work、late_resume_work 和 early_sys_sync

[cpp]  view plain copy
 
  1. static void early_suspend(struct work_struct *work)  
  2. {  
  3.     struct early_suspend *pos;  
  4.     unsigned long irqflags;  
  5.     int abort = 0;  
  6.   
  7.     mutex_lock(&early_suspend_lock);  
  8.     spin_lock_irqsave(&state_lock, irqflags);  
  9.     if (state == SUSPEND_REQUESTED)  // 判斷當前狀態是否在請求淺度休眠  
  10.         state |= SUSPENDED;      // 若是是則置位SUSPENDED  
  11.     else  
  12.         abort = 1;  
  13.     spin_unlock_irqrestore(&state_lock, irqflags);  
  14.   
  15.     if (abort) {  // 取消early_suspend  
  16.         if (debug_mask & DEBUG_SUSPEND)  
  17.             pr_info("early_suspend: abort, state %d\n", state);  
  18.         mutex_unlock(&early_suspend_lock);  
  19.         goto abort;  
  20.     }  
  21.   
  22.     if (debug_mask & DEBUG_SUSPEND)  
  23.         pr_info("early_suspend: call handlers\n");  
  24.     // 遍歷淺度休眠鏈表並執行其中全部suspend函數  
  25.     // 執行順序根據優先等級而定,等級越低越先執行  
  26.     list_for_each_entry(pos, &early_suspend_handlers, link) {  
  27.         if (pos->suspend != NULL)  
  28.             pos->suspend(pos);  
  29.     }  
  30.     mutex_unlock(&early_suspend_lock);  
  31.   
  32.     if (debug_mask & DEBUG_SUSPEND)  
  33.         pr_info("early_suspend: sync\n");  
  34.   
  35.     /* Remove sys_sync from early_suspend, and use work queue to complete sys_sync */  
  36.     //sys_sync();  
  37. abort:  
  38.     spin_lock_irqsave(&state_lock, irqflags);  
  39.     if (state == SUSPEND_REQUESTED_AND_SUSPENDED)  
  40.         wake_unlock(&main_wake_lock);  
  41.     spin_unlock_irqrestore(&state_lock, irqflags);  
  42. }  

在suspend流程中首先判斷當前狀態是否爲SUSPEND_REQUESTED,若是是則置位SUSPENDED標誌,若是不是則取消suspend流程;而後遍歷淺度休眠鏈表,從鏈表頭部到尾部依次調用各節點的suspend()函數,執行完後判斷當前狀態是否爲SUSPEND_REQUESTED_AND_SUSPENDED,若是是則釋放main_wake_lock,當前系統中若是隻存在main_wake_lock這個有效鎖,則會在wake_unlock()裏面啓動深度休眠線程,若是還有其餘其餘wake_lock則保持當前狀態。

 

 

[cpp]  view plain copy
 
  1. static void late_resume(struct work_struct *work)  
  2. {  
  3.     struct early_suspend *pos;  
  4.     unsigned long irqflags;  
  5.     int abort = 0;  
  6.   
  7.     mutex_lock(&early_suspend_lock);  
  8.     spin_lock_irqsave(&state_lock, irqflags);  
  9.     if (state == SUSPENDED)  // 清除淺度休眠完成標誌  
  10.         state &= ~SUSPENDED;  
  11.     else  
  12.         abort = 1;  
  13.     spin_unlock_irqrestore(&state_lock, irqflags);  
  14.   
  15.     if (abort) {  
  16.         if (debug_mask & DEBUG_SUSPEND)  
  17.             pr_info("late_resume: abort, state %d\n", state);  
  18.         goto abort;  
  19.     }  
  20.     if (debug_mask & DEBUG_SUSPEND)  
  21.         pr_info("late_resume: call handlers\n");  
  22.     // 反向遍歷淺度休眠鏈表並執行其中全部resume函數  
  23.     // 執行順序根據優先等級而定,等級越高越先執行  
  24.     list_for_each_entry_reverse(pos, &early_suspend_handlers, link)  
  25.         if (pos->resume != NULL)  
  26.             pos->resume(pos);  
  27.     if (debug_mask & DEBUG_SUSPEND)  
  28.         pr_info("late_resume: done\n");  
  29. abort:  
  30.     mutex_unlock(&early_suspend_lock);  
  31. }  

在resume流程中一樣首先判斷當前狀態是否爲SUSPENDED,若是是則清除SUSPENDED標誌,而後反向遍歷淺度休眠鏈表,按照優先等級從高到低的順序執行節點的resume()函數。

相關文章
相關標籤/搜索