關(guān)于ucos中os_tmr.c中的代碼分析
我本身也是個初學(xué)者,喜歡嵌入式而自學(xué)ucos系統(tǒng),ucos是個開源的代碼,短小而又簡單,這是我學(xué)習(xí)的筆記,希望能對喜歡ucos的人有一點幫助,因本人也是初學(xué)者,如有錯誤迎指點。一般的書多是2.5版本,沒有os_tmr.c,所以我寫了關(guān)于這部分代碼的分析。
我讀ucos.中的os_tmr.c:
我想這個文件里就是為了寫一個建立在操作系統(tǒng)的定時器,原來我們學(xué)的時鐘節(jié)拍就像cpu總線時鐘脈沖一樣。我們建立的是定時器結(jié)構(gòu)體,在os_tmr.c中有一個函數(shù)OSTmr_Task()這個函數(shù)對定時器結(jié)構(gòu)體的信息進行處理,在定時時間到了時候,該定時器中的一個指向回調(diào)函數(shù)的指針就調(diào)用這個回調(diào)節(jié)器函數(shù)進行工作,當(dāng)然,你要寫回調(diào)函數(shù),不然就什么也不做,以前做過ucos移植的人知道要寫一個硬件定時器中斷函數(shù),這回要加個OSTmrSignal()這里有個發(fā)送信號。我們學(xué)硬件時知道,用到硬件定時器時要給它一個計算脈沖。這個軟件定時器也要一個計算脈沖。我們建立的定時器結(jié)構(gòu)體都會掛到OSTmrWheelTbl[OS_TMR_CFG_WHEEL_SIZE]上面,OS_TMR_CFG_WHEEL+SIZE是要自己定義的,至于掛到OSTmrWheelTbl[0] 到OSTmrWheelTbl[OS_TMR_CFG_WHEEL_SIZE-1]哪一個上,只要看一下OSTmr_Link (OS_TMR *ptmr, INT8U type)就明白了,而且一個OSTmrWheelTbl[n]上可以掛很多個定時器結(jié)構(gòu)體。
一、定時器的建立:
定時器是在我們的應(yīng)用程序中建立的,
OS_TMR *OSTmrCreate (INT32U dly,
INT32U period,
INT8U opt,
OS_TMR_CALLBACK callback,
void *callback_arg,
INT8U *pname,
INT8U *perr)
想使用定時器那些函數(shù)要在os_cfg.h中定義 OS_TMR_EN。
返回值是os_tmr結(jié)構(gòu)體(定義在ucos_ii.h中)。
typedef struct os_tmr {
INT8U OSTmrType;
OS_TMR_CALLBACK OSTmrCallback;
void *OSTmrCallbackArg;
void *OSTmrNext;
void *OSTmrPrev;
INT32U OSTmrMatch; 當(dāng) OSTmrTime == OSTmrMatch 定時器到時間了。
INT32U OSTmrDly;
INT32U OSTmrPeriod;
#if OS_TMR_CFG_NAME_EN > 0u
INT8U *OSTmrName;
#endif
INT8U OSTmrOpt;
INT8U OSTmrState;
} OS_TMR;
OSTmrType類型定義在ucos_ii.h中:OS_TMR_TYPE
OS_ARG_CHK_EN要在os_cfg.h中定義一下,來確定要不要一些功能。
OS_TMR_CFG_NAME_EN要你自己在os_cfg.h中定義,來控制要不要用OSTmrName
OSTmrState在ucos_ii.h中有以下幾種類型:
OS_TMR_STATE_UNUSED 不存在這個定時器
OS_TMR_STATE_RUNNING 這個定時器正在運行
OS_TMR_STATE_COMPLETED這個定時器已經(jīng)跑完了
OS_TMR_STATE_STOPPED 這個定時器停止了
參數(shù):
我讀ucos.中的os_tmr.c:
一、定時器的建立:
OS_TMR
想使用定時器那些函數(shù)要在os_cfg.h中定義 OS_TMR_EN。
返回值是os_tmr結(jié)構(gòu)體(定義在ucos_ii.h中)。
typedef
INT8U
OS_TMR_CALLBACK
void
void
INT32U
INT32U
INT32U
#if OS_TMR_CFG_NAME_EN > 0u
INT8U
#endif
INT8U
INT8U
} OS_TMR;
OSTmrType類型定義在ucos_ii.h中:OS_TMR_TYPE
OS_ARG_CHK_EN要在os_cfg.h中定義一下,來確定要不要一些功能。
OS_TMR_CFG_NAME_EN要你自己在os_cfg.h中定義,來控制要不要用OSTmrName
OSTmrState在ucos_ii.h中有以下幾種類型:
參數(shù):
- Dly
定時時間,如果是這個定時器只用一次,那么就用這個,如果定時器要反復(fù)用那么它是第一次時用,以后用period。 - Period
定時器從復(fù)用時會用到這個作定時時間。 - Opt
這里有兩種選項,告訴我們是只用一次還是反復(fù)使用。只用一次OS_TMR_OPT_ONE_SHOT,反復(fù)使用OS_TMR_OPT_PERIODIC。這些定義在ucos_ii.h中。
定時器選項有五種
#define OS_TMR_OPT_NONE 0u 沒有選擇
#define OS_TMR_OPT_ONE_SHOT 1u 定時器不會自動重復(fù)使用
#define OS_TMR_OPT_PERIODIC 2u 定時器會自動重裝
#define OS_TMR_OPT_CALLBACK 3u OSTmrStop()中使用,調(diào)用回調(diào)函數(shù),但不帶參數(shù)
#define OS_TMR_OPT_CALLBACK_ARG 4u 也是OSTmrStop()中使用,調(diào)用回調(diào)函數(shù),但有參數(shù)。
#define
#define
#define
#define
#define
- Callback
指向回調(diào)函數(shù)的指針,這個函數(shù)這樣聲明,void mycallback(OS_TMR *ptmr, void p_arg ); - Callback_arg
參數(shù)給callback的。 - Pname
定時器的名字 - Perr
錯誤指針* OS_ERR_NONE 沒有錯誤
用到的函數(shù)OSTmr_Alloc()得到一個定時器結(jié)構(gòu)體。
二、刪除一個定時器,也是在我們的功能函數(shù)中使用,返回為是否成功刪除。
BOOLEAN
- Ptmr
指向定時器結(jié)構(gòu)體。 - Perr
指向錯誤的指針。
三、得到定時器名字的函數(shù),返回名字的長度。
INT8U
四、定時器還有多長時間溢出。返回還有多長時間溢出。
INT32U
五、獲得定時器狀態(tài)的函數(shù),返回狀態(tài)。
INT8U
六、啟動你的定時器,返回是否成功啟動。
BOOLEAN
七、停止定時器,返回是否成功停止。
BOOLEAN
回調(diào)函數(shù)在這里使用,callback()。
Opt 為OS_TMR_OPT_NONE不使用回調(diào)函數(shù)。
OS_TMR_OPT_CALLBACK使用回調(diào)函數(shù)不用參數(shù)。
OS_TMR_OPT_CALLBACK_ARG要使用參數(shù)。
八、發(fā)送信號,這個是在timer tick中使用要您寫到ISR中
INT8U
九、從定時器池中得到一個結(jié)構(gòu)體。在建構(gòu)函數(shù)中用
static
十、釋放定時器,中刪除函數(shù)中用
static
十一、OSTmr_Init(void),在OSInit()中用。
十二、static
十三、OSTmr_Task()這個是調(diào)度你建立的定時器用的,一但定時時間到就調(diào)用回調(diào)函數(shù)。
我們建立的定時器都進入定時器輪盤里OSTmrWheelTbl[],
十四、static
Ptmr->OSTmrMatch的確定方法
if (type == OS_TMR_LINK_PERIODIC) {
掛載定時器時spoke
pspoke = &OSTmrWheelTbl[spoke];這樣確定的置位,當(dāng)OSTmrTime加到和OSTmrMatch相等時一定會來以這個spoke為下標的數(shù)組里找該定時器。至于定義一個OSTmrWheelTbl[]而不是把你所有建立的定時器串成一串是怕一起處理浪費時間吧,這樣可以一次少處理幾個定時器。
我想看了OSTmr_Task (void *p_arg)這個函數(shù)的人可能會好奇為什么用那種方法掛載定時器,當(dāng)定時時間到了時會找到OSTmrWheelTbl[]正確的下標,并在那個OSTmrWheelTbl[ok]里找到該定時器吧。其實你可以算一下,定義OS_TMR_CFG_WHEEL_SIZE=8,然后在OSTmrTime=6時建立一個定時器(假如定時器只工作一次),OSTmrDly=12,那個這個定時器會掛到OSTmrWheelTbl[2]中,當(dāng)OSTmrTime加到18時它就會去
OSTmrWheelTbl[2]找該定時器。
十五、static
評論