在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。
|