USB設(shè)備驅(qū)動(dòng)程序開發(fā)

　　引言

　　USB總線是1995年微軟、IBM等公司推出的一種新型通信標(biāo)準(zhǔn)總線，特點(diǎn)是速度快、價(jià)格低、獨(dú)立供電、支持熱插拔等，其版本從早期的1.0、1.1已經(jīng)發(fā)展到目前的2.0版本，2.0版本的最高數(shù)據(jù)傳輸速度達(dá)到480Mbit/s，能滿足包括視頻在內(nèi)的多種高速外部設(shè)備的數(shù)據(jù)傳輸要求，由于其眾多的優(yōu)點(diǎn)，USB總線越來越多的被應(yīng)用到計(jì)算機(jī)與外設(shè)的接口中，芯片廠家也提供了多種USB接口芯片供設(shè)計(jì)者使用，為了開發(fā)出功能強(qiáng)大的USB設(shè)備，設(shè)計(jì)者往往需要自己開發(fā)USB設(shè)備驅(qū)動(dòng)程序，驅(qū)動(dòng)程序開發(fā)一直是Windows開發(fā)中較難的一個(gè)方面，但是通過使用專門的驅(qū)動(dòng)程序開發(fā)包能減小開發(fā)的難度，提高工作效率，本文使用Compuware Numega公司的DriverStudio3.2開發(fā)包，開發(fā)了基于NXP公司USB2.0控制芯片ISP1581的USB設(shè)備驅(qū)動(dòng)程序。

　　USB設(shè)備驅(qū)動(dòng)程序的模型

　　USB設(shè)備驅(qū)動(dòng)程序是一種典型的WDM(Windows Driver Model)驅(qū)動(dòng)程序，其程序模型如圖1所示。用戶應(yīng)用程序工作在Windows操作系統(tǒng)的用戶模式層，它不能直接訪問USB設(shè)備，當(dāng)需要訪問時(shí)，通過調(diào)用操作系統(tǒng)的API(Application programming interface)函數(shù)生成I/O請(qǐng)求信息包(IRP)，IRP被傳輸?shù)焦ぷ饔趦?nèi)核模式層的設(shè)備驅(qū)動(dòng)程序，并通過驅(qū)動(dòng)程序完成與UBS外設(shè)通信。設(shè)備驅(qū)動(dòng)程序包括兩層：函數(shù)驅(qū)動(dòng)程序?qū)雍涂偩€驅(qū)動(dòng)程序?qū)?，函?shù)驅(qū)動(dòng)程序一方面通過IRP及API函數(shù)與應(yīng)用程序通信，另一方面調(diào)用相應(yīng)的總線驅(qū)動(dòng)程序，總線驅(qū)動(dòng)程序完成和外設(shè)硬件通信。USB總線驅(qū)動(dòng)程序已經(jīng)由操作系統(tǒng)提供，驅(qū)動(dòng)程序開發(fā)的重點(diǎn)是函數(shù)驅(qū)動(dòng)程序。

　　USB設(shè)備驅(qū)動(dòng)程序的設(shè)計(jì)

　　使用DriverStudio3.2開發(fā)USB設(shè)備驅(qū)動(dòng)程序

　　該驅(qū)動(dòng)程序的主要功能包括：從控制端點(diǎn)0讀取規(guī)定個(gè)數(shù)的數(shù)據(jù)、向端點(diǎn)0發(fā)出控制命令、從端點(diǎn)2批量讀數(shù)據(jù)、向端點(diǎn)2批量寫數(shù)據(jù)，驅(qū)動(dòng)程序的開發(fā)采用DriverStudio3.2驅(qū)動(dòng)程序開發(fā)包及VC++6.0，使用開發(fā)包中的向?qū)С绦駾riverWizard就可以方便的生成驅(qū)動(dòng)程序框架、模塊及部分程序源代碼，開發(fā)者只需要在功能模塊中加入自己的實(shí)現(xiàn)程序就能完成復(fù)雜的USB設(shè)備驅(qū)動(dòng)程序設(shè)計(jì)，下面介紹使用DriverWizard生成ISP1581驅(qū)動(dòng)程序的過程：

　　(1)啟動(dòng)DriverWizard，選擇DriverWorks Project創(chuàng)造一個(gè)名為USBDIO的VC++項(xiàng)目;

　　(2)在驅(qū)動(dòng)程序類型中選擇WDM Driver，WDM Function Driver,在硬件設(shè)備所支持的總線類型中選擇USB(WDM Only)，在USB Vendor ID(廠商識(shí)別碼)中填寫0741，在USB Product ID(產(chǎn)品識(shí)別碼)中填寫0821;

　　(3)增加USB設(shè)備端點(diǎn)，設(shè)置端點(diǎn)2為批量輸入/輸出傳輸方式;

　　(4)在驅(qū)動(dòng)程序支持的功能項(xiàng)中選擇Read、Write、Device Control、Cleanup;

　　(5)選擇自動(dòng)產(chǎn)生批量讀及批量寫程序代碼;

　　(6)在I/O請(qǐng)求IRP處理方式中選擇None，即IRP不排隊(duì);

　　(7)在接口的打開方式中選擇Symbolic link:UsbdioDevice，即應(yīng)用程序以符號(hào)鏈接名打開設(shè)備;

　　(8)定義應(yīng)用程序調(diào)用DeviceIo Control 函數(shù)對(duì)WDM驅(qū)動(dòng)程序通信的控制命令，結(jié)果如圖2所示。

　　(9)最后選擇完成并確認(rèn)生成新的項(xiàng)目信息，向?qū)С绦蚓蜁?huì)在usbdio目錄中生成一個(gè)名為USBDIO的項(xiàng)目文件，其中包括了ISP1581驅(qū)動(dòng)程序框架、模塊及部分源代碼。

USB設(shè)備驅(qū)動(dòng)程序的編程

　　在使用DriverWizard生成驅(qū)動(dòng)程序框架、模塊及部分程序源代碼后，開發(fā)者只需完成圖2中三個(gè)控制代碼所對(duì)應(yīng)的三個(gè)功能模塊的編程：模塊USBDIO_IOCTL_ ID_CODE_Handler的功能是從控制端點(diǎn)0讀取數(shù)據(jù)，模塊USBDIO_IOCTL_ TEST_COMMAND_Handler的功能是向控制端點(diǎn)0發(fā)送一個(gè)控制命令，模塊USBDIO_IOCTL_DMA_COMMAND _Handler的功能是向控制端點(diǎn)0發(fā)送一個(gè)要求USB設(shè)備進(jìn)行DMA傳輸?shù)目刂泼睿旅媸堑谝粋€(gè)模塊的編程實(shí)例。

　　NTSTATUS USBDIODevice::USBDIO

　　_IOCTL_ID_CODE_Handler(KIrp I)

　　{

　　NTSTATUS status =STATUS_

　　SUCCESS;

　　t << "Entering USBDIODevice

　　::USBDIO _IOCTL_ID_ CODE_

　　Handler, " << I << EOL;

　　PURB pUrb;

　　ULONG numData;

　　numData=*(PUCHAR)I.IoctlBuffer();

　　//設(shè)置讀取的數(shù)據(jù)個(gè)數(shù)

　　pUrb=m_Lower.BuildVendorRequest(

　　(PUCHAR)I.IoctlBuffer(),//驅(qū)動(dòng)程

　　序存放讀取的數(shù)據(jù)的內(nèi)存區(qū)

　　numData,//wLength，讀取的數(shù)據(jù)個(gè)數(shù)

　　0,

　　0x0c,//bRequest 0,//wValue

　　TRUE,//input

　　TRUE,

　　NULL,

　　0x0472,//wIndex,傳輸?shù)焦碳绦?/P>

　　的讀數(shù)命令碼

　　URB_FUNCTION_VENDOR_ENDPOINT,

　　NULL

　　);

　　if(pUrb==NULL)

　　{

　　I.Information() =0;

　　status=STATUS_INSUFFICIENT_

　　RESOURCES;

　　}

　　else

　　{

　　I.Information() =numData;

　　tatus=m_Lower.SubmitUrb(pUrb,NULL,

　　NULL,0);

　　delete pUrb;

　　}

　　return status;

　　}

　　對(duì)象I包含了應(yīng)用程序下傳的IRP內(nèi)容，包括命令或數(shù)據(jù)等參數(shù)，函數(shù)BuildVendorRequest用來分配并初始化一個(gè)用于廠商請(qǐng)求的URB(USB Request Block)，該URB將作為下傳IRP的一個(gè)參數(shù)，通過函數(shù)SubmitUrb發(fā)送給總線驅(qū)動(dòng)程序，以便完成與硬件的通信。

　在初始化URB時(shí)需要了解USB的傳輸方式及傳輸協(xié)議，該功能使用了USB的控制傳輸方式，該方式包括三個(gè)階段：設(shè)置階段、數(shù)據(jù)階段和狀態(tài)階段，其中數(shù)據(jù)階段可選，開發(fā)者主要關(guān)注設(shè)置階段中的8個(gè)關(guān)鍵字節(jié)的定義，8字節(jié)分成了5個(gè)字段，定義了傳輸請(qǐng)求及相關(guān)信息，這8個(gè)字節(jié)的格式如圖3所示。

　　BmRequestType：1字節(jié)，用來指定數(shù)據(jù)流動(dòng)的方向，請(qǐng)求的類型，以及接收者。

　　bRequest：1字節(jié)，用來指定請(qǐng)求。

　　wValue：2字節(jié)，主機(jī)用來傳輸信息給設(shè)備，開發(fā)者可以根據(jù)情況自己定義。

　　wIndex：2字節(jié)，主機(jī)用來傳輸信息給設(shè)備，開發(fā)者可以根據(jù)情況自己定義。

　　wLength：2字節(jié)，包含數(shù)據(jù)階段中接下來要傳輸?shù)臄?shù)據(jù)字節(jié)數(shù)目。

　　以上字段的應(yīng)用已經(jīng)在程序注釋中標(biāo)出，在此不再贅述。

　　USB設(shè)備驅(qū)動(dòng)程序的安裝及調(diào)用

　　USB設(shè)備驅(qū)動(dòng)程序的安裝

　　驅(qū)動(dòng)程序編譯完成后會(huì)生成一個(gè)名為USBDIO.SYS的文件，即USB設(shè)備驅(qū)動(dòng)程序，另外在使用向?qū)С绦騑izardDriver生成驅(qū)動(dòng)程序時(shí)會(huì)產(chǎn)生一個(gè)名為USBDIO.INF的驅(qū)動(dòng)程序安裝程序，對(duì)此程序只需稍做修改就能正常使用，具體是將類改為USB，即Class=USB，由于本驅(qū)動(dòng)程序使用符號(hào)鏈接名打開設(shè)備，所以刪除ClassGUID選項(xiàng)，注意設(shè)備標(biāo)識(shí)符必需為：%DeviceDesc%=USBDIO_DDI, USB\VID_0471&PID_0821，其中0471是USB控制芯片的廠商識(shí)別碼，0821是USB設(shè)備標(biāo)識(shí)碼。

　　驅(qū)動(dòng)程序安裝過程是：將USB設(shè)備加電，連入計(jì)算機(jī)的USB接口，這時(shí)候會(huì)看到Windows操作系統(tǒng)提示發(fā)現(xiàn)新硬件，提問是否安裝驅(qū)動(dòng)程序，選擇是，然后選擇驅(qū)動(dòng)程序所在文件夾，選擇文件USBDIO.INF即可完成安裝。

　　USB設(shè)備驅(qū)動(dòng)程序的調(diào)用

　　為了完成對(duì)驅(qū)動(dòng)程序的調(diào)用，筆者使用VC++6.0編寫了USB應(yīng)用程序包，程序包共由五個(gè)功能模塊組成，用戶通過調(diào)用這些模塊即可方便的完成對(duì)USB外設(shè)的控制及讀寫，這些模塊如下。

　　● int CTRLReadData(unsigned char usbSelect，unsigned char *rbuffer，unsigned char numData)，主要功能是讀取ISP1581控制端點(diǎn)0發(fā)來的數(shù)據(jù)，數(shù)據(jù)存放在緩沖區(qū)rbuffer中。

　　● int CTRLSendTestCommand (unsigned char usbSelect，unsigned short int testCommand)，主要功能是發(fā)送測(cè)試命令，變量testCommand定義了測(cè)試命令。

　　● int CTRLSendDMACommand (unsigned char usbSelect，unsigned char dmaDirection，unsigned char ramSelect,unsigned long dmaLength)，主要功能是發(fā)送DMA傳輸命令，變量dmaDirection定義數(shù)據(jù)傳輸方向，ramSelect定義將要操作的USB外設(shè)的存儲(chǔ)器，dmaLength定義了數(shù)據(jù)傳輸總數(shù)。

　　● int DMARead(unsigned char usbSelect，unsigned char *rbuffer，int len，int waitTime)，主要功能是計(jì)算機(jī)批量讀取ISP1581中的數(shù)據(jù)，而ISP1581以DMA方式從外部RAM讀取數(shù)據(jù)。

　　● int DMAWrite(unsigned char usbSelect，unsigned char *rbuffer，int len， int waitTime)，主要功能是計(jì)算機(jī)批量寫數(shù)據(jù)到ISP1581，而ISP1581將以DMA方式寫數(shù)據(jù)到外部RAM。