MTK优美代码赏析4:MTK_MMI协议栈

  MTK软件行业有一个岗位，叫做MMI工程师，专门为mmi设置一个岗位就可知道MMI模块在mtk中的核心处理地位，当然他的地位也就决定了他的事务繁忙，mmi需要接收和处理所有其他task的消息，并在界面上进行相应的表现，这个数据量是相当大的。比如media层，L4层等。

  mmi task对其他task之间的交互数据实在太多，任务繁重，如果让你设计你将如何设计此功能呢？我是想不出来的。不过我还是觉得应该所有的操作系统应该都会处理上述的需求，只不过对外表现的复杂度不同而已，我们不应该被物质外在的复杂而迷惑。

  MTK_MMI协议栈的设计很好的处理了多TASK给MMI_task的消息调度，同时实现各task与mmi_task之间的功能抽象，也就是说其他task做了相应的处理就把处理的结果发送给mmi即可，大可不必去管mmi_task是怎么处理这些消息的。一般我们较多的处理的是L4层和mmi层之间传递的消息。

   对于一个task来说，需要做的是：1.定义一个消息，2.发送消息，3.接收消息并处理消息所承载的动作。

（这一部分可以参考我的博文《创建MTK_task的demo》http://www.cnblogs.com/zhangsufeng/archive/2010/08/16/1801042.html）

  mmi_task的协议栈处理的是第三条需求，其需要的处理接口（用例）：1.设置消息所承载的动作 2.执行消息所承载的动作 3.取消消息所承载的动作 4.清除所有消息所承载的动作 。

  这一部分MTK的设计可以见mmi_frm_events_gprot.h定义

 2 extern void mmi_frm_execute_current_protocol_handler(U16 eventID, void *MsgStruct, int mod_src, void *Message);       /* execute current protocol func handler */
 3 extern void mmi_frm_set_protocol_event_handler(U16 eventID, PsIntFuncPtr funcPtr, MMI_BOOL isMultiHandler);
 4 extern void mmi_frm_clear_protocol_event_handler(U16 eventID, PsIntFuncPtr funcPtr);
 5 extern void mmi_frm_clear_all_protocol_event_handler(void);
 6 #ifdef __MMI_DUAL_SIM__
 7 extern void mmi_frm_set_slave_protocol_event_handler(U16 eventID, PsIntFuncPtr funcPtr, MMI_BOOL isMultiHandler);
 8 extern void mmi_frm_clear_slave_protocol_event_handler(U16 eventID, PsIntFuncPtr funcPtr);
 9 extern void mmi_frm_clear_all_slave_protocol_event_handler(void);
10 #endif /* __MMI_DUAL_SIM__ */ 

 

   针对协议栈的处理，MTK的优美代码是给出了一个清晰简洁的实现方式。其操作方式可能如下：

1.其所有消息的ID定义在stack_msgs.h中的enmu msg_type中(另一个MMI_stack_msgs.h为cplus环境下的消息，Venus_Ui下可能会用到)

2.MTK开辟了一个很大得数组来定义其核心的接口数据，实现高聚低耦

 1 /*****************************************************************************
 2  * Global Variable                                                             
 3  *****************************************************************************/
 4 PseventInfo protocolEventHandler[MAX_PROTOCOL_EVENT];
 5 #ifdef __MMI_DUAL_SIM__
 6 PseventInfo SlaveProtocolEventHandler[MAX_SLAVE_PROTOCOL_EVENT];
 7 #endif /* __MMI_DUAL_SIM__ */
 8 
 9 /* static event table info, e.g. table pointer, num. of table items */
10 const mmi_frm_event_static_info_struct g_event_table_static_info[EVENT_TABLE_END] = {
11     {protocolEventHandler, sizeof(protocolEventHandler)/sizeof(PseventInfo)},
12 #ifdef __MMI_DUAL_SIM__            
13     {SlaveProtocolEventHandler, sizeof(SlaveProtocolEventHandler)/sizeof(PseventInfo)},
14 #endif
15 };
16 
17 /* runtime event table info, e.g. used and max. size */
18 mmi_frm_event_runtime_info_struct g_event_table_runtime_info[EVENT_TABLE_END];

 

g_event_table_static_info来存储所有的消息，g_event_table_runtime_info来存储运行时承载动作的消息数目信息(主要用来减少匹配消息时的计算事件)，两者相互配合来完成整个消息处理的需求（

这个设计里MTK 考虑到__MMI_DUAL_SIM__ 双卡模式下的处理）。有一点需要注意就是MAX_PROTOCOL_EVENT和MAX_SLAVE_PROTOCOL_EVENT是在程序里固定的数据，在自己创建消息时要小心这个数组越界。

对应的结构体设计如下：

/***************************************************************************** 
* Typedef 
*****************************************************************************/
typedef void (*PsFuncPtr) (void *);

/* Async PRT event information struct */
typedef struct _PseventInfo
{
    PsFuncPtr entryFuncPtr;
    U16 eventID;    /* for timer & hardware events      */
    U8 flagMulti;   /* is multi-handler or not */
} PseventInfo;

typedef struct _PIntseventInfo
{
    U16 eventID;    /* for timer & hardware events      */
    PsIntFuncPtr entryIntFuncPtr;
    PsIntFuncPtr postIntFuncPtr;
} PsInteventInfo;

/* enum event table */
typedef enum {
    EVENT_TABLE_MASTER,     /* main table */
#ifdef __MMI_DUAL_SIM__
    EVENT_TABLE_SLAVE,      /* table for dual sim */
#endif
    EVENT_TABLE_END
} mmi_frm_event_table_enum;

/* static info of event table (may declared as const) */
typedef struct {
    PseventInfo *table;     /* pointer to event table */
    U16 num_of_events;      /* number of events (table size) */
} mmi_frm_event_static_info_struct;

/* runtime info of event table */
typedef struct {
    U16 max_events;     /* max. count of events used*/
    U16 used_events;    /* count of currently used events */
} mmi_frm_event_runtime_info_struct;

 

  空间申请好了，下一步就是对这块空间的利用来实现相应的需求。

3.抽象出来的共有接口:消息匹配

函数原型：

S16 mmi_frm_search_event(
            mmi_frm_event_table_enum tableType,
            U16 eventID, 
            PsFuncPtr* pFuncPtr,
            S16 startIdx, 
            MMI_BOOL doSwap,
            S16 *pNextIdx, 
            S16 *pFirstEmptyIdx, 
            MMI_BOOL *pIsMultiInTable)；

 

给定消息去协议栈中进行匹配，事件pFuncPtr非空时也要匹配消息所载事件为pFuncPtr，返回消息所处的位置index

4.设置消息所承载的动作

其实现函数原型是：

void mmi_frm_set_protocol_event_handler_int(mmi_frm_event_table_enum tableType, U16 eventID, PsFuncPtr funcPtr, MMI_BOOL isMultiHandler);

 

 isMultiHandler表示一个消息在主卡或副卡上承载多个处理动作，其他参数比较容易理解。

5.执行消息所承载的动作

 这一部分实现是在void MMI_task(oslEntryType *entry_param)中

                                ProtocolEventHandler(
                                    (U16) Message.oslMsgId,
                                    (void*)Message.oslDataPtr,
                                    (int)Message.oslSrcId,
                                    (void*)&Message);

 

其直接调用的也即是函数：

void mmi_frm_execute_current_protocol_handler(U16 eventID, void *MsgStruct, int mod_src, void *Message);

 

(如果你想得到mmi处理的对自己有用的消息，你可以在模拟器这个函数里面设置断点)

6.取消消息所承载的动作

 void mmi_frm_clear_protocol_event_handler_int(mmi_frm_event_table_enum tableType, U16 eventID, PsFuncPtr funcPtr);

 

7.清除所有消息所承载的动作

    void mmi_frm_clear_all_protocol_event_handler(void);

 作者：张素丰，转载请注明出处：http://www.cnblogs.com/zhangsufeng/archive/2010/09/17/1828545.html

这个函数的实现代码写的实在相当完美和严谨，从中可以汲取不少编程的技巧。现在开始重新思考：如果让我来实现这个功能，我又将如何来实现呢？

目前的答案是：我根本就不知道如何去实现~~~希望自己以后也能用的上这样的架构。。 

(相应代码考虑版权问题，请自行在自己的工程中查看代码，谢谢！)