標題: UC/OS—III常用資料整理 [打印本頁]
作者: liuda 時間: 2015-1-23 02:01
標題: UC/OS—III常用資料整理
任務堆棧：存儲任務中的調(diào)用的函數(shù)、局部變量、中斷服務程序和CPU寄存器的值。
全局變量的保護：
1.如果只在一個任務中寫（或只有一個數(shù)據(jù)），而在其他任務中只是讀取，則可以不用互斥型信號量，最多會造成讀取的數(shù)據(jù)未被完全寫完。
2.如果全局變量在多個任務中寫，則需要用互斥型信號量保護，這樣當有任務申請到互斥型信號量（保護不可重入的程序段）寫數(shù)據(jù)時，其他任務的同一個互斥型信號量必須等待上一個任務的釋放才可進行寫。
3.如果全局變量在中斷中寫，則在其他任務中的全局變量的寫操作要用臨界段（禁止中斷和禁止調(diào)度:保護不可被分割的程序段）保護。（因為如果不關(guān)中斷相當于中斷的優(yōu)先級最高，而且不能被像其他任務那樣掛起。）
OS_CFG_ISR_POST_DEFERRED_EN為1臨界段使用鎖調(diào)度器方式；
為0臨界段使用禁中斷方式（CPU_SR_ALLOC();
OS_CRITICAL_ENTER();OS_CRITICAL_EXIT();
OS_CRITICAL_EXIT_NO_SCHED();
OSSchedLockNestingCtr記錄調(diào)度器被鎖的次數(shù)）。
檢測任務堆棧的使用情況：
OS_CFG_STAT_TASK_STK_CHK_EN使能
OS_ERRerr;
CPU_STK_SIZE stk_free;
CPU_STK_SIZE stk_used;
OSTaskStkChk(&TaskBStkTCB,&stk_free,&stk_used,&err);
中斷中使用OSIntEnter(); 和OSIntExit();是為了退出中斷后執(zhí)行中斷調(diào)度操作，如果中斷中并未用到OSSemPost();等系統(tǒng)函數(shù)，則退出中斷服務程序后不需要進行任務調(diào)度，就可以不在中斷服務程序中使用OSIntEnter(); 和OSIntExit();。
（有時候用：CPU_CRITICAL_ENTER();OSIntNestingCtr++;
CPU_CRITICAL_EXIT();替代OSIntEnter();）
一、 變量類型
在cpu.h中是有關(guān)cpu變量的重新定義，還包括CPU_STK（CPU堆棧類型），
和CPU_STK_SIZE（CPU堆棧類型的大小）的定義，CPU_SR（CPU狀態(tài)寄存
器的定義）。
在os.h中是有關(guān)os類型的定義如OS_TCB（任務控制塊）、OS_SEM（信號量）、OS_MUTEX（互斥型信號量）、OS_MSG（消息）、OS_Q（消息隊列）、OS_ERR（系統(tǒng)錯誤）等。
在cpu_core.h中是有關(guān)cpu的定義，如CPU_ERR、CPU_TS、CPU_TS_TMR等。
CPU_STK：typedef unsigned int堆棧的類型定義
OS_TCB：struct os_tcb任務控制塊的類型定義
OS_ERR：enum os_err錯誤信息定義
CPU_TS：typedef unsigned int時間戳變量
CPU_TS_TMR：typedef unsigned int定時器變量
二、 全局變量
（OS_CFG_STAT_TASK_EN使能且調(diào)用了OSStatTaskCPUUsageInit(&err);
則開啟了統(tǒng)計任務的功能：可以統(tǒng)計CPU使用率等。）
OSStatTaskCPUUsage：CPU的使用率（0—10000= 0.00-100.00%）
OSStatTaskCPUUsageMax：CPU的使用率最大值（0—10000= 0.00-100.00%）
OSTaskCtxSwCtr：任務切換次數(shù)的記錄變量
OSStatTaskCtr：已經(jīng)建立了的任務數(shù)
三、常用函數(shù)
一、OS_CORE.C
（1）void OSInit() //系統(tǒng)初始化
（2）void OSIntEnter() //發(fā)生了一次中斷（中斷嵌套的逐層進入）
（3）void OSIntExit() //退出了一次中斷（中斷嵌套的逐層退出）
（4）void OSSched() //系統(tǒng)進行調(diào)度
（5）void OSSchedLock() //給調(diào)度器上鎖
（6）void OSSchedUnlock() //給調(diào)度器解鎖，成對使用
（7）void OSStart() //啟動多任務過程，在啟動之前必須調(diào)用OSInit()，并已建立一個任務。其中OSStartHighRdy()必須調(diào)用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）void OSTaskCreate(OS_TCB *p_tcb,//任務控制塊
CPU_CHAR *p_name,//任務名
OS_TASK_PTR p_task,//任務函數(shù)指針
void *p_arg,//任務函數(shù)參數(shù)
OS_PRIO prio,//任務優(yōu)先級
CPU_STK *p_stk_base,//堆棧指針
CPU_STK_SIZE stk_limit,//任務的堆棧剩余警戒線
CPU_STK_SIZE stk_size,//任務的空間大小
OS_MSG_QTY q_size, //能接收的信息隊列最大值
OS_TICK time_quanta,//時間片輪轉(zhuǎn)時間
void *p_ext,// 任務控制塊的擴展信息
OS_OPT opt, //任務的選項
OS_ERR *p_err) //任務的錯誤信息
（2）void OSTaskChangePrio() //任務優(yōu)先級別的改變
（3）void OSTaskDel() //任務的刪除
（4）void OSTaskSuspend() //任務的暫停
（5）void OSTaskResume() //任務的恢復
（6）void OSTaskStkChk() //校核空余內(nèi)存的數(shù)量
（7）OS_MSG_QTY OSTaskQFlush() //清空任務級消息隊列中的消息
（8）void *OSTaskQPend() //掛起任務級消息隊列
（9）CPU_BOOLEAN OSTaskQPendAbort()//取消任務級消息隊列的掛起狀態(tài)
（10）void OSTaskQPost() //向任務級消息隊列中發(fā)送消息
（11）OS_REG OSTaskRegGet() //獲取任務寄存器的當前值
（12）void OSTaskRegSet() //設(shè)置任務寄存器的當前值
（13）OS_SEM_CTR OSTaskSemPend() //任務信號量等待信號
（14）CPU_BOOLEAN OSTaskSemPendAbort()//任務信號量取消掛起狀態(tài)
（15）OS_SEM_CTR OSTaskSemPost() //任務信號量發(fā)送消息
（16）OS_SEM_CTR OSTaskSemSet() //設(shè)置任務信號量的計數(shù)值
（17）void OSTaskTimeQuantaSet() //改變?nèi)蝿盏臅r間片
voidTaskMain(void *pdata); //任務聲明
static OS_TCB TaskMainTCB; //任務控制塊
#define TASK_MAIN_PRIO 3 //任務優(yōu)先級
#define TASK_MAIN_STK_SIZE 256 //任務堆棧大小256*4=1024B
static CPU_STK TaskMainStk[TASK_MAIN_STK_SIZE];//任務堆棧定義
OSTaskCreate((OS_TCB *)&TaskMainTCB, //任務的控制塊
(CPU_CHAR *)"Task Main Start", //任務的名稱
(OS_TASK_PTR )TaskMain, //任務的函數(shù)指針
(void *)0, //任務的函數(shù)初值
(OS_PRIO )TASK_MAIN_PRIO, //任務的優(yōu)先級
(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, //任務的時間片輪轉(zhuǎn)時間
(void *)0, //任務的任務控制塊的擴展信息
(OS_OPT )(OS_OPT_TASK_STK_CHK| OS_OPT_TASK_STK_CLR), //任務的選項
(OS_ERR *)&err); //任務的錯誤信息
三、OS_TIME.C
（1）void OSTimeDly() //以時鐘節(jié)拍數(shù)為單位延時
（2）void OSTimeDlyHMSM() //用時、分、秒、毫秒為單位延時
（3）void OSTimeDlyResume() //取消任務中的延時，引發(fā)一次調(diào)度
（4）OS_TICKOSTimeGet() //獲取OSTime 值
（5）void OSTimeSet() //設(shè)置 OSTime 值
四、OS_SEM.C
（1）void OSSemCreate() //創(chuàng)建信號量
（2）OS_OBJ_QTY OSSemDel() //刪除信號量
（3）OS_SEM_CTR OSSemPend() //請求信號量
（4）OS_SEM_CTR OSSemPost() //發(fā)送（釋放）信號量
（5）void OSSemSet() //設(shè)置信號量的計數(shù)值
（6）OS_OBJ_QTYOSSemPendAbort() //取消信號量
static OS_SEM AppSem; //定義一個信號量變量
CPU_TS ts=0;//存放發(fā)送消息時的時間戳OS_TS_GET();(獲取當前時間戳)
OS_ERR err; //返回的錯誤信息
OSSemCreate(&AppSem,"Test Sem", 0, &err);//要在使用之前創(chuàng)建（如果在兩個任務中都用到，則最好在兩個任務創(chuàng)建前建立，也可在優(yōu)先級高的任務中建立）
OSSemPend(&AppSem,0,OS_OPT_PEND_BLOCKING,&ts,&err);//等待信號量（ts為發(fā)送信號量的時間戳）
OSSemPost(&AppSem, OS_OPT_POST_1,&err);//發(fā)送信號量
五、OS_FLAG.C
（1）void OSFlagCreate() //信號標志組的創(chuàng)建函數(shù)
（2）OS_OBJ_QTY OSFlagDel() //刪除信號標志組
（3）OS_FLAGS OSFlagPend() //掛起信號標志組
（4）OS_FLAGS OSFlagPost() //向信號標志組發(fā)送信號
（5）OS_OBJ_QTYOSFlagPendAbort() //取消掛起信號標志組
staticOS_FLAG_GRP AppFlag; //定義一個信號標志組變量
CPU_TSts=0; //存放發(fā)送消息時的時間戳OS_TS_GET();(獲取當前時間戳)
OS_ERRerr; //返回的錯誤信息
OSFlagCreate(&AppFlag,"TestFlag",0x00,&err);//創(chuàng)建信號標志組且設(shè)置初值為0x00
OSFlagPend(&AppFlag,0x03,0,OS_OPT_PEND_FLAG_SET_ALL,&ts,&err);
//等待信號標志組的bit0和bit1都為1
OSFlagPost(&AppFlag,0x01,OS_OPT_POST_FLAG_SET,&err);
//把信號標志組的bit0設(shè)置為1
六、OS_MUTEX.C
（1）void OSMutexCreate() //創(chuàng)建互斥型信號量
（2）OS_OBJ_QTY OSMutexDel() //刪除互斥型信號量
（3）void OSMutexPend() //請求互斥型信號量
（4）void OSMutexPost() //發(fā)送（釋放）互斥型信號量
（5）OS_OBJ_QTYOSMutexPendAbort() //取消互斥型信號量
static OS_MUTEX AppMutex; //定義一個互斥型信號量變量
CPU_TS ts=0;//存放發(fā)送消息時的時間戳OS_TS_GET();(獲取當前時間戳)
OS_ERR err; //返回的錯誤信息
OSMutexCreate(&AppMutex,"Test Mutex", &err);//創(chuàng)建互斥型信號量
OSMutexPend(&AppMutex, 0, OS_OPT_PEND_BLOCKING,&ts,&err);
//互斥型信號量申請（阻塞方式）
OSMutexPost(&AppMutex, OS_OPT_POST_NONE,&err);
//互斥型信號量釋放
七、OS_Q.C
（1）void OSQCreate() //創(chuàng)建一個消息隊列
（2）OS_OBJ_QTY OSQDel() //刪除消息隊列
（3）OS_MSG_QTY OSQFlush() //清空消息隊列
（4）void *OSQPend() //請求一個消息隊列
（6）void OSQPost() //向消息隊列發(fā)送消息
（6）OS_OBJ_QTYOSQPendAbort() //取消消息隊列的等待狀態(tài)
以指針和長度的形式向其他任務發(fā)送消息，如果是阻塞方式則接收到的數(shù)據(jù)的次數(shù)等于發(fā)送的次數(shù)才會被阻塞。
static OS_Q AppQ; //定義一個消息隊列變量
u8sendq_a[2]={1,2}; //要發(fā)送的數(shù)據(jù)
OSQCreate(&AppQ,"Test Q", 13, &err);//創(chuàng)建消息隊列包含存放消息的條數(shù)
OSQPost(&AppQ,sendq_a,2, OS_OPT_POST_FIFO,&err);//發(fā)送數(shù)據(jù)
OS_MSG_SIZEmsg_size=0; //接收到的數(shù)據(jù)的大小
CPU_TS ts=0; //發(fā)送數(shù)據(jù)時的時間戳
OS_ERRerr;
u8 *req; //接收到的數(shù)據(jù)的地址
req=(u8*)OSQPend (&AppQ, 0, OS_OPT_PEND_BLOCKING,
&msg_size,&ts,&err);
//接收數(shù)據(jù)（阻塞方式，非阻塞方式是給中斷用的）
八、OS_MEM.C
（1） void OSMemCreate() //創(chuàng)建一個固定大小的內(nèi)存分區(qū) （2）void *OSMemGet() //從分區(qū)中獲取一個內(nèi)存塊
（3）void OSMemPut() //返還一個內(nèi)存塊到分區(qū)
九、OS_TMR.C
（1）void OSTmrCreate() //創(chuàng)建一個定時器，定時調(diào)用函數(shù)
（2）CPU_BOOLEAN OSTmrDel() //刪除定時器
（3）OS_TICK OSTmrRemainGet() //定時器的剩余時間
（4）CPU_BOOLEAN OSTmrStart() //定時器開始計時
（5）OS_STATE OSTmrStateGet() //獲取定時器的當前狀態(tài)
（6）CPU_BOOLEAN OSTmrStop() //定時器停止計時
作者: 嵌入式摩羯 時間: 2017-2-26 14:21
可以，總結(jié)的挺好
作者: a274 時間: 2017-11-14 11:29
這個我喜歡，謝謝
作者: 天命風流 時間: 2018-5-7 11:42
這個必須支持
作者: 天命風流 時間: 2018-5-7 11:45
順便問一下，UC/os III 中哪個函數(shù)可以返回當前程序運行的微妙數(shù)？
作者: 18805483802 時間: 2020-5-12 15:21
寫的很好
作者: 如癡百感生 時間: 2020-6-3 17:38
收藏學習一下
作者: 21is 時間: 2021-4-28 15:14
整理的不錯，頂一下
作者: zyluglugl 時間: 2021-8-5 20:58
太利害了，真羨慕你們會這么多!
作者: jiayufei2010 時間: 2021-9-21 14:12
總結(jié)的不錯
| 歡迎光臨 (http://www.raoushi.com/bbs/) |
Powered by Discuz! X3.1 |