| 以文本方式查看主題 - 曙海教育集團論壇 (http://www.scb-ycwb.com/bbs/index.asp) -- WinCE系統定制與驅動開發 (http://www.scb-ycwb.com/bbs/list.asp?boardid=36) ---- WinCE中串口驅動及接口函數介紹 (http://www.scb-ycwb.com/bbs/dispbbs.asp?boardid=36&id=1832) |
| -- 作者：wangxinxin -- 發布時間：2010-11-26 14:01:54 -- WinCE中串口驅動及接口函數介紹 在WinCE中，串口驅動實際上就是一個流設備驅動,具體架構如圖： 串口驅動本身分為MDD層和PDD層。MDD層對上層的Device Manager提供了標準的流設備驅動接口(COM_xxx)，PDD層實現了HWOBJ結構及結構中若干針對于串口硬件操作的函數指針，這些函數指針將指向PDD層中的串口操作函數。DDSI是指MDD層與PDD層的接口，在串口驅動中實際上就是指HWOBJ，PDD層會傳給MDD層一個HWOBJ結構的指針，這樣MDD層就可以調用PDD層的函數來操作串口。 微軟針對于串口驅動提供了參考源代碼，可以在下面的目錄下找到：”\\WINCE600\\PUBLIC\\COMMON\\OAK\\DRIVERS\\SERIAL”。 串口驅動的結構也就是這樣了，下面介紹相關的驅動中的接口。 1. HWOBJ結構 在串口驅動中，HWOBJ結構中的函數實現了對串口硬件的操作，并在MDD層被調用。可以說，該結構描述了串口設備的所有特性，先來介紹一下該結構，具體定義如下： typedef struct __HWOBJ { ULONG BindFlags; DWORD dwIntID; PHW_VTBL pFuncTbl; } HWOBJ, *PHWOBJ; BindFlags：用于控制MDD層如何來處理IST，具體值如下： THREAD_IN_PDD：MDD層不處理，中斷在PDD層處理。 THREAD_AT_INIT：在驅動初始化的時候，MDD層啟動IST。 THREAD_AT_OPEN：在驅動被Open的時候，MDD層啟動IST。 dwInitID： 系統的中斷號 pFuncTbl： 指向一個PHW_VTBL結構，該結構中包含一個函數指針列表，這些函數指針指向串口硬件操作函數，用于操作串口。 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; 這些函數將在PDD層實現，用于實際的串口硬件操作。 2. MDD層API MDD層向上提供了流設備接口，這部分代碼微軟已經實現，用于管理串口。雖然我們不需要實現這部分，但是還是對相應的接口做個簡單介紹。 2.1HANDLE COM_Init(ULONG Identifier)： 初始化串口設備，該函數通過讀取注冊表獲得串口設備號，并獲得相應的HWOBJ的結構指針，通過該指針調用PDD層的硬件初始化函數初始化串口。 Identifier：如果驅動被設備管理器加載，那么這個參數將包含一個注冊表鍵值在” HKEY_LOCAL_MACHINE\\Drivers\\Active”路徑下。如果驅動是通過調用RegisterDevice函數來加載的，那么這個值等于dwInfo的值。在COM_Init中，會先打開該鍵值，用返回的句柄來查詢DeviceArrayIndex值，并根據該值獲得PDD層的HWOBJ結構指針。 2.2 BOOL COM_Deinit(void)： 卸載串口設備，該函數中主要做了一些釋放資源的操作。也可以被DeregisterDevice函數調用。 2.3 HANDLE COM_Open(HANDLE pContext, DWORD AccessCode, DWORD ShareMode)： 打開串口設備。應用程序調用CreateFile函數打開串口時，該函數會被調用。 pContext：COM_Init函數返回的Handle。 AccessCode：設置訪問模式，比如共享讀或者是讀寫模式。 ShareMode：在參數從應用程序中的CreateFile函數中傳來，表示是否支持獨自占有。 2.4 BOOL COM_Close(DWORD pContext)： 關閉串口設備。應用程序調用CloseHandle函數關閉串口時，該函數會被調用。 pContext：該參數為COM_Open函數返回的Handle。 2.5 ULONG COM_Read(HANDLE pContext, PUCHAR pTargetBuffer, ULONG BufferLength, PULONG pBytesRead)： 讀串口數據。應用程序調用ReadFile函數讀串口的時候，該函數被調用。 pContext：COM_Open函數返回的Handle。 pTargetBuffer：指向一個用于存放讀到數據的Buffer。 BufferLength：pTargetBuffer指向的Buffer的大小。 pBytesRead：實際讀到的數據的大小。 2.6 ULONG COM_Write(HANDLE pContext, PUCHAR pSourceBytes, ULONG NumberOfBytes)： 寫串口數據。應用程序調用WriteFile函數寫串口的時候，該函數被調用。 pContext：COM_Open函數返回的Handle。 pSourceBytes：指向一個Buffer，該Buffer包含要寫入串口的數據。 NumberOfBytes：要寫入串口的數據的大小。 2.7 BOOL COM_PowerUp(HANDLE pContext)： 該函數主要用于串口設備從suspend模式恢復到正常模式。 pContext：串口設備的Handle。 2.8 BOOL COM_PowerDown(HANDLE pContext)： 該函數主要用于串口設備從正常模式進入suspend狀態。 pContext：串口設備的Handle。 |