Zigbee协议栈OSAL层API函数.pdf

《Zigbee协议栈OSAL层API函数.pdf》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、3.信息管理API3.1概述这部分API提供了任务或处理单元与不同的处理环境之间的数据交换。这部分API函数能够为任务分配和收回消息缓冲区，发送命令消息给以外一个任务并且接收应答。3.2osal_msg_allocate()概述：当一个任务调用这个函数时，将为消息分配缓冲区，函数会将消息加入缓冲区，并调用osal_msg_send()将消息发送到另一个任务。原型：byte*osal_msg_allocate(uint16len)参数：len：消息的长度返回值：指向消息缓冲区的指针，当分配失败时返回NULL3.3osal_msg_deallocate

2、()概述：用于收回缓冲区原型：byteosal_msg_deallocate(byte*msg_ptr)参数：Msg_ptr:指向将要收回的缓冲区的指针返回值：RETURNVALUEDESCRIPTIONZSUCCESS回收成功INVALID_MSG_POINTER错误的指针MSG_BUFFER_NOT_AVAIL缓冲区在队列中3.4osal_msg_send()概述：任务调用这个函数以实现发送指令或数据给另一个任务或处理单元。目标任务的标识必须是一个有效的系统任务，当调用osal_create_task()启动一个任务时，将会分配任务标识。osa

3、l_msg_send()也将在目标任务的事件列表中设置SYS_EVENT_MSG原型：byteosal_msg_send(bytedestination_task,byte*msg_ptr)参数：destination_task：目标任务的标识msg_ptr：指向消息缓冲区的指针返回值：ZSUCCESS消息发送成功INVALID_MSG_POINTER无效指针INVALID_TASK目标任务无效3.5osal_msg_receive()概述：任务调用这个函数来接收消息。消息处理完毕后，发送消息的任务必须调用osal_msg_deallocate()

4、收回缓冲区。原型：byte*osal_msg_receive(bytetask_id)参数：task_id：消息发送者的任务标识返回值：指向消息所存放的缓冲区指针，如果没有收到消息将返回NULL。4.任务同步API4.1概述这个API使能一个任务等待一个事件的发生和返回控制而不是一直等待。在这个API中的函数可以用来为任务设置事件，立刻通知任务有事件被设置。4.2osal_set_event()概述：函数用来设置一个任务的事件标志原型：byteosal_set_event(bytetask_id,UINT16event_flag)参数：task_i

5、d：任务标识event_flag：２个字节，每个位特指一个事件。只有一个系统事件，其他事件在接收任务中定义。返回值：ZSUCCESS成功设置INVALID_TASK无效任务５.定时器管理ＡＰＩ５.１概述这个ＡＰＩ允许内部任务（Z-Stack）以及应用层任务使用定时器。函数提供了启动和停止定时器的功能，定时器最小增量为1MS。5.2osal_start_timer()概述：启动定时器函数。当定时器到点时，thegiveneventbitwillbeset。事件将在任务中设置，要指明具体任务，调用osal_start_timerEx()原型:byteo

6、sal_start_timer(UINT16event_id,UINT16timeout_value);参数：event_id:用户定义的eventbit.当定时器到点时，事件将通知任务。timeout_value：定时值（ms）返回值：ZSUCCESSTimer成功开启NO_TIMER_AVAILABLE无法开启5.3osal_start_timerEx()概述：功能与osal_start_timer()相近，这个函数允许调用者为另一个任务启动定时器原型：byteosal_start_timerEx(bytetaskID,UINT16event_

7、id,UINT16timeout_value);参数：略返回值：ZSUCCESSTimer成功开启NO_TIMER_AVAILABLE无法开启5.4osal_stop_timer()概述：停止正在运行的定时器，停止外部事件调用osal_stop_timerEx()原型：byteosal_stop_timer(UINT16event_id);参数：event_id：将要结束的目标事件（该事件是启动定时器的事件）返回值：ZSUCCESSTimer成功停止INVALID_EVENT_ID无效事件5.5osal_stop_timerEx()概述：结束外部事

8、件的定时器原型：byteosal_stop_timerEx(bytetask_id,UINT16event_id);参数：