Zigbee协议栈OSAL层API函数(译)

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

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

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

3、EVENT_MSG原型：byteosal_msg_send(bytedestination_t4sk,byte*msg_ptr)参数：destination_task:目标任务的标识msg_ptr:指向消息缓冲区的指针返冋值：ZSUCCESS消息发送成功INVALID_MSG_POINTER无效指针INVALID_TASK目标任务无效3.3osal_msg_receive()概述：任务调用这个函数來接收消息。消息处理完毕后，发送消息的任务必须调用osal_msg_deallocate()收冋缓冲区。原型：byte*osal_msg_receive(byt

4、etask_id)参数：task_id:消息发送者的任务标识返冋值：指向消息所存放的缓冲区指针，如果没有收到消息将返冋NULL。4•任务同步API4.1概述这个API使能一个任务等待一个事件的发生和返回控制而不是一直等待。在这个API屮的两数可以用来为任务设置事件，立刻通知任务有事件被设置。4.2osal_set_eent()概述:函数用來设置一个任务的事件标志原型:byteosal_set_event(bytetask_id,UINT16event_flag)参数：task_id:任务标识event_flag:2个字节，每个位特指一个事件。只有一个系

5、统事件，其他事件在接收任务中泄义。返冋值：ZSUCCESS成功设置INVALID_TASK无效任务5.定时器管理API5.1概述这个API允许内部任务(Z-SUick)以及应用层任务使用肚时器。函数提供了出动和停止肚时器的功能，沱时器最小增量为IMS。5.2osal_start_timer()概述：启动泄时器函数。当定时器到点时，thegiveneventbitwillbeseto事件将在任务中设置，要指明具体任务，调用osal_start_timerEx()原型：byteosal_starmer(UINTI6event_id,UINT16timeout

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

7、启5.3osal_stop_timer()概述：停止.正在运行的肚时器，停止外部事件调用osal_stop_timerEx()原型：byteosal_stop_timer(UINT16event_id);参数：event.id:将要结束的目标事件(该事件是出动肚时器的事件)返冋值：ZSUCCESSTimer成功停止INVALID_EVENT_ID无效事件5.4osal_stop_timerEx()概述：结束外部事件的定时器原型：byteosal_smerEx(bytetask_idfUINT16event_id);参数：略返回值ZSUCCESSTimer

8、成功停止INVALID_EVENT_ID无效事件5.2osal_GetSyste