ccs中dsp、bios工具的使用

.z.評(píng)語(yǔ)**成績(jī)?cè)u(píng)語(yǔ)"DSP技術(shù)"課程論文題目CCS中DSP/BIOS工具的使用作者班級(jí)_院別專業(yè)_完成時(shí)間目錄一、DSP/BIOS簡(jiǎn)介……………………1二、DSP/BIOS的組件構(gòu)成……………1三、DSP/BIOS的啟動(dòng)順序……………2四、DSP/BIOS的配置…………………2五、根底類的DSP/BIOSAPI調(diào)用……………………15六、DSP\BIOS的中斷、優(yōu)先級(jí)………22七、參考文獻(xiàn)…………23-.z.摘要：DSP/BIOS的靜態(tài)配置是利用CCS提供的配置工具完成，包括圖形化配置工具和文本配置工具。圖形化工具層次清晰，比擬直觀，而文本工具更加靈活。一、DSP/BIOS簡(jiǎn)介DSP/BIOS是CCS中集成的一個(gè)簡(jiǎn)易的嵌入式實(shí)時(shí)操作系統(tǒng)，能夠大大方便用戶編寫多任務(wù)應(yīng)用程序。DSP/BIOS擁有很多實(shí)時(shí)嵌入式操作系統(tǒng)的功能，如任務(wù)的調(diào)度，任務(wù)間的同步和通信，內(nèi)存管理，實(shí)時(shí)時(shí)鐘管理，中斷效勞管理等。有了它，用戶可以編寫復(fù)雜的多線程程序，并且會(huì)占用更少的CPU和內(nèi)存資源。DSP/BIOS是一個(gè)可用于實(shí)時(shí)調(diào)度、同步，主機(jī)和目標(biāo)機(jī)通信，以及實(shí)時(shí)分析系統(tǒng)上的一個(gè)可裁減實(shí)時(shí)內(nèi)核，它提供了搶占式的多任務(wù)調(diào)度，對(duì)硬件的及時(shí)反響，實(shí)時(shí)分析和配置工具等。同時(shí)提供標(biāo)準(zhǔn)的API接口，易于使用。它是TI的e*pressDSP實(shí)時(shí)軟件技術(shù)的的一個(gè)關(guān)鍵局部。二、DSP/BIOS的組件構(gòu)成DSP/BIOS在一個(gè)主機(jī)/目標(biāo)機(jī)環(huán)境中的組件分布如下所示：DSP/BIOSAPI：編寫的程序可以調(diào)用API接口函數(shù)；DSP/BIOS配置：創(chuàng)立的配置文件定義了程序使用的靜態(tài)BIOS對(duì)象；DSP/BIOS分析工具：集成在CCS上的一些BIOS分析工具可以對(duì)運(yùn)行與目標(biāo)設(shè)備上的程序進(jìn)展監(jiān)測(cè)，包括CPU負(fù)載、時(shí)間、日志、線程執(zhí)行狀態(tài)等。DSP/BIOS分為很多模塊，提供的所有API函數(shù)都按照模塊分類，以模塊名加下劃線開頭來(lái)命名，如圖

40所示為DSP/BIOS的全部模塊。圖40三、DSP/BIOS的啟動(dòng)順序當(dāng)DSP/BIOS的應(yīng)用程序啟動(dòng)時(shí)，一般遵循下面的步驟：〔一〕初始化DSP：DSP/BIOS程序從C/C++環(huán)境入口c_int00開場(chǎng)運(yùn)行。對(duì)于C6000平臺(tái)，在c_int00開場(chǎng)處，系統(tǒng)棧指針〔B15〕和全局頁(yè)指針〔B14〕被分別設(shè)置在堆棧斷的末尾和.bss斷的開場(chǎng)?？刂拼娣牌鰽MR、IER、CSR等被初始化；〔二〕初始化.bss段：當(dāng)堆棧被設(shè)置完成后，初始化任務(wù)被調(diào)用，利用.cinit的記錄對(duì).bss斷的變量進(jìn)展初始化；〔三〕調(diào)用BIOS_init初始化用到的各個(gè)模塊：BIOS_init調(diào)用MOD_init對(duì)配置用到的各個(gè)模塊進(jìn)展初始化，包括HWI_init、HST_init、IDL_init等；〔四〕處理.pinit表：.pinit表包含一些指向初始化函數(shù)的指針，對(duì)C++程序，全局對(duì)象類的創(chuàng)立也在此時(shí)完成；〔五〕調(diào)用用戶程序的main函數(shù)：用戶main函數(shù)可以是C/C++函數(shù)或者匯編語(yǔ)言函數(shù)，對(duì)于匯編函數(shù)，使用_main的函數(shù)名。由于此時(shí)的硬件、軟件中斷還沒(méi)有被使能，所以在用戶主函數(shù)的初始化中需要注意，可以使能單獨(dú)的中斷屏蔽位，但是不能調(diào)用類似HWI_enable的接口來(lái)使能全局中斷；〔六〕調(diào)用BIOS_start啟動(dòng)DSP/BIOS：BIOS_start在用戶main函數(shù)退出后被調(diào)用，它負(fù)責(zé)使能使用的各個(gè)模塊并調(diào)用MOD_startup啟動(dòng)每個(gè)模塊。包括CLK_startup、PIP_startup、SWI_startup、HWI_startup等。當(dāng)TSK管理模塊在配置中被使用時(shí)，TSK_startup被執(zhí)行，并且BIOS_start將不會(huì)完畢返回；〔七〕執(zhí)行idle循環(huán)：有兩種方式進(jìn)入idle循環(huán)。當(dāng)TSK管理模塊使能時(shí)，任務(wù)調(diào)度器運(yùn)行的TSK_idle任務(wù)調(diào)用IDL_loop在其它任務(wù)空閑時(shí)進(jìn)入idle循環(huán)；當(dāng)TSK模塊未被使用時(shí)，BIOS_start調(diào)用將返回，并執(zhí)行IDL_loop進(jìn)入永久的idle循環(huán)，此時(shí)硬件和軟件中斷可以搶占idle循環(huán)得到執(zhí)行。由于idle循環(huán)中管理和主機(jī)的通信，因此主機(jī)和目標(biāo)機(jī)之間的數(shù)據(jù)交互可以進(jìn)展了。四、DSP/BIOS的配置DSP/BIOS的靜態(tài)配置是利用CCS提供的配置工具完成，包括圖形化配置工具和文本配置工具。圖形化工具層次清晰，比擬直觀，而文本工具更加靈活。通常使用圖形化的配置方法，下面對(duì)主要的模塊配置做一些介紹?！惨弧矴lobalSettingProperties右鍵點(diǎn)擊"GlobalSettings〞，點(diǎn)擊"What’sThis〞，會(huì)彈出幫助窗口，該文件中有GlobalSettingProperties的各項(xiàng)設(shè)置說(shuō)明。下面介紹的其他如MEM、LOG等配置都可以用同樣的方法得到相應(yīng)的幫助。選擇彈出菜單中的"Properties〞，如圖

41所示。圖41彈出如圖

42所示對(duì)話框:圖42一般選擇默認(rèn)設(shè)置即可，CLKOUT項(xiàng)需要根據(jù)DSP硬件單板提供的工作時(shí)鐘設(shè)置，Himalaya通常運(yùn)行在1GHz頻率。DSPEndianMode項(xiàng)根據(jù)實(shí)際情況設(shè)置?！捕矼EM設(shè)置MEM模塊設(shè)置中可以根據(jù)具體情況設(shè)置不同的內(nèi)存段，其中存在一個(gè)默認(rèn)的IRAM片內(nèi)內(nèi)存段。需要注意的是，首先必須在IRAM段上設(shè)置一個(gè)heap段落，用于BIOS的內(nèi)部使用。設(shè)置方法是在IRAM段上右鍵選擇"Properties〞，彈出如圖

43對(duì)話框，必須設(shè)置紅線框中的選項(xiàng)，heapsize可根據(jù)情況具體設(shè)置。圖43接下來(lái)配置MEM全局屬性，右鍵點(diǎn)擊配置窗口中的"MEM…〞，如圖

44所示：圖44點(diǎn)擊"Properties〞，彈出如圖

45所示窗口：圖45如圖紅線框中，兩個(gè)heap段都要選擇為IRAM，"StackSize〞項(xiàng)需要根據(jù)實(shí)際情況設(shè)置最大的棧大小，其他使用缺省設(shè)置即可。在圖

44的菜單中，點(diǎn)擊"InsertMEM〞可創(chuàng)立新的內(nèi)存段。在新的內(nèi)存段名上右鍵選擇"Properties〞彈出如圖

43窗口，根據(jù)情況設(shè)置base〔基地址〕、len〔段長(zhǎng)度〕、heapsize〔用于MEM動(dòng)態(tài)內(nèi)存分配的堆大小〕?！踩矻OG設(shè)置LOG用于輸出和記錄一些打印信息，默認(rèn)存在一個(gè)LOG_system對(duì)象，是系統(tǒng)內(nèi)部用來(lái)處理打印信息的，不需要去設(shè)置?？梢栽黾有碌腖OG對(duì)象，用來(lái)在應(yīng)用程序中輸出打印信息。如圖

46，在LOG標(biāo)簽上右鍵選擇"InsertLOG〞，填寫對(duì)象名LOG_test即建立了一個(gè)新的LOG對(duì)象。圖46在LOG_test標(biāo)簽上右鍵選擇"Properties〞，彈出如圖

47窗口，可對(duì)此LOG對(duì)象屬性作一些設(shè)置。具體設(shè)置含義可通過(guò)Help查看。圖47〔四〕

CLK設(shè)置在CLK屬性中通常選擇定時(shí)器Timer0作為DSP/BIOS的基準(zhǔn)時(shí)鐘，計(jì)時(shí)分辯率設(shè)置為每秒1000次中斷，在1GHz系統(tǒng)時(shí)鐘下，近似為每次定時(shí)中斷間隔999.996微秒。TimerMode選擇為32bitunchained模式，即使用TCI6482的TMR0的TIMLO作為Timer0，而TIMHI還可以作其它用途使用。CLK屬性配置界面如圖

48所示：圖48〔五〕HWI設(shè)置HWI〔硬中斷〕中包含HWI_INT4到HWI_INT15可用來(lái)定義用戶自己的硬件中斷，HWI_RESET、HWI_NMI和HWI_RESERVED不要去改動(dòng)。如圖

49，每個(gè)硬HWI的優(yōu)先級(jí)從上到下逐漸降低。圖49選擇HWI_INT10為例，來(lái)設(shè)置EMAC/MDIO的中斷，需要填寫中斷事件號(hào)17，并且填寫中斷效勞程序名〔C函數(shù)前面需要加下劃線〕如圖50所示：圖50在Dispatcher頁(yè)面，選擇"UseDispatcher〞由BIOS代理控制中斷確實(shí)認(rèn)和去除，不需要用戶中斷效勞程序干預(yù)，比擬簡(jiǎn)便。如圖51：圖51〔六〕SWI設(shè)置SWI〔軟中斷〕的優(yōu)先級(jí)在HWI之后，但是比TSK高，可以通過(guò)右鍵菜單中的"InsertSWI〞創(chuàng)立一個(gè)SWI對(duì)象，可以指定SWI內(nèi)部?jī)?yōu)先級(jí)，從0(最低)到14(最高)。如圖

52：圖52〔七〕TSK設(shè)置在TSKManager〔任務(wù)管理器〕中可以根據(jù)需要?jiǎng)?chuàng)立各種任務(wù)，任務(wù)間是根據(jù)優(yōu)先級(jí)搶占策略來(lái)進(jìn)展調(diào)度的，TSK提供有多種優(yōu)先級(jí)別，包括-1(Suspend)、0(Idle)、1(最低)到15(最高)。如圖

53：圖53在TSKManager上右鍵選擇"InsertTSK〞并填寫任務(wù)名稱后就可以創(chuàng)立一個(gè)任務(wù)，在相應(yīng)任務(wù)上右鍵選擇"Properties〞可對(duì)任務(wù)屬性進(jìn)展設(shè)置，如圖

54：圖54StackSize〔最大堆棧大小〕和Priority〔優(yōu)先級(jí)〕需要根據(jù)任務(wù)的具體情況進(jìn)展設(shè)置。在頁(yè)面，填寫任務(wù)實(shí)體函數(shù)名〔C函數(shù)前面加一個(gè)下劃線〕，如圖

55：圖55〔八〕Synchronization設(shè)置DSP/BIOS中任務(wù)間的通信和同步可由SEM、MB*、QUE、LCK四個(gè)模塊完成：SEM〔信號(hào)量〕：用于任務(wù)同步和互斥，有計(jì)數(shù)功能，根據(jù)需要使用；MB*〔〕：也用于任務(wù)同步，可以傳遞少量數(shù)據(jù)，根據(jù)需要使用；QUE〔隊(duì)列〕：可實(shí)現(xiàn)任務(wù)同步和資源的共享，根據(jù)需要使用；LCK〔資源鎖〕：實(shí)現(xiàn)對(duì)共享資源的互斥，根據(jù)需要使用。四種同步模塊對(duì)象都可以通過(guò)各自的右鍵菜單中"Insert…〞來(lái)創(chuàng)立，并可對(duì)其屬性作相應(yīng)的設(shè)置。如圖

56所示：圖56〔九〕Input/Output設(shè)置這里可以設(shè)置一些輸入/輸出相關(guān)的高級(jí)設(shè)置，具體可通過(guò)CCS的幫助項(xiàng)來(lái)了解。一般不需要進(jìn)展設(shè)置。只有RTD*〔實(shí)時(shí)數(shù)據(jù)交換〕，需要根據(jù)目標(biāo)環(huán)境的情況對(duì)數(shù)據(jù)交換模式進(jìn)展一下選擇，用來(lái)在調(diào)試中主機(jī)和目標(biāo)機(jī)進(jìn)展數(shù)據(jù)交換。可以是仿真器環(huán)境的JTAG模式，或者是模擬器環(huán)境的Simulator模式。如圖

57所示：五、根底類的DSP/BIOSAPI調(diào)用〔一〕時(shí)鐘管理CLK

1.Unsncounts

=CLK_countspms(void)

返回每毫秒的定時(shí)器高分辨率時(shí)鐘的計(jì)數(shù)值

2.LgUnscurrtime=CLK_gethtime(void)

返回高分辨率時(shí)鐘的計(jì)數(shù)值超過(guò)32bit歸零

高分辨率時(shí)鐘是DSP時(shí)鐘除以(TDDR+1)

3.LgUnscurrtime=CLK_getltime(void)

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

高分辨率時(shí)鐘是DSP時(shí)鐘除以(TDDR+1)再除以(PRD+1)

4.Unsperiod

=CLK_getprd(void)

返回CLK管理器周期存放器的值

(二)周期函數(shù)PRD

1.LgUnsnum

=PRD_getticks(void)

返回32位周期函數(shù)管理計(jì)數(shù)值

2.voidPRD_start(PRD_Obj*period)

啟動(dòng)PRD模塊計(jì)數(shù)器，一般地，mode=one-shot

3.voidPRD_stop(PRD_Obj*period)

關(guān)閉PRD模塊計(jì)數(shù)器

4.voidPRD_tick(void)

對(duì)周期模塊的計(jì)數(shù)器加1，以便周期模塊管理器確定哪個(gè)周期性函數(shù)得以運(yùn)行

(三)軟件中斷管理SWI

1.voidSWI_andn(SWI_Obj*swi,Unsmask)

mask屏蔽字參數(shù)

將值與mask做與運(yùn)算，并用結(jié)果代替以前的值，假設(shè)為0，啟動(dòng)軟件中斷，恢復(fù)初始值

2.voidSWI_andn(SWI_Obj*swi)

將值減1，并用結(jié)果代替以前的值，假設(shè)為0，啟動(dòng)軟件中斷，恢復(fù)初始值

3.voidSWI_disable(Void)

制止軟件中斷

4.voidSWI_enable(Void)

使能軟件中斷

5.Unsnum=SWI_getmbo*(void)

返回當(dāng)前SWI對(duì)象在被執(zhí)行的值，假設(shè)中斷已經(jīng)開場(chǎng)執(zhí)行，DSP/BIOS會(huì)先保存此值

6.Unskey=SWI_getpri(SWI_Obj*swi)

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

7.voidSWI_inc(SWI_Obj*swi)

將指定的SWI對(duì)象的值加1，同時(shí)啟動(dòng)軟件中斷，就算用戶調(diào)用屢次，最終執(zhí)行一次。

8.voidSWI_or(SWI_Obj*swi,Unsmask)

mask屏蔽字參數(shù)

將啟動(dòng)指定的軟件中斷，并將此軟件中斷的值與mask做與運(yùn)算，并用結(jié)果代替以前的值，等到中斷完成之后，值恢復(fù)為初始值，一般地，調(diào)用SWI_getmbo*獲得觸發(fā)此軟件中斷的值

9.voidSWI_post(SWI_Handleswi)

啟動(dòng)指定的SWI對(duì)象的軟件中斷，此函數(shù)不受值的影響，也不影響值。一般地，周期性低啟動(dòng)一個(gè)軟件中斷，將_SWI_post填入PRD對(duì)象的函數(shù)設(shè)置欄，啟動(dòng)軟件中斷的參數(shù)寫入arg0

10.Unskey=SWI_raisepri(Unsmask)

提高SWI軟件中斷的優(yōu)先級(jí)，一般地

key=SWI_raisepri(SWI_getpri(&swi_1));

--accesssharedresouces--

SWI_restorepri(key)

11.voidSWI_restorepri(Unskey)

恢復(fù)原來(lái)的優(yōu)先級(jí)

12.SWI_Obj*swi=SWI_self(void)

當(dāng)前執(zhí)行的SWI對(duì)象的軟件中斷的地址

(四)信息輸出管理LOG

1.voidLOG_disable(LOG_Obj*log)

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

2.voidLOG_enable(LOG_Obj*log)

開啟指定對(duì)向的日志功能

3.voidLOG_error(Stringformat,Argarg0)

voidLOG_message(Stringformat,Argarg0)

前一個(gè)函數(shù)可以將一個(gè)事件、數(shù)據(jù)或出錯(cuò)信息按照指定的格式串寫入系統(tǒng)日志，不受TRC跟蹤管理模塊的影響,后一個(gè)函數(shù)類似于前一個(gè)函數(shù)，但是受到TRC跟蹤管理模塊的影響

4.voidLOG_event(LOG_Obj*log,Argarg0,Argarg1,Argarg2)

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

5.voidLOG_printf(LOG_Obj*log,Stringformat,intarg0,intarg1)

指定的LOG窗口顯示消息%d%*%o%s

6.voidLOG_reset(LOG_Obj*log)

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

(五)存儲(chǔ)器管理MEM

1.void*addr=MEM_alloc(intsegid,Unssize,Unsalign)

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

segid=存儲(chǔ)段的標(biāo)識(shí)符或者ID號(hào)

size塊大小等于多少個(gè)字

align邊界條件只為0或2的冪假設(shè)align為0、1則無(wú)約束

2.void*addr=MEM_calloc(segid,size,align)

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

3.intsegid=MEM_define(Ptrbase,Unslength,MEM_Attrs*attrs)

定義一個(gè)新的存儲(chǔ)段。返回值為存儲(chǔ)段的ID標(biāo)號(hào),attr參數(shù)為NULL，會(huì)按照默認(rèn)參數(shù)進(jìn)展配置，段的參數(shù)由構(gòu)造體typeMEM_Attrs規(guī)定,此函數(shù)僅在main函數(shù)中使用

base:新段的基地址

length：段長(zhǎng)度

attrs：段屬性

4.boolstatus=MEM_free(segid,addr,size)

釋放申請(qǐng)的動(dòng)態(tài)內(nèi)存不能在SWI和HWI中調(diào)用,調(diào)用之前，用LCK中API查看內(nèi)存塊的鎖定情況

5.voidMEM_redefine(segid,base,length)

重新定義一個(gè)存儲(chǔ)段，只能在main中調(diào)用

6.boolstatus=MEM_stat(intsegid,MEM_Stat*statbuf)

segid存儲(chǔ)段標(biāo)識(shí)符

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

structmem_stat{

Unssize;//存儲(chǔ)段大小

Unsused;//已經(jīng)使用的數(shù)量

Unslength;//最**續(xù)存儲(chǔ)塊長(zhǎng)度

同理：假設(shè)segid有效，則MEM_stat返回TRUE

不能在SWI和HWI中使用，應(yīng)判斷鎖定情況

7.void*addr=MEM_valloc(intsegid,Unssize,Unsalign,charvalue)

先申請(qǐng)內(nèi)存，初始化為指定的值value(六)C6000專用模塊C64*

1.Unsoldmask=C64_diableIER(Unsmask)

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

2.voidC64_enableIER(Unsoldmask)

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

Unsoldmask;

oldmask=C64_disableIER(0*1);//disableINT0

C64_enableIER(oldmask);

//enableINT0

3.voidC64_plug(intvecid,F*nf*n,intdmachan)

插入一個(gè)中斷向量

intvecid:中斷序號(hào)

F*nf*n:中斷效勞程序的函數(shù)指針

intdmachan:插入操作使用的DMA通道

將ISFP寫到中斷效勞表IST中。假設(shè)IST在外部RAM，則CPU復(fù)制代替DMA，此時(shí)DMA為-1

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

(七)統(tǒng)計(jì)模塊STS

1.voidSTS_add(STS_Obj*sts,LgIntvalue)

使用我們提供的數(shù)據(jù)更新STS統(tǒng)計(jì)對(duì)象的Total，Count，Ma*等參數(shù)

傳入一個(gè)32位參數(shù)，Count加1，Total累加傳遞的32位參數(shù)，MA*記錄傳遞參數(shù)的最大值

2.voidSTS_delta(STA_Obj*sts,LgIntvalue)

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

STS_delta先計(jì)算當(dāng)前傳遞參數(shù)與先前初始值只差，然后調(diào)用STS_add更新統(tǒng)計(jì)累加值

一般和STS_set一起用

eg：

STS_set〔&sts,CLK_gethtime());

STS_delta(&sts,CLK_gethtime());

3.voidSTS_reset(STS_Obj*sts)

復(fù)位統(tǒng)計(jì)對(duì)象中的累加值。Count和Total設(shè)置為0.MA*成為最大的負(fù)值。

4.voidSTS_set(STS_Obj*sts,LgIntvalue)

監(jiān)視或統(tǒng)計(jì)程序的執(zhí)行時(shí)間(八)統(tǒng)計(jì)類模塊TRC

1.TRC_LOGCLK日志記錄定時(shí)器中斷

2.TRC_LOGPRD日志記錄周期時(shí)隙和周期函數(shù)的開場(chǎng)

3.TRC_LOGSWI日志記錄軟件中斷的啟動(dòng)和完成

4.TRC_LOGTSK日志記錄任務(wù)處于準(zhǔn)備好、開場(chǎng)、停頓、繼續(xù)執(zhí)行、終止等事件

5.TRC_STSHWI收集關(guān)于HWI統(tǒng)計(jì)數(shù)據(jù)

6.TRC_STSPIP寫管道和讀管道幀進(jìn)展計(jì)數(shù)

7.TRC_STSPRD執(zhí)行期間CLK時(shí)隙個(gè)數(shù)的統(tǒng)計(jì)數(shù)據(jù)

8.TRC_STSSWISWI執(zhí)行時(shí)間的統(tǒng)計(jì)數(shù)據(jù)

9.TRC_STSTSKTSK執(zhí)行時(shí)間的統(tǒng)計(jì)數(shù)據(jù)從TSK準(zhǔn)備好到調(diào)用TSKdeltatime都要收集

10.TRC_USER0ANDTRC_USER1和TRC_query一起用執(zhí)行和忽略結(jié)果的設(shè)備調(diào)用

11.TRC_GBLHOST執(zhí)行所有的隱藏儀器功能，此比特位能夠開場(chǎng)或停頓收集所有開啟的跟蹤類型

12.TRC_GBLTARG執(zhí)行所有的隱藏儀器功能，此比特位只能被目標(biāo)程序設(shè)置(九)任務(wù)管理TSK任務(wù)管理模塊

1.voidTSK_checkstacks(TSK_Handleoldtask,TSK_Handlenewtask)

無(wú)論是新任務(wù)還是老任務(wù)，如果堆棧的最后位置上都沒(méi)有RG_STACKSTAMP標(biāo)識(shí)，則TSK_checkstacks就會(huì)

報(bào)錯(cuò)SYS_abort，出現(xiàn)這種情況可能是由于上一個(gè)任務(wù)堆棧溢出或無(wú)效的存儲(chǔ)占用了新任務(wù)的堆棧

一般地，用TSK_checkstacks(TSK_self(),TSK_self())來(lái)檢查堆棧

定義Switch函數(shù)，這樣在任務(wù)切換時(shí)自動(dòng)調(diào)用堆棧檢查函數(shù)：

voidmyswitchf*n(TSK_Handleoldtask,TSK_Handlenewtask)

{

...

TSK_checkstacks(oldtask,newtask);

...

}

2.TSK_Handletask=TSK_create(F*nf*n,TSK_Attrs*attr,Arg[arg,]...)

創(chuàng)立一個(gè)調(diào)用函數(shù)f*n的任務(wù)對(duì)象，返回新對(duì)象的句柄，失敗返回NULL。

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

靜態(tài)創(chuàng)立的任務(wù)對(duì)象，創(chuàng)立函數(shù)將在BIOS_start函數(shù)中自動(dòng)調(diào)用。BIOS_start函數(shù)在main函數(shù)之后，

在后臺(tái)IDL循環(huán)之前運(yùn)行。而動(dòng)態(tài)創(chuàng)立的任務(wù)處于Ready狀態(tài)。函數(shù)參數(shù)最多不超過(guò)8個(gè)。

任務(wù)對(duì)象函數(shù)f*n返回時(shí)，自動(dòng)調(diào)用TSK_e*it函數(shù)。

解析：TSK_Attrs*attrs任務(wù)參數(shù)指針

structTSK_Attrs{

intpriority;

Ptrstack;

Unsstacksize;

#ifdef_64_//imitateC55series.tocheck

Unssysstacksize;

#endif

Unsstackseg;

Ptrenviron;

Stringname;

boole*itflag;

}

3.voidTSK_delete(TSK_Handletask)

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

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

voidmyDeleteF*n(TSK_Handletask);

4.voidTSK_deltatime(TSK_Handletask)

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

如果未調(diào)用此函數(shù)，則就算翻開任務(wù)統(tǒng)計(jì)累加器選項(xiàng)，統(tǒng)計(jì)對(duì)象也不會(huì)更新

一般地，統(tǒng)計(jì)時(shí)先用TSK_settime函數(shù)記錄起始點(diǎn)，此函數(shù)記錄終點(diǎn)。

5.voidTSK_settime(TSK_Handletask)

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

voidtask()

{

--dosomestartupwork--

TSK_settime(TSK_self);

for(;;){

SIO_get(...);

--processdata--

TSK_deltatime(TSK_self);

}

}

假設(shè)流式IO沒(méi)有準(zhǔn)備好，則該API函數(shù)會(huì)阻塞(Blocked)，任務(wù)切換，一段時(shí)間后，流式IO數(shù)據(jù)

準(zhǔn)備好了，此時(shí)發(fā)出READY信號(hào)，將本任務(wù)置為ready狀態(tài)，此時(shí)TSK_settime會(huì)重新記錄時(shí)間。

6.voidTSK_disable(void)

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

此函數(shù)不會(huì)制止中斷，所以在中斷開場(chǎng)前需要調(diào)用此函數(shù)保證中斷發(fā)生時(shí)不會(huì)發(fā)生任務(wù)切換。

可以嵌套，但是調(diào)用幾次TSK_disable，就得相應(yīng)調(diào)用幾次TSK_enable

7.voidTSK_enable(void)

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

8.voidTSK_e*it(void)

終止當(dāng)前任務(wù)運(yùn)行。如果所有任務(wù)都被終止，則DSP/BIOS會(huì)調(diào)用SYS_e*it終止程序。

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

可以注冊(cè)一個(gè)退出輔助函數(shù)voidmyE*itF*n(void)

這樣，在任務(wù)被設(shè)置為TSK_TERMINATED模式之前，會(huì)調(diào)用這個(gè)輔助函數(shù)。

9.Ptrenviron=TSK_getenv(TSK_Handletask)

返回任務(wù)環(huán)境指針，這個(gè)指針指向一個(gè)該任務(wù)可以的全局屬性的構(gòu)造。

假設(shè)程序定義多個(gè)鉤子對(duì)象，則HOOK_getenv函數(shù)可以獲取設(shè)置的環(huán)境指針。

10.voidTSK_setenv(TSK_Handletask,Ptrenviron)

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

假設(shè)程序定義多個(gè)鉤子對(duì)象，則HOOK_setenv函數(shù)可以為每個(gè)鉤子和任務(wù)對(duì)象的組合體設(shè)置獨(dú)立的環(huán)境指針。

11.interrno=TSK_geterr(TSK_Handletask)

每個(gè)任務(wù)對(duì)象都有一個(gè)包含任務(wù)錯(cuò)誤號(hào)的存儲(chǔ)單元。初始值為SYS_OK

12.voidTSK_seterr(TSK_Handletask,interrno)

改變錯(cuò)誤號(hào)

13.Stringname=TSK_getname(TSK_Handletask)

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

對(duì)于靜態(tài)對(duì)象來(lái)說(shuō)，必須翻開AllocateTaskNameonTarget

對(duì)于動(dòng)態(tài)對(duì)象來(lái)說(shuō)，TSK_getname返回字段

14.intpriority=TSK_getpri(TSK_Handletask)

返回優(yōu)先級(jí)

15.intoldpri=TSK_setpri(TSK_Handletask,intnewpri)

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

設(shè)置優(yōu)先級(jí)對(duì)于TSK_BLOCKED狀態(tài)任務(wù)只是優(yōu)先級(jí)改變，而不會(huì)改變狀態(tài)；

對(duì)于TSK_READY狀態(tài)的任務(wù)而言，可能會(huì)改變運(yùn)行狀態(tài)。

16.STS_Handlests=TSK_getsts(TSK_Handletask)

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

17.voidTSK_sleep(Unsnticks)

暫停任務(wù)的時(shí)鐘個(gè)數(shù)，此時(shí)鐘數(shù)可能比真實(shí)的暫停時(shí)鐘少一個(gè)時(shí)鐘〔告警時(shí)鐘〕

18.voidTSK_itick(void)

對(duì)告警時(shí)鐘加1，以便讓TSK_sleep或者SEM_pend函數(shù)暫停執(zhí)行的任務(wù)恢復(fù)到ready。

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

19.voidTSK_tick(void)

對(duì)告警時(shí)鐘加1，以便讓TSK_sleep或者SEM_pend函數(shù)暫停執(zhí)行的任務(wù)恢復(fù)到ready。

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

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

20.Unscurrtime=TSK_time(void)

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

21.TSK_Handlecurrtask=TSK_self(void)

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

22.voidTSK_stat(TSK_Handletask,TSK_Stat*statbuf)

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

structTSK_Stat{

TSK_Attrsattrs;//任務(wù)參數(shù)

TSK_Modemode;

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

Ptrsp;

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

Unsused;

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

}

注意：任務(wù)比HWI和SWI中斷優(yōu)先級(jí)要低，所以當(dāng)任務(wù)被中斷時(shí)，還是返回TSK_RUNNING，

因?yàn)橹袛嗤瓿珊笕蝿?wù)繼續(xù)運(yùn)行。

23.voidTSK_yield(void)

強(qiáng)制任務(wù)切換，請(qǐng)注意，任務(wù)可以被中斷，但是，任務(wù)之間必須依靠切換來(lái)進(jìn)展，就是說(shuō)，

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

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

(十)任務(wù)管理HOOK鉤子函數(shù)管理模塊

HOOK模塊管理者一