Ⅰ、寫在前面

學習本文之前可以參看我前面的文章:

UCOS2系統(tǒng)內核講述（四）_創(chuàng)建任務

上一篇文章講述了關于函數(shù)“OSTaskCreateExt”創(chuàng)建任務函數(shù)體里面重要一些的內容，本文接著上一張講述關于“OSTaskCreateExt”函數(shù)體里面調用的一個函數(shù)“OS_TCBInit”初始化任務控制塊，“OS_TCBInit”也是與系統(tǒng)內核緊密相關的一個函數(shù)。

關于本文的更多詳情請往下看。

Ⅱ、OS_TCBInit參數(shù)詳情

在學習OS_TCBInit之前要明確一下，“OS_TCBInit”和“OS_InitTCBList”（OSInit下面調用的函數(shù)），從命名上看上去有點相似，但仔細看一下區(qū)別還是可以看到出來的。

“OS_InitTCBList”在前面文章有講述過（可以看我前面相關的文章），主要是初始化TCB鏈表。“OS_InitTCBList”函數(shù)體內容相關于將TCB鏈表復位。

本文將的“OS_TCBInit”是在創(chuàng)建任務時初始化一個任務的TCB，要將優(yōu)先級、堆棧等信息初始化?！癘S_TCBInit”函數(shù)體內容相當于對任務的TCB里面對應的內容落實到具體的參數(shù)上。

可以將“OS_TCBInit”和“OS_InitTCBList”區(qū)別比喻如下：

“OS_TCBInit”是將某一個整形變量初始話為0（復位值）；

“OS_InitTCBList”是將某一個整形變量賦值為1（具體值）；

從main函數(shù)跟蹤代碼可以找到“OS_TCBInit”函數(shù)，如下動畫：

“OS_TCBInit”函數(shù)的每一個參數(shù)在函數(shù)體源代碼上面都有注釋（我也將源代碼注釋修改為中文了，可以下載參看）。

該函數(shù)位于“os_core.c”下面；

1.第一個參數(shù)prio

prio看過UCOS系統(tǒng)的朋友應該對整個參數(shù)不會陌生，它就是任務的優(yōu)先級。

這個參數(shù)是從“OSTaskCreateExt”函數(shù)參數(shù)中傳下來的（原封不動，一樣的參數(shù)）。

注意：任務的優(yōu)先級數(shù)值越小，它的優(yōu)先級越高。比如：

Task1優(yōu)先級是1，Task2優(yōu)先級是2。則Task1優(yōu)先級高于Task2的優(yōu)先級。

2.第二個參數(shù)ptos

ptos這個參數(shù)和上一篇文章中OSTaskCreateExt創(chuàng)建任務中的ptos一樣，是指向棧頂?shù)闹羔?。?chuàng)建任務中利用“OSTaskStkInit”初始化堆棧得到棧頂?shù)闹羔榩sp，將該指針傳遞給OS_TCBInit函數(shù)的參數(shù)。

同樣說明一下：這個參數(shù)和“第三個參數(shù)pbos”對應，需要根據(jù)棧的增長方向“OS_STK_GROWTH”來決定。

3.第三個參數(shù)pbos

pbos這個參數(shù)和“第二個參數(shù)”一樣，是從上一層的OSTaskCreateExt創(chuàng)建任務中的ptob參數(shù)意思一樣，是指向棧底的指針。

4.第四個參數(shù)id

id這個參數(shù)不多說，和上文一樣的意思。

5.第五個參數(shù)stk_size

stk_size這個參數(shù)和上一篇文章也是一樣，這里再提示一下，它就是堆棧的大小，就是你分配堆?？臻g（定義堆棧數(shù)組）的大小。

6.第六個參數(shù)pext

pext這個參數(shù)是指向用戶提供的內存(指針)。

這個參數(shù)對初學者意義不大，可暫時不用去理解它，你把它理解為擴展使用就是了。

7.第六個參數(shù)opt

opt：用戶操作選項參數(shù)。

上一篇文章已經說的很詳細，具體說明見上一篇文章。

到此，細心的會發(fā)現(xiàn)，其實“OS_TCBInit”函數(shù)的參數(shù)基本是繼承“OSTaskCreateExt”函數(shù)的參數(shù)。從這里可以看得出“OS_TCBInit”函數(shù)才是創(chuàng)建任務重要的函數(shù)。

Ⅲ、OS_TCBInit函數(shù)體內容描述

上一章節(jié)講述了“OS_TCBInit”的參數(shù)，其實傳遞進來的參數(shù)是保存在TCB鏈表里面的，用于保存一個任務重要的信息，具體如何實現(xiàn)就要看接下來的函數(shù)體說明（建議下載源代碼一起參考學習）。

1.第一部分

A.鏈表節(jié)點及參數(shù):

OSTCBFreeList是當前空閑TCB鏈表，相當于每初始化一個任務就要將OSTCBFreeList指向下一個沒有使用的FreeList，保證在每次創(chuàng)建任務的時候有OSTCBFreeList可用。

if (ptcb != (OS_TCB *)0)

這個條件就是上面說的，判斷還有沒有空閑TCB鏈表，如果沒有空閑TCB鏈表就會返回“錯誤”。

OSTCBFreeList = ptcb->OSTCBNext;指向下一個TCB鏈表。

下面來的就是其它參數(shù)賦值（堆棧、優(yōu)先級、任務狀態(tài)就緒等）。

B.任務參數(shù):

這里說的任務參數(shù)和上一篇文章說的不一樣，主要說的是傳遞下來的參數(shù)信息，歸位到對應的空間，也就是參數(shù)賦值。

ptcb->OSTCBDelReq = OS_ERR_NONE;

這里有一個語句，就是任務可以刪除（當我們使能了刪除任務功能，在創(chuàng)建任務之后就可以刪除創(chuàng)建的任務）。

2.第二部分

A.優(yōu)先級:

UCOS優(yōu)先級實現(xiàn)其功能具體的這部分是比較困難的，使用了“優(yōu)先級表”，而且查找優(yōu)先級的算法也相對來說比較困難，初學者暫時可以不用考慮，感興趣的朋友可以網上“UCOS優(yōu)先級調度算法”。

B.事件:

這個需要結合事件（信號量、消息郵箱等）來講述，我會在后面講述UCOS資源的事件中提及相關的信息。

C.性能分析參數(shù):

這個參數(shù)可以從注釋的意思來理解，“性能分析”意思就是對系統(tǒng)運行的性能，CPU使用率等來理解。前面在講述OS_TaskIdle空閑任務時就看到，函數(shù)體里面有這么一條語句：OSIdleCtr++; 也就是統(tǒng)計空閑任務的計數(shù)次數(shù)。

3.第三部分

在上面上部分的“準備”工作之后，這剩下的就是“就緒”工作了。

OSTCBInitHook(ptcb);和OSTaskCreateHook(ptcb);這兩個函數(shù)一般都是成對出現(xiàn)，是用戶自己的HOOK函數(shù)，用戶自己要實現(xiàn)某一些功能就寫在這里。

OSTCBPrioTbl[prio] = ptcb; 這條語句將該任務在TCB表中有一個對應的位置。

ptcb->OSTCBNext = OSTCBList;和上面第一部分類似，指向TCB鏈表。

OSTaskCtr++;任務也有一個統(tǒng)計計數(shù)的變量。

Ⅳ、實例工程下載

筆者針對于初學者提供的例程都是去掉了許多不必要的功能，精簡了官方的代碼，對初學者一看就明白，以簡單明了的工程供大家學習。

筆者提供的實例工程都是在板子上經過多次測試并沒有問題才上傳至360云盤，歡迎下載測試、參照學習。

我將最新UCOS2.92操作系統(tǒng)移植到F0、F1、F3、F4各個硬件平臺上，可以根據(jù)你芯片系列選擇下載。

UCOS基于STM32F0、F1、F3、F4系列實例工程源代碼（匯總）：

https://yunpan.cn/cM9Fjv88cXbjI訪問密碼 048d

本文講述的部分注釋修改為中文（軟件工程源代碼）：

https://yunpan.cn/ckKeBFx25VIEB訪問密碼 a9df

基于STM32平臺的UCOS源代碼工程(官方原始軟件工程)

官網下載（需要賬號）：

https://www.micrium.com/downloadcenter/download-results/?searchterm=hm-stmicroelectronics&supported=true

360云盤下載：

https://yunpan.cn/cM9Gzv4drXqxv訪問密碼 c82c