ZStack OSAL中文说明.docVIP

概述 OSAL (Operating System Abstraction Layer)，翻译为“操作系统抽象层”。 　　在基于ZigBee协议的应用开发中，应用程序框架中包含了最多240个应用程序对象。如果我们把一个应用程序对象看做为一个任务的话，那么应用程序框架将包含一个支持多任务的资源分配机制。于是OSAL便有了存在的必要性，它正是Z-Stack为了实现这样一个机制而存在的。 　　OSAL就是以实现多任务为核心的系统资源管理机制。所以OSAL与标准的操作系统还是有很大的区别的。简单而言，OSAL实现了类似操作系统的某些功能，但并不能称之为真正意义上的操作系统。 2．OSAL的API接口 函数名称 功能描述 void osal_nv_init() 初始化FLASH存储器 uint8 osal_init_system() 初始化操作系统 void osal_mem_init() 初始化内存分配系统2.1 消息管理功能 1）uint8 * osal_msg_allocate( uint16 len )：申请一个指定长度的消息区，该函数调用void *osal_mem_alloc( uint16 size )函数实现，从堆中申请存储空间。 （2）uint8 osal_msg_deallocate( uint8 *msg_ptr )：接收到消息的任务处理完成后释放消息的空间。 （3）uint8 osal_msg_send( uint8 destination_task, uint8 *msg_ptr )：发送消息到指定任务，将消息放入队列，并把任务的相应事件标志置位。 （4）uint8 *osal_msg_receive( uint8 task_id )：接收发送到某个消息的任务，在任务处理完消息后，必修释放消息的存储空间。该函数查找消息队列，如果消息队列中有多个发送给该任务的消息，保持事件标志位。 （5）osal_event_hdr_t *osal_msg_find(uint8 task_id, uint8 event)：寻找发送给具有某个事件的任务的消息。 任务同步功能 （）uint8 osal_set_event(uint8 task_id, uint16 event_flag )：设置某个任务的某个事件标志。event_flag为16位，只有一个系统事件SYS_EVENT_MSG，其余的事件都是用户定义的事件。 时间管理功能 时间管理的API既可以被Z-stack协议栈中的任务使用，也可以被应用级任务使用。粒度为1ms。 （1）uint8 osal_start_timerEx( uint8 taskID, uint16 event_id, uint16 timeout_value)：为某个任务设置一个定时器，taskID为任务ID，event_id为用户指定的事件标志位，timeout_value为超时时间，以ms为单位。 uint8 osal_start_reload_timer( uint8 taskID, uint16 event_id, uint16 timeout_value )：设置定时器，与上一个函数不同的是该函数设置的定时器超时后被重新装载。 （3）uint8 osal_stop_timerEx( uint8 task_id, uint16 event_id )：停止一个已经开始的定时器。 （4）uint32 osal_GetSystemClock( void )：获取系统时间，返回值以ms为单位。 中断管理功能 （1）uint8 osal_int_enable( uint8 interrupt_id ) ：使能某个中断 （2）uint8 osal_int_disable( uint8 interrupt_id ) ：禁止某个中断 任务管理功能 const pTaskEventHandlerFn tasksArr[] = { macEventLoop, nwk_event_loop, Hal_ProcessEvent, MT_ProcessEvent, APS_event_loop, APSF_ProcessEvent, ZDApp_event_loop, ZDNwkMgr_event_loop, GenericApp_ProcessEvent }; const uint8 tasksCnt = sizeof( tasksArr ) / sizeof( tasksArr[0] ); 数组tasksArr定义了各个任务的事件回调函数，如果有用户自己定义的任务，必须将其事件回调函数加入到该数组中。 void osalInitTasks(