zigbee协议栈osal层api函数(译).doc

文档介绍：Zigbee 协议栈 OSAL 层 API 函数(译) 3. 信息管理 API 概述这部分 API 提供了任务或处理单元与不同的处理环境之间的数据交换。这部分 API 函数能够为任务分配和收回消息缓冲区,发送命令消息给以外一个任务并且接收应答。 osal_msg_allocate () 概述: 当一个任务调用这个函数时,将为消息分配缓冲区,函数会将消息加入缓冲区,并调用 osal_msg_send() 将消息发送到另一个任务。原型: byte *osal_msg_allocate( uint16 len ) 参数: len :消息的长度返回值: 指向消息缓冲区的指针,当分配失败时返回 NULL osal_msg_deallocate( ) 概述: 用于收回缓冲区原型: byte osal_msg_deallocate( byte *msg_ptr ) 参数: Msg_ptr : 指向将要收回的缓冲区的指针返回值: RETURN VALUE DESCRIPTION ESS 回收成功 INVALID_MSG_POINTER 错误的指针 MSG_BUFFER_NOT_AVAIL 缓冲区在队列中 osal_msg_send( ) 概述: 任务调用这个函数以实现发送指令或数据给另一个任务或处理单元。目标任务的标识必须是一个有效的系统任务,当调用 osal_create_task () 启动一个任务时,将会分配任务标识。 osal_msg_send() 也将在目标任务的事件列表中设置 SYS_EVENT_MSG 原型: byte osal_msg_send( byte destination_task, byte *msg_ptr ) 参数: destination_task :目标任务的标识 msg_ptr : 指向消息缓冲区的指针返回值: ESS 消息发送成功 INVALID_MSG_POINTER 无效指针 INVALID_TASK 目标任务无效 osal_msg_receive( ) 概述: 任务调用这个函数来接收消息。消息处理完毕后,发送消息的任务必须调用 osal_msg_deallocate() 收回缓冲区。原型: byte *osal_msg_receive( byte task_id ) 参数: task_id :消息发送者的任务标识返回值: 指向消息所存放的缓冲区指针,如果没有收到消息将返回 NULL 。 4. 任务同步 API 概述这个 API 使能一个任务等待一个事件的发生和返回控制而不是一直等待。在这个 API 中的函数可以用来为任务设置事件,立刻通知任务有事件被设置。 osal_set_event( ) 概述: 函数用来设置一个任务的事件标志原型: byte osal_set_event( byte task_id, UINT16 event_flag ) 参数: task_id :任务标识 event_flag :2个字节,每个位特指一个事件。只有一个系统事件,其他事件在接收任务中定义。返回值: ESS 成功设置 INVALID_TASK 无效任务 5. 定时器管理API 5. 1概述这个API允许内部任务( Z-Stack )以及应用层任务使用定时器。函数提供了启动和停止定时