input子系統學習筆記六 按鍵驅動執行個體分析下【轉】

        input_report_key()向子系統報告事件

        在 button_interrupt()中斷函數中,不需要考慮重複按鍵的重複點選情況,input_report_key()函數會自動檢查這個問題,并報告一次事件給輸入子系統。該函數的代碼如下:

C++代碼

1. static inline void input_report_key(struct input_dev *dev,unsigned int  
2. code, int value)  
3. {  
4.         input_event(dev, EV_KEY, code, !!value);  
5. }  

        該函數的第 1 個參數是産生事件的輸入裝置, 第2 個參數是産生的事件, 第3 個參數是事件的值。需要注意的是, 2 個參數可以取類似 BTN_0、 BTN_1、BTN_LEFT、BTN_RIGHT 等值,這些鍵值被定義在 include/linux/input.h 檔案中。當第 2 個參數為按鍵時,第 3 個參數表示按鍵的狀态,value 值為 0 表示按鍵釋放,非 0 表示按鍵按下。

        input_event()

        在 input_report_key()函數中正在起作用的函數是 input_event()函數,該函數用來向輸入子系統報告輸入裝置産生的事件,這個函數非常重要,它的代碼如下:

Java代碼

1. void input_event(struct input_dev *dev,unsigned int type, unsigned int code, int value)  
3.         unsigned long flags;  
4.         /*調用 is_event_supported()函數檢查輸入裝置是否支援該事件*/  
5.         if (is_event_supported(type, dev->evbit, EV_MAX)) {  
6.                 spin_lock_irqsave(&dev->event_lock, flags);//調用 spin_lock_irqsave()函數對将事件鎖鎖定。  
7.                 add_input_randomness(type,code,value);//add_input_randomness()函數對事件發送沒有一點用處,隻是用來對随機數熵池增加一些貢獻,因為按鍵輸入是一種随機事件,是以對熵池是有貢獻的。  
8.                 input_handle_event(dev, type, code, value);//調用 input_handle_event()函數來繼續輸入子系統的相關子產品發送資料。該函數較為複雜,下面單獨進行分析。  
9.                 spin_unlock_irqrestore(&dev->event_lock, flags);  
10.         }  

        is_event_supported()

1. static inline int is_event_supported(unsigned int code,  
2. unsigned long *bm, unsigned int max)  
4.         return code <= max && test_bit(code, bm);  

        該函數檢查 input_dev.evbit 中的相應位是否設定,如果設定傳回 1,否則傳回 0。每一種類型的事件都在 input_dev.evbit 中用一個位來表示,構成一個位圖,如果某位為 1,表示該輸入裝置支援這類事件,如果為 0,表示輸入裝置不支援這類事件。目前 Linux 支援十多種事件類型,是以用一個 long 型變量就可以全部表示了。

        input_handle_event()

        input_handle_event()函數向輸入子系統傳送事件資訊。第 1 個參數是輸入裝置 input_dev,第 2 個參數是事件的類型,第 3 個參數是鍵碼,第 4 個參數是鍵值。該函數的代碼如下:

1. static void input_handle_event(struct input_dev *dev,  
2. unsigned int type, unsigned int code, int value)  
4.         int disposition = INPUT_IGNORE_EVENT;//定義了一個 disposition 變量,該變量表示使用什麼樣的方式處理事件。此處初始化為 INPUT_IGNORE_EVENT,表示如果後面沒有對該變量重新指派,則忽略這個事件。  
5.         switch (type) {  
6.         case EV_SYN:  
7.                 switch (code) {  
8.                         case SYN_CONFIG:  
9.                                 disposition = INPUT_PASS_TO_ALL;  
10.                                 break;  
11.                         case SYN_REPORT:  
12.                                 if (!dev->sync) {  
13.                                         dev->sync = 1;  
14.                                         disposition = INPUT_PASS_TO_HANDLERS;  
15.                                 }  
17.                         case SYN_MT_REPORT:  
18.                                 dev->sync = 0;  
19.                                 disposition = INPUT_PASS_TO_HANDLERS;  
21.                 }  
22.         break;  
23.         case EV_KEY:  
24.         //調用 is_event_supported()函數判斷是否支援該按鍵。  
25.                 if (is_event_supported(code, dev->keybit, KEY_MAX) &&  
26.                 !!test_bit(code, dev->key) != value) {  
27.                         //調用 test_bit()函數來測試按鍵狀态是否改變。  
28.                         if (value != 2) {  
29.                                 __change_bit(code,dev->key);/*調用__change_bit()函數改變鍵的狀态。*/  
30.                                         if (value)  
31.                                                 input_start_autorepeat(dev, code);/*處理重複按鍵的情況。*/  
32.                                         else  
33.                                                 input_stop_autorepeat(dev);  
34.                         }  
35.                 disposition = INPUT_PASS_TO_HANDLERS;/*将 disposition變量設定為 INPUT_PASS_TO_HANDLERS,表示事件需要 handler 來處理。disposition 的取值有如下幾種: 
36.                         1. #define INPUT_IGNORE_EVENT 0 
37.                         2. #define INPUT_PASS_TO_HANDLERS 1 
38.                         3. #define INPUT_PASS_TO_DEVICE 2 
39.                         4.#define INPUT_PASS_TO_ALL(INPUT_PASS_TO_HANDLERS | INPUT_PASS_TO_DEVICE) 
40.                 INPUT_IGNORE_EVENT 表示忽略事件,不對其進行處理。INPUT_PASS_ TO_HANDLERS 表示将事件交給handler處理。INPUT_PASS_TO_DEVICE 表示将事件交給 input_dev 處理。INPUT_PASS_TO_ALL 表示将事件交給 handler 和 input_dev 共同處理。 */  
43.         case EV_SW:  
44.                 if (is_event_supported(code, dev->swbit, SW_MAX) &&  
45.                         !!test_bit(code, dev->sw) != value) {  
46.                         __change_bit(code, dev->sw);  
47.                         disposition = INPUT_PASS_TO_HANDLERS;  
49.                 break;  
50.         case EV_ABS:  
51.                 if (is_event_supported(code, dev->absbit, ABS_MAX)) {  
52.                 if (test_bit(code, input_abs_bypass)) {  
54.                         break;  
55.                     }  
56.         value = input_defuzz_abs_event(value,  
57.         dev->abs[code], dev->absfuzz[code]);  
58.                 if (dev->abs[code] != value) {  
59.                         dev->abs[code] = value;  
64.         case EV_REL:  
65.                 if (is_event_supported(code, dev->relbit, REL_MAX) && value)  
68.         case EV_MSC:  
69.                 if (is_event_supported(code, dev->mscbit, MSC_MAX))  
70.                         disposition = INPUT_PASS_TO_ALL;  
72.         case EV_LED:  
73.                 if (is_event_supported(code, dev->ledbit, LED_MAX) &&  
74.                         !!test_bit(code, dev->led) != value) {  
75.                         __change_bit(code, dev->led);  
79.         case EV_SND:  
80.                 if (is_event_supported(code, dev->sndbit, SND_MAX)) {  
81.                         if (!!test_bit(code, dev->snd) != !!value)  
82.                 __change_bit(code, dev->snd);  
83.                 disposition = INPUT_PASS_TO_ALL;  
86.         case EV_REP:  
87.         if (code <= REP_MAX && value >= 0 && dev->rep[code] != value) {  
88.                 dev->rep[code] = value;  
92.         case EV_FF:  
93.         if (value >= 0)  
96.         case EV_PWR:  
100.         if (disposition != INPUT_IGNORE_EVENT && type != EV_SYN)/*處理 EV_SYN 事件,這裡并不對其進行關心。*/  
101.         dev->sync = 0;  
102.         /*首先判斷 disposition 等于 INPUT_PASS_TO_DEVICE,然後判斷 dev->event 是否對其指定了一個處理函數,如果這些條件都滿足,則調用自定義的 dev->event()函數處理事件。有些事件是發送給裝置,而不是發送給 handler 處理的。event()函數用來向輸入子系統報告一個将要發送給裝置的事件,例如讓 LED 燈點亮事件、蜂鳴器鳴叫事件等。當事件報告給輸入子系統後,就要求裝置處理這個事件。*/  
103.         if ((disposition & INPUT_PASS_TO_DEVICE) && dev->event)  
104.         dev->event(dev, type, code, value);  
105.         /*第 87、88 行,如果事件需要 handler 處理,則調用 input_pass_event()函數 
106.         */  
107.         if (disposition & INPUT_PASS_TO_HANDLERS)  
108.                 input_pass_event(dev, type, code, value);  

        input_pass_event()

        input_pass_event()函數将事件傳遞到合适的函數,然後對其進行處理,該函數的代碼如下:

1. static void input_pass_event(struct input_dev *dev,  
4.         struct input_handler *handler;  
5.         struct input_handle *handle;/*配置設定一個 input_handle 結構的指針。*/  
6.         rcu_read_lock();  
7.         handle = rcu_dereference(dev->grab);/*得到 dev->grab 的指針。 
8.         grab 是強制為 input device 的 handler,這時要調用 handler的 event 函數。*/  
9.         if (handle)  
10.         handle->handler->event(handle, type, code, value);  
11.         else {  
12.         bool filtered = false;  
13.         /*表示如果沒有為 input device 強制指定 handler,為 grab 指派,即就會周遊 input device->h_list 上的 handle 成員。如果該 handle 被打開,表示該裝置已經被一個使用者程序使用。就會調用與輸入裝置對應的 handler 的 event()函數。注意,隻有在 handle 被打開的情況下才會接收到事件,這就是說,隻有裝置被使用者程式使用時,才有必要向使用者空間導出資訊。*/  
14.         list_for_each_entry_rcu(handle, &dev->h_list, d_node) {  
15.         if (!handle->open)  
16.                 continue;  
17.         handler = handle->handler;  
18.         if (!handler->filter) {  
19.                 if (filtered)  
21.                 handler->event(handle, type, code, value);  
22.         } else if (handler->filter(handle, type, code, value))  
23.                 filtered = true;