ZigBee协议栈OSAL层API函数(译).doc

。这部分API函数能够为任务分配和收回消息缓冲区,发送命令消息给以外一个任务并且接收应答。()概述:当一个任务调用这个函数时,将为消息分配缓冲区,函数会将消息加入缓冲区,并调用osal_msg_send()将消息发送到另一个任务。原型:byte*osal_msg_allocate(uint16len)参数:len:消息的长度返回值:指向消息缓冲区的指针,()概述:用于收回缓冲区原型:byteosal_msg_deallocate(byte*msg_ptr)参数:Msg_ptr:指向将要收回的缓冲区的指针返回值:()概述:任务调用这个函数以实现发送指令或数据给另一个任务或处理单元。目标任务的标识必须是一个有效的系统任务,当调用osal_create_task()启动一个任务时,将会分配任务标识。osal_msg_send()也将在目标任务的事件列表中设置SYS_EVENT_MSG原型:byteosal_msg_send(bytedestination_task,byte*msg_ptr)destination_task:目标任务的标识msg_ptr:指向消息缓冲区的指针返回值:()概述:任务调用这个函数来接收消息。消息处理完毕后,发送消息的任务必须调用osal_msg_deallocate()收回缓冲区。原型:byte*osal_msg_receive(bytetask_id)参数:task_id:消息发送者的任务标识返回值:指向消息所存放的缓冲区指针,如果没有收到消息将返回NULL。。在这个API中的函数可以用来为任务设置事件,立刻通知任务有事件被设置。()概述:函数用来设置一个任务的事件标志原型:byteosal_set_event(bytetask_id,UINT16event_flag)参数:task_id:任务标识event_flag:2个字节,每个位特指一个事件。只有一个系统事件,其他事件在接收任务中定义。(Z-Stack)以及应用层任务使用定时器。函数提供了启动和停止定时器的功能,定时器最小增量为1MS。()概述:启动定时器函数。当定时器到点时,thegiveneventbitwillbeset。事件将在任务中设置,要指明具体任务,调用osal_start_timerEx()原型:byteosal_start_timer(UINT16event_id,UINT16timeout_value);参数:event_id:,事件将通知任务。timeout_value:定时值(ms)返回值:()概述:功能与osal_start_timer()相近,这个函数允许调用者为另一个任务启动定时器原型:byteosal_start_timerEx(bytetaskID,UINT16event_id,UINT16timeout_value);参数:略返回值:()概述:停止正在运行的定时器,停止外部事件调用osal_stop_timerEx()原型:byteosal_stop_timer(UINT16event_id);参数:event_id:将要结束的目标事件(该事件是启动定时器的事件)返回值:()概述:结束外部事件的定时器原型:byteosal_stop_timerEx(bytetask_id,UINT16event_id);参数:()概述: