WinCE下的串口驅(qū)動(dòng)分析

串口驅(qū)動(dòng)分析

Auth：nasiry

date： 2005年4月12日
abort： windowsCE.net 420串口驅(qū)動(dòng)分析

雖然串口通訊已經(jīng)是普遍的標(biāo)準(zhǔn)而且廣為大家熟知，但驅(qū)動(dòng)中涉及的部分內(nèi)容也可能在平時(shí)的應(yīng)用中并不是很常用到，在這里做一個(gè)簡(jiǎn)單的介紹待后面說(shuō)明到具體代碼的時(shí)候可以連貫一些。

串行通訊接口是目前十分流行的通訊接口之一。由于其電氣界面的簡(jiǎn)單性使其在計(jì)算機(jī)領(lǐng)域的應(yīng)用相當(dāng)?shù)膹V泛。在這里提到的串行通訊接口主要是指UART(通用串行)和IRDA兩種。通常的串行連接電氣連接上有3wire和9wire兩種。3wire的接線方式下定義了發(fā)送、接收和地三根連接。其用途就如名稱(chēng)一樣分別用于發(fā)送、接收。下面是通常3wire連接的結(jié)構(gòu)框圖

通常在串行接口控制器上會(huì)有兩個(gè)FIFO用作接收和發(fā)送的緩沖，當(dāng)接收到數(shù)據(jù)后會(huì)直接將接收到的數(shù)據(jù)置入該緩沖器，并同時(shí)由控制電路向本地總線發(fā)出通知，以便讓本地總線將緩沖器內(nèi)的數(shù)據(jù)讀走，這樣在響應(yīng)(等待和讀取)的過(guò)程中仍然能通過(guò)緩沖器來(lái)接收數(shù)據(jù)。而發(fā)送發(fā)送的過(guò)程剛剛相反，本地總線可一直向發(fā)送緩沖寫(xiě)入數(shù)據(jù)直到器填滿(mǎn)為止，而無(wú)需對(duì)每個(gè)數(shù)據(jù)的發(fā)送進(jìn)行等待。這就是基本的收發(fā)流程(這部分邏輯流程相信大家是最熟悉的)。這一點(diǎn)在3wire和9wire中都是相同的。但是我們考慮下面的情況，如果接收一方的響應(yīng)由于某種原因的干擾(如處理器被其他中斷服務(wù)占用)的時(shí)候可能就來(lái)不及相應(yīng)之前ReceiveFIFO就可能被填滿(mǎn)了，這樣后續(xù)發(fā)送過(guò)來(lái)的數(shù)據(jù)就會(huì)丟失，這樣在需要數(shù)據(jù)可靠傳輸?shù)那闆r下串行通訊的弊端也就顯示出來(lái)了。如需要數(shù)據(jù)的可靠傳輸就需要對(duì)數(shù)據(jù)流的收發(fā)進(jìn)行控制。在9wire中將串行連接定義為如下形式。

也就是說(shuō)在原3wire的基礎(chǔ)上增加了DCD,DTR,DSR,RTS,CTS,DELL六個(gè)控制線。其中RTS/CTS用于流控制，另外的DCD和DELL則留作連接modem使用。有了專(zhuān)門(mén)的硬件流控制引腳也就使得流控制成為可能，以完成收發(fā)兩端的匹配使得數(shù)據(jù)可以可靠的傳輸。用RTS/CTS（請(qǐng)求發(fā)送/清除發(fā)送）流控制時(shí)，應(yīng)將通訊兩端的RTS、CTS線對(duì)應(yīng)相連).在發(fā)送端準(zhǔn)備發(fā)送數(shù)據(jù)之前設(shè)置RTS(Request to send)也就使發(fā)送請(qǐng)求線，若接收端以作好接收準(zhǔn)備，就啟動(dòng)響應(yīng)的CTS（Clear to send）引線。這樣，收發(fā)雙發(fā)就進(jìn)入數(shù)據(jù)傳輸狀態(tài)，在此過(guò)程中如若接收端處理數(shù)據(jù)的速度低于發(fā)送端的發(fā)送速度，接收一端還可以設(shè)置CTS引線恢復(fù)原來(lái)阻塞得狀態(tài)以暫時(shí)中斷數(shù)據(jù)傳輸，之后若需要恢復(fù)數(shù)據(jù)傳輸恢復(fù)CTS狀態(tài)即可。這樣UART的傳輸即實(shí)現(xiàn)了流控制，保障了數(shù)據(jù)傳輸?shù)耐陚湫浴?

在這里還要說(shuō)一下軟件流控制，雖然硬件已經(jīng)可以完成流控制的任務(wù)但很多少時(shí)候受到連線數(shù)的限制不能使用硬件流控制也就設(shè)計(jì)了專(zhuān)門(mén)的軟件流控制的方法?，F(xiàn)在回到3線傳輸?shù)那榫埃艚邮斩私邮諗?shù)據(jù)過(guò)程中緩沖器的負(fù)載到達(dá)某一限制(也就是留出一定的緩沖空間)時(shí)接收端向發(fā)送端發(fā)送一個(gè)特殊的標(biāo)示位(接收停止位)，當(dāng)發(fā)送端收到該標(biāo)示的時(shí)候就停止發(fā)送，直到接收端緩沖器低于另一限制后發(fā)送標(biāo)示(接收許可位)給發(fā)送端，這樣就可以控制數(shù)據(jù)流的傳輸起停。這種軟件流控制是在給緩沖器留余量來(lái)完成的，在收發(fā)雙端處理器速度差很大的時(shí)候就不太適用了，就必須要用硬件流控制。

其他幾個(gè)引腳都是與modem相關(guān)的，DSR數(shù)據(jù)裝置準(zhǔn)備好（Data set ready)用于表明MODEM處于可以使用的狀態(tài)。DTR數(shù)據(jù)終端準(zhǔn)備好(Data terminal ready)表明數(shù)據(jù)終端可以使用。這兩個(gè)信號(hào)用于檢查Modem是否連接。DELL腳當(dāng)有電話撥入時(shí)Modem將會(huì)設(shè)置這個(gè)引腳。DCD信號(hào)是當(dāng)Modem接收到數(shù)字載波信號(hào)的時(shí)候被設(shè)置，用于了解Modem接收信號(hào)的情況。

至于剩下的奇偶效驗(yàn)和停止位設(shè)置就只是需要針對(duì)寄存器設(shè)置無(wú)需軟件干涉就可以完成了。下面我們來(lái)看具體的驅(qū)動(dòng)程序。

在wince中串口的驅(qū)動(dòng)實(shí)現(xiàn)是有固定模型的，ce中的串口模型遵循ISO/OSI網(wǎng)絡(luò)通訊模型(7層)，就是說(shuō)串口屬于CE網(wǎng)絡(luò)模塊的一個(gè)部分。其中rs232界面(或其它的物理介質(zhì))實(shí)現(xiàn)網(wǎng)絡(luò)的物理層，而驅(qū)動(dòng)和serialAPI共同組成數(shù)據(jù)鏈路層，其它部分都沒(méi)有做定義。在典型的應(yīng)用中,serialAPI與間接通過(guò)TAPI或直接與ActiveSync交互，組成CE網(wǎng)絡(luò)的一部分。而紅外本身的協(xié)議就相對(duì)復(fù)雜的多，它有專(zhuān)門(mén)的一套模型來(lái)描述其使用規(guī)則，對(duì)紅外設(shè)備本身了解不多也就不能深入下去。在串口的這一側(cè)，整個(gè)驅(qū)動(dòng)模型也是相當(dāng)?shù)膹?fù)雜的，但所幸的是驅(qū)動(dòng)僅僅使用到SerialAPI這一層，在這個(gè)層次上串口的行為還是相對(duì)簡(jiǎn)單的。

我們這里僅僅涉及上面所提到的Serial/irda Driver這部分(綠色部分)。在wince提供的驅(qū)動(dòng)例程中串口/紅外驅(qū)動(dòng)采用分層結(jié)構(gòu)設(shè)計(jì)，MDD提供框架性的實(shí)現(xiàn)，負(fù)責(zé)提供OS所需的基本實(shí)現(xiàn)，并將代碼設(shè)計(jì)與具體的硬件設(shè)計(jì)無(wú)關(guān)。而PDD提供了對(duì)硬件操作相應(yīng)的代碼。這些代碼通過(guò)結(jié)構(gòu)HWOBJ來(lái)相互聯(lián)系。對(duì)于MDD PDD的整體驅(qū)動(dòng)來(lái)看，串口驅(qū)動(dòng)模型是作為Stream來(lái)實(shí)現(xiàn)的。

兩者合一以達(dá)到實(shí)現(xiàn)驅(qū)動(dòng)的目的。DDSI就是指這兩個(gè)部分之間的接口，這個(gè)接口并非受到強(qiáng)制的物理/邏輯關(guān)系來(lái)約束，而是人為的規(guī)定的。在涉及到一種特定硬件我們進(jìn)行針對(duì)實(shí)現(xiàn)的時(shí)候往往需要的是了解硬件的物理特性和控制邏輯，然后根據(jù)DDSI的約束就來(lái)進(jìn)行實(shí)現(xiàn)。對(duì)于這里描述的驅(qū)動(dòng)模型而言結(jié)合關(guān)鍵在于結(jié)構(gòu)指針HWOBJ的使用和具體實(shí)現(xiàn)。在實(shí)際的驅(qū)動(dòng)應(yīng)用中僅僅需要實(shí)現(xiàn)HWOBJ相關(guān)的一系列函數(shù)，而無(wú)需從驅(qū)動(dòng)頂層完全開(kāi)發(fā)。串口驅(qū)動(dòng)模型作為一種常用驅(qū)動(dòng)模型在windowsCE中常常用于串口/紅外/USB Client的具體實(shí)現(xiàn)。該驅(qū)動(dòng)模型中對(duì)全功能的串口進(jìn)行了定義，除了常用的TX和RX引線定義以外，針對(duì)DTR、RTS等功能引腳都進(jìn)行了支持，使得用該模型設(shè)計(jì)的串口驅(qū)動(dòng)支持流控制、具備驅(qū)動(dòng)Modem等設(shè)備的能力。

事實(shí)上，如果需要的話完全可以將該驅(qū)動(dòng)一體化設(shè)計(jì)(拋開(kāi)PDD-MDD的劃分，也就無(wú)須DDSI)。也就是不使用現(xiàn)有的驅(qū)動(dòng)架構(gòu)來(lái)進(jìn)行實(shí)現(xiàn)。考慮到串口驅(qū)動(dòng)的使用頻率和執(zhí)行效率要求都不是很苛刻的情況下拋棄驅(qū)動(dòng)架構(gòu)另外實(shí)現(xiàn)的就沒(méi)有多大必要了。

對(duì)于驅(qū)動(dòng)本身而言，串行驅(qū)動(dòng)從功能和實(shí)現(xiàn)上相當(dāng)?shù)暮?jiǎn)單，確具被相當(dāng)全面的成分，對(duì)該驅(qū)動(dòng)的分析和了解無(wú)疑是學(xué)習(xí)流式驅(qū)動(dòng)程序很好的典范。

在開(kāi)始具體代碼之前我們先來(lái)看看，相關(guān)的一些結(jié)構(gòu)。 HWOBJ是相應(yīng)的硬件設(shè)備操作的抽象集合。結(jié)構(gòu)的定義后的注釋與實(shí)際的用途有點(diǎn)點(diǎn)出入，BandFlags指定IST的啟動(dòng)時(shí)間，可選為在初始化過(guò)程啟動(dòng)或是在打開(kāi)設(shè)備的時(shí)候起動(dòng)ISR.而第二個(gè)參數(shù)則是指定攔截的具體的系統(tǒng)中斷號(hào)。最后一個(gè)參數(shù)是一個(gè)結(jié)構(gòu)，該結(jié)構(gòu)定義了硬件操作的各式行為函數(shù)的指針，MDD正是通過(guò)這些函數(shù)來(lái)訪問(wèn)具體的PDD操作。
typedef struct __HWOBJ {

ULONG BindFlags; / Flags controlling MDD behaviour. Se above.

DWORD dwIntID; / Interrupt Identifier used if THREAD_AT_INIT or THREAD_AT_OPEN

PHW_VTBL pFuncTbl;

} HWOBJ, *PHWOBJ;

而HW_VTBL則是代表具體硬件操作函數(shù)指針的集合，該結(jié)構(gòu)所指向的函數(shù)包括了初始化、打開(kāi)、關(guān)閉、接收、發(fā)送、設(shè)置Baudrate等一系列操作。結(jié)構(gòu)存在就像紐帶一樣聯(lián)系著PDD中的具體實(shí)現(xiàn)和MDD中的抽象操作。PDD的實(shí)現(xiàn)必須遵循HW_VTBL中所描述的函數(shù)形式，并構(gòu)造出相應(yīng)的HW_VTBL實(shí)例。驅(qū)動(dòng)的編寫(xiě)就是針對(duì)這些函數(shù)來(lái)一一進(jìn)行實(shí)現(xiàn)。

typedef struct __HW_VTBL {

PVOID (*HWInit)(ULONG Identifier, PVOID pMDDContext, PHWOBJ pHWObj);

BOOL (*HWPostInit)(PVOID pHead);

ULONG (*HWDeinit)(PVOID pHead);

BOOL (*HWOpen)(PVOID pHead);

ULONG (*HWClose)(PVOID pHead);

INTERRUPT_TYPE (*HWGetIntrType)(PVOID pHead);

ULONG (*HWRxIntrHandler)(PVOID pHead, PUCHAR pTarget, PULONG pBytes);

VOID (*HWTxIntrHandler)(PVOID pHead, PUCHAR pSrc, PULONG pBytes);

VOID (*HWModemIntrHandler)(PVOID pHead);

VOID (*HWLineIntrHandler)(PVOID pHead);

ULONG (*HWGetRxBufferSize)(PVOID pHead);

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;交待了上述兩個(gè)結(jié)構(gòu)以后我們來(lái)看看具體的代碼，為保障對(duì)系統(tǒng)架構(gòu)的清晰認(rèn)識(shí)，我們將MDD的代碼和PDD的代碼分開(kāi)進(jìn)行分析。

由于串口驅(qū)動(dòng)由Device.exe直接調(diào)用，所以MDD部分是以完整的Stream接口給出的. 也就具備基于Stream接口的驅(qū)動(dòng)程序所需的函數(shù)實(shí)現(xiàn)，包括COM_Init，COM_Deinit

，COM_Open,COM_Close ,COM_Read ,COM_Write, COM_Seek,, COM_PowerUp, COM_PowerDown, COM_IOControl幾個(gè)基本實(shí)現(xiàn)。由于串口發(fā)送/接收的信息并不能定位，而僅僅是簡(jiǎn)單的傳送，所以COM_Seek僅僅是形式上實(shí)現(xiàn)了一下。

COM_Init

COM_Init是該驅(qū)動(dòng)的初始化函數(shù),在設(shè)備管理器加載該驅(qū)動(dòng)后首先調(diào)用，用于初始化所需的變量，硬件設(shè)備等資源。該過(guò)程分配代表設(shè)備硬件實(shí)例的數(shù)據(jù)結(jié)構(gòu)，并通過(guò)硬件抽象接口HWInit初始化硬件。同時(shí)該函數(shù)會(huì)調(diào)用InterruptInitialize為接收內(nèi)核中的邏輯中斷創(chuàng)建相應(yīng)事件并初始化臨界區(qū)。該函數(shù)還需要得到硬件緩沖器的物理地址和獲知該緩沖器的大小(該沖器最小為2K)。最后它將建立相應(yīng)的緩沖作為接收的中介。下面我們來(lái)看這個(gè)函數(shù)的實(shí)現(xiàn)過(guò)程。

在函數(shù)中定義了兩個(gè)重要的變量。pSerialHead和pHWHead.前者用于描述相應(yīng)的串口的狀態(tài)，后者則是對(duì)應(yīng)硬件的數(shù)據(jù)抽象。首先為pSerialHead分配空間和初始化鏈表和臨界區(qū)等數(shù)據(jù)并同時(shí)為接收和發(fā)送中斷創(chuàng)建事件。然后再?gòu)淖?cè)表中獲得當(dāng)前的注冊(cè)項(xiàng)值(由于device.exe是根據(jù)注冊(cè)表鍵值來(lái)調(diào)用驅(qū)動(dòng)的，當(dāng)前鍵注冊(cè)表項(xiàng)指的就是與上述鍵值在同一根下的注冊(cè)項(xiàng))。得到DeviceArrayIndex、Priority256鍵下的具體值后就可以調(diào)用GetSerialObject(在PDD中實(shí)現(xiàn))來(lái)獲得具體的HWObj對(duì)象，并通過(guò)該對(duì)象來(lái)調(diào)用硬件初始化函數(shù)了。(由于在這里已經(jīng)對(duì)硬件進(jìn)行了初始化，之后的返回都需要調(diào)用COM_Deinit來(lái)完成。)由于硬件初始化(實(shí)際的驅(qū)動(dòng)初始化代碼)已經(jīng)得到執(zhí)行這個(gè)時(shí)候就只有分配和初始化緩沖的工作需要做了。所以調(diào)用HWGetRxBufferSize(PDD代碼)來(lái)獲取PDD中設(shè)定的緩沖大小，并根據(jù)返回的具體值分配緩沖。最后如果BindFlags被設(shè)定為T(mén)HREAD_AT_INIT就再調(diào)用StartDispatchThread啟動(dòng)分發(fā)線程(實(shí)際的IST)。這樣就完成了系統(tǒng)初始化的操作。

COM_Deinit

當(dāng)驅(qū)動(dòng)被稱(chēng)被卸下的時(shí)候該事件啟動(dòng)，用作與COM_Init相反的操作。這個(gè)過(guò)程大致會(huì)釋放驅(qū)動(dòng)中所使用的資源，停止期間創(chuàng)建的線程等操作。具體說(shuō)來(lái)，大致為停止在MDD中的所有IST，和釋放內(nèi)存資源和臨界區(qū)等系統(tǒng)資源。同時(shí)還需調(diào)用HWDeinit來(lái)釋放PDD中所使用到的系統(tǒng)資源。

COM_Open

COM_Oepn在CreateFile后被調(diào)用，用于以讀/寫(xiě)模式打開(kāi)設(shè)備，并初始化所需要的空間/資源等，創(chuàng)建相應(yīng)的實(shí)例，為后面的操作做好準(zhǔn)備。這里的代碼相對(duì)比較容易，下面就簡(jiǎn)單講一下。既然是初始化，肯定就免不了對(duì)參數(shù)的檢查。首先檢查通過(guò)COM_Init返回的pHead結(jié)構(gòu)是否有效，這里雖然沒(méi)有顯式的在這兩個(gè)函數(shù)之間傳遞參數(shù)，而是在設(shè)備管理器的內(nèi)部傳遞這個(gè)參數(shù)的。

之后是檢查文件系統(tǒng)傳遞過(guò)來(lái)的Open句柄中的Open模式是否有效，這個(gè)參數(shù)由應(yīng)用程序產(chǎn)生，通過(guò)文件系統(tǒng)直接傳遞到驅(qū)動(dòng)。之后就開(kāi)始初始化的操作，在這里將會(huì)建立相應(yīng)的HW_OPEN_INFO實(shí)體。下面和為該結(jié)構(gòu)的定義。

typedef struct __HW_OPEN_INFO {

PHW_INDEP_INFO pSerialHead; / @field Pointer back to our HW_INDEP_INFO

DWORD AccessCode; / @field What permissions was this opened with

DWORD ShareMode; / @field What Share Mode was this opened with

DWORD StructUsers; / @field Count of threads currently using struct.

COMM_EVENTS CommEvents; / @field Contains all in…. handling

LIST_ENTRY llist; / @field Linked list of OPEN_INFOs

} HW_OPEN_INFO, *PH

結(jié)構(gòu)中的第一個(gè)參數(shù)指向我們前面提到的HW_INDEP_INFO結(jié)構(gòu)，第二個(gè)參數(shù)為操作權(quán)限碼，也就是READ/WRITE這類(lèi)的權(quán)限。第三個(gè)參數(shù)為共享模式，以確定是否支持獨(dú)占。這兩個(gè)參數(shù)都是與文件系統(tǒng)的內(nèi)容對(duì)應(yīng)的。而CommEvent則對(duì)應(yīng)于本實(shí)例的事件。由于驅(qū)動(dòng)架構(gòu)支持多個(gè)OPEN操作實(shí)例的存在，所以這里維護(hù)了一個(gè)鏈表來(lái)聯(lián)系這些結(jié)構(gòu)。在這里由于IST的啟動(dòng)可以在COM_Init和COM_Open中進(jìn)行，還有處理器啟動(dòng)IST的內(nèi)容。準(zhǔn)備好HW_OPEN_INFO結(jié)構(gòu)后就可以調(diào)用HWOpen(PDD)來(lái)進(jìn)行PDD所需的Open操作了。Open操作完成后調(diào)用HWPurgeComm(PDD)來(lái)處理（取消或等待）當(dāng)前仍在通訊狀態(tài)的任務(wù)。然后重置軟件FIFO就基本完成了COM_Open的動(dòng)作了。

事實(shí)上這里主要是對(duì)所需的數(shù)據(jù)結(jié)構(gòu)進(jìn)行處理，對(duì)于硬件的具體操作都留給PDD去做了，MDD所維護(hù)的僅僅是一個(gè)架構(gòu)性的代碼。Open操作完成后，驅(qū)動(dòng)就進(jìn)入了工作狀態(tài)這個(gè)時(shí)候。

COM_Close

COM_Close為與COM_Open相對(duì)應(yīng)的操作。這期間的目的是釋放COM_Open所使用的系統(tǒng)資源，除此以外如果在COM_Open期間創(chuàng)建了相應(yīng)的IST還需要停止該線程，在最后將該HW_OPEN_INFO脫鏈。這樣一來(lái)驅(qū)動(dòng)狀態(tài)就得以恢復(fù)。當(dāng)然這期間還做了一寫(xiě)避免線程競(jìng)爭(zhēng)的處理，使得代碼看起來(lái)不是那么簡(jiǎn)單。

StartDispatchThread/StopDispatchThread

這兩個(gè)函數(shù)都不是Stream所需要的標(biāo)準(zhǔn)接口，但卻是中斷服務(wù)程序所需的IST啟動(dòng)和關(guān)閉的手段，所以在這里順便說(shuō)一下。

StartDispatchThread函數(shù)用于啟動(dòng)IST，主要的工作為調(diào)用InterruptInitialize將系統(tǒng)中斷與相應(yīng)的事件聯(lián)系起來(lái)。并啟動(dòng)SerialDispatchThread作為IST.其中調(diào)用了叫做 InterruptDone的函數(shù)，該函數(shù)會(huì)調(diào)用OAL中的OEMInterruptDone來(lái)完成中斷的響應(yīng)。

StopDispatchThread用于與StartDispatchThread相反的操作。停止的過(guò)程相對(duì)要復(fù)雜一些，該函數(shù)首先設(shè)定當(dāng)前線程的優(yōu)先級(jí)與分發(fā)線程相同，以便于在停止該線程的動(dòng)作不會(huì)比釋放內(nèi)存的動(dòng)作快以避免出錯(cuò)。停止的動(dòng)作是讓線程主動(dòng)完成的，具體的方法是提交表示位KillRxThread然后通過(guò)Sleep請(qǐng)求調(diào)度,待到IST自己停止。這個(gè)時(shí)候由于IST已經(jīng)停止所以在程序的最后調(diào)用InterruptDisable來(lái)屏蔽中斷。

SerialDispatchThread/ SerialEventHandler

SerialDispatchThread/ SerialEventHandler就是串口驅(qū)動(dòng)的中斷分發(fā)程序(也就是IST的所在)。整個(gè)IST被分開(kāi)寫(xiě)成兩個(gè)部分---循環(huán)主體和事件處理程序。循環(huán)主體SerialDispatchThread內(nèi)容相對(duì)比較簡(jiǎn)單，反復(fù)等待串口事件并調(diào)用SerialEventHandler對(duì)具體的中斷進(jìn)行處理，直到pSerialHead->KillRxThread被設(shè)置后退出。SerialEventHandler為中斷處理的具體實(shí)現(xiàn)，程序在獲得串口事件后運(yùn)行，目的在于對(duì)中斷進(jìn)行進(jìn)一步的判斷并執(zhí)行相應(yīng)的處理。

下面參考兩個(gè)結(jié)構(gòu)體來(lái)完成接受和發(fā)送中斷服務(wù)的分析。我們先來(lái)看RX_BUFFER_INFO結(jié)構(gòu)。

typedef struct __RX_BUFFER_INFO {

ULONG Read; /* @field Current Read index. */

ULONG Write; /* @field Current Write index. */

ULONG Length; /* @field Length of buffer */

BOOL DataAvail; /* @field BOOL reflecting existence of data. */

PUCHAR RxCharBuffer; /* @field Start of buffer */

CRITICAL_SECTION CS; /* @field Critical section */

} RX_BUFFER_INFO, *PRX_BUFFER_INFO;

用該結(jié)構(gòu)的原因是在驅(qū)動(dòng)內(nèi)部維護(hù)了一個(gè)緩沖器用作驅(qū)動(dòng)和應(yīng)用程序之間的緩沖見(jiàn)下圖.

可以看到在硬件內(nèi)部已經(jīng)有一個(gè)FIFO緩沖器，這保障了驅(qū)動(dòng)的數(shù)據(jù)接收，但由于應(yīng)用不一定能保障在驅(qū)動(dòng)獲得數(shù)據(jù)后及時(shí)將數(shù)據(jù)取走，因此在驅(qū)動(dòng)內(nèi)部維護(hù)了另外一個(gè)緩沖器。在RX_BUFFER_FIFO結(jié)構(gòu)中的read成員為MDD取數(shù)據(jù)時(shí)在FIFO的位置標(biāo)志，而PDD向軟件寫(xiě)入數(shù)據(jù)的位標(biāo)則對(duì)應(yīng)被稱(chēng)作Write，DataAvail用作表示緩沖器內(nèi)的數(shù)據(jù)是否有效。而RxCharBuffer則是指向軟件FIFO的指針。當(dāng)收到數(shù)據(jù)的時(shí)候就將write標(biāo)示往上遞增，而程序向驅(qū)動(dòng)取數(shù)得時(shí)候Read遞增，這樣就可以根據(jù)Read和Write成員來(lái)維護(hù)這個(gè)FIFO。有了這個(gè)基本思路墊底我們接著看RX的中斷服務(wù)具體如何實(shí)現(xiàn)。這間還會(huì)涉及到流控制的成分。

接收分支：在接收分支的開(kāi)始計(jì)算軟件緩沖器的剩余空間，如果有剩余的空間的話直接調(diào)用HWRxIntrHandler(PDDa實(shí)現(xiàn))來(lái)從硬件緩沖區(qū)獲取剩余空間大小的數(shù)據(jù)，若已無(wú)剩余空間則建立一個(gè)16byte的臨時(shí)緩沖區(qū)，將數(shù)據(jù)讀入該區(qū)域，實(shí)際上這個(gè)緩沖區(qū)在后面根本就不會(huì)被讀取所以這些數(shù)據(jù)全部丟失掉了這也就自然需要統(tǒng)計(jì)硬件/軟件緩沖導(dǎo)致的數(shù)據(jù)丟失(接收不及時(shí)導(dǎo)致)。接下來(lái)就是所謂XFlow的流程了，所謂XFlow就是我們上面提到的軟件流控制。也就是用軟件的方法來(lái)協(xié)調(diào)發(fā)送和接收端的收發(fā)，保障數(shù)據(jù)的完整接收。當(dāng)接收到XOFF/XON標(biāo)記的時(shí)候由于這個(gè)標(biāo)記本身不數(shù)據(jù)數(shù)據(jù)而是控制標(biāo)志，所以要講后面的數(shù)據(jù)全部前置一位，覆蓋掉XON/XOFF的位置。同時(shí)還需要根據(jù)標(biāo)示的具體狀態(tài)來(lái)設(shè)置DCB結(jié)構(gòu)中的控制標(biāo)示來(lái)控制數(shù)據(jù)收發(fā)流程。如果是XON標(biāo)志，還需要在處理完接收流程后恢復(fù)發(fā)送流程。接收的動(dòng)作會(huì)改變write標(biāo)記的位置，這里需要重新計(jì)算該標(biāo)示。至于硬件流控制的流程中該驅(qū)動(dòng)模型是以緩沖器的75%為分位點(diǎn)來(lái)起停收發(fā)的，可用的硬件連線可以是DTR,也可以是RTS（模式相同僅僅是連線不同），這里的操作很簡(jiǎn)單，僅僅是通過(guò)計(jì)算緩沖器的存儲(chǔ)狀態(tài)來(lái)清除該標(biāo)志就完成了硬件流控制的操作。由于在此過(guò)程中IST與其他部分是同步執(zhí)行的,所以這個(gè)時(shí)候如果使用XFlow可能還會(huì)需要做一次安全檢查。這樣接收的流程就結(jié)束了。

發(fā)送分支： 我們同樣來(lái)看看TX_BUFFER_INFO結(jié)構(gòu)，看樣子似乎該結(jié)構(gòu)維護(hù)了一個(gè)和TX緩沖類(lèi)似的緩沖區(qū)，但事實(shí)上這個(gè)緩沖區(qū)域是不獨(dú)立存在的，發(fā)送的流程因?yàn)榭梢灾苯邮褂盟璋l(fā)送的數(shù)據(jù)的存儲(chǔ)區(qū)域來(lái)作為發(fā)送緩沖，所以這個(gè)緩沖沒(méi)有獨(dú)立存在的必要。由于使用其它進(jìn)程的數(shù)據(jù)區(qū)域，所以這里增加了權(quán)限控制項(xiàng)的成分，用于突破進(jìn)程間的訪問(wèn)限制。

typedef struct __TX_BUFFER_INFO {

DWORD Permissions; /* @field Current permissions */

ULONG Read; /* @field Current Read index. */

ULONG Length; /* @field Length of buffer */

PUCHAR TxCharBuffer; /* @field Start of buffer */

CRITICAL_SECTION CS; /* @field Critical section */

} TX_BUFFER_INFO, *PTX_BUFFER_INFO;

下面來(lái)看看代碼的具體內(nèi)容。首先是對(duì)OpenCnt的檢查，也就是設(shè)備是否被打開(kāi)。若當(dāng)會(huì)話已經(jīng)關(guān)閉也就沒(méi)有必要繼續(xù)將數(shù)據(jù)送出了，并同時(shí)重置緩沖器的各個(gè)標(biāo)志位。整個(gè)流程比較簡(jiǎn)單，在需要流控制時(shí)設(shè)置RTS或檢查Xflow的情況后將數(shù)據(jù)送入硬件緩沖器.如果在沒(méi)有數(shù)據(jù)需要發(fā)送的情況下簡(jiǎn)單的清除中斷標(biāo)示并發(fā)出發(fā)送結(jié)束事件就可以了。至于SetProcPermissions設(shè)置的目的在于獲得訪問(wèn)其它線程數(shù)據(jù)空間的手段。

至于所謂的Modem和Line的情況則全部交給PDD來(lái)處理，我們后面再討論。在這些全部都處理完了以后如果前面處理了接收，則發(fā)出接收（有可用的數(shù)據(jù)用于接收）的消息，讓程序開(kāi)始接收。后面還跟進(jìn)了一個(gè)EvaluateEventFlag 函數(shù)，這個(gè)函數(shù)用于產(chǎn)生標(biāo)準(zhǔn)的Communication Events EV_RXFLAG，而且由于該驅(qū)動(dòng)程序本身支持mult-open模式，所以需要將該事件送發(fā)到所有的實(shí)例中去。在ist期間有一些互鎖、臨界區(qū)的操作，因?yàn)椴挥绊懥鞒?，同步化的?nèi)容這里我沒(méi)有提。中斷服務(wù)的分析大致就是如此，沒(méi)有涉及到邏輯環(huán)節(jié)在后面的PDD部分再進(jìn)行討論。

COM_Read

COM_Read是獲取串口所接收到數(shù)據(jù)的操作，在前面的IST中沒(méi)有看到對(duì)RX buffer進(jìn)行修改Read標(biāo)記的操作，也就是這兒來(lái)完成的。該函數(shù)有三個(gè)參數(shù)，第一個(gè)參數(shù)是從上面的COM_OPEN通過(guò)設(shè)備管理器交換來(lái)的，后兩個(gè)參數(shù)與文件系統(tǒng)的使用方法完全一樣，一個(gè)是接受緩沖指針，另一個(gè)是長(zhǎng)度。代碼的開(kāi)始照樣是例行公事的參數(shù)檢查，包括對(duì)存取權(quán)限，OpenCnt等。之后計(jì)算超時(shí)時(shí)間，如果設(shè)定了超時(shí)讀取動(dòng)作會(huì)在超時(shí)后返回，不管是否讀到了足夠長(zhǎng)度的數(shù)據(jù)。隨后就是簡(jiǎn)單對(duì)軟件緩沖進(jìn)行讀取的操作了，讀取的操作是在RX_CS中完成的。下面要處理器的主要就是幾種異常的情形，讀取過(guò)程中設(shè)備被關(guān)閉/取消讀取和超時(shí)。最后在讀取的過(guò)程中需要處理的就只是流控制的成本了。首先是軟件流的情形，如果緩沖的狀態(tài)由高于分位點(diǎn)至分位點(diǎn)以下就發(fā)出XON標(biāo)記，啟動(dòng)發(fā)送端的發(fā)送。而硬件流的情形無(wú)論是RTS還是DTR與軟件流的相類(lèi)似，同樣由一個(gè)分為點(diǎn)(50%)來(lái)決定發(fā)出啟動(dòng)發(fā)送端的信號(hào)，僅僅是這里使用的具體措施的不同。這些硬件信號(hào)的發(fā)出都是由PDD來(lái)完成的，其中包括HWSetRTS和HWSetDTR(2選一)。至此Read的流程就結(jié)束了。

COM_Write

COM_Write是與COM_Read相對(duì)應(yīng)的操作。所傳遞的參數(shù)的形式也是很相似的，僅僅是數(shù)據(jù)流向的不同。在程序的開(kāi)始，同樣也是參數(shù)檢查，內(nèi)容與COM_Read一致。在數(shù)據(jù)檢查完成之后進(jìn)入臨界區(qū)(保障多線程下的獨(dú)占)將送入的目標(biāo)地址和長(zhǎng)度設(shè)置為T(mén)X buffer，待到數(shù)據(jù)發(fā)送完成事件后調(diào)用DoTxData來(lái)啟動(dòng)發(fā)送。這里啟動(dòng)發(fā)送的目的在于獲得硬件中斷維持發(fā)送流程。在這里DoTxData是作為兩種狀態(tài)來(lái)執(zhí)行的，在通過(guò)COM_Write的執(zhí)行的過(guò)程中是在device.exe所創(chuàng)建的線程空間內(nèi)執(zhí)行的，但由系統(tǒng)中斷事件主動(dòng)啟動(dòng)的過(guò)程中屬于IST本身的的進(jìn)程空間，這樣在COM_Write中調(diào)用DoTxData之前設(shè)置的權(quán)限代碼(由GetCurrentPermissions獲得)就可以由TxBufferInfo傳遞到IST中去使得中斷過(guò)程也具備了訪問(wèn)緩沖的權(quán)限(結(jié)合前面說(shuō)明IST的流程)。當(dāng)提交中斷處理發(fā)送后待到pSerialHead->hTransmitEvent被設(shè)置或是異常或超時(shí)后就結(jié)束了發(fā)送流程，在這部分的最后。與COM_Read類(lèi)似需要處理一些異常情況，當(dāng)然如果使用了硬件流控制還需要在這里清除掉發(fā)送請(qǐng)求信號(hào)，當(dāng)這些狀態(tài)處理完成以后發(fā)送EV_TXEMPTY事件通告所有open的句柄發(fā)送結(jié)束就完成了該部分的流程。

COM_PowerUp/ COM_PowerDown

這兩個(gè)函數(shù)的調(diào)用都由CE的電源事件來(lái)引發(fā)，MDD并沒(méi)有對(duì)這兩個(gè)函數(shù)進(jìn)行處理，僅僅是將其傳遞給PDD。

COM_IOControl

該函數(shù)用于實(shí)現(xiàn)向設(shè)備發(fā)送命令的功能。由于代碼本身沒(méi)有什么流程或邏輯性可言，全都是單獨(dú)的實(shí)現(xiàn)，下面就用列表的方式大致的說(shuō)一下這些命令字和其實(shí)現(xiàn)。

到這里MDD的主要函數(shù)都已經(jīng)介紹過(guò)了，下面幾個(gè)函數(shù)是在DeviceIOControl中用到的。這里順便也來(lái)看一下:

ProcessExiting

該函數(shù)在IOCTL_PSL_NOTIFY命令的執(zhí)行過(guò)程中被調(diào)用,之前的情景是使用驅(qū)動(dòng)的進(jìn)程在被取消的過(guò)程中，在這里主要是清除所有正在會(huì)話中的線程。以便直接kill掉該進(jìn)程。

WaitCommEvent

事實(shí)上該函數(shù)為SerialAPI WaitCommEvent在驅(qū)動(dòng)內(nèi)的實(shí)現(xiàn)，其作用為阻塞線程直道某一固定的串口通告(事件消息)發(fā)生。在具體的實(shí)現(xiàn)中，是用WaitForSingleObject來(lái)實(shí)現(xiàn)阻塞。在進(jìn)入阻塞之前，函數(shù)適用一個(gè)循環(huán)主體首先查詢(xún)是否存在已有的通告與等待通告相符，若沒(méi)有就等待下一次事件發(fā)生，待事件發(fā)生再次進(jìn)行檢查。如此循環(huán)達(dá)到阻塞的目的。

ApplyDCB

DCB數(shù)據(jù)結(jié)構(gòu)是描述串行口波特率，流控制，奇偶效驗(yàn)等資料的載體。該函數(shù)是MDD設(shè)置DCB數(shù)據(jù)結(jié)構(gòu)至驅(qū)動(dòng)內(nèi)部和硬件的手段，這里使用了大量的PDD操作來(lái)完成硬件設(shè)置。

總結(jié)：

在驅(qū)動(dòng)實(shí)現(xiàn)方面，除去所謂Multi-Open的處理外，串口的MDD并沒(méi)有什么特別的之處，在掌握了硬件行為和應(yīng)用軟件行為后很容易能讀懂其間的代碼。