UCOSIII 常用函数文档格式.docx

UCOSIII 常用函数文档格式.docx

《UCOSIII 常用函数文档格式.docx》由会员分享，可在线阅读，更多相关《UCOSIII 常用函数文档格式.docx（8页珍藏版）》请在冰豆网上搜索。

OSTaskStkChk（&

TaskBStkTCB,&

stk_free,&

stk_used,&

err）;

中断中使用OSIntEnter（）;

和OSIntExit（）;

是为了退出中断后执行中断调度操作，如果中断中并未用到OSSemPost（）;

等系统函数，则退出中断服务程序后不需要进行任务调度，就可以不在中断服务程序中使用OSIntEnter（）;

。

（有时候用：

CPU_CRITICAL_ENTER（）;

OSIntNestingCtr++;

CPU_CRITICAL_EXIT（）;

替代OSIntEnter（）;

一、变量类型

在cpu.h中是有关cpu变量的重新定义，还包括CPU_STK（CPU堆栈类型），

和CPU_STK_SIZE（CPU堆栈类型的大小）的定义，CPU_SR（CPU状态寄存

器的定义）。

在os.h中是有关os类型的定义如OS_TCB（任务控制块）、OS_SEM（信号量）、OS_MUTEX（互斥型信号量）、OS_MSG（消息）、OS_Q（消息队列）、OS_ERR（系统错误）等。

在cpu_core.h中是有关cpu的定义，如CPU_ERR、CPU_TS、CPU_TS_TMR等

CPU_STK：

typedefunsignedint堆栈的类型定义

OS_TCB：

structos_tcb任务控制块的类型定义

OS_ERR：

enumos_err错误信息定义

CPU_TS：

typedefunsignedint时间戳变量

CPU_TS_TMR：

typedefunsignedint定时器变量

二、全局变量

（OS_CFG_STAT_TASK_EN使能且调用了

OSStatTaskCPUUsageInit（&

则开启了统计任务

的功能：

可以统计CPU使用率等。

OSStatTaskCPUUsage：

CPU的使用率

（0—10000= 

0.00-100.00%）

OSStatTaskCPUUsageMax：

CPU的使用率最大值（0—10000= 

OSTaskCtxSwCtr：

任务切换次数的记录变量

OSStatTaskCtr：

已经建立了的任务数

三、常用函数

一、OS_CORE.C

（1）void 

OSInit（） 

//系统初始化

（2）void 

OSIntEnter（） 

//发生了一次中断（中断嵌套的逐层进入）

（3）void 

OSIntExit（） 

//退出了一次中断（中断嵌套的逐层退出）

（4）void 

OSSched（） 

//系统进行调度

（5）void 

OSSchedLock（） 

//给调度器上锁

（6）void 

OSSchedUnlock（） 

//给调度器解锁，成对使用

（7）void 

OSStart（） 

//启动多任务过程，在启动之前必须调用OSInit（），并已建立一个任务。

其中OSStartHighRdy（）必须调用OSTaskSwHook（），并令OSRunning=TRUE.

（8）void 

OS_Pend（） 

//挂起任务

（9）void 

OS_Post（） 

//解挂任务

（10）void 

OS_PendAbort（） 

//取消挂起任务

（11）INT16UOSVersion（） 

//返回uc/os的版本号*10000

（12）void 

OS_IdleTaskInit（） 

//空闲任务初始化

（13）void 

OS_IdleTask（） 

//空闲任务

二、OS_TASK.C

（1）voidOSTaskCreate（OS_TCB 

*p_tcb,//任务控制块

CPU_CHAR 

*p_name,//任务名

OS_TASK_PTRp_task,//任务函数指针

void 

*p_arg,//任务函数参数

OS_PRIO 

prio,//任务优先级

CPU_STK 

*p_stk_base,//堆栈指针

CPU_STK_SIZE 

stk_limit,//任务的堆栈剩余警戒线

stk_size,//任务的空间大小

OS_MSG_QTY 

q_size,//能接收的信息队列最大值

OS_TICK 

time_quanta,//时间片轮转时间

*p_ext,//任务控制块的扩展信息

OS_OPT 

opt,//任务的选项

OS_ERR 

*p_err）//任务的错误信息

（2）voidOSTaskChangePrio（） 

//任务优先级别的改变

（3）voidOSTaskDel（） 

//任务的删除

（4）voidOSTaskSuspend（） 

//任务的暂停

（5）voidOSTaskResume（） 

//任务的恢复

（6）voidOSTaskStkChk（） 

//校核空余内存的数量

（7）OS_MSG_QTYOSTaskQFlush（） 

//清空任务级消息队列中的消息

（8）void*OSTaskQPend（） 

//挂起任务级消息队列

（9）CPU_BOOLEANOSTaskQPendAbort（）//取消任务级消息队列的挂起状态

（10）voidOSTaskQPost（） 

//向任务级消息队列中发送消息

（11）OS_REGOSTaskRegGet（） 

//获取任务寄存器的当前值

（12）voidOSTaskRegSet（） 

//设置任务寄存器的当前值

（13）OS_SEM_CTROSTaskSemPend（） 

//任务信号量等待信号

（14）CPU_BOOLEANOSTaskSemPendAbort（）//任务信号量取消挂起状态

（15）OS_SEM_CTROSTaskSemPost（） 

//任务信号量发送消息

（16）OS_SEM_CTROSTaskSemSet（） 

//设置任务信号量的计数值

（17）voidOSTaskTimeQuantaSet（） 

//改变任务的时间片

voidTaskMain（void*pdata）;

//任务声明

static 

OS_TCB 

TaskMainTCB;

//任务控制块

#define 

TASK_MAIN_PRIO 

3 

//任务优先级

TASK_MAIN_STK_SIZE 

256 

//任务堆栈

大小256*4=1024B

CPU_STKTaskMainStk[TASK_MAIN_STK_SIZE];

//任务堆栈定义

OSTaskCreate（（OS_TCB 

*）&

TaskMainTCB, 

//任务的控制块 

（CPU_CHAR 

*）"

TaskMainStart"

//任务的名称

（OS_TASK_PTR）TaskMain 

//任务的函数指针

（void 

*）0, 

//任务的函数初值

（OS_PRIO）TASK_MAIN_PRIO 

//任务的优先级

（CPU_STK 

TaskMainStk[0] 

//任务的堆栈

（CPU_STK_SIZE）TASK_MAIN_STK_SIZE/10,

//任务堆栈剩余警戒线

（CPU_STK_SIZE）TASK_MAIN_STK_SIZE,

//任务的空间大小

（OS_MSG_QTY 

）0, 

//所能接收的信息队列最大值

（OS_TICK 

//任务的时间片轮转时间

*）0, 

//任务的任务控制块的扩展信息

（OS_OPT 

）（OS_OPT_TASK_STK_CHK|OS_OPT_TASK_STK_CLR）,//任务的选项

（OS_ERR 

//任务的错误信息

三、OS_TIME.C

（1）voidOSTimeDly（） 

//以时钟节拍数为单位延时

（2）voidOSTimeDlyHMSM（） 

//用时、分、秒、毫秒为单位延时

（3）voidOSTimeDlyResume（） 

//取消任务中的延时，引发一次调度

（4）OS_TICKOSTimeGet（） 

//获取OSTime值

（5）voidOSTimeSet（） 

//设置OSTime值

四、OS_SEM.C

（1）voidOSSemCreate（） 

//创建信号量

（2）OS_OBJ_QTYOSSemDel（） 

//删除信号量

（3）OS_SEM_CTROSSemPend（） 

//请求信号量

（4）OS_SEM_CTROSSemPost（） 

//发送（释放）信号量

OSSemSet（）