歡迎來到裝配圖網! | 幫助中心 裝配圖網zhuangpeitu.com!
裝配圖網
ImageVerifierCode 換一換
首頁 裝配圖網 > 資源分類 > DOC文檔下載  

第11章 API 參考手冊.doc

  • 資源ID:1574651       資源大小:683KB        全文頁數(shù):59頁
  • 資源格式: DOC        下載積分:5積分
快捷下載 游客一鍵下載
會員登錄下載
微信登錄下載
三方登錄下載: 微信開放平臺登錄 支付寶登錄   QQ登錄   微博登錄  
二維碼
微信掃一掃登錄
下載資源需要5積分
郵箱/手機:
溫馨提示:
用戶名和密碼都是您填寫的郵箱或者手機號,方便查詢和重復下載(系統(tǒng)自動生成)
支付方式: 支付寶    微信支付   
驗證碼:   換一換

 
賬號:
密碼:
驗證碼:   換一換
  忘記密碼?
    
友情提示
2、PDF文件下載后,可能會被瀏覽器默認打開,此種情況可以點擊瀏覽器菜單,保存網頁到桌面,就可以正常下載了。
3、本站不支持迅雷下載,請使用電腦自帶的IE瀏覽器,或者360瀏覽器、谷歌瀏覽器下載即可。
4、本站資源下載后的文檔和圖紙-無水印,預覽文檔經過壓縮,下載后原文更清晰。
5、試題試卷類文檔,如果標題沒有明確說明有答案則都視為沒有答案,請知曉。

第11章 API 參考手冊.doc

參考手冊-321OSInit( )第11章參考手冊本章提供了C/OS-的用戶指南。每一個用戶可以調用的內核函數(shù)都按字母順序加以說明,包括:l 函數(shù)的功能描述l 函數(shù)原型l 函數(shù)名稱及源代碼l 函數(shù)使用到的常量l 函數(shù)參數(shù)l 函數(shù)返回值l 特殊說明和注意點Void OSInit(void);所屬文件調用者開關量OS_CORE.C啟動代碼無OSinit()初始化C/OS-,對這個函數(shù)的調用必須在調用OSStart()函數(shù)之前,而OSStart()函數(shù)真正開始運行多任務。參數(shù)無返回值無注意/警告必須先于OSStart()函數(shù)的調用范例:void main (void) . OSInit(); /* 初始化 uC/OS-II */ . OSStart(); /*啟動多任務內核 */OSIntEnter( )Void OSIntEnter(void);所屬文件調用者開關量OS_CORE.C中斷無OSIntEnter()通知C/OS-一個中斷處理函數(shù)正在執(zhí)行,這有助于C/OS-掌握中斷嵌套的情況。OSIntEnter()函數(shù)通常和OSIntExit()函數(shù)聯(lián)合使用。參數(shù)無返回值無注意/警告在任務級不能調用該函數(shù)。如果系統(tǒng)使用的處理器能夠執(zhí)行自動的獨立執(zhí)行讀取-修改-寫入的操作,那么就可以直接遞增中斷嵌套層數(shù)(OSIntNesting),這樣可以避免調用函數(shù)所帶來的額外的開銷。范例一:(Intel 80x86的實模式, 在大模式下編譯,real mode,large model) ISRx PROC FAR PUSHA ; 保存中斷現(xiàn)場 PUSH ES PUSH DS; MOV AX, DGROUP ; 讀入數(shù)據(jù)段 MOV DS, AX; CALL FAR PTR _OSIntEnter ; 通知內核進入中斷 . . POP DS ; 恢復中斷現(xiàn)場 POP ES POPA IRET ; 中斷返回 ISRx ENDP范例二:(Intel 80x86的實模式, 在大模式下編譯,, real mode , large model) ISRx PROC FAR PUSHA ; 保存中斷現(xiàn)場 PUSH ES PUSH DS; MOV AX, DGROUP ; 讀入數(shù)據(jù)段 MOV DS, AX; INC BYTE PTR _OSIntNesting ; 通知內核進入中斷 . . . POP DS ; 恢復中斷現(xiàn)場 POP ES POPA IRET ; 中斷返回 ISRx ENDPOSIntExit( )Void OSIntExit(void);所屬文件調用者開關量OS_CORE.C中斷無OSIntExit()通知C/OS-一個中斷服務已執(zhí)行完畢,這有助于C/OS-掌握中斷嵌套的情況。通常OSIntExit()和OSIntEnter()聯(lián)合使用。當最后一層嵌套的中斷執(zhí)行完畢后,如果有更高優(yōu)先級的任務準備就緒,C/OS-會調用任務調度函數(shù),在這種情況下,中斷返回到更高優(yōu)先級的任務而不是被中斷了的任務。參數(shù)無返回值無注意/警告在任務級不能調用該函數(shù)。并且即使沒有調用OSIntEnter()而是使用直接遞增OSIntNesting的方法,也必須調用OSIntExit()函數(shù)。范例:(Intel 80x86 的實模式, 在大模式下編譯, real mode , large model) ISRx PROC FAR PUSHA ; 保存中斷現(xiàn)場 PUSH ES PUSH DS . . CALL FAR PTR _OSIntExit ; 通知內核進入中斷 POP DS ; 恢復中斷現(xiàn)場 POP ES POPA IRET ; 中斷返回 ISRx ENDPOSMboxAccept( )Void *OSMboxAccept(OS_EVENT *pevent);所屬文件調用者開關量OS_MBOX.C任務或中斷OS_MBOX_ENOSMboxAccept()函數(shù)查看指定的消息郵箱是否有需要的消息。不同于OSMboxPend()函數(shù),如果沒有需要的消息,OSMboxAccept()函數(shù)并不掛起任務。如果消息已經到達,該消息被傳遞到用戶任務并且從消息郵箱中清除。通常中斷調用該函數(shù),因為中斷不允許掛起等待消息。參數(shù)pevent 是指向需要查看的消息郵箱的指針。當建立消息郵箱時,該指針返回到用戶程序。(參考OSMboxCreate()函數(shù))。返回值如果消息已經到達,返回指向該消息的指針;如果消息郵箱沒有消息,返回空指針。注意/警告必須先建立消息郵箱,然后使用。范例:OS_EVENT *CommMbox;void Task (void *pdata) void *msg; pdata = pdata; for (;) msg = OSMboxAccept(CommMbox); /* 檢查消息郵箱是否有消息*/ if (msg != (void *)0) . /* 處理消息*/ . else . /*沒有消息*/ . . . OSMboxCreate( )OS_EVENT *OSMboxCreate(void *msg);所屬文件調用者開關量OS_MBOX.C任務或啟動代碼OS_MBOX_ENOSMboxCreate()建立并初始化一個消息郵箱。消息郵箱允許任務或中斷向其他一個或幾個任務發(fā)送消息。參數(shù)msg 參數(shù)用來初始化建立的消息郵箱。如果該指針不為空,建立的消息郵箱將含有消息。返回值指向分配給所建立的消息郵箱的事件控制塊的指針。如果沒有可用的事件控制塊,返回空指針。注意/警告必須先建立消息郵箱,然后使用。范例:OS_EVENT *CommMbox; void main(void) . . OSInit(); /* 初始化C/OS- */ . . CommMbox = OSMboxCreate(void *)0); /* 建立消息郵箱 */ OSStart(); /* 啟動多任務內核 */OSMboxPend( )Void *OSMboxPend ( OS_EVNNT *pevent, INT16U timeout, int8u *err );所屬文件調用者開關量OS_MBOX.C任務OS_MBOX_ENOSMboxPend()用于任務等待消息。消息通過中斷或另外的任務發(fā)送給需要的任務。消息是一個以指針定義的變量,在不同的程序中消息的使用也可能不同。如果調用OSMboxPend()函數(shù)時消息郵箱已經存在需要的消息,那么該消息被返回給OSMboxPend()的調用者,消息郵箱中清除該消息。如果調用OSMboxPend()函數(shù)時消息郵箱中沒有需要的消息,OSMboxPend()函數(shù)掛起當前任務直到得到需要的消息或超出定義等待超時的時間。如果同時有多個任務等待同一個消息,C/OS-默認最高優(yōu)先級的任務取得消息并且任務恢復執(zhí)行。一個由OSTaskSuspend()函數(shù)掛起的任務也可以接受消息,但這個任務將一直保持掛起狀態(tài)直到通過調用OSTaskResume()函數(shù)恢復任務的運行。參數(shù)pevent 是指向即將接受消息的消息郵箱的指針。該指針的值在建立該消息郵箱時可以得到。(參考OSMboxCreate()函數(shù))。Timeout 允許一個任務在經過了指定數(shù)目的時鐘節(jié)拍后還沒有得到需要的消息時恢復運行。如果該值為零表示任務將持續(xù)的等待消息。最大的等待時間為65,535個時鐘節(jié)拍。這個時間長度并不是非常嚴格的,可能存在一個時鐘節(jié)拍的誤差,因為只有在一個時鐘節(jié)拍結束后才會減少定義的等待超時時鐘節(jié)拍。Err 是指向包含錯誤碼的變量的指針。OSMboxPend()函數(shù)返回的錯誤碼可能為下述幾種:l OS_NO_ERR :消息被正確的接受。l OS_TIMEOUT :消息沒有在指定的周期數(shù)內送到。l OS_ERR_PEND_ISR :從中斷調用該函數(shù)。雖然規(guī)定了不允許從中斷調用該函數(shù),但C/OS-仍然包含了檢測這種情況的功能。l OS_ERR_EVENT_TYPE :pevent 不是指向消息郵箱的指針。返回值OSMboxPend()函數(shù)返回接受的消息并將 *err置為OS_NO_ERR。如果沒有在指定數(shù)目的時鐘節(jié)拍內接受到需要的消息,OSMboxPend()函數(shù)返回空指針并且將 *err設置為OS_TIMEOUT。注意/警告必須先建立消息郵箱,然后使用。不允許從中斷調用該函數(shù)。范例:OS_EVENT *CommMbox;void CommTask(void *pdata) INT8U err; void *msg; pdata = pdata; for (;) . . msg = OSMboxPend(CommMbox, 10, &err); if (err = OS_NO_ERR) . . /* 消息正確的接受 */ . else . . /* 在指定時間內沒有接受到消息*/ . . . OSMboxPost( )INT8U OSMboxPost(OS_EVENT *pevent, void *msg);所屬文件調用者開關量OS_MBOX.C任務或中斷OS_MBOX_ENOSMboxPost()函數(shù)通過消息郵箱向任務發(fā)送消息。消息是一個指針長度的變量,在不同的程序中消息的使用也可能不同。如果消息郵箱中已經存在消息,返回錯誤碼說明消息郵箱已滿。OSMboxPost()函數(shù)立即返回調用者,消息也沒有能夠發(fā)到消息郵箱。如果有任何任務在等待消息郵箱的消息,最高優(yōu)先級的任務將得到這個消息。如果等待消息的任務優(yōu)先級比發(fā)送消息的任務優(yōu)先級高,那么高優(yōu)先級的任務將得到消息而恢復執(zhí)行,也就是說,發(fā)生了一次任務切換。參數(shù)pevent 是指向即將接受消息的消息郵箱的指針。該指針的值在建立該消息郵箱時可以得到。(參考OSMboxCreate()函數(shù))。Msg 是即將實際發(fā)送給任務的消息。消息是一個指針長度的變量,在不同的程序中消息的使用也可能不同。不允許傳遞一個空指針,因為這意味著消息郵箱為空。返回值OSMboxPost()函數(shù)的返回值為下述之一:l OS_NO_ERR :消息成功的放到消息郵箱中。l OS_MBOX_FULL :消息郵箱已經包含了其他消息,不空。l OS_ERR_EVENT_TYPE :pevent 不是指向消息郵箱的指針。注意/警告必須先建立消息郵箱,然后使用。不允許傳遞一個空指針,因為這意味著消息郵箱為空。范例:OS_EVENT *CommMbox;INT8U CommRxBuf100;void CommTaskRx(void *pdata) INT8U err; pdata = pdata; for (;) . err = OSMboxPost(CommMbox, (void *)&CommRxBuf0); . OSMboxQuery( )INT8U OSMboxQuery(OS_EVENT *pevent, OS_MBOX_DATA *pdata);所屬文件調用者開關量OS_MBOX.C任務或中斷OS_MBOX_ENOSMboxQuery()函數(shù)用來取得消息郵箱的信息。用戶程序必須分配一個OS_MBOX_DATA的數(shù)據(jù)結構,該結構用來從消息郵箱的事件控制塊接受數(shù)據(jù)。通過調用OSMboxQuery()函數(shù)可以知道任務是否在等待消息以及有多少個任務在等待消息,還可以檢查消息郵箱現(xiàn)在的消息。參數(shù)pevent 是指向即將接受消息的消息郵箱的指針。該指針的值在建立該消息郵箱時可以得到。(參考OSMboxCreate()函數(shù))。Pdata 是指向OS_MBOX_DATA數(shù)據(jù)結構的指針,該數(shù)據(jù)結構包含下述成員:Void *OSMsg;/* 消息郵箱中消息的復制 */INT8U OSEventTblOS_EVENT_TBL_SIZE;/*消息郵箱等待隊列的復制*/INT8U OSEventGrp;返回值OSMboxQuery()函數(shù)的返回值為下述之一:l OS_NO_ERR :調用成功l OS_ERR_EVENT_TYPE :pevent 不是指向消息郵箱的指針。注意/警告必須先建立消息郵箱,然后使用。范例:OS_EVENT *CommMbox;void Task (void *pdata) OS_MBOXDATA mbox_data; INT8U err; pdata = pdata; for (;) . err = OSMboxQuery(CommMbox, &mbox_data); if (err = OS_NO_ERR) . /* 如果mbox_data.OSMsg為非空指針,說明消息郵箱非空*/ . OSMemCreate( )OS_MEM *OSMemCreate( void *addr, INT32U nblks ,INT32U blksize, INT8U *err);所屬文件調用者開關量OS_MEM.C任務或初始代碼OS_/MEM_ENOSMemCreate()函數(shù)建立并初始化一塊內存區(qū)。一塊內存區(qū)包含指定數(shù)目的大小確定的內存塊。程序可以包含這些內存塊并在用完后釋放回內存區(qū)。參數(shù)addr 建立的內存區(qū)的起始地址。內存區(qū)可以使用靜態(tài)數(shù)組或在初始化時使用malloc()函數(shù)建立。Nblks 需要的內存塊的數(shù)目。每一個內存區(qū)最少需要定義兩個內存塊。Blksize 每個內存塊的大小,最少應該能夠容納一個指針。Err 是指向包含錯誤碼的變量的指針。OSMemCreate()函數(shù)返回的錯誤碼可能為下述幾種:OS_NO_ERR :成功建立內存區(qū)。OS_MEM_INVALID_PART :沒有空閑的內存區(qū)。OS_MEM_INVALID_BLKS :沒有為每一個內存區(qū)建立至少兩個內存塊。OS_MEM_INVALID_SIZE :內存塊大小不足以容納一個指針變量。返回值OSMemCreate()函數(shù)返回指向內存區(qū)控制塊的指針。如果沒有剩余內存區(qū),OSMemCreate()函數(shù)返回空指針。注意/警告必須首先建立內存區(qū),然后使用。范例:OS_MEM *CommMem;INT8U CommBuf16128;void main(void) INT8U err; OSInit(); /* 初始化C/OS- */ . CommMem = OSMemCreate(&CommBuf00, 16, 128, &err); . OSStart(); /* 啟動多任務內核 */OSMemGet( )Void *OSMemGet(OS_MEM *pmem, INT8U *err);所屬文件調用者開關量OS_MEM.C任務或中斷OS_MEM_ENOSMemGet()函數(shù)用于從內存區(qū)分配一個內存塊。用戶程序必須知道所建立的內存塊的大小,同時用戶程序必須在使用完內存塊后釋放內存塊??梢远啻握{用OSMemGet()函數(shù)。參數(shù)pmem 是指向內存區(qū)控制塊的指針,可以從OSMemCreate()函數(shù)返回得到。Err 是指向包含錯誤碼的變量的指針。OSMemGet(函數(shù)返回的錯誤碼可能為下述幾種:l OS_NO_ERR :成功得到一個內存塊。l OS_MEM_NO_FREE_BLKS :內存區(qū)已經沒有空間分配給內存塊。返回值OSMemGet()函數(shù)返回指向內存區(qū)塊的指針。如果沒有空間分配給內存塊,OSMemGet()函數(shù)返回空指針。注意/警告必須首先建立內存區(qū),然后使用。范例:OS_MEM *CommMem;void Task (void *pdata) INT8U *msg; pdata = pdata; for (;) msg = OSMemGet(CommMem, &err); if (msg != (INT8U *)0) . /* 內存塊已經分配 */ . . OSMemPut( )INT8U OSMemPut( OS_MEM *pmem, void *pblk);所屬文件調用者開關量OS_MEM.C任務或中斷OS_MEM_ENOSMemPut()函數(shù)釋放一個內存塊,內存塊必須釋放回原先申請的內存區(qū)。參數(shù)pmem 是指向內存區(qū)控制塊的指針,可以從OSMemCreate()函數(shù) 返回得到。Pblk 是指向將被釋放的內存塊的指針。返回值OSMemPut()函數(shù)的返回值為下述之一:OS_NO_ERR :成功釋放內存塊OS_MEM_FULL :內存區(qū)已經不能再接受更多釋放的內存塊。這種情況說明用戶程序出現(xiàn)了錯誤,釋放了多于用OSMemGet()函數(shù)得到的內存塊。注意/警告必須首先建立內存區(qū),然后使用。內存塊必須釋放回原先申請的內存區(qū)。范例:OS_MEM *CommMem;INT8U *CommMsg;void Task (void *pdata) INT8U err; pdata = pdata; for (;) err = OSMemPut(CommMem, (void *)CommMsg); if (err = OS_NO_ERR) . /* 釋放內存塊 */ . OSMemQuery( )INT8U OSMemQuery(OS_MEM *pmem, OS_MEM_DATA *pdata);所屬文件調用者開關量OS_MEM.C任務或中斷OS_MEM_ENOSMemQuery()函數(shù)得到內存區(qū)的信息。該函數(shù)返回OS_MEM結構包含的信息,但使用了一個新的OS_MEM_DATA的數(shù)據(jù)結構。OS_MEM_DATA數(shù)據(jù)結構還包含了正被使用的內存塊數(shù)目的域。參數(shù)pmem 是指向內存區(qū)控制塊的指針,可以從OSMemCreate()函數(shù) 返回得到。Pdata 是指向OS_MEM_DATA數(shù)據(jù)結構的指針,該數(shù)據(jù)結構包含了以下的域:Void OSAddr;/*指向內存區(qū)起始地址的指針*/VoidOSFreeList;/*指向空閑內存塊列表起始地址的指針*/INT32UOSBlkSize;/*每個內存塊的大小*/INT32UOSNBlks;/*該內存區(qū)的內存塊總數(shù)*/INT32UOSNFree;/*空閑的內存塊數(shù)目*/INT32UOSNUsed; /*使用的內存塊數(shù)目*/返回值OSMemQuery()函數(shù)返回值總是OS_NO_ERR。注意/警告必須首先建立內存區(qū),然后使用。范例:OS_MEM *CommMem;void Task (void *pdata) INT8U err; OS_MEM_DATA mem_data; pdata = pdata; for (;) . err = OSMemQuery(CommMem, &mem_data); . OSQAccept( )Void *OSQAccept(OS_EVENT *pevent);所屬文件調用者開關量OS_Q.C任務或中斷OS_Q_ENOSQAccept()函數(shù)檢查消息隊列中是否已經有需要的消息。不同于OSQPend()函數(shù),如果沒有需要的消息,OSQAccept()函數(shù)并不掛起任務。如果消息已經到達,該消息被傳遞到用戶任務。通常中斷調用該函數(shù),因為中斷不允許掛起等待消息。參數(shù)pevent 是指向需要查看的消息隊列的指針。當建立消息隊列時,該指針返回到用戶程序。(參考OSMboxCreate()函數(shù))。返回值如果消息已經到達,返回指向該消息的指針;如果消息隊列沒有消息,返回空指針。注意/警告必須先建立消息隊列,然后使用。范例:OS_EVENT *CommQ;void Task (void *pdata) void *msg; pdata = pdata; for (;) msg = OSQAccept(CommQ); /* 檢查消息隊列 */ if (msg != (void *)0) . /* 處理接受的消息 */ . else . /* 沒有消息 */ . OSQCreate( )OS_EVENT *OSQCreate( void *start, INT8U size);所屬文件調用者開關量OS_Q.C任務或啟動代碼OS_Q_ENOSQCreate()函數(shù)建立一個消息隊列。任務或中斷可以通過消息隊列向其他一個或多個任務發(fā)送消息。消息的含義是和具體的應用密切相關的。參數(shù)start 是消息內存區(qū)的基地址,消息內存區(qū)是一個指針數(shù)組。Size 是消息內存區(qū)的大小。返回值OSQCreate()函數(shù)返回一個指向消息隊列事件控制塊的指針。如果沒有空余的事件空閑塊,OSQCreate()函數(shù)返回空指針。注意/警告必須先建立消息隊列,然后使用。范例:OS_EVENT *CommQ;void *CommMsg10;void main(void) OSInit(); /* 初始化C/OS- */ . . CommQ = OSQCreate(&CommMsg0, 10); /*建立消息隊列 */ . OSStart(); /* 啟動多任務內核 */OSQFlush( )INT8U *SOQFlush(OS_EVENT *pevent);所屬文件調用者開關量OS_Q.C任務或中斷OS_Q_ENOSQFlush()函數(shù)清空消息隊列并且忽略發(fā)送往隊列的所有消息。不管隊列中是否有消息,這個函數(shù)的執(zhí)行時間都是相同的。參數(shù)pevent 是指向消息隊列的指針。該指針的值在建立該隊列時可以得到。(參考OSQCreate()函數(shù))。返回值OSQFlush()函數(shù)的返回值為下述之一:l OS_NO_ERR :消息隊列被成功清空l OS_ERR_EVENT_TYPE :試圖清除不是消息隊列的對象注意/警告必須先建立消息隊列,然后使用。范例:OS_EVENT *CommQ;void main(void) INT8U err; OSInit(); /* 初始化C/OS- */ . err = OSQFlush(CommQ); . OSStart(); /* 啟動多任務內核 */OSQPend( )Void *OSQPend( OS_EVENT *pevent, INT16U timeout, INT8U *err);所屬文件調用者開關量OS_Q.C任務OS_Q_ENOSQPend()函數(shù)用于任務等待消息。消息通過中斷或另外的任務發(fā)送給需要的任務。消息是一個以指針定義的變量,在不同的程序中消息的使用也可能不同。如果調用OSQPend()函數(shù)時隊列中已經存在需要的消息,那么該消息被返回給OSQPend()函數(shù)的調用者,隊列中清除該消息。如果調用OSQPend()函數(shù)時隊列中沒有需要的消息,OSQPend()函數(shù)掛起當前任務直到得到需要的消息或超出定義的超時時間。如果同時有多個任務等待同一個消息,C/OS-默認最高優(yōu)先級的任務取得消息并且任務恢復執(zhí)行。一個由OSTaskSuspend()函數(shù)掛起的任務也可以接受消息,但這個任務將一直保持掛起狀態(tài)直到通過調用OSTaskResume()函數(shù)恢復任務的運行。參數(shù)pevent 是指向即將接受消息的隊列的指針。該指針的值在建立該隊列時可以得到。(參考OSMboxCreate()函數(shù))。Timeout 允許一個任務在經過了指定數(shù)目的時鐘節(jié)拍后還沒有得到需要的消息時恢復運行狀態(tài)。如果該值為零表示任務將持續(xù)的等待消息。最大的等待時間為65535個時鐘節(jié)拍。這個時間長度并不是非常嚴格的,可能存在一個時鐘節(jié)拍的誤差,因為只有在一個時鐘節(jié)拍結束后才會減少定義的等待超時時鐘節(jié)拍。Err 是指向包含錯誤碼的變量的指針。OSQPend()函數(shù)返回的錯誤碼可能為下述幾種:l OS_NO_ERR :消息被正確的接受。l OS_TIMEOUT :消息沒有在指定的周期數(shù)內送到。l OS_ERR_PEND_ISR :從中斷調用該函數(shù)。雖然規(guī)定了不允許從中斷調用該函數(shù),但C/OS-仍然包含了檢測這種情況的功能。l OS_ERR_EVENT_TYPE :pevent 不是指向消息隊列的指針。返回值OSQPend()函數(shù)返回接受的消息并將 *err置為OS_NO_ERR。如果沒有在指定數(shù)目的時鐘節(jié)拍內接受到需要的消息,OSQPend()函數(shù)返回空指針并且將 *err設置為OS_TIMEOUT。注意/警告必須先建立消息郵箱,然后使用。不允許從中斷調用該函數(shù)。范例:OS_EVENT *CommQ;void CommTask(void *data) INT8U err; void *msg; pdata = pdata; for (;) . . msg = OSQPend(CommQ, 100, &err); if (err = OS_NO_ERR) . . /* 在指定時間內接受到消息 */ . else . . /* 在指定的時間內沒有接受到指定的消息 */ . OSQPost( )INT8U OSQPost(OS_EVENT *pevent, void *msg);所屬文件調用者開關量OS_Q.C任務或中斷OS_Q_ENOSQPost()函數(shù)通過消息隊列向任務發(fā)送消息。消息是一個指針長度的變量,在不同的程序中消息的使用也可能不同。如果隊列中已經存滿消息,返回錯誤碼。OSQPost()函數(shù)立即返回調用者,消息也沒有能夠發(fā)到隊列。如果有任何任務在等待隊列中的消息,最高優(yōu)先級的任務將得到這個消息。如果等待消息的任務優(yōu)先級比發(fā)送消息的任務優(yōu)先級高,那么高優(yōu)先級的任務將得到消息而恢復執(zhí)行,也就是說,發(fā)生了一次任務切換。消息隊列是先入先出(FIFO)機制的,先進入隊列的消息先被傳遞給任務。參數(shù)pevent 是指向即將接受消息的消息隊列的指針。該指針的值在建立該隊列時可以得到。(參考OSQCreate()函數(shù))。Msg 是即將實際發(fā)送給任務的消息。消息是一個指針長度的變量,在不同的程序中消息的使用也可能不同。不允許傳遞一個空指針。返回值OSQPost()函數(shù)的返回值為下述之一:l OS_NO_ERR :消息成功的放到消息隊列中。l OS_MBOX_FULL :消息隊列已滿。l OS_ERR_EVENT_TYPE :pevent 不是指向消息隊列的指針。注意/警告必須先建立消息隊列,然后使用。不允許傳遞一個空指針。范例:OS_EVENT *CommQ;INT8U CommRxBuf100;void CommTaskRx(void *pdata) INT8U err; pdata = pdata; for (;) . . err = OSQPost(CommQ, (void *)&CommRxBuf0); if (err = OS_NO_ERR) . /* 將消息放入消息隊列 */ . else . /* 消息隊列已滿 */ . . . OSQPostFront( )INT8U OSQPostFront(OS_EVENT *pevent, void *msg);所屬文件調用者開關量OS_Q.C任務或中斷OS_Q_ENOSQPostFront()函數(shù)通過消息隊列向任務發(fā)送消息。OSQPostFront()函數(shù)和OSQPost()函數(shù)非常相似,不同之處在于OSQPostFront()函數(shù)將發(fā)送的消息插到消息隊列的最前端。也就是說,OSQPostFront()函數(shù)使得消息隊列按照后入先出(LIFO)的方式工作,而不是先入先出(FIFO)。消息是一個指針長度的變量,在不同的程序中消息的使用也可能不同。如果隊列中已經存滿消息,返回錯誤碼。OSQPost()函數(shù)立即返回調用者,消息也沒能發(fā)到隊列。如果有任何任務在等待隊列中的消息,最高優(yōu)先級的任務將得到這個消息。如果等待消息的任務優(yōu)先級比發(fā)送消息的任務優(yōu)先級高,那么高優(yōu)先級的任務將得到消息而恢復執(zhí)行,也就是說,發(fā)生了一次任務切換參數(shù)pevent 是指向即將接受消息的消息隊列的指針。該指針的值在建立該隊列時可以得到。(參考OSQCreate()函數(shù))。Msg 是即將實際發(fā)送給任務的消息。消息是一個指針長度的變量,在不同的程序中消息的使用也可能不同。不允許傳遞一個空指針。返回值OSQPost()函數(shù)的返回值為下述之一:l OS_NO_ERR :消息成功的放到消息隊列中。l OS_MBOX_FULL :消息隊列已滿。l OS_ERR_EVENT_TYPE :pevent 不是指向消息隊列的指針。注意/警告必須先建立消息隊列,然后使用。不允許傳遞一個空指針。范例:OS_EVENT *CommQ;INT8U CommRxBuf100;void CommTaskRx(void *pdata) INT8U err; pdata = pdata; for (;) . err = OSQPostFront(CommQ, (void *)&CommRxBuf0); if (err = OS_NO_ERR) . /* 將消息放入消息隊列 */ else . /* 消息隊列已滿 */ . . OSQQuery( )INT8U OSQQuery(OS_EVENT *pevent, OS_Q_DATA *pdata);所屬文件調用者開關量OS_Q.C任務或中斷OS_Q_ENOSQQuery()函數(shù)用來取得消息隊列的信息。用戶程序必須建立一個OS_Q_DATA的數(shù)據(jù)結構,該結構用來保存從消息隊列的事件控制塊得到的數(shù)據(jù)。通過調用OSQQuery()函數(shù)可以知道任務是否在等待消息、有多少個任務在等待消息、隊列中有多少消息以及消息隊列可以容納的消息數(shù)。OSQQuery()函數(shù)還可以得到即將被傳遞給任務的消息的信息。參數(shù)pevent 是指向即將接受消息的消息郵箱的指針。該指針的值在建立該消息郵箱時可以得到。(參考OSQCreate()函數(shù))。Pdata 是指向OS_Q_DATA數(shù)據(jù)結構的指針,該數(shù)據(jù)結構包含下述成員:Void *OSMsg;/* 下一個可用的消息*/INT16U OSNMsgs;/* 隊列中的消息數(shù)目*/INT16UOSQSize;/* 消息隊列的大小 */INT8U OSEventTblOS_EVENT_TBL_SIZE;/* 消息隊列的等待隊列*/INT8U OSEventGrp;返回值OSQQuery()函數(shù)的返回值為下述之一:l OS_NO_ERR :調用成功l OS_ERR_EVENT_TYPE :pevent 不是指向消息隊列的指針。注意/警告必須先建立消息隊列,然后使用。范例:OS_EVENT *CommQ;void Task (void *pdata) OS_Q_DATA qdata; INT8U err; pdata = pdata; for (;) . . err = OSQQuery(CommQ, &qdata); if (err = OS_NO_ERR) . /* 取得消息隊列的信息 */ . . OSSchedLock( )Void OSSchedLock(void);所屬文件調用者開關量OS_CORE.C任務或中斷N/AOSSchedLock()函數(shù)停止任務調度,只有使用配對的函數(shù)OSSchedUnlock()才能重新開始內核的任務調度。調用OSSchedLock()函數(shù)的任務獨占CPU,不管有沒有其他高優(yōu)先級的就緒任務。在這種情況下,中斷仍然可以被接受和執(zhí)行(中斷必須允許)。OSSchedLock()函數(shù)和OSSchedUnlock()函數(shù)必須配對使用。C/OS-可以支持多達254層的OSSchedLock()函數(shù)嵌套,必須調用同樣次數(shù)的OSSchedUnlock()函數(shù)才能恢復任務調度。參數(shù)無返回值無注意/警告任務調用了OSSchedLock()函數(shù)后,決不能再調用可能導致當前任務掛起的系統(tǒng)函數(shù):OSTimeDly(),OSTimeDlyHMSM(),OSSemPend(),OSMboxPend(),OSQPend()。因為任務調度已經被禁止,其他任務不能運行,這會導致系統(tǒng)死鎖。范例:void TaskX(void *pdata) pdata = pdata; for (;) . OSSchedLock(); /* 停止任務調度 */ . . /* 不允許被打斷的執(zhí)行代碼 */ . OSSchedUnlock(); /* 恢復任務調度 */ . OSSchedUnlock( )Void OSSchedUnlock(void);所屬文件調用者開關量OS_CORE.C任務或中斷N/A在調用了OSSchedLock()函數(shù)后,OSSchedUnlock()函數(shù)恢復任務調度。參數(shù)無返回值無注意/警告任務調用了OSSchedLock()函數(shù)后,決不能再調用可能導致當前任務掛起的系統(tǒng)函數(shù):OSTimeDly(),OSTimeDlyHMSM(),OSSemPend(),OSMboxPend(),OSQPend()。因為任務調度已經被禁止,其他任務不能運行,這會導致系統(tǒng)死鎖。范例:void TaskX(void *pdata) pdata = pdata; for (;) . OSSchedLock(); /* 停止任務調度 */ . . /* 不允許被打斷的執(zhí)行代碼 */ . OSSchedUnlock(); /* 恢復任務調度 */ . OSSemAccept( )INT16U *OSSemAccept(OS_EVENT *pevent);所屬文件調用者開關量OS_SEM.C任務或中斷OS_SEM_ENOSSemAccept()函數(shù)查看設備是否就緒或事件是否發(fā)生。不同于OSSemPend()函數(shù),如果設備沒有就緒,OSSemAccept()函數(shù)并不掛起任務。中斷調用該函數(shù)來查詢信號量。參數(shù)pevent 是指向需要查詢的設備的信號量。當建立信號量時,該指針返回到用戶程序。(參考OSSemCreate()函數(shù))。返回值當調用OSSemAccept()函數(shù)時,設備信號量的值大于零,說明設備就緒,這個值被返回調用者,設備信號量的值減一。如果調用OSSemAccept()函數(shù)時,設備信號量的值等于零,說明設備沒有就緒,返回零。注意/警告必須先建立信號量,然后使用。范例:OS_EVENT *DispSem;void Task (void *pdata) INT16U value; pdata = pdata; for (;) value = OSSemAccept(DispSem); /*查看設備是否就緒或事件是否發(fā)生 */ if (value > 0) . /* 就緒,執(zhí)行處理代碼 */ . . . OSSemCreate( )OS_EVENT *OSSemCreate(WORD value);所屬文件調用者開關量OS_SEM.C任務或啟動代碼OS_SEM_ENOSSemCreate()函數(shù)建立并初始化一個信號量。信號量的作用如下:l 允許一個任務和其他任務或者中斷同步。l 取得設備的使用權l(xiāng) 標志事件的發(fā)生參數(shù)value 參數(shù)是建立的信號量的初始值,可以取0到65535之間的任何值。返回值OSSemCreate()函數(shù)返回指向分配給所建立的消息郵箱的事件控制塊的指針。如果沒有可用的事件控制塊,OSSemCreate()函數(shù)返回空指針。注意/警告必須先建立信號量,然后使用。范例:OS_EVENT *DispSem;void main(void) . . OSInit(); /* 初始化C/OS- */ . . DispSem = OSSemCreate(1); /* 建立顯示設備的信號量 */ . . OSStart();

注意事項

本文(第11章 API 參考手冊.doc)為本站會員(丁**)主動上傳,裝配圖網僅提供信息存儲空間,僅對用戶上傳內容的表現(xiàn)方式做保護處理,對上載內容本身不做任何修改或編輯。 若此文所含內容侵犯了您的版權或隱私,請立即通知裝配圖網(點擊聯(lián)系客服),我們立即給予刪除!

溫馨提示:如果因為網速或其他原因下載失敗請重新下載,重復下載不扣分。




關于我們 - 網站聲明 - 網站地圖 - 資源地圖 - 友情鏈接 - 網站客服 - 聯(lián)系我們

copyright@ 2023-2025  zhuangpeitu.com 裝配圖網版權所有   聯(lián)系電話:18123376007

備案號:ICP2024067431-1 川公網安備51140202000466號


本站為文檔C2C交易模式,即用戶上傳的文檔直接被用戶下載,本站只是中間服務平臺,本站所有文檔下載所得的收益歸上傳人(含作者)所有。裝配圖網僅提供信息存儲空間,僅對用戶上傳內容的表現(xiàn)方式做保護處理,對上載內容本身不做任何修改或編輯。若文檔所含內容侵犯了您的版權或隱私,請立即通知裝配圖網,我們立即給予刪除!