Zigbee协议栈OSAL层API函数(译)OSAL API F8W-2003-0002.doc

Zigbee协议栈OSAL层API函数(译)OSAL_API_F8W-2003-0002。这部分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:用户定义