DirectFB 源码解读之外设输入处理流程

转载时请表明原文出处(http://blog.sina.com.cn/wyw1976)及作者邮箱(wyw1976@gmail.com)
 
    接着上一节，我们看看输入设备的事件是怎样从硬件传到DFB的最终用户的。下面的代码是DFB用户处理外设事件的一种方法：
  
DirectFBInit( &argc, &argv )；
DirectFBCreate( &dfb )；
dfb->EnumInputDevices( dfb, enum_input_device, &devices );//枚举得到系统存在并被DFB支持的所有外设，每找到
                                                  //一个都会调用一次callback函数，你可以在这个
                                                  //callback函数中记录每个device的详细信息。
dfb->CreateInputEventBuffer( dfb, DICAPS_ALL, DFB_TRUE, &events ));//创建一个InputEvent Buffer，第二个参
                                                          //数表示该buffer关心的那种事件，
                                                          //DFB将所有的外设事件分为三类：key,
                                                          //axis, button，你可以在程序中指定
                                                          //三种的任何组合
if (events->WaitForEventWithTimeout( events, 10, 0 ) != DFB_TIMEOUT) //等待事件的发生。
{
          while (1)
          {
               DFBInputEvent evt;
               while (events->GetEvent( events, DFB_EVENT(&evt) ) == DFB_OK) //获取所有的事件
               {
                 //do something.........                                     //处理该事件
                }
               events->WaitForEvent( events );                               //继续等待事件
          }
 }
 
需要注明的是：上面只是input event的一种使用方法，你也可以创建一个input device, 通过这个device创建一个属于它自己的一般的Event buffer (而不是input event buffer)。
 
现在我们就是顺着上面的代码看看DFB内部做了些什么？
（1）前两步DirectFBInit和DirectFBCreate完成DFB的初始化，与这个例子有关的就是input core part 的初始化，其结果如上一节所述《DirectFB 源码解读之初始化-10》。需要补充的是，在调用OpenDevice打开设备的时候，会得到device_info, 它的内容是每个driver填写的，其中的一项desc.caps表明了该设备的类型：KEY, BUTTON 或AXIS。当然有的设备可以既有button，也有axis，如鼠标。
 
（2）dfb->EnumInputDevices也很简单，根据上一节，所有device和driver的信息都记录在core_local这个全局变量的链表中，遍历这个链表即可。
 
（3）dfb->CreateInputEventBuffer,这一步做两件事情， 一是创建一个Event buffer对象（就如同用户调用dfb->CreateEventBuffer一样），包括初始化它的函数接口等。二是与device绑定。
 
    先看看Event buffer 这个对象包含了那些内容：IDirectFBEventBuffer的私有数据即IDirectFBEventBuffer_data，有两个我们关心的链表，一个是devices记录了与该eventbuffer关联的所有设备，一个是events记录了这个eventbuffer中所有的event。 
     而devices与eventbuffer的关联，就是填充《DirectFB 源码解读之初始化-10》图中的虚线reaction，每个reaction，包含两个指针：IDirectFBEventBuffer_data和处理函数（统一为IDirectFBEventBuffer_InputReact），前一个表示谁关心该设备的事件，后一个表示有了事件后如何处理。链接工作具体是在IDirectFBEventBuffer_AttachInputDevice中完成的。调用流程如下：


 
    前一节，我们说到，DFB为每个有效的输入设备创建一个线程，该线程在得到下层的事件后，做一个简单的事件匹配，调用dfb_input_dispatch，开始分发。它会调用fusion_reactor_dispatch，而它会调用该device上的每个reaction的处理函数（IDirectFBEventBuffer_InputReact），该函数将事件挂到event buffer 的events链表中，同时等待的线程（ 如果存在的话）。
 
（4）events->WaitForEventWithTimeout。 如果events链表中有数据，则直接返回；否则调用pthread_cond_timedwait,阻塞当前线程，直到发生事件或超时。
 
（5）events->GetEvent就是从链表中取得event。