在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)用?梢哉f,該結(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ù)中傳來,表示是否支持獨自占有。
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è)備從正常模式進入suspend狀態(tài)。
pContext:串口設(shè)備的Handle。
|