??? 摘? 要: 介紹了在Windows2000操作系統(tǒng)下,使用DriverStudio軟件編寫符合WDM模式的PCI數(shù)據(jù)傳輸卡驅(qū)動(dòng)程序,并詳細(xì)分析了一個(gè)應(yīng)用實(shí)例??
??? 關(guān)鍵詞: PCI總線? 設(shè)備驅(qū)動(dòng)程序? WDM模式? DriverStudio
?
PCI總線規(guī)范是為提高微機(jī)總線的數(shù)據(jù)傳輸速度而制定的一種局部總線標(biāo)準(zhǔn)?在設(shè)計(jì)自行開發(fā)的基于PCI總線的數(shù)據(jù)傳輸設(shè)備時(shí),需要開發(fā)相應(yīng)的設(shè)備驅(qū)動(dòng)程序" title="設(shè)備驅(qū)動(dòng)程序">設(shè)備驅(qū)動(dòng)程序?通常開發(fā)PCI設(shè)備驅(qū)動(dòng)程序有多種模式,在Windows2000環(huán)境下,主要采用WDM模式?本文針對自行開發(fā)的基于PCI總線的CCD視頻信號傳輸控制卡,編寫了符合WDM模式的驅(qū)動(dòng)程序?
1 WDM模式驅(qū)動(dòng)程序
1.1 WDM模式(Windows Driver Model)
Windows2000對驅(qū)動(dòng)程序的編寫不再基于以往的Win3.x和Win9x下的VxD(虛擬設(shè)備驅(qū)動(dòng)程序)結(jié)構(gòu),而是基于一種新的驅(qū)動(dòng)模型——WDM(Windows Driver Model)?
WDM為Windows98/2000/XP操作系統(tǒng)的設(shè)備驅(qū)動(dòng)程序的設(shè)計(jì)提供了統(tǒng)一的框架?WDM來源于Windows NT的分層32位設(shè)備驅(qū)動(dòng)程序模型(layered 32-bit device driver model)?它支持更多的特性,如即插即用(PnP)?電源管理?WMI和NT事件?
1.2 設(shè)備驅(qū)動(dòng)程序
設(shè)備驅(qū)動(dòng)程序是操作系統(tǒng)的一個(gè)組成部分,它由I/O管理器(I/O" title="I/O">I/O Manager)管理和調(diào)動(dòng)?Windows2000操作系統(tǒng)下的I/O管理器" title="管理器">管理器功能描述如圖1所示?
?
I/O管理器每收到一個(gè)來自用戶應(yīng)用程序" title="應(yīng)用程序">應(yīng)用程序的請求就創(chuàng)建一個(gè)I/O請求包(IRP)的數(shù)據(jù)結(jié)構(gòu),并將其作為參數(shù)傳遞給驅(qū)動(dòng)程序?驅(qū)動(dòng)程序通過識別IRP中的物理設(shè)備對象(PDO)來區(qū)別是發(fā)送給哪一個(gè)設(shè)備?IRP結(jié)構(gòu)中存放請求的類型?用戶緩沖區(qū)的首地址?用戶請求數(shù)據(jù)的長度等信息?驅(qū)動(dòng)程序處理完這個(gè)請求后,在該結(jié)構(gòu)中填入處理結(jié)果的有關(guān)信息,調(diào)用IoCompleteRequest將其返回給 I/O管理器,用戶應(yīng)用程序的請求隨即返回?訪問硬件時(shí),驅(qū)動(dòng)程序通過調(diào)用硬件抽象層的函數(shù)實(shí)現(xiàn)?
1.3 DriverStudio工具簡介
NuMega Lab公司開發(fā)的DriverStudio是一整套開發(fā)?調(diào)試和檢測Windows平臺下設(shè)備驅(qū)動(dòng)程序的工具軟件包?它把DDK(Device Development Kit)封裝成完整的C++函數(shù)庫,根據(jù)具體硬件通過向?qū)煽蚣艽a,并且提供了一套完整的調(diào)試和性能測試工具SoftICE?DriverMonitor等?
2 應(yīng)用實(shí)例
本文利用PCI專用接口芯片PCI9052設(shè)計(jì)了一個(gè)數(shù)據(jù)傳輸控制卡?卡上主要的芯片有PCI9052?FIFO(CY
?
??? 在數(shù)據(jù)輸入過程中,最重要的是對數(shù)據(jù)進(jìn)行實(shí)時(shí)控制,因此需要硬件中斷。在中斷程序中,根據(jù)外部FIFO狀態(tài)完成數(shù)據(jù)的讀入。
2.1 用DriverWizard生成驅(qū)動(dòng)程序框架
??? DriverStudio中的DriverWorks軟件為開發(fā)WDM程序提供了一個(gè)完整的框架?它包含一個(gè)可快速生成WDM驅(qū)動(dòng)程序框架的代碼生成向?qū)Чぞ?/SPAN>DriverWizard,而且還帶有許多類庫?在用DriverWizard生成的程序框架中寫入相對于設(shè)備的特定代碼,編譯后即可得到所需的驅(qū)動(dòng)程序?
在利用DriverWorks V2.7的向?qū)?/SPAN>Driver Wizard完成驅(qū)動(dòng)程序的框架時(shí)共有11個(gè)步驟,其中關(guān)鍵步驟有:
(1)在第四步中選中PCI,并在VendorID和DeviceID中分別輸入廠商號和設(shè)備號,還需填入PCI Subsystem ID和PCI Revision ID?這四項(xiàng)可以用網(wǎng)上的免費(fèi)軟件PCITree或PCIView瀏覽PCI設(shè)備,用這兩個(gè)軟件也可以得到BAR0~BAR5的資源分配情況和中斷號?
(2)第七步IRP隊(duì)列排隊(duì)方法,它決定了驅(qū)動(dòng)程序檢查設(shè)備的方式?本設(shè)計(jì)選SystemManaged,則所有的IRP排隊(duì)都由系統(tǒng)(即I/O管理器)完成?
(3)第九步是最關(guān)鍵的一步?首先在Resources中添加資源,在name中輸入變量名,在PCI Base Address中輸入0～5的序列號。0～5和BAR0～BAR5一一對應(yīng)?在設(shè)置中斷對話框中,在name欄寫入中斷服務(wù)程序的名稱,選中創(chuàng)建中斷服務(wù)程序ISR(Create ISR),不選創(chuàng)建延遲程序調(diào)用DPC(Create DPC),選中Make ISR/DPC class functions,使ISR/DPC成為設(shè)備類的成員函數(shù)?
??? 其次選中Buffer以選取讀寫方式,用于描述與I/O操作相關(guān)的數(shù)據(jù)緩沖區(qū)?本設(shè)計(jì)需要快速傳送大量數(shù)據(jù),因此采用Direct I/O方式?
??? (4)在第十步中,需要加入與應(yīng)用程序或者其他驅(qū)動(dòng)程序通信的I/O控制代碼參量?
2.2 驅(qū)動(dòng)程序模塊框圖和代碼分布
??? PCI設(shè)備驅(qū)動(dòng)程序模塊包括配置空間的訪問模塊?IO端口模塊?內(nèi)存讀寫模塊和終端模塊等?各模塊之間是對等的?驅(qū)動(dòng)程序模塊框圖如圖3所示?
?
??? 驅(qū)動(dòng)程序初始化模塊代碼段放在#pragma? code_seg (“INT”)和#pragma? code_seg( )雪之間?在系統(tǒng)初始化完成后,這部分代碼從內(nèi)存中釋放,防止占用系統(tǒng)寶貴的內(nèi)存資源?#pragma? code_seg( )之后是驅(qū)動(dòng)程序和系統(tǒng)的許多模塊的實(shí)現(xiàn)部分。這部分在驅(qū)動(dòng)程序運(yùn)行后不會(huì)從內(nèi)存中釋放。
2.3 驅(qū)動(dòng)程序主要模塊的實(shí)現(xiàn)
??? (1) 雪配置空間的訪問模塊
??? DriverWorks的KPciConfiguration類封裝了訪問PCI設(shè)備配置空間的所有操作?首先初始化這個(gè)類的實(shí)例:
??? KpciConfiguration PciConfig(m_Lower.TopOfStack( ));
??? /*m_Lower是 KpnpLowerDevice類的對象?m_LowerTopOfStack( )返回當(dāng)前設(shè)備堆棧頂部的設(shè)備對象。*/
初始化完后可以直接利用成員函數(shù) ReadHeader/ WriteHeader函數(shù)訪問所有的配置寄存器?
??? 為了確定映射空間的類型和大小,先向目標(biāo)基地址寄存器寫入0Xffffffffh,然后回讀該寄存器的值?如果最低位為1,表示映射于I/O空間,反之為存儲(chǔ)空間;如果映射于存儲(chǔ)空間,從第四位開始計(jì)算0的個(gè)數(shù)可以確定內(nèi)存空間的大小;如果是I/O方式,從第二位開始計(jì)算0的個(gè)數(shù)可確定I/O空間的大小,最大為256字節(jié)?如果設(shè)備的存儲(chǔ)空間超過256字節(jié),要實(shí)現(xiàn)設(shè)備的整個(gè)存儲(chǔ)部分的訪問,就必須采用內(nèi)存映射?
??? (2) I/O操作模塊
??? Driverworks的KIoRange類封裝了I/O端口訪問的操作?部分代碼如下:
??? {……
??? KIORange? DevIoPort( );//創(chuàng)建實(shí)例
??? NTSTATUS status= DevIoPort( ).Initialize? (pResListTranslated,pResListRaW,PciConfig.BaseAddressIndexToOrdinal(0));
??? /*第一個(gè)參數(shù)為轉(zhuǎn)換后的資源列表指針;第二個(gè)參數(shù)為原始資源列表指針;第三個(gè)參數(shù)中的0為 I/O口對應(yīng)的基地址,用來轉(zhuǎn)換成特定端口資源的序數(shù)*/
??? If(NT _SUCCESS(status))
??? {……
????????????? DevIoPort.inb(0,LineBuf1,10)；
??? /*成功初始化后可分別用KIoRange類的成員函數(shù)inb( )/outb( )從端口中讀/寫字節(jié) */
??? else{Invalidate( );return status;
??? /*未能初始化成功,錯(cuò)誤信息在status中*/
??? }
……}
??? (3) 內(nèi)存讀寫模塊
??? DriverWorks的 KMemoryRange類封裝了端口訪問的操作?
??? status=m_MemoryRange( ).Initialize(pResListTranslated,pResListRaw, PciConfig.BaseAddressIndexToOrdinal(0));
??? 此函數(shù)的參數(shù)?意義及具體用法與I/O端口的操作基本相同?
??? 內(nèi)存對象也用來發(fā)送控制字,以控制CPLD的開始和停止等?實(shí)際上控制字" title="控制字">控制字是通過PCI9052發(fā)送的?該控制字地址已被映射成PCI的內(nèi)存空間?所以定義一個(gè)指向內(nèi)存空間的內(nèi)存對象,通過該對象即可發(fā)送控制字?
??? (4)中斷模塊
??? 在中斷模塊,首先要激活PCI9052中斷使能位,然后判斷硬件中斷響應(yīng)是否產(chǎn)生,如果有,則進(jìn)行突發(fā)傳輸,讀入FIFO中的數(shù)據(jù)?
??? BOOLEAN TranCard::Isr_MyIrq(void)
??? {?if ( // 中斷未產(chǎn)生)
??????? {……
????return? FALSE;}
??? else
??? {/*如果產(chǎn)生硬件中斷,設(shè)置命令寄存器,進(jìn)行突發(fā)數(shù)據(jù)傳輸*/
?????? return TRUE;}
??? {
??? 為了將硬件中斷與編寫的中斷服務(wù)程序連接在一起,采用InitializeAndConnect方法,部分代碼如下:
??? NTSTATUS TranCardDevice::OnStartDevice(KIrp I)
??? {……
?????? status=m_MyIrq. InitializeAndConnect(
?????? pResListTranlated,
?????? LinkTo(Isr_MyIrq)
?????? This;)
??? ……)
2.4 驅(qū)動(dòng)程序的調(diào)用
??? 編寫驅(qū)動(dòng)程序本身不是最終目的,最終目的是調(diào)用驅(qū)動(dòng)程序管理資源,并為用戶應(yīng)用程序使用?驅(qū)動(dòng)程序加載以后,它的許多進(jìn)程處于Idle狀態(tài),實(shí)際上需要用戶應(yīng)用程序去調(diào)用激活?應(yīng)用程序利用Win32 API直接調(diào)用驅(qū)動(dòng)程序,實(shí)現(xiàn)驅(qū)動(dòng)程序和應(yīng)用程序的信息交互?
??? 首先用CreateFile( )打開設(shè)備,獲得一個(gè)指向設(shè)備對象的句柄?使用CreateFile函數(shù)時(shí)應(yīng)注意:由于驅(qū)動(dòng)程序是*.sys,所以第一個(gè)參數(shù)應(yīng)該是這個(gè)設(shè)備對象的標(biāo)志連接(symbolic link)?該標(biāo)志連接名有一個(gè)設(shè)置數(shù)據(jù)文件搜索路徑的數(shù)字號,而這個(gè)數(shù)字號通常是零?如果這個(gè)連接名是″TranCard″,則傳遞給CreateFile的宇符串就是:″\\\\.\\ TranCard0″?例如:
HANDLE hDevice=CreateFile:″\\\\.\\TranCard0″。GENERIC_READ|GENERIC_WRITE，FILE_SHARE_READ, NULL, OPEN_EXISTING,0,NULL);
??? 然后用 DeviceIoControl( )進(jìn)行數(shù)據(jù)的傳送?最后用CloseHandle( )關(guān)閉設(shè)備句柄?
??? 下面是應(yīng)用DeviceIoControl( )程序片段?
??? {……
??? m_b=DeviceIoControl(hDevice)TRANCARD_IOCTL_RECEIVE,buffer, sizeof(buffer),NULL, 0,&buffersize,NULL);
??? ……}
2.5 驅(qū)動(dòng)程序的調(diào)試
??? 采用SoftICE?DriverMonitor作為調(diào)試工具,基本調(diào)試過程如下:(1)使用symbol loader加載驅(qū)動(dòng)程序,然后使用SoftICE跟蹤調(diào)試,確認(rèn)驅(qū)動(dòng)程序正常加載;(2)對核心的中斷響應(yīng)程序代碼,用SoftICE中的Genint命令產(chǎn)生虛擬中斷,單步跟蹤中斷;(3)硬件發(fā)送大量的數(shù)據(jù),通過查看內(nèi)存的數(shù)據(jù),確認(rèn)數(shù)據(jù)傳輸是否正確?
??? 在驅(qū)動(dòng)程序的調(diào)試過程中,經(jīng)常出現(xiàn)系統(tǒng)“死機(jī)”?“藍(lán)屏”等現(xiàn)象,這些情況可能因內(nèi)存訪問分頁錯(cuò)誤?設(shè)備資源和系統(tǒng)資源沖突?I/O使用錯(cuò)誤?程序中“指針”使用錯(cuò)誤等因素造成?
??? 上述方案均調(diào)試通過?使用WDM模式開發(fā)驅(qū)動(dòng)程序,程序結(jié)構(gòu)清晰,開發(fā)周期較短,效率高?在PCI從模式條件下,大數(shù)據(jù)量連續(xù)傳輸速度可達(dá)28Mbps以上?
?
參考文獻(xiàn)
1 Walter Oney.Programming the Microsoft Windows Drivers?Model.Microsoft Press Copyright[c]. 1999
2 DriverWorks Help V2.7. Compuware Corporation,2002
3 張惠娟,周利華,翟鴻鳴.Windows環(huán)境下的設(shè)備驅(qū)動(dòng)程序設(shè)計(jì).西安:西安電子科技大學(xué)出版社,2002
4 Chris Cant著,孫 義,馬莉波,國雪飛譯.Windows WDM設(shè)備驅(qū)動(dòng)程序開發(fā)指南.2000
?