μC/OS-Ⅲ常用函数解析

  1. OSTaskCreate()函数,任务创建

void  OSTaskCreate (OS_TCB        *p_tcb,
                    CPU_CHAR      *p_name,
                    OS_TASK_PTR    p_task,
                    void          *p_arg,
                    OS_PRIO        prio,
                    CPU_STK       *p_stk_base,
                    CPU_STK_SIZE   stk_limit,
                    CPU_STK_SIZE   stk_size,
                    OS_MSG_QTY     q_size,
                    OS_TICK        time_quanta,
                    void          *p_ext,
                    OS_OPT         opt,
                    OS_ERR        *p_err)


 

1)p_tcb:指向任务控制块的指针.
2)p_name:指向任务控制块变量名字符串的指针。
3)p_task:指向任务地址.
4)p_arg:指向任务参数的指针。 每个任务允许以指针的形式传递一个参数。
5)prio:任务优先级,这个值越小,优先级越高。 这个值的范围只能是小于等于OS_
CFG PRIO MAX-2,且大于或等于1。OS_CFG_PRIO_MAX宏定义大小可以自己定义,最高优先级和最低优先级分别被中断处理任务和空闲任务占据,虽然uC/OS-III 允许多个任务共同占有同一个优先级,但是,如果任务占有最高和最低两个优先
级,则会影响中断处理任务和空闲任务的功能。 不过在中断延迟功能关闭后,中断处理任务
就不存在,这时可以使用优先级最高的任务.
6)p_stk_base:任务堆栈最低的地址,如果定义一个数组当成一块堆栈,那么数组的首
地址要传递给这个参数。每个任务都是一个线程,需要有独自的堆栈。
7)stk size:堆栈大小。不能小于宏OS_CFG_STK SIZE MIN定义的数据大小,不然
创建任务会出错。
8)stk_limit:堆栈的限制。
9)q_size:任务消息队列的容量,注意使用任务消息队列的时候不能将这个参数设置为0。
10)time_quanta:时间片大小。
11)p_ext:任务拓展。
12)opt:任务选项,主要有以下几种类型。
 OSOPT_TASK_NONE:没有任何设置。

 OS_OPT_TASK_STK_CHK:如果参数包含这个选项,表示后面可以进行堆栈检测。

 OS_OPT_TASK_STK_CLR:堆栈全部进行清0操作。

 OS_OPT_TASK_SAVE_FP:任务是否保存浮点寄存器。

13)p_err:指向返回错误类型的指针,主要有以下几种类型(只包含部分) OS ERR NONE:没有错误。

 OS_ERR_NAME:参数p_name是空指针。

 OS_ERR_PRIO_INVALID:优先级设置错误详见前面参数prio的设置说明。

 OS_ERR_STK_INVALID:堆栈不可用,参数p_stk_base是空指针。

 OS_ERR_STK_SIZE_INVALID:堆栈大小设置不可用,stksize为0。

 OS_ERR_STK_LIMIT_INVALID:堆栈限制大小大于或等于堆栈设置大小

 OS_ERR_TASK_CREATE_ISR:企图在中断中创建任务。

 OS_ERR_TASK_INVALID:参数task是空指针。 

 OS_ERR_TCB_INVALID:参数p_tcb是空指针。

//声明一个任务

OS_TCB Task2_TaskTCB;
//错误返回标志

OS_ERR err;

void  OSTaskDel (OS_TCB  *p_tcb,
                 OS_ERR  *p_err)
//删除任务

void   OSTaskSuspend (OS_TCB  *p_tcb,
                      OS_ERR  *p_err)
//挂起任务

void  OSTaskResume (OS_TCB  *p_tcb,
                    OS_ERR  *p_err)
//恢复挂起任务

//函数使用,例:

OSTaskSuspend((OS_TCB*)&Task2_TaskTCB,&err);

/*挂起任务OS_TCB Task2_TaskTCB*/
发布了50 篇原创文章 · 获赞 3 · 访问量 1万+

猜你喜欢

转载自blog.csdn.net/weixin_41865104/article/details/103752075
今日推荐