標題：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。