当前位置：首页 > news >正文

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

news 来源：原创 2024/5/2 22:02:50

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);

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