以按键事件为例阐述消息传递机制

以按键事件为例阐述消息传递机制

这里主要想说的是按键事件发生后，app层是怎么收到消息的一些想法。

main.c:
        执行InitBoard( OB_COLD )           // OB_COLD宏定义为0
        { 
            if ( level == OB_COLD )
                {
                *(uint8 *)0x0 = 0;
                 osal_int_disable( INTS_ALL ) 
                }
        } 

这个函数执行完毕系统关禁止中断

    然后执行HalDriverInit (void)    //头文件有#define HAL_KEY TRUE
            {   
            ......          
            #if (defined HAL_KEY) && (HAL_KEY == TRUE)
             HalKeyInit();
            #endif  
            .....           
            }   

———————————————————————————————————————
hal_key.c:

    执行HalKeyInit( void )  //这是关于按键初始化的配置，比如回调函数，按键储存变量
            {
                halKeySavedKeys = 0;
                .......
                pHalKeyProcessFunction  = NULL;//回调函数为空
                HalKeyConfigured = FALSE;   //按键还没有配置
            }

执行完返回main.c

———————————————————————————————————————
顺着main函数的函数体往下执行，再次遇到

InitBoard(  OB_READY  );            // #define OB_READY 2
        {
            ......
        else  
         {
           HalKeyConfig(HAL_KEY_INTERRUPT_DISABLE, OnBoard_KeyCallback);
         }
        }

---

hal_key.c:
// #define HAL_KEY_INTERRUPT_DISABLE 0x00

    执行  HalKeyConfig ( bool  interruptEnable , halKeyCBack_t   cback ）
        {
          Hal_KeyIntEnable = interruptEnable;  //将0x00赋值给Hal_KeyIntEnable

          pHalKeyProcessFunction = cback;    
        /*回调函数赋值给 pHalKeyProcessFunction，往上查定义得到
        static  halKeyCBack_t  pHalKeyProcessFunction，再往上查得到
        typedef  void  (*halKeyCBack_t) (uint8 keys, uint8 state)； 
        说白了pHalKeyProcessFunction就是个函数指针*/

        ......
        else    
      {
       HAL_KEY_SW_6_ICTL &= ~(HAL_KEY_SW_6_ICTLBIT); /* don't generate interrupt */
       HAL_KEY_SW_6_IEN &= ~(HAL_KEY_SW_6_IENBIT);   /* Clear interrupt enable bit */

       osal_start_timerEx (Hal_TaskID, HAL_KEY_EVENT, HAL_KEY_POLLING_VALUE);        
        //       #define HAL_KEY_EVENT         0x0001 


HAL_KEY_POLLING_VALUE定义为500ms，开始计时任务，每100ms触发一次。意思就是HAL_KEY_EVENT这个事件100ms发生一次
  }
    HalKeyConfigured = TRUE;
}

——————————————————————————————————————
到此为止，按键相关的初始化都搞完了。接下来就是等第一个100ms
现在第一个100ms来了。

main.c:
    osal_start_system()
        for(;;)
    {  osal_run_system();}

________________________________________________________________________________________________

执行  osal_run_system();
    {
        osalTimeUpdate();
         Hal_ProcessPoll();
        //上面两个函数实现了计时和事件置位

        ......
        events = tasksEvents[idx];
        tasksEvents[idx] = 0;
        events = (tasksArr[idx])( idx, events );
    }

主循环里面检测到Hal_TaskID这个任务被置位（至于osal_start_timerEx是怎么让任务置位这个问题我还没弄懂，暂且当做已知…），保存在event，然后把任务清0。进入事件处理函数（这里为什么叫事件处理函数而不是叫任务处理函数呢？我想是因为一个任务可以接受处理很多个事件，这个函数只是个入口，函数体里面是会具体区分什么事件的）。
———————————————————————————————————————

hal_drivers.c
    Hal_ProcessEvent( uint8 task_id, uint16 events )
    {
        if (events & HAL_KEY_EVENT)
         {
            #if (defined HAL_KEY) && (HAL_KEY == TRUE)
                HalKeyPoll();
           if (!Hal_KeyIntEnable)
            {
              osal_start_timerEx( Hal_TaskID, HAL_KEY_EVENT, 100);
            }
           #endif // HAL_KEY

        return events ^ HAL_KEY_EVENT;
        }
  }

这里想说，osal_start_timerEx (Hal_TaskID, HAL_KEY_EVENT, HAL_KEY_POLLING_VALUE)传递给Hal_TaskID这个任务的事件是HAL_KEY_EVENT。(events & HAL_KEY_EVENT)的结果就是1，进入if判断，HalKeyPoll()获得是哪个按键按下了。然后继续osal_start_timerEx( Hal_TaskID, HAL_KEY_EVENT, 100)，为什么要这样做呢？因为在osal_run_system()里面有tasksEvents[idx] = 0 意味着这个事件被处理过了，但是谁知道什么时候有人要按键呢，所以只能不停的查询。
——————————————————————————————————————————
看到这里，好像还是没说怎么通知app层啊？仔细找找，原来在HalKeyPoll();里hal_key.c:

HalKeyPoll()
{
if (!Hal_KeyIntEnable)
  {
    if (keys == halKeySavedKeys)
    {
           return;
    }
       halKeySavedKeys = keys;
  }
  else
  {
/* Key interrupt handled here */
  }  
    if (keys && (pHalKeyProcessFunction))
  {
    (pHalKeyProcessFunction) (keys, HAL_KEY_STATE_NORMAL);
  }

创建halKeySavedKeys变量是为了下一次触发事件的时候和keys进行比较，如果相同则说明
这一次轮询没有按键，就return回去（橙色代码）。如果keys有值并且回调函数已经定义了的话就调用回调函数。
#define HAL_KEY_STATE_NORMAL 0x00
———————————————————————————————————————
Onboard.c:
回调函数前面说了是个函数指针，实际上调用：

OnBoard_KeyCallback ( uint8 keys, uint8 state )
{
    ......
    if ( OnBoard_SendKeys( keys, shift ) != ZSuccess )
    .......
}


OnBoard_SendKeys( uint8 keys, uint8 state )
{
    //在这里正式填充消息结构体（不是那种无线消息），而是“keyChange_t”，我觉得是这个层次向app层发消息的特定的结构体，是不是别的层向app层发送的话有别的结构体样式？

    if ( registeredKeysTaskID != NO_TASK_ID )  
  {
        msgPtr = (keyChange_t *)osal_msg_allocate( sizeof(keyChange_t) );
    if ( msgPtr )
    {
      msgPtr->hdr.event = KEY_CHANGE;
      msgPtr->state = state;
      msgPtr->keys = keys;

      osal_msg_send( registeredKeysTaskID, (uint8 *)msgPtr );
    }
    return ( ZSuccess );
  }

在文件开头有static uint8 registeredKeysTaskID = NO_TASK_ID;
在这个文件里有函数RegisterForKeys( uint8 task_id ) 。函数实现了registeredKeysTaskID = task_id。 那么到底谁调用了这个函数呢？全局查找之后发现在sampleapp.c里面调用了它，这里就明白了很多教程说使用按键就一定要先调用按键注册函数，因为如果不这样做的话if循环根本进不去….

define KEY_CHANGE 0xC0 这是一个事件的编号，猜想应该还有很多事件的宏定义散落在不同的文件里，但是好像记得说过事件是独热码编码的，那怎么会有0xc0这种东西，暂时保留疑问….

———————————————————————————————————————————

OSAL.c:
    osal_msg_send(destination_task, (uint8 *)msgPtr )
    {
        ......
        osal_msg_enqueue( &osal_qHead, msg_ptr );
        osal_set_event( destination_task, SYS_EVENT_MSG );
        ......
    }

// destination_task就是app层的id
//这里就正式将消息传给destination_task，也就是SampleApp_TaskID。其实我们口中说的将消息传给谁，程序中的实现是这样的：将这个消息加入消息队列（所有任务都能访问的一个队列），然后那个消息传给了哪个任务，就将那个任务事件标志位置1（main循环就能轮询到），那个任务对应的事件处理函数里面就会去取属于自己的消息（函数是不知道属于自己的消息放在哪里的，所以它一定要将整个消息队列遍历一次，这个说法在osal_msg_receive( SampleApp_TaskID )的函数体中可以证实）

————————————————————————————————————————————

OSAL.c:
osal_set_event( uint8 task_id, uint16 event_flag )
{
.......
tasksEvents[task_id] |= event_flag;
......
}

这句话牛逼啦，event_flag就是传递的参数SYS_EVENT_MSG，也就是0x8000.
task¬_id下标对应的tasksevents就变成了0x8000。为什么要这样？理由 1.统一规定一个强制的参数作为事件发生的标志，清晰明了 2.后面的事件处理函数好判断

_ ____________________________________________________________________
sampleapp.c：
现在任务已经被置位，并进入了事件处理函数

SampleApp_ProcessEvent( uint8 task_id, uint16 events )
{   
    ......
    if ( events & SYS_EVENT_MSG )  //没有上面的event_flag,这个if是进不去的。
    {
        ........
    while ( MSGpkt )
    {
      switch ( MSGpkt->hdr.event )
      {
        ......

          case KEY_CHANGE:
          SampleApp_HandleKeys( ((keyChange_t *)MSGpkt)->state, ((keyChange_t *)MSGpkt)->keys );

            break;
        }

        ......
  }
}

SYS_EVENT_MSG告诉你有事件发生了，发生的事什么事件通过（MSGpkt->hdr.event）来判断，通过switch语句跳转到不同的处理函数上。
———————————————————————————————————————
关于消息从产生到传递到处理暂时只能理解这个份上了….