| 以文本方式查看主題 - 曙海教育集團(tuán)論壇 (http://www.adgdgn.cn/bbs/index.asp) -- WinCE系統(tǒng)定制與驅(qū)動開發(fā) (http://www.adgdgn.cn/bbs/list.asp?boardid=36) ---- WinCE中串口驅(qū)動及接口函數(shù)介紹 (http://www.adgdgn.cn/bbs/dispbbs.asp?boardid=36&id=1832) |
| -- 作者：wangxinxin -- 發(fā)布時間：2010-11-26 14:01:54 -- WinCE中串口驅(qū)動及接口函數(shù)介紹 在WinCE中，串口驅(qū)動實際上就是一個流設(shè)備驅(qū)動,具體架構(gòu)如圖： 串口驅(qū)動本身分為MDD層和PDD層。MDD層對上層的Device Manager提供了標(biāo)準(zhǔn)的流設(shè)備驅(qū)動接口(COM_xxx)，PDD層實現(xiàn)了HWOBJ結(jié)構(gòu)及結(jié)構(gòu)中若干針對于串口硬件操作的函數(shù)指針，這些函數(shù)指針將指向PDD層中的串口操作函數(shù)。DDSI是指MDD層與PDD層的接口，在串口驅(qū)動中實際上就是指HWOBJ，PDD層會傳給MDD層一個HWOBJ結(jié)構(gòu)的指針，這樣MDD層就可以調(diào)用PDD層的函數(shù)來操作串口。 微軟針對于串口驅(qū)動提供了參考源代碼，可以在下面的目錄下找到：”\\WINCE600\\PUBLIC\\COMMON\\OAK\\DRIVERS\\SERIAL”。 串口驅(qū)動的結(jié)構(gòu)也就是這樣了，下面介紹相關(guān)的驅(qū)動中的接口。 1. HWOBJ結(jié)構(gòu) 在串口驅(qū)動中，HWOBJ結(jié)構(gòu)中的函數(shù)實現(xiàn)了對串口硬件的操作，并在MDD層被調(diào)用。可以說，該結(jié)構(gòu)描述了串口設(shè)備的所有特性，先來介紹一下該結(jié)構(gòu)，具體定義如下： typedef struct __HWOBJ { ULONG BindFlags; DWORD dwIntID; PHW_VTBL pFuncTbl; } HWOBJ, *PHWOBJ; BindFlags：用于控制MDD層如何來處理IST，具體值如下： THREAD_IN_PDD：MDD層不處理，中斷在PDD層處理。 THREAD_AT_INIT：在驅(qū)動初始化的時候，MDD層啟動IST。 THREAD_AT_OPEN：在驅(qū)動被Open的時候，MDD層啟動IST。 dwInitID： 系統(tǒng)的中斷號 pFuncTbl： 指向一個PHW_VTBL結(jié)構(gòu)，該結(jié)構(gòu)中包含一個函數(shù)指針列表，這些函數(shù)指針指向串口硬件操作函數(shù)，用于操作串口。 view plaincopy to clipboardprint? typedef struct __HW_VTBL { PVOID (*HWInit)(ULONG Identifier, PVOID pMDDContext); ULONG (*HWDeinit)(PVOID pHead); BOOL (*HWOpen)(PVOID pHead); ULONG (*HWClose)(PVOID pHead); ULONG (*HWGetBytes)(PVOID pHead, PUCHAR pTarget, PULONG pBytes); PVOID (*HWGetRxStart)(PVOID pHead); INTERRUPT_TYPE (*HWGetIntrType)(PVOID pHead); VOID (*HWOtherIntrHandler)(PVOID pHead); VOID (*HWLineIntrHandler)(PVOID pHead); ULONG (*HWGetRxBufferSize)(PVOID pHead); VOID (*HWTxIntrHandler)(PVOID pHead); ULONG (*HWPutBytes)(PVOID pHead, PUCHAR pSrc, ULONG NumBytes, PULONG pBytesSent); BOOL (*HWPowerOff)(PVOID pHead); BOOL (*HWPowerOn)(PVOID pHead); VOID (*HWClearDTR)(PVOID pHead); VOID (*HWSetDTR)(PVOID pHead); VOID (*HWClearRTS)(PVOID pHead); VOID (*HWSetRTS)(PVOID pHead); BOOL (*HWEnableIR)(PVOID pHead, ULONG BaudRate); BOOL (*HWDisableIR)(PVOID pHead); VOID (*HWClearBreak)(PVOID pHead); VOID (*HWSetBreak)(PVOID pHead); BOOL (*HWXmitComChar)(PVOID pHead, UCHAR ComChar); ULONG (*HWGetStatus)(PVOID pHead, LPCOMSTAT lpStat); VOID (*HWReset)(PVOID pHead); VOID (*HWGetModemStatus)(PVOID pHead, PULONG pModemStatus); VOID (*HWGetCommProperties)(PVOID pHead, LPCOMMPROP pCommProp); VOID (*HWPurgeComm)(PVOID pHead, DWORD fdwAction); BOOL (*HWSetDCB)(PVOID pHead, LPDCB pDCB); BOOL (*HWSetCommTimeouts)(PVOID pHead, LPCOMMTIMEOUTS lpCommTO); BOOL (*HWIoctl)(PVOID pHead, DWORD dwCode,PBYTE pBufIn, DWORD dwLenIn, PBYTE pBufOut,DWORD dwLenOut,PDWORD pdwActualOut); } HW_VTBL, *PHW_VTBL; typedef struct __HW_VTBL { PVOID (*HWInit)(ULONG Identifier, PVOID pMDDContext); ULONG (*HWDeinit)(PVOID pHead); BOOL (*HWOpen)(PVOID pHead); ULONG (*HWClose)(PVOID pHead); ULONG (*HWGetBytes)(PVOID pHead, PUCHAR pTarget, PULONG pBytes); PVOID (*HWGetRxStart)(PVOID pHead); INTERRUPT_TYPE (*HWGetIntrType)(PVOID pHead); VOID (*HWOtherIntrHandler)(PVOID pHead); VOID (*HWLineIntrHandler)(PVOID pHead); ULONG (*HWGetRxBufferSize)(PVOID pHead); VOID (*HWTxIntrHandler)(PVOID pHead); ULONG (*HWPutBytes)(PVOID pHead, PUCHAR pSrc, ULONG NumBytes, PULONG pBytesSent); BOOL (*HWPowerOff)(PVOID pHead); BOOL (*HWPowerOn)(PVOID pHead); VOID (*HWClearDTR)(PVOID pHead); VOID (*HWSetDTR)(PVOID pHead); VOID (*HWClearRTS)(PVOID pHead); VOID (*HWSetRTS)(PVOID pHead); BOOL (*HWEnableIR)(PVOID pHead, ULONG BaudRate); BOOL (*HWDisableIR)(PVOID pHead); VOID (*HWClearBreak)(PVOID pHead); VOID (*HWSetBreak)(PVOID pHead); BOOL (*HWXmitComChar)(PVOID pHead, UCHAR ComChar); ULONG (*HWGetStatus)(PVOID pHead, LPCOMSTAT lpStat); VOID (*HWReset)(PVOID pHead); VOID (*HWGetModemStatus)(PVOID pHead, PULONG pModemStatus); VOID (*HWGetCommProperties)(PVOID pHead, LPCOMMPROP pCommProp); VOID (*HWPurgeComm)(PVOID pHead, DWORD fdwAction); BOOL (*HWSetDCB)(PVOID pHead, LPDCB pDCB); BOOL (*HWSetCommTimeouts)(PVOID pHead, LPCOMMTIMEOUTS lpCommTO); BOOL (*HWIoctl)(PVOID pHead, DWORD dwCode,PBYTE pBufIn, DWORD dwLenIn, PBYTE pBufOut,DWORD dwLenOut,PDWORD pdwActualOut); } HW_VTBL, *PHW_VTBL; 這些函數(shù)將在PDD層實現(xiàn)，用于實際的串口硬件操作。 2. MDD層API MDD層向上提供了流設(shè)備接口，這部分代碼微軟已經(jīng)實現(xiàn)，用于管理串口。雖然我們不需要實現(xiàn)這部分，但是還是對相應(yīng)的接口做個簡單介紹。 2.1HANDLE COM_Init(ULONG Identifier)： 初始化串口設(shè)備，該函數(shù)通過讀取注冊表獲得串口設(shè)備號，并獲得相應(yīng)的HWOBJ的結(jié)構(gòu)指針，通過該指針調(diào)用PDD層的硬件初始化函數(shù)初始化串口。 Identifier：如果驅(qū)動被設(shè)備管理器加載，那么這個參數(shù)將包含一個注冊表鍵值在” HKEY_LOCAL_MACHINE\\Drivers\\Active”路徑下。如果驅(qū)動是通過調(diào)用RegisterDevice函數(shù)來加載的，那么這個值等于dwInfo的值。在COM_Init中，會先打開該鍵值，用返回的句柄來查詢DeviceArrayIndex值，并根據(jù)該值獲得PDD層的HWOBJ結(jié)構(gòu)指針。 2.2 BOOL COM_Deinit(void)： 卸載串口設(shè)備，該函數(shù)中主要做了一些釋放資源的操作。也可以被DeregisterDevice函數(shù)調(diào)用。 2.3 HANDLE COM_Open(HANDLE pContext, DWORD AccessCode, DWORD ShareMode)： 打開串口設(shè)備。應(yīng)用程序調(diào)用CreateFile函數(shù)打開串口時，該函數(shù)會被調(diào)用。 pContext：COM_Init函數(shù)返回的Handle。 AccessCode：設(shè)置訪問模式，比如共享讀或者是讀寫模式。 ShareMode：在參數(shù)從應(yīng)用程序中的CreateFile函數(shù)中傳來，表示是否支持獨(dú)自占有。 2.4 BOOL COM_Close(DWORD pContext)： 關(guān)閉串口設(shè)備。應(yīng)用程序調(diào)用CloseHandle函數(shù)關(guān)閉串口時，該函數(shù)會被調(diào)用。 pContext：該參數(shù)為COM_Open函數(shù)返回的Handle。 2.5 ULONG COM_Read(HANDLE pContext, PUCHAR pTargetBuffer, ULONG BufferLength, PULONG pBytesRead)： 讀串口數(shù)據(jù)。應(yīng)用程序調(diào)用ReadFile函數(shù)讀串口的時候，該函數(shù)被調(diào)用。 pContext：COM_Open函數(shù)返回的Handle。 pTargetBuffer：指向一個用于存放讀到數(shù)據(jù)的Buffer。 BufferLength：pTargetBuffer指向的Buffer的大小。 pBytesRead：實際讀到的數(shù)據(jù)的大小。 2.6 ULONG COM_Write(HANDLE pContext, PUCHAR pSourceBytes, ULONG NumberOfBytes)： 寫串口數(shù)據(jù)。應(yīng)用程序調(diào)用WriteFile函數(shù)寫串口的時候，該函數(shù)被調(diào)用。 pContext：COM_Open函數(shù)返回的Handle。 pSourceBytes：指向一個Buffer，該Buffer包含要寫入串口的數(shù)據(jù)。 NumberOfBytes：要寫入串口的數(shù)據(jù)的大小。 2.7 BOOL COM_PowerUp(HANDLE pContext)： 該函數(shù)主要用于串口設(shè)備從suspend模式恢復(fù)到正常模式。 pContext：串口設(shè)備的Handle。 2.8 BOOL COM_PowerDown(HANDLE pContext)： 該函數(shù)主要用于串口設(shè)備從正常模式進(jìn)入suspend狀態(tài)。 pContext：串口設(shè)備的Handle。 |