OSTaskCreate 和 OSTaskCreateExt 函数
|
- UID
- 1029342
- 性别
- 男
|
OSTaskCreate 和 OSTaskCreateExt 函数
- //建立一个新任务
- #if OS_TASK_CREATE_EN > 0 //允许生成OSTaskCreate()函数
- INT8U OSTaskCreate (void (*task)(void *pd), void *pdata, OS_STK *ptos, INT8U prio)
- {
- #if OS_CRITICAL_METHOD == 3 //中断函数被设定为模式3
- OS_CPU_SR cpu_sr;
- #endif
- OS_STK *psp; //初始化任务堆栈指针变量,返回新的栈顶指针
- INT8U err; //定义(获得并定义初始化任务控制块)是否成功
- #if OS_ARG_CHK_EN > 0 //所有参数必须在指定的参数内
- if (prio > OS_LOWEST_PRIO) { //检查任务优先级是否合法
- return (OS_PRIO_INVALID); //参数指定的优先级大于OS_LOWEST_PRIO
- }
- #endif
- OS_ENTER_CRITICAL(); //关闭中断
- if (OSTCBPrioTbl[prio] == (OS_TCB *)0) { //确认优先级未被使用,即就绪态为0
- OSTCBPrioTbl[prio] = (OS_TCB *)1; //保留这个优先级,将就绪态设为1
- OS_EXIT_CRITICAL(); //打开中断
- psp = (OS_STK *)OSTaskStkInit(task, pdata, ptos, 0); //初始化任务堆栈
- err = OS_TCBInit(prio, psp, (OS_STK *)0, 0, 0, (void *)0, 0); //获得并初始化任务控制块
- if (err == OS_NO_ERR) { //任务控制初始化成功
- OS_ENTER_CRITICAL(); //关闭中断
- OSTaskCtr++; //任务计数器加1
- OS_EXIT_CRITICAL(); //打开中断
- if (OSRunning == TRUE) { //检查是否有(某个)任务在运行
- OS_Sched(); //任务调度,最高任务优先级运行
- }
- } else { //否则,任务初始化失败
- OS_ENTER_CRITICAL(); //关闭中断
- OSTCBPrioTbl[prio] = (OS_TCB *)0; //放弃任务,设此任务就绪态为0
- OS_EXIT_CRITICAL(); //打开中断
- }
- return (err); //返回(获得并定义初始化任务控制块是否成功)
- }
- OS_EXIT_CRITICAL(); //打开中断
- return (OS_PRIO_EXIST); //返回(具有该优先级的任务已经存在)
- }
- #endif
- //建立一个新任务。与OSTaskCreate()不同的是,OSTaskCreateExt()允许用户设置更多的细节
- //内容。任务的建立可以在多任务环境启动之前,也可以在正在运行的任务中建立,但中断处理
- //程序中不能建立新任务。一个任务必须为无限循环结构,且不能有返回点。
- #if OS_TASK_CREATE_EXT_EN > 0 //允许生成OSTaskCreateExt()函数
- INT8U OSTaskCreateExt (void (*task)(void *pd), //建立扩展任务(任务代码指针)
- void *pdata, //传递参数指针
- OS_STK *ptos, //分配任务堆栈栈顶指针
- INT8U prio, //分配任务优先级
- INT16U id, //(未来的)优先级标识(与优先级相同)
- OS_STK *pbos, //分配任务堆栈栈底指针
- INT32U stk_size, //指定堆栈的容量(检验用)
- void *pext, //指向用户附加的数据域的指针
- INT16U opt) //建立任务设定选项
- {
- #if OS_CRITICAL_METHOD == 3 //中断函数被设定为模式3
- OS_CPU_SR cpu_sr;
- #endif
- OS_STK *psp; //初始化任务堆栈指针变量,返回新的栈顶指针
- INT8U err; //定义(获得定义初始化任务控制块)是否成功
- #if OS_ARG_CHK_EN > 0 //所有参数必须在指定的参数内
- if (prio > OS_LOWEST_PRIO) { //检查任务优先级是否合法
- return (OS_PRIO_INVALID); //参数指定的优先级大于OS_LOWEST_PRIO
- }
- #endif
- OS_ENTER_CRITICAL(); //关闭中断
- if (OSTCBPrioTbl[prio] == (OS_TCB *)0) { //确认优先级未被使用,即就绪态为0
- OSTCBPrioTbl[prio] = (OS_TCB *)1; //保留这个优先级,将就绪态设为0
- OS_EXIT_CRITICAL(); //打开中断
- //以下两为1堆栈才能清0
- if (((opt & OS_TASK_OPT_STK_CHK) != 0x0000) || //检验任务堆栈,CHK=1
- ((opt & OS_TASK_OPT_STK_CLR) != 0x0000)) { //任务建立时是否清0,CLR=1
- #if OS_STK_GROWTH == 1 //堆栈生长方向
- (void)memset(pbos, 0, stk_size * sizeof(OS_STK)); //从下向上递增
- #else
- (void)memset(ptos, 0, stk_size * sizeof(OS_STK)); //从下向下递减
- #endif
- }
- psp = (OS_STK *)OSTaskStkInit(task, pdata, ptos, opt); //初始化任务堆栈
- err = OS_TCBInit(prio, psp, pbos, id, stk_size, pext, opt); //获得并初始化任务控制块
- if (err == OS_NO_ERR) { //任务控制初始化成功
- OS_ENTER_CRITICAL(); //关闭中断
- OSTaskCtr++; //任务计数器加1
- OS_EXIT_CRITICAL(); //打开中断
- if (OSRunning == TRUE) { //检查是否有(某个)任务在运行
- OS_Sched(); //任务调度,最高任务优先级运行
- }
- } else { //否则,任务初始化失败
- OS_ENTER_CRITICAL(); //关闭中断
- OSTCBPrioTbl[prio] = (OS_TCB *)0; //放弃任务,设此任务就绪态为0
- OS_EXIT_CRITICAL(); //打开中断
- }
- return (err); //返回(获得并定义初始化任务控制块是否成功)
- }
- OS_EXIT_CRITICAL(); //打开中断
- return (OS_PRIO_EXIST); //具有该优先级的任务已经存在
- }
- #endif
|
|
|
|
|
|
