CCS中DSP、BIOS工具的使用

/評語學(xué)號成績評語《DＳP技術(shù)》課程論文題目CCS中DSP/BＩOS工具的使用作者班級_院別專業(yè)_完成時間

目??錄一、DSP/BIOＳ簡介……………………１二、ＤSP/BIOS的組件構(gòu)成……………１三、DＳP/ＢIOS的啟動順序……………2四、DSP/BＩOS的配置…………………2五、基礎(chǔ)類的ＤSＰ／BIＯSAPI調(diào)用……………………15六、DSP＼BＩOS的中斷、優(yōu)先級………22七、參考文獻…………23摘要:DSP/BIOＳ的靜態(tài)配置是利用CＣS提供的配置工具完成,包括圖形化配置工具和文本配置工具。圖形化工具層次清晰,比較直觀，而文本工具更加靈活.一、DSP/BＩＯS簡介DSP／BＩOＳ是CCS中集成的一個簡易的嵌入式實時操作系統(tǒng),能夠大大方便用戶編寫多任務(wù)應(yīng)用程序。DSP/BIOS擁有很多實時嵌入式操作系統(tǒng)的功能,如任務(wù)的調(diào)度，任務(wù)間的同步和通信，內(nèi)存管理,實時時鐘管理，中斷服務(wù)管理等。有了它，用戶可以編寫復(fù)雜的多線程程序，并且會占用更少的ＣＰU和內(nèi)存資源.ＤSP/BIOS是一個可用于實時調(diào)度、同步，主機和目標機通信,以及實時分析系統(tǒng)上的一個可裁減實時內(nèi)核,它提供了搶占式的多任務(wù)調(diào)度，對硬件的及時反應(yīng)，實時分析和配置工具等。同時提供標準的AＰI接口，易于使用.它是TI的eXｐressDSＰ實時軟件技術(shù)的的一個關(guān)鍵部分。

二、DSP/BＩＯS的組件構(gòu)成DSP／BIOＳ在一個主機／目標機環(huán)境中的組件分布如下所示：DSP／BIOＳAPI：編寫的程序可以調(diào)用ＡPI接口函數(shù)；DSP/ＢIOＳ配置：創(chuàng)建的配置文件定義了程序使用的靜態(tài)BＩOS對象;ＤSＰ/BＩOS分析工具：集成在CCS上的一些BＩＯS分析工具可以對運行與目標設(shè)備上的程序進行監(jiān)測,包括CPU負載、時間、日志、線程執(zhí)行狀態(tài)等。

ＤSP/BIOS分為很多模塊,提供的所有ＡＰI函數(shù)都按照模塊分類，以模塊名加下劃線開頭來命名，如圖

40所示為DSP／BIＯS的全部模塊.圖

40

三、DSＰ/BIＯS的啟動順序當(dāng)DＳP/BＩＯS的應(yīng)用程序啟動時,一般遵循下面的步驟:（一）初始化DSP:DSP／ＢＩOＳ程序從C/Ｃ++環(huán)境入口c_int00開始運行。對于Ｃ6０00平臺，在ｃ＿int00開始處，系統(tǒng)棧指針（Ｂ15）和全局頁指針（B14)被分別設(shè)置在堆棧斷的末尾和.bss斷的開始?？刂萍拇嫫鰽ＭR、IEＲ、ＣSＲ等被初始化;(二）初始化.bsｓ段:當(dāng)堆棧被設(shè)置完成后,初始化任務(wù)被調(diào)用,利用．ciniｔ的記錄對．bss斷的變量進行初始化;(三）調(diào)用ＢIOS_ｉnｉt初始化用到的各個模塊：BIOS_inｉt調(diào)用ＭＯD_init對配置用到的各個模塊進行初始化，包括HWI＿init、HSＴ_init、IＤL_iｎｉt等；（四)處理．pinｉt表:。piniｔ表包含一些指向初始化函數(shù)的指針，對C+＋程序，全局對象類的創(chuàng)建也在此時完成；（五)調(diào)用用戶程序的main函數(shù)：用戶ｍaiｎ函數(shù)可以是Ｃ／C＋+函數(shù)或者匯編語言函數(shù),對于匯編函數(shù)，使用_ｍain的函數(shù)名。由于此時的硬件、軟件中斷還沒有被使能，所以在用戶主函數(shù)的初始化中需要注意,可以使能單獨的中斷屏蔽位，但是不能調(diào)用類似HWI＿enable的接口來使能全局中斷；（六）調(diào)用ＢＩOS＿sｔａrｔ啟動ＤＳP/BIOS：BIＯS_start在用戶main函數(shù)退出后被調(diào)用，它負責(zé)使能使用的各個模塊并調(diào)用MＯD_ｓtaｒtup啟動每個模塊。包括CLＫ＿sｔartup、PIP_stａｒtup、SWＩ_staｒtｕp、HWI_startup等。當(dāng)TＳK管理模塊在配置中被使用時，ＴSK＿stａrtup被執(zhí)行，并且BIＯS_ｓtart將不會結(jié)束返回;（七)執(zhí)行ｉdle循環(huán):有兩種方式進入ｉdle循環(huán)。當(dāng)TSK管理模塊使能時，任務(wù)調(diào)度器運行的TSK_idｌe任務(wù)調(diào)用IDＬ_lｏop在其它任務(wù)空閑時進入ｉdlｅ循環(huán);當(dāng)TSＫ模塊未被使用時,BIOS_staｒt調(diào)用將返回，并執(zhí)行ＩDL_loｏｐ進入永久的idle循環(huán),此時硬件和軟件中斷可以搶占ｉｄle循環(huán)得到執(zhí)行。由于iｄle循環(huán)中管理和主機的通信，因此主機和目標機之間的數(shù)據(jù)交互可以進行了.

四、DＳP/BＩOS的配置DＳＰ/BＩOＳ的靜態(tài)配置是利用ＣCS提供的配置工具完成,包括圖形化配置工具和文本配置工具.圖形化工具層次清晰，比較直觀,而文本工具更加靈活.通常使用圖形化的配置方法,下面對主要的模塊配置做一些介紹。(一）GlobａｌSｅｔtingPｒｏperties右鍵點擊“GlｏｂａlSeｔtinｇs”，點擊“What’sThiｓ”，會彈出幫助窗口，該文件中有GloｂalSｅttingＰroｐｅrtiｅs的各項設(shè)置說明。下面介紹的其他如MEM、LOG等配置都可以用同樣的方法得到相應(yīng)的幫助。選擇彈出菜單中的“Properties”，如圖

４1所示.圖

41彈出如圖

4２所示對話框:圖

42一般選擇默認設(shè)置即可，CLＫＯUT項需要根據(jù)DＳP硬件單板提供的工作時鐘設(shè)置，Ｈiｍalaya通常運行在1GHz頻率。DSPEndｉａnMode

項根據(jù)實際情況設(shè)置。

（二)ＭEM設(shè)置MEM模塊設(shè)置中可以根據(jù)具體情況設(shè)置不同的內(nèi)存段，其中存在一個默認的IRＡM片內(nèi)內(nèi)存段.需要注意的是，首先必須在IRＡM段上設(shè)置一個heａp段落，用于BIOS的內(nèi)部使用。設(shè)置方法是在IRAM段上右鍵選擇“Proｐerｔies”，彈出如圖

４３對話框，必須設(shè)置紅線框中的選項，ｈeaｐsize可根據(jù)情況具體設(shè)置。圖

43接下來配置MEM全局屬性，右鍵點擊配置窗口中的“MEM…"，如圖

44所示：圖

４4點擊“Pｒopｅrｔｉes",彈出如圖

45所示窗口:圖

4５如圖紅線框中，兩個hｅap段都要選擇為ＩRAM，“StackSize"項需要根據(jù)實際情況設(shè)置最大的棧大小,其他使用缺省設(shè)置即可。在圖

4４的菜單中，點擊“InsertMEM"可創(chuàng)建新的內(nèi)存段。在新的內(nèi)存段名上右鍵選擇“Pｒｏperｔiｅs”彈出如圖

４３窗口,根據(jù)情況設(shè)置basｅ(基地址)、len（段長度)、ｈeapsizｅ(用于MEM動態(tài)內(nèi)存分配的堆大小)。

(三)LOG設(shè)置LOG用于輸出和記錄一些打印信息，默認存在一個ＬOG_sｙstem對象，是系統(tǒng)內(nèi)部用來處理打印信息的,不需要去設(shè)置.可以增加新的ＬOＧ對象，用來在應(yīng)用程序中輸出打印信息。如圖

４6,在ＬOG標簽上右鍵選擇“ＩｎserｔLＯG”,填寫對象名LOＧ_test即建立了一個新的LOG對象。圖

46在LOG_tesｔ標簽上右鍵選擇“Prｏpeｒtiｅs”，彈出如圖

47窗口，可對此LＯＧ對象屬性作一些設(shè)置。具體設(shè)置含義可通過Heｌｐ查看。圖

47

（四）

CLＫ設(shè)置在CＬK屬性中通常選擇定時器Ｔimer０作為ＤSP/BIOS的基準時鐘,計時分辯率設(shè)置為每秒1０00次中斷,在1GHｚ系統(tǒng)時鐘下，近似為每次定時中斷間隔9９9。9９6微秒。TimerＭode選擇為32ｂitｕｎchaiｎed模式，即使用TCI6482的TMR0的TＩMLＯ作為Timeｒ0，而ＴＩMHI還可以作其它用途使用。ＣLK屬性配置界面如圖

48所示:圖

４８

（五）ＨWＩ設(shè)置HWI(硬中斷）中包含HWI_ＩNＴ4到ＨWＩ_INＴ1５可用來定義用戶自己的硬件中斷，HWI_ＲESET、HWI_NMI和HWＩ_RＥSERＶED不要去改動.如圖

４９,每個硬ＨWI的優(yōu)先級從上到下逐漸降低。圖

49選擇HWI_INT10為例,來設(shè)置ＥＭAC／MDＩＯ的中斷，需要填寫中斷事件號17，并且填寫中斷服務(wù)程序名（C函數(shù)前面需要加下劃線)如圖５0所示：圖

50在Dｉsｐatchｅr頁面，選擇“UｓｅDispaｔcｈer"由BＩOS代理控制中斷的確認和清除，不需要用戶中斷服務(wù)程序干預(yù),比較簡便.如圖51:圖

51

(六)SWI設(shè)置ＳWＩ（軟中斷）的優(yōu)先級在HＷI之后，但是比TＳK高，可以通過右鍵菜單中的“InｓerｔSWI”創(chuàng)建一個SＷＩ對象，可以指定SWＩ內(nèi)部優(yōu)先級,從0(最低）到１4（最高)。如圖

52:圖

52（七）TＳK設(shè)置在TSKManager（任務(wù)管理器)中可以根據(jù)需要創(chuàng)建各種任務(wù)，任務(wù)間是根據(jù)優(yōu)先級搶占策略來進行調(diào)度的,ＴSK提供有多種優(yōu)先級別，包括－1(Suspｅnd）、0（Idｌe）、１（最低）到15(最高）。如圖

５3：圖

５３在TＳKＭaｎager上右鍵選擇“InsｅrtTＳK”并填寫任務(wù)名稱后就可以創(chuàng)建一個任務(wù),在相應(yīng)任務(wù)上右鍵選擇“Proｐerties"可對任務(wù)屬性進行設(shè)置，如圖

54：圖

5４StａｃkSize（最大堆棧大小)和Priｏｒity（優(yōu)先級)需要根據(jù)任務(wù)的具體情況進行設(shè)置。在頁面，填寫任務(wù)實體函數(shù)名（C函數(shù)前面加一個下劃線）,如圖

５5：圖

55

(八）Ｓyｎｃhronization設(shè)置?ＤSＰ/ＢIOＳ中任務(wù)間的通信和同步可由SEM、MBX、QＵE、LCK四個模塊完成：SＥM(信號量)：用于任務(wù)同步和互斥,有計數(shù)功能,根據(jù)需要使用；MBＸ（郵箱)：也用于任務(wù)同步，可以傳遞少量數(shù)據(jù),根據(jù)需要使用；QＵE(隊列)：可實現(xiàn)任務(wù)同步和資源的共享,根據(jù)需要使用;LCK（資源鎖）：實現(xiàn)對共享資源的互斥，根據(jù)需要使用.四種同步模塊對象都可以通過各自的右鍵菜單中“Ｉnserｔ…”來創(chuàng)建,并可對其屬性作相應(yīng)的設(shè)置。如圖

５６所示:圖

56

（九）Input／Outpuｔ設(shè)置這里可以設(shè)置一些輸入/輸出相關(guān)的高級設(shè)置，具體可通過CCS的幫助項來了解。一般不需要進行設(shè)置.只有RTDX(實時數(shù)據(jù)交換），需要根據(jù)目標環(huán)境的情況對數(shù)據(jù)交換模式進行一下選擇,用來在調(diào)試中主機和目標機進行數(shù)據(jù)交換?？梢允欠抡嫫鳝h(huán)境的JＴＡＧ模式，或者是模擬器環(huán)境的Siｍulator模式。如圖

５7所示：五、基礎(chǔ)類的DSP/BIOＳAPI調(diào)用(一）時鐘管理ＣLＫ?1．Ｕnsncounts

=CLK＿countspms(void）?

返回每毫秒的定時器高分辨率時鐘的計數(shù)值?2.LgＵnscurrtimｅ=CLＫ_gethtime（void)

返回高分辨率時鐘的計數(shù)值超過３２biｔ歸零

高分辨率時鐘是ＤSP時鐘除以（TDDR＋1)

3。ＬgUnscｕrrtime=CLＫ_getltimｅ(void）

返回低分辨率時鐘的計數(shù)值超過32bit歸零

高分辨率時鐘是DSP時鐘除以(TDDＲ+1)再除以(PＲＤ+1)

４。Unｓperiｏｄ

=CLK_ｇetprd(vｏiｄ）

返回CLＫ管理器周期寄存器的值

?（二）周期函數(shù)PRD

1.LgUnsnｕm

=PＲＤ_getticks（voｉd)?

返回32位周期函數(shù)管理計數(shù)值?２．voiｄPＲD＿staｒt(PRD_Obj*perｉod)

啟動PRＤ模塊計數(shù)器，一般地,ｍｏｄｅ=ｏne-ｓhｏt

3.ｖｏidPRD＿stop(ＰRD＿Obj*pｅriod）

關(guān)閉PRD模塊計數(shù)器?4。ｖoiｄPRD_tick(voｉd）

對周期模塊的計數(shù)器加１，以便周期模塊管理器確定哪個周期性函數(shù)得以運行

?(三)軟件中斷管理SWI

1.voidSＷI_anｄｎ(SWI_Obｊ＊swi，Unsmask）

ｍaｓk屏蔽字參數(shù)

將郵箱值與ｍaｓk做與運算，并用結(jié)果代替以前的郵箱值，若為0,啟動軟件中斷,恢復(fù)郵箱初始值

2.voidSＷI＿andn(SWI＿Oｂj＊swｉ）

將郵箱值減1，并用結(jié)果代替以前的郵箱值,若為０，啟動軟件中斷,恢復(fù)郵箱初始值

3.vｏｉdSWI_ｄｉsａblｅ（Void）

禁止軟件中斷

4.voidSＷI＿enaｂle（Vｏｉd）

使能軟件中斷

５.Ｕnsnum=ＳWI_gｅtｍbox（void)?

返回當(dāng)前SＷＩ對象在被執(zhí)行的郵箱值，若中斷已經(jīng)開始執(zhí)行，ＤＳＰ/ＢIOS會先保存此值

6.Unskｅy=SWI_gｅｔpri（SWI＿Obj＊swi）

返回指定的SWI對象的優(yōu)先級

7.voｉdSWI_iｎc（SＷI_Obj＊ｓwi)

將指定的SWI對象的郵箱值加1,同時啟動軟件中斷,就算用戶調(diào)用多次，最終執(zhí)行一次。

８。voiｄSWＩ_or(SWI＿Oｂj＊swi,Uｎsmaｓk)

mａｓｋ屏蔽字參數(shù)

將啟動指定的軟件中斷,并將此軟件中斷的郵箱值與mask做與運算,并用結(jié)果代替以前的郵箱值,等到中斷完成之后，郵箱值恢復(fù)為初始值，一般地,調(diào)用SWＩ_getｍbox獲得觸發(fā)此軟件中斷的郵箱值

９．voｉdSWI_pｏst(SWＩ_Handleswi)?

啟動指定的SWＩ對象的軟件中斷,此函數(shù)不受郵箱值的影響,也不影響郵箱值.一般地,周期性低啟動一個軟件中斷，將_SWＩ_pｏsｔ填入ＰRＤ對象的函數(shù)設(shè)置欄，啟動軟件中斷的參數(shù)寫入ａrg0?1０．Ｕnskeｙ=SWI_ｒａisepｒi（Uｎsmａｓk）?

提高ＳＷI軟件中斷的優(yōu)先級，一般地

ｋey=SWI_ｒaｉsepｒi（SＷI＿getｐri（＆sｗi_1））；?

—-aｃｃesｓsｈarｅdｒeｓｏucｅs--?

SWI＿restoｒepｒi（keｙ）?11。voidSWI_rｅstorepri（Uｎｓkey）?

恢復(fù)原來的優(yōu)先級

12。SWＩ_Obj＊ｓwi=SWＩ_self（void)?

當(dāng)前執(zhí)行的ＳＷI對象的軟件中斷的地址?

?（四）信息輸出管理LＯG

1．ｖoiｄLOG_disablｅ（LOG_Oｂｊ＊log)

關(guān)閉指定對向的日志功能

2.voidＬＯG_ｅｎable（ＬOG_Obj*ｌoｇ）

開啟指定對向的日志功能?3。ｖoｉdLOG_ｅrror(Stringfｏrｍat，Argaｒg０)

voiｄＬOＧ_ｍessaｇｅ（Strｉｎｇforｍat，Aｒgarｇ0）

前一個函數(shù)可以將一個事件、數(shù)據(jù)或出錯信息按照指定的格式串寫入系統(tǒng)日志,不受TＲC跟蹤管理模塊的影響，后一個函數(shù)類似于前一個函數(shù),但是受到TRＣ跟蹤管理模塊的影響?4。voidＬOG＿eｖent(LOG_Ｏｂj＊log，Ａｒgarg0，Ａrgarｇ1,Ａｒｇarg2)

將未格式化的事件消息寫入日志中

5。voｉdLOG_ｐriｎtf(LOG_Obｊ＊lｏg，Ｓｔringfｏrmat,ｉｎtaｒg０，iｎｔａrg1)?

指定的ＬOG窗口顯示消息％d％x%o％ｓ?６。voidＬOG_ｒeset（ＬOG_Oｂｊ*log)

復(fù)位日志緩沖區(qū)

?（五）存儲器管理ＭEM?1.vｏiｄ＊addr=MEM_allｏc（inｔsegid，Ｕｎssｉze,Unsaliｇn）

指定存儲段分配連續(xù)塊,返回起始地址?

segid＝存儲段的標識符或者ID號?

size塊大小等于多少個字?

aｌign邊界條件只為0或2的冪若aｌｉgn為０、1則無約束

2．ｖｏid＊ａddr＝MＥM_calloc（ｓegid，size，ａlign)

分配內(nèi)存并初始化為０

３.intsegid=ＭEM_ｄｅfiｎe（Ptrｂasｅ，Unslength，MＥM＿Aｔtrs*atｔrs）?

定義一個新的存儲段。返回值為存儲段的ＩＤ標號，attr參數(shù)為NULＬ,會按照默認參數(shù)進行配置,段的參數(shù)由結(jié)構(gòu)體tｙpｅMEM_Attrs規(guī)定，此函數(shù)僅在ｍain函數(shù)中使用?

base:新段的基地址

lｅnｇth：段長度

attrs：段屬性?4．boolｓｔatus＝MＥM_ｆreｅ(segid,adｄr,siｚe）

釋放申請的動態(tài)內(nèi)存不能在SWI和HＷI中調(diào)用,調(diào)用之前,用LCK中API查看內(nèi)存塊的鎖定情況

5．vｏidMEM＿ｒedｅfｉne(ｓegｉd，base,lengtｈ)

重新定義一個存儲段，只能在ｍａin中調(diào)用?６。boｏlsｔatｕｓ=ＭEM＿stat（ｉnｔsegid，MEＭ_Ｓｔat＊sｔaｔbuｆ）

seｇid存儲段標識符

statbuf狀態(tài)緩存區(qū)指針

structmem_staｔ{?

Ｕnssize;//存儲段大小?

Ｕｎsｕｓed;//已經(jīng)使用的數(shù)量

Unslength；//最大連續(xù)存儲塊長度?

同理：若ｓegid有效，則ＭEM_sｔａｔ返回TRUE?

不能在SWI和HWＩ中使用,應(yīng)判斷鎖定情況?7。voｉd*aｄdr＝MEM_vaｌloc(intseｇｉd,Unssize，Unｓalign，charvalue）

先申請內(nèi)存,初始化為指定的值vａluｅ(六)Ｃ6000專用模塊C64x

１．Unｓoldmask=C６4＿ｄiａblｅＩER（Unsmaｓk)?

關(guān)閉相應(yīng)的中斷返回值實際屏蔽的中斷

２.ｖoidC64_enabｌeIEＲ(Unｓｏlｄmask）

開放相應(yīng)的中斷

?

Unsｏldmasｋ；?

oｌdmask=C6４_disabｌeIEＲ（0x1);//disableIＮT０?

C６4_ｅnableＩＥR(oｌdｍask）;

//enableINT0

3.voiｄC64_plug（intvecid,Fｘnｆxn,inｔdmachaｎ)?

插入一個中斷向量?

inｔｖecid:中斷序號?

Fxnfxｎ：中斷服務(wù)程序的函數(shù)指針

ｉnｔdmachaｎ：插入操作使用的ＤMA通道

將IＳFP寫到中斷服務(wù)表ＩST中。若IST在外部RAM,則CPU復(fù)制代替DMA，此時DMＡ為—1?

IST在片內(nèi)RAM時,使用DMA方式,是０，1，2,3用戶保證在函數(shù)調(diào)用時該DMＡ通道有效

（七)統(tǒng)計模塊ＳTＳ

1。voiｄSＴS_add（ＳＴS_Oｂj＊sｔｓ，LgＩntｖalｕe）?

使用我們提供的數(shù)據(jù)更新STＳ統(tǒng)計對象的Ｔotal，Cｏunt，Max等參數(shù)

傳入一個32位參數(shù)，Count加1,Ｔotal累加傳遞的32位參數(shù),ＭAX記錄傳遞參數(shù)的最大值?２。vｏｉdSTS＿dｅlｔａ(STＡ_Obj*sts,LgIntvalue)?

每個對象都包含有初始值，該初始值由配置文件指定或者由SＴS_set函數(shù)設(shè)置

STS_deltａ先計算當(dāng)前傳遞參數(shù)與先前初始值只差,然后調(diào)用ＳTS_adｄ更新統(tǒng)計累加值?

一般和STS_sｅt一起用

eg:?

ＳTS_set（＆sts,ＣＬＫ_gｅthｔime（)）；?

ＳＴS_dｅlｔa(＆sｔs，ＣLK_gethtｉme(））；

3。ｖoidＳＴS_rｅseｔ（ＳTS＿Oｂj*sｔs）

復(fù)位統(tǒng)計對象中的累加值。Count和Ｔotal設(shè)置為0．ＭAX成為最大的負值.

?4。voｉdＳTＳ_set（STS_Ｏbｊ＊sts,LｇIntvalｕｅ)?

監(jiān)視或統(tǒng)計程序的執(zhí)行時間（八）統(tǒng)計類模塊TＲC?1.TRC_ＬOGCＬK日志記錄定時器中斷?2.ＴRC＿LＯGＰRD日志記錄周期時隙和周期函數(shù)的開始?3．ＴRC_LOGSＷI日志記錄軟件中斷的啟動和完成?4.TRC＿ＬOGＴSK日志記錄任務(wù)處于準備好、開始、停止、繼續(xù)執(zhí)行、終止等事件?5．TRC_STSＨWI收集關(guān)于HWＩ統(tǒng)計數(shù)據(jù)

６。ＴRＣ＿SＴＳＰIP寫管道和讀管道幀進行計數(shù)?７.TRC＿SＴSPRD執(zhí)行期間CLＫ時隙個數(shù)的統(tǒng)計數(shù)據(jù)

8.ＴRＣ＿SＴSSWIＳＷI執(zhí)行時間的統(tǒng)計數(shù)據(jù)

９。TRC_STSTSKTSＫ執(zhí)行時間的統(tǒng)計數(shù)據(jù)從TSK準備好到調(diào)用ＴSＫdeｌtatime都要收集?1０.TＲC_ＵSＥR0AＮDTＲC_USER1和TRC_ｑuｅｒy一起用執(zhí)行和忽略結(jié)果的設(shè)備調(diào)用?１１。TRＣ＿ＧBＬHOST執(zhí)行所有的隱藏儀器功能，此比特位能夠開始或停止收集所有開啟的跟蹤類型

１2．TRC_GBLTARG執(zhí)行所有的隱藏儀器功能，此比特位只能被目標程序設(shè)置(九)任務(wù)管理ＴＳK任務(wù)管理模塊

１.ｖoｉdTSＫ_chｅcｋstａcｋs（ＴＳK_Haｎdleoldｔask，ＴSＫ＿Handlｅnewtaｓk）

無論是新任務(wù)還是老任務(wù)，如果堆棧的最后位置上都沒有RG_STACKSＴAＭP標識，那么TSＫ_checkｓtａｃｋs就會

報錯ＳYS_abｏｒt，出現(xiàn)這種情況可能是由于上一個任務(wù)堆棧溢出或無效的存儲占用了新任務(wù)的堆棧?

一般地，用TＳK_ｃhecｋstａcｋs（TSＫ＿sｅlf（)，TSK_self（)）來檢查堆棧

定義Sｗiｔch函數(shù)，這樣在任務(wù)切換時自動調(diào)用堆棧檢查函數(shù):?

voｉdmｙswｉｔchfxn(ＴSK_Handleoldtask，TＳK_Hanｄｌenｅwtａｓk)

{

.。．

ＴSK_cheｃｋｓtaｃks（ｏldtaｓk，newtasｋ);?

。.。?

}

2.TＳK＿Hanｄｌetaｓｋ＝TＳK＿cｒeatｅ（Fxnfxn，TSＫ_Aｔｔｒｓ*attr，Arg［arg,］．．.)

創(chuàng)建一個調(diào)用函數(shù)fxn的任務(wù)對象,返回新對象的句柄，失敗返回NULL。?

調(diào)用此函數(shù)是動態(tài)創(chuàng)建,而在配置工具中創(chuàng)建是靜態(tài)創(chuàng)建,二者效果一樣。

靜態(tài)創(chuàng)建的任務(wù)對象，創(chuàng)建函數(shù)將在BIＯS_start函數(shù)中自動調(diào)用。BIOＳ_ｓtaｒt函數(shù)在main函數(shù)之后，?

在后臺IDＬ循環(huán)之前運行。而動態(tài)創(chuàng)建的任務(wù)處于Ｒｅａｄy狀態(tài)。函數(shù)參數(shù)最多不超過８個。

任務(wù)對象函數(shù)fxn返回時，自動調(diào)用TSＫ_exit函數(shù)。

解析：TＳＫ_Attｒs＊attrｓ任務(wù)參數(shù)指針?

strｕctＴＳK_Attｒs｛

ｉnｔprioｒity;

Ptrstａck；

Unsｓtacksize；?

＃ifdｅf＿64_／/ｉmitａt(yī)eC5５series.toｃhｅck?

Ｕnssysstackｓｉze；

#endｉf

Uｎsstacｋｓｅｇ；

Ｐtｒenviron;?

Stringname；

bｏolexｉtfｌag;?

}

3.ｖoｉｄTSK_deletｅ（TＳK＿Handｌｅtａsk)?

從所有內(nèi)部隊列里面刪除這個任務(wù)，并且調(diào)用MEＭ_free釋放任務(wù)對象和堆棧。?

只能刪除處于結(jié)束狀態(tài)的任務(wù)，也可調(diào)用刪除的鉤子函數(shù)。?

voidmyDｅletｅFxn（TSＫ_Hａndletａｓk）；?4。vｏidTSK＿deltatｉme(TＳＫ_Ｈａndlｅtaｓk)?

累計從任務(wù)準備好到執(zhí)行此函數(shù)時候的時間差

如果未調(diào)用此函數(shù)，那么就算打開任務(wù)統(tǒng)計累加器選項,統(tǒng)計對象也不會更新

一般地，統(tǒng)計時先用TＳK_settime函數(shù)記錄起始點,此函數(shù)記錄終點。?５。vｏidTSK_settime(TSK_Haｎdlｅｔaｓk）?

設(shè)定統(tǒng)計初始值

voiｄtaｓk（)

{?

——dｏsｏmestartupworｋ--

TSK＿ｓettimｅ(TSK_sｅlf)；

for（；；）{?

ＳIO_get（..．)；?

－－proｃessdatａ-—

TSＫ_dｅｌｔatime(TSK_sｅlｆ）;

｝?

｝?

假如流式IO沒有準備好，那么該ＡPI函數(shù)會阻塞(Blｏｃked），任務(wù)切換，一段時間后，流式IＯ數(shù)據(jù)?

準備好了,此時發(fā)出RＥＡDＹ信號,將本任務(wù)置為ready狀態(tài)，此時TSＫ＿sｅttｉme會重新記錄時間。

6．vｏｉdTＳK＿ｄｉｓaｂle（ｖoid）?

全局關(guān)閉內(nèi)核調(diào)度機制，Busy-Ｓhｕttｉng—Down狀態(tài)。只有當(dāng)前任務(wù)可行，其余所有任務(wù)禁止。

此函數(shù)不會禁止中斷,所以在中斷開始前需要調(diào)用此函數(shù)保證中斷發(fā)生時不會發(fā)生任務(wù)切換。?

可以嵌套,但是調(diào)用幾次TSK_dｉsaｂｌe，就得相應(yīng)調(diào)用幾次TSＫ＿enａｂｌe?7.ｖoidTSK＿enａblｅ(voｉd）?

全局開啟內(nèi)核調(diào)度機制

8．vｏidTSK＿exit(voｉｄ)

終止當(dāng)前任務(wù)運行。如果所有任務(wù)都被終止，則ＤSP/BIOS會調(diào)用SYＳ_eｘiｔ終止程序。

無論什么時候,任務(wù)從頂層函數(shù)返回時，都是自動調(diào)用此函數(shù)。?

可以注冊一個退出輔助函數(shù)voidmyＥｘitFxn（void）

這樣,在任務(wù)被設(shè)置為ＴSK_ＴEＲMINＡTED模式之前,會調(diào)用這個輔助函數(shù)。

9.Ptreｎviron=TSＫ_gｅｔenv（TSＫ_Handleｔaｓｋ)

返回任務(wù)環(huán)境指針,這個指針指向一個該任務(wù)可以訪問的全局屬性的結(jié)構(gòu)。?

若程序定義多個鉤子對象,那么ＨOOK＿getenv函數(shù)可以獲取設(shè)置的環(huán)境指針。?1０．vｏｉｄTSK_setｅnv（TSK_Handlｅtask,Pｔreｎvirｏn)

設(shè)置指定任務(wù)的環(huán)境指針。

若程序定義多個鉤子對象，那么HＯOK_sｅtenv函數(shù)可以為每個鉤子和任務(wù)對象的組合體設(shè)置獨立的環(huán)境指針。?1１.iｎｔerrｎｏ=TSK＿gｅtｅrｒ（TSK_Handｌeｔａsk)?

每個任務(wù)對象都有一個包含任務(wù)錯誤號的存儲單元.初始值為SＹＳ_ＯＫ

12。ｖｏidTSK＿ｓｅteｒｒ（TSＫ_Ｈａndletask,iｎteｒrｎｏ)

改變錯誤號?1３。Sｔringname＝TSK_ｇetｎame（ＴSK_Hanｄleｔａｓk）?

返回任務(wù)的名字。?

對于靜態(tài)對象來說，必須打開AllocateTaskNameonTargeｔ?

對于動態(tài)對象來說，TSＫ＿geｔnaｍe返回字段?14.ｉｎtｐrｉorｉty=ＴＳK_ｇetpri(TSＫ_Handｌetask)?

返回優(yōu)先級

15.intｏldpri=TSＫ_seｔpｒi(TSK_Haｎｄletask,inｔnewpri)

設(shè)置優(yōu)先級?

設(shè)置優(yōu)先級對于TＳＫ_BＬＯCKED狀態(tài)任務(wù)只是優(yōu)先級改變,而不會改變狀態(tài)；

對于ＴSK＿REAＤY狀態(tài)的任務(wù)而言，可能會改變運行狀態(tài).?16.STＳ_Hanｄlests=TSＫ_getsts(ＴSＫ＿Handletasｋ)?

獲得統(tǒng)計對象句柄，以便查看數(shù)據(jù)

17.voidＴSK_sleep(Unｓnticks）

暫停任務(wù)的時鐘個數(shù)，此時鐘數(shù)可能比真實的暫停時鐘少一個時鐘（告警時鐘）

１8．vｏidTＳK_itick（ｖoiｄ)?

對告警時鐘加1，以便讓TSＫ_sleep或者SEM_penｄ函數(shù)暫停執(zhí)行的任務(wù)恢復(fù)到ｒｅady。

一些暫停的任務(wù)可能會隨著告警時鐘的增加而超時，從而就緒。

19。vｏｉdＴSK_tiｃk（vｏｉd)

對告警時鐘加1,以便讓ＴSK_sleep或者SEM＿penｄ函數(shù)暫停執(zhí)行的任務(wù)恢復(fù)到ready。?

一些暫停的任務(wù)可能會隨著告警時鐘的增加而超時，從而就緒.

可以在中斷服務(wù)程序和當(dāng)前任務(wù)中調(diào)用，后者在控制超時非常有用。

20.Unｓcuｒrtｉmｅ=TSＫ＿time(void)

返回系統(tǒng)告警時鐘的當(dāng)前值。(由于延遲,只能得到一個大概的系統(tǒng)時鐘）

２1.TSK_Ｈａndlecurｒtask=TSＫ_self（void）

返回當(dāng)前任務(wù)對象的句柄

22。ｖoidTSK＿stat（TSK＿Ｈａｎdlｅｔaｓk，TＳK_Ｓｔａt(yī)*sｔatbuf)?

返回任務(wù)的屬性參數(shù)和狀態(tài)信息

stｒucｔTSK＿Stａｔ｛?

ＴＳＫ_Ａｔｔｒsａt(yī)ｔrs；//任務(wù)參數(shù)

TSK_Ｍｏdemｏｄe；

//任務(wù)執(zhí)行模式?

Ptrsｐ；

/／任務(wù)當(dāng)前堆棧指針

Uｎｓused；

//任務(wù)堆棧曾經(jīng)使用的最大值

｝

注意：任務(wù)比HＷI和SWI中斷優(yōu)先級要低,所以當(dāng)任務(wù)被中斷時,還是返回ＴSK＿ＲUNNINＧ,?

因為中斷完成后任務(wù)繼續(xù)運行。

23。ｖoidTSK＿yielｄ（void）?

強制任務(wù)切換,請注意，任務(wù)可以被中斷，但是，任務(wù)之間必須依靠切換來進行,就是說,

即便當(dāng)前有高優(yōu)先級任務(wù)就緒，它不能被執(zhí)行，除非切換.?

此函數(shù)用于任務(wù)之間的同步.?

?（十）任務(wù)管理HＯＯＫ鉤子函數(shù)管理模塊?

HOOK模塊管理者一組涉及鉤