Windows CE下驅(qū)動(dòng)程序開發(fā)基礎(chǔ)(一)
文/付林林
這是我從1月6日開始主持天極網(wǎng)論壇嵌入式開發(fā)版以來第一次發(fā)表文章,加上以前瑣碎的文章共計(jì)30篇。研究的越多就越感覺自己懂的太少,其實(shí)在驅(qū)動(dòng)開發(fā)方面我還是個(gè)菜鳥,我是想再次拋磚引玉,讓做驅(qū)動(dòng)有N年經(jīng)驗(yàn)的人奉獻(xiàn)一點(diǎn)出來,讓大家減少一些研究驅(qū)動(dòng)源碼而又缺少注釋所帶來的痛苦。
我想即使讀者看過微軟的關(guān)于驅(qū)動(dòng)開發(fā)的培訓(xùn)教材和CE幫助文檔中的驅(qū)動(dòng)部分,頭腦中仍然一片茫然。要想真正了解驅(qū)動(dòng)程序必須結(jié)合一些驅(qū)動(dòng)程序源碼,在此我以串口驅(qū)動(dòng)程序(COM16550)中初始化過程為線索簡(jiǎn)單講一講驅(qū)動(dòng)開發(fā)的基礎(chǔ)知識(shí)。
Windows CE下的串口驅(qū)動(dòng)程序能夠處理所有I/O行為類似串口的設(shè)備,包括基于16450、16550 UART(通用異步收發(fā)芯片)的設(shè)備和一些采用DMA的設(shè)備,常見的有9針串口、紅外I/O口、Modem等。在%_WINCEROOT%PublicCommonOAKDriversSerial目錄下,COM_MDD2子目錄包含新的串口驅(qū)動(dòng)MDD層函數(shù)代碼。COM16550子目錄包含串口驅(qū)動(dòng)PDD層代碼。SER16550子目錄包含的一系列函數(shù)專用于控制與16550兼容的UART,這樣PDD層的主要工作就是調(diào)用SER16550中的函數(shù)。還有一個(gè)ISR16550子目錄包含的是串口驅(qū)動(dòng)程序?qū)S玫目砂惭bISR(中斷服務(wù)例程),而很多硬件設(shè)備驅(qū)動(dòng)程序采用CE默認(rèn)的可安裝ISR giisr.dll。一般串口設(shè)備相應(yīng)的注冊(cè)表設(shè)置例子及意義如下:
[HKEY_LOCAL_MACHINEDriversBuiltInSerial_1]
鍵意義"SysIntr"=dword:13串口1的中斷ID為十進(jìn)制13"IoBase"=dword:02F8串口1的IO空間首地址為十六進(jìn)制2F8"IoLen"=dword:8串口1的IO空間長(zhǎng)度為8個(gè)字節(jié)"DeviceArrayIndex"=dword:0串口1的索引,是1的由來"Order"=dword:0串口1驅(qū)動(dòng)的加載順序"DeviceType"=dword:0串口1的設(shè)備類型"DevConfig"=hex: 10,00 ....串口1在與Modem設(shè)備通訊時(shí)的配置,如波特率、奇偶校檢等"FriendlyName"="COM1:"串口1在撥號(hào)程序中顯示的名字"Tsp"="Unimodem.dll"串口1 被用于與Modem設(shè)備通訊的時(shí)候要加載的TSP(TAPI Service provider)DLL"Prefix"="COM"串口1的流接口的前綴"Dll"="com16550.Dll"串口1的驅(qū)動(dòng)程序DLL
SysIntr由CE在文件Nkintr.h中預(yù)定義,用于唯一標(biāo)識(shí)中斷設(shè)備。OEM可以在文件Oalintr.h中定義自己的SysIntr。常見的預(yù)定義SysIntr有SYSINTR_NOP(中斷只由ISR處理,IST不再處理),SYSINTR_RESCHED(重新調(diào)度線程),SYSINTR_DEVICES(由CE預(yù)定義的設(shè)備中斷ID的基值),SYSINTR_PROFILE、SYSINTR_TIMING、SYSINTR_FIRMWARE等都是基于SYSINTR_DEVICES定義的。IoBase是串口1的IO地址空間的首地址,IoLen是IO空間的大小。IO地址空間只存在于x86平臺(tái),如果在其它平臺(tái)硬件寄存器必須映射到物理地址空間,那子鍵的名稱為MemBase和MemLen。在x86平臺(tái)更多硬件的寄存器由于IO空間的局限也映射到物理地址空間。DeviceArrayIndex是設(shè)備的索引,用于區(qū)分同類型的設(shè)備。Prefix是流驅(qū)動(dòng)程序的前綴,當(dāng)應(yīng)用程序調(diào)用CreateFile函數(shù)傳遞COM1:參數(shù)時(shí),文件系統(tǒng)負(fù)責(zé)與串口驅(qū)動(dòng)程序通信,串口驅(qū)動(dòng)程序是在CE啟動(dòng)時(shí)由device.exe加載的。下面從MDD層函數(shù)COM_Init開始探索串口驅(qū)動(dòng)的初始化過程。COM_Init是在串口設(shè)備被檢測(cè)后由設(shè)備管理器device.exe調(diào)用的,主要的作用是初始化設(shè)備,它的唯一參數(shù)Identifier是由device.exe傳遞的,其類型是一個(gè)字符串指針,字符串的內(nèi)容是HLMDriversActivexx,xx是一個(gè)十進(jìn)制數(shù)(device.exe會(huì)跟蹤系統(tǒng)中每個(gè)驅(qū)動(dòng)程序,把加載的驅(qū)動(dòng)程序記錄在Active鍵下)。
COM_Init先分配一個(gè)HW_INDEP_INFO結(jié)構(gòu)體,這個(gè)結(jié)構(gòu)體是獨(dú)立于串口硬件的頭信息(MDD、PDD、SER16550都包含自己獨(dú)特的結(jié)構(gòu)體,具體的結(jié)構(gòu)體定義請(qǐng)參見串口驅(qū)動(dòng)源碼),分配之后再初始化結(jié)構(gòu)體中每個(gè)成員,初始化結(jié)構(gòu)體后調(diào)用 OpenDeviceKey((LPCTSTR)Identifier)打開HLMDriversActivexxKey包含的注冊(cè)表路徑,在這里路徑一般為HLMDriversBuiltInSerial,即串口的驅(qū)動(dòng)程序信息在注冊(cè)表中所處的位置。COM_Init接著在HLMDriversBuiltInSerial下查詢DeviceArrayIndex、Priority256的值,Priority256指定了驅(qū)動(dòng)程序的優(yōu)先級(jí),如果沒有就用默認(rèn)的優(yōu)先級(jí)。接下來調(diào)用GetSerialObject(DeviceArrayIndex),這個(gè)函數(shù)由PDD層定義,返回HWOBJ結(jié)構(gòu)體,這個(gè)結(jié)構(gòu)體主要包含PDD層和SER16550定義的函數(shù)的指針。
也就是說MDD通過調(diào)用這個(gè)函數(shù)才能調(diào)用底層實(shí)現(xiàn)的函數(shù)。接下來的大多數(shù)工作都是調(diào)用底層函數(shù)實(shí)現(xiàn)初始化。第一個(gè)調(diào)用的底層函數(shù)SerInit主要設(shè)置由用戶設(shè)置的硬件配置,例如線路控制、波特率。它調(diào)用Ser_GetRegistryData函數(shù)得到保存在注冊(cè)表中的硬件信息,Ser_GetRegistryData在內(nèi)部調(diào)用系統(tǒng)提供的DDKReg_GetIsrInfoDDK和DDKReg_GetWindowInfo函數(shù)得到在HLMDriversBuiltInSerial下保存的IRQ、SysIntr、IsrDll、IsrHandler、IoBase、IoLen。IRQ是邏輯中斷號(hào),IsrDll表示當(dāng)前驅(qū)動(dòng)程序的可安裝ISR所在的DLL名稱,IsrHandler 表示可安裝ISR的函數(shù)名稱。
在這里順便提一下可安裝ISR,讀者在我以前發(fā)表的關(guān)于OAL的文章中可以了解到OEM在OEMInit函數(shù)中關(guān)聯(lián)IRQ和SysIntr,當(dāng)硬件設(shè)備發(fā)生中斷時(shí),ISR會(huì)禁止同級(jí)和低級(jí)中斷,然后根據(jù)IRQ返回關(guān)聯(lián)的SysIntr,內(nèi)核根據(jù)ISR返回的SysIntr喚醒相應(yīng)的IST(SysIntr與IST創(chuàng)建的Event關(guān)聯(lián)),IST處理中斷之后調(diào)用InterruptDone解除中斷禁止。在OEMInit中關(guān)聯(lián)的缺點(diǎn)是一旦編譯了CE內(nèi)核后就無(wú)法添加這種關(guān)聯(lián)了,而一些硬件設(shè)備會(huì)隨時(shí)插拔或者共享中斷,要關(guān)聯(lián)這樣的硬件設(shè)備解決方法就是可安裝ISR,可安裝ISR專用于處理指定的硬件設(shè)備發(fā)出的中斷,所以如果硬件設(shè)備需要可安裝ISR必須在注冊(cè)表中添加IsrDll、IsrHandler。多數(shù)硬件設(shè)備采用CE默認(rèn)的可安裝ISR giisr.dll,格式如下:
"IsrDll"="giisr.dll"
"IsrHandler"="ISRHandler"
如果一個(gè)硬件驅(qū)動(dòng)程序需要可安裝ISR而開發(fā)者又不想自己寫一個(gè),那么可以利用giisr.dll來實(shí)現(xiàn)。除了在注冊(cè)表中添加如上所示外,還要在驅(qū)動(dòng)程序中調(diào)用相關(guān)函數(shù)注冊(cè)可安裝ISR。偽代碼如下:
g_IsrHandle = LoadIntChainHandler(IsrDll, IsrHandler, (BYTE)Irq);
GIISR_INFO Info;
PHYSICAL_ADDRESS PortAddress = {PhysAddr, 0};
TransBusAddrToStatic(BusType, dwBusNumber, PortAddress, dwAddrLen, &dwIOSpace, &(PVOID)PhysAddr)
Info.SysIntr = dwSysIntr;
Info.CheckPort = TRUE;
Info.PortIsIO = (dwIOSpace) ? TRUE : FALSE;
Info.UseMaskReg = TRUE;
Info.PortAddr = PhysAddr + 0x0C;
Info.PortSize = sizeof(DWORD);
Info.MaskAddr = PhysAddr + 0x10;
KernelLibIoControl(g_IsrHandle, IOCTL_GIISR_INFO, &Info, sizeof(Info), NULL, 0, NULL);
LoadIntChainHandler函數(shù)負(fù)責(zé)注冊(cè)可安裝ISR,參數(shù)1為DLL名稱,參數(shù)2為ISR函數(shù)名稱,參數(shù)3為IRQ。TransBusAddrToStatic函數(shù)在后面講。如果要利用giisr.dll作為可安裝ISR,必須先填充GIISR_INFO結(jié)構(gòu)體,CheckPort=TRUE表示giisr要檢測(cè)指定的寄存器來確定當(dāng)前發(fā)出中斷的是否是這個(gè)設(shè)備。PortIsIO表示寄存器地址屬于哪個(gè)地址空間,F(xiàn)ALSE表示是內(nèi)定空間,TRUE表示IO空間。UseMaskReg=TRUE表示設(shè)備有一個(gè)掩碼寄存器,專用于指定當(dāng)前設(shè)備是否是中斷源,也就是發(fā)出中斷,而MaskAddr表示掩碼寄存器的地址。如果對(duì)Info.Mask賦值,那么PortAddr表示一個(gè)特殊的寄存器地址,這個(gè)寄存器的值與Mask的值&運(yùn)算的結(jié)果如果為真,則證明當(dāng)前設(shè)備是中斷源,否則返回SYSINTR_CHAIN(表示當(dāng)前ISR沒有處理中斷,內(nèi)核將調(diào)用ISR鏈中下一個(gè)ISR),如果UseMaskReg=TRUE,那么MaskReg寄存器的值與PortAddr指定的寄存器的值&運(yùn)算的結(jié)果如果為真,則證明當(dāng)前設(shè)備是中斷源。