标题：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。