移植μC/OS-Ⅱ

只用當(dāng)OS_CFG.H中的OS_CPU_HOOKS_EN被置為1時才會產(chǎn)生 OSTaskSwHook()的代碼。

8.05.05OSTaskStatHook()

OSTaskStatHook()每秒鐘都會被OSTaskStat()調(diào)用一次。用戶可以用OSTaskStatHook()來擴展統(tǒng)計功能。例如，用戶可以保持并顯示每個任務(wù)的執(zhí)行時間，每個任務(wù)所用的CPU份額，以及每個任務(wù)執(zhí)行的頻率等等。OSTaskStatHook()沒有任何參數(shù)，也不返回任何值。

只用當(dāng)OS_CFG.H中的OS_CPU_HOOKS_EN被置為1時才會產(chǎn)生OSTaskStatHook()的代碼。

8.05.06OSTimeTickHook()

OSTaskTimeHook()在每個時鐘節(jié)拍都會被OSTaskTick()調(diào)用。實際上，OSTaskTimeHook()是在節(jié)拍被μC/OS-Ⅱ真正處理，并通知用戶的移植實例或應(yīng)用程序之前被調(diào)用的。OSTaskTimeHook()沒有任何參數(shù)，也不返回任何值。

只用當(dāng)OS_CFG.H中的OS_CPU_HOOKS_EN被置為1時才會產(chǎn)生OSTaskTimeHook()的代碼。

無論何時建立任務(wù)，在分配好和初始化TCB后就會調(diào)用該函數(shù)，當(dāng)然任務(wù)的堆棧結(jié)構(gòu)也已經(jīng)初始化好了。OSTaskCreateHook()允許用戶用自己的方式來擴展任務(wù)建立函數(shù)的功能。例如用戶可以初始化和存儲與任務(wù)相關(guān)的浮點寄存器，MMU寄存器以及其它寄存器的內(nèi)容。通常，用戶可以存儲用戶的應(yīng)用程序所分配的附加的內(nèi)存信息。用戶還可以通過使用OSTaskCreateHook()來觸發(fā)示波器或邏輯分析儀，以及設(shè)置斷點。

參數(shù)

ptcb是指向所創(chuàng)建任務(wù)的任務(wù)控制塊的指針。

返回值

無

注意事項

該函數(shù)在被調(diào)用的時候中斷是禁止的。 因此用戶應(yīng)盡量減少該函數(shù)中的代碼以縮短中斷

的響應(yīng)時間。

范例

該例子假定了用戶是用OSTaskCreateExt()建立任務(wù)的，因為它希望在任務(wù)OS_TCB中

有.OSTCBExtPtr域，該域包含了指向浮點寄存器的指針。

VoidOSTaskCreateHook(OS_TCB*ptcb)

{

if(ptcb->OSTCBExtPtr!=(void*)0){

/* 儲存浮點寄存器的內(nèi)容到..*/

/*..TCB擴展域中 */

}

}

當(dāng)用戶通過調(diào)用OSTaskDel()來刪除任務(wù)時都會調(diào)用該函數(shù)。這樣用戶就可以處理OSTaskCreateHook()所分配的內(nèi)存。 OSTaskDelHook()就在TCB從TCB鏈中被移除前被調(diào)用。

用戶還可以通過使用OSTaskDelHook()來觸發(fā)示波器或邏輯分析儀，以及設(shè)置斷點。

參數(shù)

ptcb是指向所創(chuàng)建任務(wù)的任務(wù)控制塊的指針。

返回值

無

注意事項

該函數(shù)在被調(diào)用的時候中斷是禁止的。 因此用戶應(yīng)盡量減少該函數(shù)中的代碼以縮短中斷

的響應(yīng)時間。

范例

voidOSTaskDelHook(OS_TCB*ptcb)

{

/* 輸出信號觸發(fā)示波器 */

}

當(dāng)執(zhí)行任務(wù)切換時都會調(diào)用該函數(shù)。全局變量OSTCBHighRdy指向得到CPU的任務(wù)的TCB，而OSTCBCur指向被切換出去的任務(wù)的TCB。OSTaskSwHook()在保存好了任務(wù)的寄存器和保存好了指向當(dāng)前任務(wù)TCB的堆棧指針后馬上被調(diào)用。 用戶可以用該函數(shù)來保存或恢復(fù)浮點寄存器或MMU寄存器的內(nèi)容，來得到任務(wù)執(zhí)行時間的軌跡以及任務(wù)被切換進來的次數(shù)等等。

參數(shù)

無

返回值

無

注意事項

該函數(shù)在被調(diào)用的時候中斷是禁止的。 因此用戶應(yīng)盡量減少該函數(shù)中的代碼以縮短中斷的響應(yīng)時間。

范例

voidOSTaskSwHook(void)

{

/* 將浮點寄存器的內(nèi)容儲存在當(dāng)前任務(wù)的TCB擴展域中。 */

/* 用新任務(wù)的TCB擴展域中的值更新浮點寄存器的內(nèi)容。 */

}

該函數(shù)每秒鐘都會被μC/OS-Ⅱ的統(tǒng)計任務(wù)調(diào)用。OSTaskStatHook()允許用戶加入自己的統(tǒng)計功能。

參數(shù)

無

返回值

無

注意事項

統(tǒng)計任務(wù)大概在調(diào)用OSStart()后再過5秒開始執(zhí)行。注意，當(dāng)OS_TASK_STAT_EN或者

OS_TASK_CREATE_EXT_EN被置為0時，該函數(shù)不會被調(diào)用。

范例

voidOSTaskStatHook(void)

{

/* 計算所有任務(wù)執(zhí)行的總時間 */

/* 計算每個任務(wù)的執(zhí)行時間在總時間內(nèi)所占的百分比 */

}

只要發(fā)生時鐘節(jié)拍，該函數(shù)就會被OSTimeTick()調(diào)用。一旦進入OSTimeTick()就會馬上調(diào)用OSTimeTickHook()以允許執(zhí)行用戶的應(yīng)用程序中的與時間密切相關(guān)的代碼。用戶還可以通過使用該函數(shù)觸發(fā)示波器或邏輯分析儀來調(diào)試，或者為仿真器設(shè)置斷點。

參數(shù)

無

返回值

無

注意事項

OSTimeTick()通常是被ISR調(diào)用的， 所以時鐘節(jié)拍ISR的執(zhí)行時間會因為用戶在該函數(shù)

中提供的代碼而增加。當(dāng)OSTimeTick()被調(diào)用的時候，中斷可以是禁止的也可以是允許的，

這主要取決于該處理器上的移植是怎樣進行的。如果中斷是禁止的，該函數(shù)將會影響到中斷

響應(yīng)時間。

范例

voidOSTimeTickHook(void)

{

/* 觸發(fā)示波器 */

}