zigbee协议栈中osal_start_timerEx()函数的使用方法

osal_start_timerEx是一个用来设置定时器，使某任务能够定时运行的函数。但是想要了解这个函数，需要层层上推，了解到更深层次，才能够明白它工作的原理。

首先了解一下osal_start_timerEx函数的原型：

uint8 osal_start_timerEx( uint8 taskID, uint16 event_id, uint16 timeout_value )
{
  halIntState_t intState;
  osalTimerRec_t *newTimer;

  HAL_ENTER_CRITICAL_SECTION( intState );  

  newTimer = osalAddTimer( taskID, event_id, timeout_value );   //添加新定时器

  HAL_EXIT_CRITICAL_SECTION( intState );   

  return ( (newTimer != NULL) ? SUCCESS : NO_TIMER_AVAIL );
}

 

 

其中，参数的含义是：

taskID：要设定定时器的任务ID号；

event_id：事件的类型（我的理解是要设定定时器的事件是个什么类型的事件）；

timeout_value：定时时间，即发送周期信息的时间周期。

 

函数里需要注意的是osalAddTimer函数，这个函数的功能就是添加一个新定时器。但是新的定时器添加到哪里了呢？我们先来了解一下定时器的数据结构：

typedef struct

{

  void   *next;

  uint16 timeout;  

  uint16 event_flag;

  uint8  task_id;

  uint16 reloadTimeout;

} osalTimerRec_t;

数据结构中包括timeout、event_flag、task_id和reloadTimeout，除此之外，还有一个next指针。了解数据结构的话都知道，这项的存在说明这个结构体能够组成一个链表，因此实际上是存在一个由定时器结构体组成的链表，这个链表叫做软件定时器数据链表。

因此osalAddTimer函数就是在这个链表中新增添了一个定时器节点，那么这个链表是由哪个函数来管理的呢？是由osalTimerUpdate函数管理的。由osalTimerUpdate以ms为单位对这些“软定时器”减计数，当定时器溢出，即调用osal_set_event函数。Osal_set_event是专门用来设置tasksEvents，而tasksEvents数组存放了一个任务是否该被运行的序列（tasksEvents不清楚的话似乎应该先从头学起）。

所以总结起来是这样子的：osal_start_timerEx通过osalAddTimer向链表中添加定时器，由osalTimerUpdate来减计数，当这个定时器溢出后，则会对taskID对应的task设置一个event_id，从而让这个任务在后面的主循环中运行到。能够在主循环中运行到的原因是会调用osal_set_event函数来实现主循环里对此项任务的调用。

举例：

osal_start_timerEx( SampleApp_TaskID,

SAMPLEAPP_SEND_PERIODIC_MSG_EVT,

SAMPLEAPP_SEND_PERIODIC_MSG_TIMEOUT + (osal_rand() & 0x00FF) );

SampleApp_TaskID：任务优先级ID，在任务初始化函数SampleApp_Init()中被初始化，ID号是由协议栈的操作系统OSAL分配；

SAMPLEAPP_SEND_PERIODIC_MSG_EVT：发送周期信息事件；

SAMPLEAPP_SEND_PERIODIC_MSG_TIMEOUT：定时时间，在自己的应用文件夹App中定义。

（如：#define SAMPLEAPP_SEND_PERIODIC_MSG_TIMEOUT   3000      //每隔3秒）

 

当网络组建成功后，每隔SAMPLEAPP_SEND_PERIODIC_MSG_TIMEOUT + (osal_rand() & 0x00FF)，即3秒的时间就会去执行SAMPLEAPP_SEND_PERIODIC_MSG_EVT触发的函数。