UCOS-IIAPI參考材料介紹材料

1、UCOS-II API 參考手冊(cè)本章提供了卩C/OS- n的用戶指南。每一個(gè)用戶可以調(diào)用的內(nèi)核函數(shù)都按字母順序加以說(shuō) 明，包括：函數(shù)的功能描述函數(shù)原型函數(shù)名稱(chēng)及源代碼函數(shù)使用到的常量函數(shù)參數(shù)函數(shù)返回值特殊說(shuō)明和注意點(diǎn)OSI nit()Void OSIn it(void);所屬文件調(diào)用者開(kāi)關(guān)量OS CORE.C啟動(dòng)代碼無(wú)OSinit ()初始化卩C/OS-n，對(duì)這個(gè)函數(shù)的調(diào)用必須在調(diào)用OSStart ()函數(shù)之前，而OSStart()函數(shù)真正開(kāi)始運(yùn)行多任務(wù)。參數(shù)無(wú)返回值無(wú)注意/警告必須先于OSStart ()函數(shù)的調(diào)用范例：void main (void)OSInit();/*初始化 uC/OS

2、-ll */OSStart();/*啟動(dòng)多任務(wù)內(nèi)核*/!-OSI ntEn ter（）Void OSIntEnter （void）;所屬文件調(diào)用者開(kāi)關(guān)量OS CORE.C中斷無(wú)OSIntEnter ()通知卩C/OS- n個(gè)中斷處理函數(shù)正在執(zhí)行，這有助于卩C/OS- n掌握中斷嵌套的情況。OSIntEnter ()函數(shù)通常和 OSIntExit ()函數(shù)聯(lián)合使用。參數(shù)無(wú)返回值無(wú)-修改-寫(xiě)入的操作，那么就可以直接遞增中 OSIntNesting ),這樣可以避免調(diào)用函數(shù)所帶來(lái)的額外的開(kāi)銷(xiāo)。范例一：（Intel 80x86注意/警告 在任務(wù)級(jí)不能調(diào)用該函數(shù)。 如果系統(tǒng)使用的處理器能夠執(zhí)行自動(dòng)的獨(dú)立

3、執(zhí)行讀取 斷嵌套層數(shù)(的實(shí)模式,在大模式下編譯，real mode , large model )ISRx P ROC FARPUSHA;PUSH ESP USHDSMOVAX, DGROU P;MOVDS, AXCALLFAR PTR OSIntEnterPOPDS；POPESPOPA保存中斷現(xiàn)場(chǎng)讀入數(shù)據(jù)段通知內(nèi)核進(jìn)入中斷恢復(fù)中斷現(xiàn)場(chǎng)ISRx END P中斷返回IRET;ISRx END P范例二：（Intel 80x86 的實(shí)模式，在大模式下編譯，real mode , large model ）ISRx P ROC FARP USHA保存中斷現(xiàn)場(chǎng)P USHESP USHDSMOVAX,

4、DGROU P讀入數(shù)據(jù)段MOVDS, AXINCBYTE PTR OSIntNesting ;通知內(nèi)核進(jìn)入中斷POPDS恢復(fù)中斷現(xiàn)場(chǎng)POPESPOPAIRET中斷返回OSI ntExit()Void OSIntExit (void);所屬文件調(diào)用者開(kāi)關(guān)量OS CORE.C中斷無(wú)OSIntExit ()通知卩C/OS- n個(gè)中斷服務(wù)已執(zhí)行完畢，這有助于卩C/OS- n掌握中斷嵌套的情況。通常OSIntExit ()和OSIntEnter ()聯(lián)合使用。當(dāng)最后一層嵌套的中斷執(zhí)行完畢后，如果 有更高優(yōu)先級(jí)的任務(wù)準(zhǔn)備就緒，卩C/OS- n會(huì)調(diào)用任務(wù)調(diào)度函數(shù)，在這種情況下，中斷返回到更高優(yōu)先級(jí)的任務(wù)而不

5、是被中斷了的任務(wù)。參數(shù)無(wú)返回值無(wú)注意/警告在任務(wù)級(jí)不能調(diào)用該函數(shù)。并且即使沒(méi)有調(diào)用 的方法，也必須調(diào)用 OSIntExit ()函數(shù)。 范例：(Intel 80x86的實(shí)模式，在大模式下編譯,OSIntEnter ()而是使用直接遞增OSIntNestingreal mode , large model )ISRx P ROC FARP USHAP USHP USH保存中斷現(xiàn)場(chǎng)CALLPOPPOPESDSFAR PTR OSIntExit ;DS；ES通知內(nèi)核進(jìn)入中斷恢復(fù)中斷現(xiàn)場(chǎng)中斷返回POPAIRETISRx END P!-OSMboxAcce pt()Void *OSMboxAcce pt

6、 ( OS_EVENT *p eve nt);所屬文件調(diào)用者開(kāi)關(guān)量OS MBOX.C任務(wù)或中斷OS MBOX ENOSMboxAccept （）函數(shù)查看指定的消息郵箱是否有需要的消息。不同于OSMboxPend （）函數(shù),如果沒(méi)有需要的消息，OSMboxAccept （）函數(shù)并不掛起任務(wù)。如果消息已經(jīng)到達(dá)，該消息被傳遞到用戶任務(wù)并且從消息郵箱中清除。通常中斷調(diào)用該函數(shù)，因?yàn)橹袛嗖辉试S掛起等待消息。參數(shù)當(dāng)建立消息郵箱時(shí)，該指針?lè)祷氐接脩舫绦?。（參考pevent是指向需要查看的消息郵箱的指針。OSMboxCreate （）函數(shù)）。返回值如果消息已經(jīng)到達(dá)，返回指向該消息的指針;如果消息郵箱沒(méi)有消息，

7、返回空指針。注意/警告必須先建立消息郵箱，然后使用。范例：OS_EVENT *CommMbox;void Task (void *p data)void *msg;P data = P data;for (;) msg = OSMboxAcce pt(CommMbox); /*if (msg != (void *)0) . /*檢查消息郵箱是否有消息*/處理消息*/ else /*沒(méi)有消息*/!-OSMboxCreate()OS_EVENT *OSMboxCreate (void *msg);所屬文件調(diào)用者開(kāi)關(guān)量OS MBOX.C任務(wù)或啟動(dòng)代碼OS MBOX ENOSMboxCreate ()

8、建立并初始化一個(gè)消息郵箱。消息郵箱允許任務(wù)或中斷向其他一個(gè)或幾個(gè)任 務(wù)發(fā)送消息。參數(shù)msg參數(shù)用來(lái)初始化建立的消息郵箱。如果該指針不為空，建立的消息郵箱將含有消息。返回值如果沒(méi)有可用的事件控制塊， 返回空指針。指向分配給所建立的消息郵箱的事件控制塊的指針。注意/警告必須先建立消息郵箱，然后使用。范例：OS_EVENT *CommMbox;void main(void)OSInitO;/*初始化卩c/os- n */建立消息郵箱 */啟動(dòng)多任務(wù)內(nèi)核*/CommMbox = OSMboxCreate(void *)0);/*OSStart();/*!-OSMbox Pend()Void *OSMb

9、ox Pend ( OS_EVNNT *p eve nt, INT16U timeout, in t8u *err );所屬文件調(diào)用者開(kāi)關(guān)量OS MBOX.C任務(wù)OS MBOX ENOSMboxPend()用于任務(wù)等待消息。 消息通過(guò)中斷或另外的任務(wù)發(fā)送給需要的任務(wù)。消息是一個(gè)以指針定義的變量，在不同的程序中消息的使用也可能不同。如果調(diào)用OSMboxPend ()函數(shù)時(shí)消息郵箱已經(jīng)存在需要的消息，那么該消息被返回給OSMboxPend ()的調(diào)用者，消息郵箱中清除該消息。如果調(diào)用OSMboxPend ()函數(shù)時(shí)消息郵箱中沒(méi)有需要的消息，OSMboxPend()函數(shù)掛起當(dāng)前任務(wù)直到得到需要的消息

10、或超出定義等待超時(shí)的時(shí)間。如果同時(shí)有多個(gè)任務(wù)等待同一個(gè)消息，卩C/OS- n默認(rèn)最高優(yōu)先級(jí)的任務(wù)取得消息并且任務(wù)恢復(fù)執(zhí)行。一個(gè)由OSTaskSuspend ()函數(shù)掛起的任務(wù)也可以接受消息，但這個(gè)任務(wù)將一直保持掛起狀態(tài)直到通過(guò)調(diào)用OSTaskResume ()函數(shù)恢復(fù)任務(wù)的運(yùn)行。參數(shù)peve nt是指向即將接受消息的消息郵箱的指針。該指針的值在建立該消息郵箱時(shí)可以得到。(參考 OSMboxCreate ()函數(shù))。Timeout 允許一個(gè)任務(wù)在經(jīng)過(guò)了指定數(shù)目的時(shí)鐘節(jié)拍后還沒(méi)有得到需要的消息時(shí)恢復(fù)運(yùn)行。如果該值為零表示任務(wù)將持續(xù)的等待消息。最大的等待時(shí)間為65,535個(gè)時(shí)鐘節(jié)拍。這個(gè)時(shí)間長(zhǎng)度并不

11、是非常嚴(yán)格的，可能存在一個(gè)時(shí)鐘節(jié)拍的誤差，因?yàn)橹挥性谝粋€(gè)時(shí)鐘節(jié)拍結(jié)束后才會(huì)減少 定義的等待超時(shí)時(shí)鐘節(jié)拍。Err是指向包含錯(cuò)誤碼的變量的指針。OSMboxPend ()函數(shù)返回的錯(cuò)誤碼可能為下述幾種:OS_NO_ERR :消息被正確的接受。OS_TIMEOUT :消息沒(méi)有在指定的周期數(shù)內(nèi)送到。OS_ERR_PEND_ISR :從中斷調(diào)用該函數(shù)。雖然規(guī)定了不允許從中斷調(diào)用該函數(shù)，但卩 C/OS- n仍然包含了檢測(cè)這種情況的功能。OS_ERR_EVENT_T YPE: p eve nt不是指向消息郵箱的指針。返回值OSMboxPend ()函數(shù)返回接受的消息并將*err置為OS_NO_ERR。如果沒(méi)

12、有在指定數(shù)目的時(shí)鐘節(jié)拍內(nèi)接受到需要的消息，OSMbox Pend ()函數(shù)返回空指針并且將*err設(shè)置為OS_TIMEOUT。注意/警告必須先建立消息郵箱，然后使用。 不允許從中斷調(diào)用該函數(shù)。范例:!-OS_EVENT *CommMbox;void CommTask(void *p data)INT8U err;void *msg;P data = P data;for (;) msg = OSMbox Pend(CommMbox, 10, & err);if (err = OS_NO_ERR) ./*消息正確的接受*/ else ./*在指定時(shí)間內(nèi)沒(méi)有接受到消息*/!-OSMbox

13、Post()INT8U OSMbox Post ( OS_EVENT *p eve nt, void *msg);所屬文件調(diào)用者開(kāi)關(guān)量OS MBOX.C任務(wù)或中斷OS MBOX EN函數(shù)立即返回調(diào)用者，消息也沒(méi)有能夠發(fā)到消息郵箱。如果有任何任務(wù)在等待 最高優(yōu)先級(jí)的任務(wù)將得到這個(gè)消息。如果等待消息的任務(wù)優(yōu)先級(jí)比發(fā)送消息 那么高優(yōu)先級(jí)的任務(wù)將得到消息而恢復(fù)執(zhí)行，也就是說(shuō)，發(fā)生了一次任務(wù)切OSMboxPost ()函數(shù)通過(guò)消息郵箱向任務(wù)發(fā)送消息。消息是一個(gè)指針長(zhǎng)度的變量，在不同的程 序中消息的使用也可能不同。如果消息郵箱中已經(jīng)存在消息，返回錯(cuò)誤碼說(shuō)明消息郵箱已滿。OSMboxPost ()消息郵箱的

14、消息， 的任務(wù)優(yōu)先級(jí)高， 換。參數(shù)peve nt是指向即將接受消息的消息郵箱的指針。該指針的值在建立該消息郵箱時(shí)可以得到。 (參考 OSMboxCreate ()函數(shù))。Msg是即將實(shí)際發(fā)送給任務(wù)的消息。消息是一個(gè)指針長(zhǎng)度的變量，在不同的程序中消息的使用 也可能不同。不允許傳遞一個(gè)空指針，因?yàn)檫@意味著消息郵箱為空。返回值OSMboxPost ()函數(shù)的返回值為下述之一：OS_NO_ERR :消息成功的放到消息郵箱中。OS_MBOX_FULL :消息郵箱已經(jīng)包含了其他消息，不空。OS_ERR_EVENT_T YPE: p eve nt不是指向消息郵箱的指針。注意/警告必須先建立消息郵箱，然后使用

15、。不允許傳遞一個(gè)空指針，因?yàn)檫@意味著消息郵箱為空。范例：OS_EVENT *CommMbox;INT8U CommRxBuf100;void CommTaskRx(void *p data)INT8U err;P data = P data;for (;) err = OSMbox Po st(CommMbox, (void *)&CommRxBuf0);OSMboxQuery()INT8U OSMboxQuery ( OS_EVENT *p eve nt, OS_MBOX_DATA *p data );所屬文件調(diào)用者開(kāi)關(guān)量OS MBOX.C任務(wù)或中斷OS MBOX ENOSMboxQ

16、uery()函數(shù)用來(lái)取得消息郵箱的信息。 用戶程序必須分配一個(gè) OS_MBOX_DATA的 數(shù)據(jù)結(jié)構(gòu)，該結(jié)構(gòu)用來(lái)從消息郵箱的事件控制塊接受數(shù)據(jù)。通過(guò)調(diào)用OSMboxQuery ()函數(shù)可以知道任務(wù)是否在等待消息以及有多少個(gè)任務(wù)在等待消息，還可以檢查消息郵箱現(xiàn)在的消息。參數(shù)pevent(參考是指向即將接受消息的消息郵箱的指針。該指針的值在建立該消息郵箱時(shí)可以得到。OSMboxCreate ()函數(shù))。P data是指向OS_MBOX_DATA數(shù)據(jù)結(jié)構(gòu)的指針，該數(shù)據(jù)結(jié)構(gòu)包含下述成員:Void *OSMsg;/*消息郵箱中消息的復(fù)制INT8U OSEve ntTblOS_EVENT_TBL_SIZE

17、;INT8U OSEventGrp ；*/*消息郵箱等待隊(duì)列的復(fù)制 */返回值OSMboxQuery ()函數(shù)的返回值為下述之一：OS_NO_ERR :調(diào)用成功OS_ERR_EVENT_T YPE: p eve nt不是指向消息郵箱的指針。注意/警告必須先建立消息郵箱，然后使用。范例：OS_EVENT *CommMbox;void Task (void *p data)OS_MBOXDATA mbox_data;INT8U err;p data = p data;for (;) err = OSMboxQuery(CommMbox, & mbox_data);if (err = OS_

18、NO_ERR) ./*如果mbox_data.OSMsg為非空指針，說(shuō)明消息郵箱非空*/!-OSMemCreate()OS_MEM *OSMemCreate( void *addr, INT32U n biks ,INT32U biksize, INT8U *err);所屬文件調(diào)用者開(kāi)關(guān)量OS MEM.C任務(wù)或初始代碼OS/MEM ENOSMemCreate ()函數(shù)建立并初始化一塊內(nèi)存區(qū)。一塊內(nèi)存區(qū)包含指定數(shù)目的大小確定的內(nèi)存 塊。程序可以包含這些內(nèi)存塊并在用完后釋放回內(nèi)存區(qū)。參數(shù)malloc ()函數(shù)addr 建立的內(nèi)存區(qū)的起始地址。內(nèi)存區(qū)可以使用靜態(tài)數(shù)組或在初始化時(shí)使用 建立。Nblks

19、BlksizeErr需要的內(nèi)存塊的數(shù)目。每一個(gè)內(nèi)存區(qū)最少需要定義兩個(gè)內(nèi)存塊。 每個(gè)內(nèi)存塊的大小，最少應(yīng)該能夠容納一個(gè)指針。是指向包含錯(cuò)誤碼的變量的指針。OSMemCreate。函數(shù)返回的錯(cuò)誤碼可能為下述幾種:成功建立內(nèi)存區(qū)。:沒(méi)有空閑的內(nèi)存區(qū)。:沒(méi)有為每一個(gè)內(nèi)存區(qū)建立至少兩個(gè)內(nèi)存塊。:內(nèi)存塊大小不足以容納一個(gè)指針變量。ERROS_NO.OS_MEM_INVOS_MEM_INVOS_MEM_INVALID PARTALID BLKSALID SIZE返回值OSMemCreate函數(shù)返回空指針。 注意/警告 必須首先建立內(nèi)存區(qū)，然后使用。 范例：()函數(shù)返回指向內(nèi)存區(qū)控制塊的指針。如果沒(méi)有剩余內(nèi)存

20、區(qū),OSMemCreate()OS_MEM *CommMem;INT8U CommBuf16128;void main(void)INT8U err;OSInit();/*初始化卩C/OS- n*/CommMem = OSMemCreate(&CommBuf00, 16, 128, &err);OSStartO;/*啟動(dòng)多任務(wù)內(nèi)核*/!-OSMemGet()Void *OSMemGet(OS_MEM *p mem, INT8U *err);所屬文件調(diào)用者開(kāi)關(guān)量OS MEM.C任務(wù)或中斷OS MEM ENOSMemGet ()函數(shù)用于從內(nèi)存區(qū)分配一個(gè)內(nèi)存塊。用戶程序必須知道所建立

21、的內(nèi)存塊的大小, 同時(shí)用戶程序必須在使用完內(nèi)存塊后釋放內(nèi)存塊?？梢远啻握{(diào)用OSMemGet ()函數(shù)。參數(shù)pmem是指向內(nèi)存區(qū)控制塊的指針，可以從 OSMemCreate ()函數(shù)返回得到。Err是指向包含錯(cuò)誤碼的變量的指針。OSMemGet (函數(shù)返回的錯(cuò)誤碼可能為下述幾種:OS_NO_ERR :成功得到一個(gè)內(nèi)存塊。 OS_MEM_NO_FREE_BLKS :內(nèi)存區(qū)已經(jīng)沒(méi)有空間分配給內(nèi)存塊。返回值OSMemGet ()函OSMemGet ()函數(shù)返回指向內(nèi)存區(qū)塊的指針。如果沒(méi)有空間分配給內(nèi)存塊，數(shù)返回空指針。注意/警告必須首先建立內(nèi)存區(qū)，然后使用。范例：OS_MEM *CommMem;voi

22、d Task (void *p data)INT8U *msg;P data = P data;for (;) msg = OSMemGet(CommMem, &err);內(nèi)存塊已經(jīng)分配*/if (msg != (INT8U *)0) . /*!-OSMe mPut()INT8U OSMem Put( OS_MEM *pm em, void *p bik);所屬文件調(diào)用者開(kāi)關(guān)量OS MEM.C任務(wù)或中斷OS MEM ENOSMemPut ()函數(shù)釋放一個(gè)內(nèi)存塊，內(nèi)存塊必須釋放回原先申請(qǐng)的內(nèi)存區(qū)。參數(shù)pmem 是指向內(nèi)存區(qū)控制塊的指針，可以從OSMemCreatePblk是指向?qū)⒈会尫诺?/p>

23、內(nèi)存塊的指針。()函數(shù)返回得到。返回值OSMemPut ()函數(shù)的返回值為下述之一：OS_NO_ERR :成功釋放內(nèi)存塊OS_MEM_FULL :內(nèi)存區(qū)已經(jīng)不能再接受更多釋放的內(nèi)存塊。 誤，釋放了多于用 OSMemGet ()函數(shù)得到的內(nèi)存塊。 注意/警告必須首先建立內(nèi)存區(qū)，然后使用。 內(nèi)存塊必須釋放回原先申請(qǐng)的內(nèi)存區(qū)。范例：OS_MEM *CommMem;INT8U *CommMsg;這種情況說(shuō)明用戶程序出現(xiàn)了錯(cuò)void Task (void *p data)INT8U err;p data = p data;for (;) err = OSMe mP ut(CommMem, (void *

24、)CommMsg); if (err = OS_NO_ERR) . /*釋放內(nèi)存塊*/!-OSMemQuery()INT8U OSMemQuery(OS_MEM *pmem, OS_MEM_DATA *p data);所屬文件調(diào)用者開(kāi)關(guān)量OS MEM.C任務(wù)或中斷OS MEM ENOSMemQuery ()函數(shù)得到內(nèi)存區(qū)的信息。該函數(shù)返回OS_MEM結(jié)構(gòu)包含的信息，但使用了一個(gè)新的OS_MEM_DATA的數(shù)據(jù)結(jié)構(gòu)。OS_MEM_DATA數(shù)據(jù)結(jié)構(gòu)還包含了正被使用的內(nèi)存塊數(shù) 目的域。參數(shù)pmem是指向內(nèi)存區(qū)控制塊的指針，可以從OSMemCreate ()函數(shù) 返回得到。Pdata是指向OS_MEM

25、_DA TA數(shù)據(jù)結(jié)構(gòu)的指針，該數(shù)據(jù)結(jié)構(gòu)包含了以下的域：VoidOSAddr;/*指向內(nèi)存區(qū)起始地址的指針*/VoidOSFreeList;/*指向空閑內(nèi)存塊列表起始地址的指針*/INT32UOSBlkSize;/*每個(gè)內(nèi)存塊的大小*/INT32UOSNBlks;/*該內(nèi)存區(qū)的內(nèi)存塊總數(shù)*/INT32UOSNFree;/*空閑的內(nèi)存塊數(shù)目*/INT32UOSNUsed;/*使用的內(nèi)存塊數(shù)目*/返回值OSMemQuery ()函數(shù)返回值總是 OS_NO_ERR。注意/警告必須首先建立內(nèi)存區(qū)，然后使用。范例：OS_MEM *CommMem;void Task (void *p data)INT8U

26、err;OS_MEM_DATA mem_data;p data = p data;for (;) err = OSMemQuery(CommMem, &mem_data);OSQAcce pt()Void *OSQAcce pt(OS_EVENT *p eve nt);所屬文件調(diào)用者開(kāi)關(guān)量OS Q.C任務(wù)或中斷OS Q ENOSQAccept ()函數(shù)檢查消息隊(duì)列中是否已經(jīng)有需要的消息。不同于OSQPend ()函數(shù)，如果沒(méi)有需要的消息，OSQAccept ()函數(shù)并不掛起任務(wù)。如果消息已經(jīng)到達(dá)，該消息被傳遞到用戶任務(wù)。通常中斷調(diào)用該函數(shù)，因?yàn)橹袛嗖辉试S掛起等待消息。參數(shù)當(dāng)建立消息隊(duì)列

27、時(shí)，該指針?lè)祷氐接脩舫绦颉?參考pevent是指向需要查看的消息隊(duì)列的指針。OSMboxCreate ()函數(shù))。返回值如果消息已經(jīng)到達(dá)，返回指向該消息的指針;如果消息隊(duì)列沒(méi)有消息，返回空指針。注意/警告必須先建立消息隊(duì)列，然后使用。范例:OS_EVENT *CommQ;void Task (void *p data)void *msg;p data = p data;for (;) msg = OSQAcce pt(CommQ);if (msg != (void *)0) . /*/*檢查消息隊(duì)列*/處理接受的消息*/ else /*沒(méi)有消息*/!-OSQCreate()OS_EVENT *

28、OSQCreate( void *start, INT8U size);所屬文件調(diào)用者開(kāi)關(guān)量OS Q.C任務(wù)或啟動(dòng)代碼OS Q ENOSQCreate()函數(shù)建立一個(gè)消息隊(duì)列。任務(wù)或中斷可以通過(guò)消息隊(duì)列向其他一個(gè)或多個(gè)任務(wù)發(fā)送消息。消息的含義是和具體的應(yīng)用密切相關(guān)的。參數(shù)start是消息內(nèi)存區(qū)的基地址，消息內(nèi)存區(qū)是一個(gè)指針數(shù)組。Size 是消息內(nèi)存區(qū)的大小。返回值OSQCreate ()函數(shù)返回一個(gè)指向消息隊(duì)列事件控制塊的指針。如果沒(méi)有空余的事件空閑塊, OSQCreate ()函數(shù)返回空指針。注意/警告必須先建立消息隊(duì)列，然后使用。范例：OS_EVENT *CommQ;void *CommM

29、sg10;void main(void)/*初始化卩C/OS- n */OSInit();CommQ = OSQCreate(&CommMsg0, 10);/*建立消息隊(duì)列*/OSStart();/*啟動(dòng)多任務(wù)內(nèi)核*/OSQFlush()INT8U *SOQFlush ( OS_EVENT *p eve nt);所屬文件調(diào)用者開(kāi)關(guān)量OS Q.C任務(wù)或中斷OS Q ENOSQFlush ()函數(shù)清空消息隊(duì)列并且忽略發(fā)送往隊(duì)列的所有消息。不管隊(duì)列中是否有消息，這 個(gè)函數(shù)的執(zhí)行時(shí)間都是相同的。參數(shù)(參考 OSQCreate ()peve nt 是指向消息隊(duì)列的指針。該指針的值在建立該隊(duì)列時(shí)可

30、以得到。 函數(shù))。返回值OSQFlush ()函數(shù)的返回值為下述之一：OS_NO_ERR :消息隊(duì)列被成功清空 OS_ERR_EVENT_T YPE :試圖清除不是消息隊(duì)列的對(duì)象注意/警告然后使用。必須先建立消息隊(duì)列，范例：OS_EVENT *CommQ;void main(void)INT8U err;OSInitO;/*初始化卩C/OS- n */err = OSQFIush(CommQ);OSStart();/*啟動(dòng)多任務(wù)內(nèi)核 */!-OSQ Pend()Void *OSQ Pend( OS_EVENT *p eve nt, INT16U timeout, INT8U *err);所屬文

31、件調(diào)用者開(kāi)關(guān)量OS Q.C任務(wù)OS Q ENOSQPend ()函數(shù)用于任務(wù)等待消息。消息通過(guò)中斷或另外的任務(wù)發(fā)送給需要的任務(wù)。消息是 一個(gè)以指針定義的變量，在不同的程序中消息的使用也可能不同。如果調(diào)用OSQPend ()函數(shù)時(shí)隊(duì)列中已經(jīng)存在需要的消息，那么該消息被返回給OSQPend ()函數(shù)的調(diào)用者，隊(duì)列中清除該消息。如果調(diào)用 OSQPend ()函數(shù)時(shí)隊(duì)列中沒(méi)有需要的消息，OSQPend ()函數(shù)掛起當(dāng)前任務(wù)直到得到需要的消息或超出定義的超時(shí)時(shí)間。如果同時(shí)有多個(gè)任務(wù)等待同一個(gè)消息，卩C/OS-n默認(rèn)最高優(yōu)先級(jí)的任務(wù)取得消息并且任務(wù)恢復(fù)執(zhí)行。一個(gè)由OSTaskSuspend ()函數(shù)掛起的

32、任務(wù)也可以接受消息，但這個(gè)任務(wù)將一直保持掛起狀態(tài)直到通過(guò)調(diào)用OSTaskResume ()函數(shù)恢復(fù)任務(wù)的運(yùn)行。參數(shù)(參考peve nt 是指向即將接受消息的隊(duì)列的指針。該指針的值在建立該隊(duì)列時(shí)可以得到。OSMboxCreate ()函數(shù))。Timeout 允許一個(gè)任務(wù)在經(jīng)過(guò)了指定數(shù)目的時(shí)鐘節(jié)拍后還沒(méi)有得到需要的消息時(shí)恢復(fù)運(yùn)行狀 態(tài)。如果該值為零表示任務(wù)將持續(xù)的等待消息。最大的等待時(shí)間為65535個(gè)時(shí)鐘節(jié)拍。這個(gè)時(shí)間長(zhǎng)度并不是非常嚴(yán)格的，可能存在一個(gè)時(shí)鐘節(jié)拍的誤差，因?yàn)橹挥性谝粋€(gè)時(shí)鐘節(jié)拍結(jié)束后才 會(huì)減少定義的等待超時(shí)時(shí)鐘節(jié)拍。Err是指向包含錯(cuò)誤碼的變量的指針。OSQPend ()函數(shù)返回的錯(cuò)誤

33、碼可能為下述幾種：OS_NO_ERR :消息被正確的接受。OS_TIMEOUT :消息沒(méi)有在指定的周期數(shù)內(nèi)送到。OS_ERR_PEND_ISR :從中斷調(diào)用該函數(shù)。雖然規(guī)定了不允許從中斷調(diào)用該函數(shù)，但卩 C/OS- n仍然包含了檢測(cè)這種情況的功能。OS_ERR_EVENT_T YPE: p eve nt不是指向消息隊(duì)列的指針。返回值OSQPend ()函數(shù)返回接受的消息并將 *err置為OS_NO_ERR。如果沒(méi)有在指定數(shù)目的時(shí)鐘節(jié) 拍內(nèi)接受到需要的消息， OSQPend ()函數(shù)返回空指針并且將 *err設(shè)置為OS_TIMEOUT。注意/警告必須先建立消息郵箱，然后使用。 不允許從中斷調(diào)用該

34、函數(shù)。范例：OS_EVENT *CommQ;!-void CommTask(void *data)INT8U err;void *msg;P data = P data;for (；) msg = OSQ Pend(CommQ, 100, &err); if (err = OS_NO_ERR) else /*在指定時(shí)間內(nèi)接受到消息*/*在指定的時(shí)間內(nèi)沒(méi)有接受到指定的消息*/!-OSQ Po st()INT8U OSQPo st(OS_EVENT *p eve nt, void *msg);所屬文件調(diào)用者開(kāi)關(guān)量OS Q.C任務(wù)或中斷OS Q ENOSQPost ()函數(shù)通過(guò)消息隊(duì)列向任務(wù)

35、發(fā)送消息。消息是一個(gè)指針長(zhǎng)度的變量，在不同的程序 中消息的使用也可能不同。如果隊(duì)列中已經(jīng)存滿消息，返回錯(cuò)誤碼。OSQPost ()函數(shù)立即返回調(diào)用者，消息也沒(méi)有能夠發(fā)到隊(duì)列。如果有任何任務(wù)在等待隊(duì)列中的消息，最高優(yōu)先級(jí)的任 務(wù)將得到這個(gè)消息。如果等待消息的任務(wù)優(yōu)先級(jí)比發(fā)送消息的任務(wù)優(yōu)先級(jí)高，那么高優(yōu)先級(jí)的 任務(wù)將得到消息而恢復(fù)執(zhí)行，也就是說(shuō)，發(fā)生了一次任務(wù)切換。消息隊(duì)列是先入先出(FIFO)機(jī)制的，先進(jìn)入隊(duì)列的消息先被傳遞給任務(wù)。參數(shù)peve nt是指向即將接受消息的消息隊(duì)列的指針。該指針的值在建立該隊(duì)列時(shí)可以得到。(參考OSQCreate ()函數(shù))。Msg是即將實(shí)際發(fā)送給任務(wù)的消息。消息是

36、一個(gè)指針長(zhǎng)度的變量，在不同的程序中消息的使用 也可能不同。不允許傳遞一個(gè)空指針。返回值OSQPost ()函數(shù)的返回值為下述之一：OS_NO_ERR :消息成功的放到消息隊(duì)列中。OS_MBOX_FULL :消息隊(duì)列已滿。 OS_ERR_EVENT_T YPE : p eve nt不是指向消息隊(duì)列的指針。注意/警告必須先建立消息隊(duì)列，然后使用。不允許傳遞一個(gè)空指針。范例:OS_EVENT *CommQ;INT8U CommRxBuf100;void CommTaskRx(void *p data)INT8U err;P data = p data;!-for (；) err = OSQ Po s

37、t(CommQ, (void *)&CommRxBuf0); if (err = OS_NO_ERR) else /*將消息放入消息隊(duì)列*/*消息隊(duì)列已滿*/!-OSQ Po stFro nt()INT8U OSQ PostFro nt(OS_EVENT *p eve nt, void *msg);所屬文件調(diào)用者開(kāi)關(guān)量OS Q.C任務(wù)或中斷OS Q ENOSQPostFront ()函數(shù)和 OSQPost ()OSQPostFront ()函數(shù)將發(fā)送的消息插到消息隊(duì)列的最前端。也LIFO )的方式工作，而不是先入 在不同的程序中消息的使用也可能不同。如果隊(duì)列OSQPost ()函數(shù)立即

38、返回調(diào)用者，消息也沒(méi)能發(fā)到隊(duì)列。女0 最高優(yōu)先級(jí)的任務(wù)將得到這個(gè)消息。如果等待消息的任務(wù) 那么高優(yōu)先級(jí)的任務(wù)將得到消息而恢復(fù)執(zhí)行，也就是說(shuō)，OSQPostFront ()函數(shù)通過(guò)消息隊(duì)列向任務(wù)發(fā)送消息。 函數(shù)非常相似，不同之處在于 就是說(shuō)，OSQPostFront ()函數(shù)使得消息隊(duì)列按照后入先出( 先出(FIFO)o消息是一個(gè)指針長(zhǎng)度的變量， 中已經(jīng)存滿消息，返回錯(cuò)誤碼。 果有任何任務(wù)在等待隊(duì)列中的消息， 優(yōu)先級(jí)比發(fā)送消息的任務(wù)優(yōu)先級(jí)高， 發(fā)生了一次任務(wù)切換參數(shù)peve nt是指向即將接受消息的消息隊(duì)列的指針。該指針的值在建立該隊(duì)列時(shí)可以得到。(參考OSQCreate ()函數(shù))。Msg是即

39、將實(shí)際發(fā)送給任務(wù)的消息。消息是一個(gè)指針長(zhǎng)度的變量，在不同的程序中消息的使用 也可能不同。不允許傳遞一個(gè)空指針。返回值OSQPost ()函數(shù)的返回值為下述之一：OS_NO_ERR :消息成功的放到消息隊(duì)列中。OS_MBOX_FULL :消息隊(duì)列已滿。 OS_ERR_EVENT_T YPE: p eve nt不是指向消息隊(duì)列的指針。注意/警告必須先建立消息隊(duì)列，然后使用。不允許傳遞一個(gè)空指針。范例：OS_EVENT *CommQ;INT8U CommRxBuf100;void CommTaskRx(void *p data)INT8U err;p data = p data;for (；) er

40、r = OSQ Po stFront(CommQ, (void *)&CommRxBuf0); if (err = OS_NO_ERR) /*將消息放入消息隊(duì)列*/ else /*消息隊(duì)列已滿*/OSQQuery()INT8U OSQQuery(OS_EVENT *p eve nt, OS_Q_DATA *p data);所屬文件調(diào)用者開(kāi)關(guān)量OS Q.C任務(wù)或中斷OS Q ENOSQQuery()函數(shù)用來(lái)取得消息隊(duì)列的信息。用戶程序必須建立一個(gè) OS_Q_DATA的數(shù)據(jù)結(jié)構(gòu),該結(jié)構(gòu)用來(lái)保存從消息隊(duì)列的事件控制塊得到的數(shù)據(jù)。通過(guò)調(diào)用OSQQuery ()函數(shù)可以知道任務(wù)是否在等待消息、有

41、多少個(gè)任務(wù)在等待消息、隊(duì)列中有多少消息以及消息隊(duì)列可以容納的 消息數(shù)。OSQQuery ()函數(shù)還可以得到即將被傳遞給任務(wù)的消息的信息。參數(shù)Pevent(參考是指向即將接受消息的消息郵箱的指針。該指針的值在建立該消息郵箱時(shí)可以得到。OSQCreate ()函數(shù))。P dataVoid*OSMsg;/*下一個(gè)可用的消息*/INT16UOSNMsgs ；/* 隊(duì)列中的消息數(shù)目*/INT16UOSQSize；/* 消息隊(duì)列的大小*/INT8UOSEve ntTblOS_EVENT_TBL_SIZE;/*消息隊(duì)列的等待隊(duì)列*/INT8UOSEve ntGrp ；是指向OS_Q_DATA數(shù)據(jù)結(jié)構(gòu)的指針，

42、該數(shù)據(jù)結(jié)構(gòu)包含下述成員:返回值OSQQuery ()OS NO ERR函數(shù)的返回值為下述之一：_ _:調(diào)用成功OS_ERR_EVENT_T YPE: p eve nt不是指向消息隊(duì)列的指針。注意/警告必須先建立消息隊(duì)列，然后使用。范例：OS_EVENT *CommQ;void Task (void *p data)OS_Q_DATA qdata;INT8U err;!-p data = p data;for (；) err = OSQQuery(CommQ, & qdata);if (err = OS_NO_ERR) ./*取得消息隊(duì)列的信息*/!-OSSchedLock()Void

43、OSSchedLock(void);所屬文件調(diào)用者開(kāi)關(guān)量OS CORE.C任務(wù)或中斷N/AOSSchedLock ()函數(shù)停止任務(wù)調(diào)度，只有使用配對(duì)的函數(shù)OSSchedUniock ()才能重新開(kāi)始內(nèi)核的任務(wù)調(diào)度。調(diào)用OSSchedLock ()函數(shù)的任務(wù)獨(dú)占 CPU,不管有沒(méi)有其他高優(yōu)先級(jí)的就緒任務(wù)。在這種情況下，中斷仍然可以被接受和執(zhí)行(中斷必須允許)。OSSchedLock ()函數(shù)和OSSchedUniock ()函數(shù)必須配對(duì)使用。卩C/OS- n可以支持多達(dá) 254層的OSSchedLock ()函數(shù)嵌套，必須調(diào)用同樣次數(shù)的OSSchedUniock ()函數(shù)才能恢復(fù)任務(wù)調(diào)度。參數(shù)無(wú)

44、返回值無(wú)注意/警告任務(wù)調(diào)用了 OSSchedLock ()函數(shù)后，決不能再調(diào)用可能導(dǎo)致當(dāng)前任務(wù)掛起的系統(tǒng)函數(shù)：其他任務(wù)不能運(yùn)行，這會(huì)導(dǎo)致系統(tǒng)死鎖。OSTimeDly () , OSTimeDlyHMSM () , OSSemPend () , OSMboxPend () , OSQPend ()。因 為任務(wù)調(diào)度已經(jīng)被禁止，范例:void TaskX(void *p data) p data = p data;for (;) OSSchedLockO;/*停止任務(wù)調(diào)度 */*不允許被打斷的執(zhí)行代碼*/OSSchedUnlockO;/*恢復(fù)任務(wù)調(diào)度*/OSSchedU nl ock()Void O

45、SSchedU nlock(void);所屬文件調(diào)用者開(kāi)關(guān)量OS CORE.C任務(wù)或中斷N/A在調(diào)用了 OSSchedLock ()函數(shù)后，OSSchedUniock ()函數(shù)恢復(fù)任務(wù)調(diào)度。參數(shù)無(wú)返回值無(wú)注意/警告任務(wù)調(diào)用了 OSSchedLock ()函數(shù)后，決不能再調(diào)用可能導(dǎo)致當(dāng)前任務(wù)掛起的系統(tǒng)函數(shù)：其他任務(wù)不能運(yùn)行，這會(huì)導(dǎo)致系統(tǒng)死鎖。OSTimeDly ()，OSTimeDlyHMSM ()，OSSemPend()，OSMboxPend()，OSQPend ()。因 為任務(wù)調(diào)度已經(jīng)被禁止，范例:void TaskX(void *p data) p data = p data;for (;

46、) OSSchedLock();/*停止任務(wù)調(diào)度*/*不允許被打斷的執(zhí)行代碼*/OSSchedUnlockO;/*恢復(fù)任務(wù)調(diào)度*/!-OSSemAcce pt()INT16U *OSSemAcce pt (OS_EVENT *p eve nt );所屬文件調(diào)用者開(kāi)關(guān)量OS SEM.C任務(wù)或中斷OS SEM ENOSSemAccept ()函數(shù)查看設(shè)備是否就緒或事件是否發(fā)生。不同于 OSSemPend ()函數(shù)，如果 設(shè)備沒(méi)有就緒，OSSemAccept ()函數(shù)并不掛起任務(wù)。中斷調(diào)用該函數(shù)來(lái)查詢(xún)信號(hào)量。參數(shù)pevent是指向需要查詢(xún)的設(shè)備的信號(hào)量。當(dāng)建立信號(hào)量時(shí)，該指針?lè)祷氐接脩舫绦?。OSSe

47、mCreate ()函數(shù))。(參考返回值當(dāng)調(diào)用OSSemAccept ()函數(shù)時(shí)，設(shè)備信號(hào)量的值大于零，說(shuō)明設(shè)備就緒，這個(gè)值被返回調(diào)用 者，設(shè)備信號(hào)量的值減一。如果調(diào)用OSSemAccept ()函數(shù)時(shí)，設(shè)備信號(hào)量的值等于零，說(shuō)明設(shè)備沒(méi)有就緒，返回零。注意/警告必須先建立信號(hào)量，然后使用。范例：OS_EVENT *Dis pSem;void Task (void *p data)INT16U value;P data = P data;for (;) value = OSSemAcce pt(Dis pSem); /*if (value > 0) 查看設(shè)備是否就緒或事件是否發(fā)生*/*就緒

48、，執(zhí)行處理代碼*/!-OSSemCreate()OS_EVENT *OSSemCreate ( WORD value);所屬文件調(diào)用者開(kāi)關(guān)量OS SEM.C任務(wù)或啟動(dòng)代碼OS SEM ENOSSemCreate ()函數(shù)建立并初始化一個(gè)信號(hào)量。信號(hào)量的作用如下: 允許一個(gè)任務(wù)和其他任務(wù)或者中斷同步。取得設(shè)備的使用權(quán)標(biāo)志事件的發(fā)生參數(shù)0到65535之間的任何值。value參數(shù)是建立的信號(hào)量的初始值，可以取返回值如果沒(méi)有可用的OSSemCreate()函數(shù)返回指向分配給所建立的消息郵箱的事件控制塊的指針。 事件控制塊，OSSemCreate ()函數(shù)返回空指針。注意/警告必須先建立信號(hào)量，然后使用

49、。范例：OS_EVENT *Dis pSemvoid main(void)OSInitO;/*初始化卩C/OS- n*/Dis pSem = OSSemCreate(1);/*建立顯示設(shè)備的信號(hào)量*/*啟動(dòng)多任務(wù)內(nèi)核*/OSStart();!-void Disp Task(void *p data)OSSe mPend()Void OSSe mPend ( OS_EVNNT *p eve nt, INT16U timeout, in t8u *err );所屬文件調(diào)用者開(kāi)關(guān)量OS SEM.C任務(wù)OS SEM ENOSSemPend ()函數(shù)用于任務(wù)試圖取得設(shè)備的使用權(quán)，任務(wù)需要和其他任務(wù)或中斷同步，任務(wù) 需要等待特定事件的發(fā)生的場(chǎng)合。如果任務(wù)調(diào)用OSSemPend ()函數(shù)時(shí)，信號(hào)量的值大于零，OSSemPend ()函數(shù)遞減該值并返回該值。如果調(diào)用時(shí)信號(hào)量等于零，OSSemPend ()函數(shù)函數(shù)將任務(wù)加入該信號(hào)量的等待隊(duì)列。置起信號(hào)量或超出等待的預(yù)期時(shí)間。OSSemPend ()函數(shù)掛起當(dāng)前任務(wù)直到其他的