raw_osAPI使用手冊.doc

文档作者：常鹏飞 函数 raw_enter_interrupt() 在raw_system.c文件中 参数 无 功能 此函数在进入中断一开始的时候调用 说明 调用此函数的时候必须处于关中断关状（响应中断的，最开始进入中断时硬件保证是关中断状态）因为其函数体中没有 RAW_SR_ALLOC（）； RAW_CRITICAL_ENTER（）； … RAW_CRITICAL_EXIT（）； 函数 raw_finish_int() 在raw_system.c文件中 参数 无 功能 当中断退出的时候调用 说明 在抢占模式下，在最外层中断退出时可能引发任务切换 函数 raw_time_tick() 在raw_system.c文件中 参数 无 功能 在时钟中断处理函数中调用 说明 在时钟中断处理函数中调用 函数 raw_system_time_get() 在raw_system.c文件中 参数 无 功能 返回系统的已经运行时钟数 说明 系统运行时钟数在达到0xffffffff后会翻头到0 函数 RAW_U32 raw_system_time_set(RAW_U32 time) 在raw_system.c文件中 参数 RAW_U32 time 功能 设置系统运行时钟数 说明 函数 RAW_U16 raw_os_init() 在raw_sched.c文件中 参数 无 功能 raw_os初始化时调用，成功返回RAW_SUCCESS 说明 函数 RAW_U16 raw_os_start() 在raw_sched.c文件中 参数 无 功能 raw_os正式启动运行 说明 理论上讲这个函数永远不会返回，若返回说明出错，返回RAW_SYSTEM_ERROR 函数 raw_task_create 在raw_task.c文件中 参数 RAW_TASK_OBJ *task_obj 指向要创建任务的RAW_TASK_OBJ的指针 RAW_U8 *task_name 任务的名字 RAW_VOID *task_arg 传给任务的参数 RAW_U8 task_prio 任务的优先级，数越小优先级越大 RAW_U16 time_slice 分配给任务的时间片，用于时间片调度，指定意味用默认值 PORT_STACK *task_stack_base 堆栈的起始地址 RAW_U32 stack_size 堆栈的大小 RAW_TASK_ENTRY task_entry 任务的入口 RAW_U8 auto_start 标记是否立即运行？？？ RAW_AUTO_START 1 （task_state会置为RAW_RDY状态，将该任务加入就绪队列，最后进行调度检查） RAW_DONT_START 0 （task_state会置为RAW_SUSPENDED状态） 功能 创建一个任务，如果创建这个任务有更高的优先级，那么它会立即得到运行 返回值 RAW_IDLE_EXIT 空闲任务的优先级独占，不允许其它任务再使用这个优先级 RAW_OS_STOPPED raw_os还没有开始运行 RAW_SUCCESS 成功创建任务 RAW_NULL_OBJECT RAW_TASK_OBJ类型指针为空 RAW_BYOND_MAX_PRIORITY 优先级溢出 RAW_NULL_POINTER 空指针（task_stack_base、task_entry为空时） 函数 raw_task_stack_check 在raw_task.c中 参数 RAW_TASK_OBJ *task_obj 指向要检查堆栈任务的RAW_TASK_OBJ的指针 RAW_U32 *free_stack 指向的变量用于保存剩余堆栈元素数（注，不是字节数） 功能 检测指定任务剩余堆栈元素数 说明 此函数需在RAW_SYSTEM_CHECK宏开关打开情况下，才能使用 返回值 RAW_NULL_OBJECT 当task_obj为空指针时 RAW_NULL_POINTER 当free_stack为空指针时 RAW_SUCCESS 调用成功返回 函数 raw_disable