USB设备驱动程序开发

admin

引言
　　USB总线是1995年微软、IBM等公司推出的一种新型通信标准总线，特点是速度快、价格低、独立供电、支持热插拔等，其版本从早期的1.0、1.1已经发展到目前的2.0版本，2.0版本的最高数据传输速度达到480Mbit/s，能满足包括视频在内的多种高速外部设备的数据传输要求，由于其众多的优点，USB总线越来越多的被应用到计算机与外设的接口中，芯片厂家也提供了多种USB接口芯片供设计者使用，为了开发出功能强大的USB设备，设计者往往需要自己开发USB设备驱动程序，驱动程序开发一直是Windows开发中较难的一个方面，但是通过使用专门的驱动程序开发包能减小开发的难度，提高工作效率，本文使用Compuware Numega公司的DriverStudio3.2开发包，开发了基于NXP公司USB2.0控制芯片ISP1581的USB设备驱动程序。
　　USB设备驱动程序的模型
　　USB设备驱动程序是一种典型的WDM(Windows Driver Model)驱动程序，其程序模型如图1所示。用户应用程序工作在Windows操作系统的用户模式层，它不能直接访问USB设备，当需要访问时，通过调用操作系统的API(Application PROGRAMMING interface)函数生成I/O请求信息包(IRP)，IRP被传输到工作于内核模式层的设备驱动程序，并通过驱动程序完成与UBS外设通信。设备驱动程序包括两层：函数驱动程序层和总线驱动程序层，函数驱动程序一方面通过IRP及API函数与应用程序通信，另一方面调用相应的总线驱动程序，总线驱动程序完成和外设硬件通信。USB总线驱动程序已经由操作系统提供，驱动程序开发的重点是函数驱动程序。
　　USB设备驱动程序的设计
　　使用DriverStudio3.2开发USB设备驱动程序
　　该驱动程序的主要功能包括：从控制端点0读取规定个数的数据、向端点0发出控制命令、从端点2批量读数据、向端点2批量写数据，驱动程序的开发采用DriverStudio3.2驱动程序开发包及VC++6.0，使用开发包中的向导程序DriverWizard就可以方便的生成驱动程序框架、模块及部分程序源代码，开发者只需要在功能模块中加入自己的实现程序就能完成复杂的USB设备驱动程序设计，下面介绍使用DriverWizard生成ISP1581驱动程序的过程：
　　(1)启动DriverWizard，选择DriverWorks Project创造一个名为USBDIO的VC++项目;
　　(2)在驱动程序类型中选择WDM Driver，WDM Function Driver,在硬件设备所支持的总线类型中选择USB(WDM Only)，在USB Vendor ID(厂商识别码)中填写0741，在USB Product ID(产品识别码)中填写0821;
　　(3)增加USB设备端点，设置端点2为批量输入/输出传输方式;
　　(4)在驱动程序支持的功能项中选择Read、Write、Device Control、Cleanup;
　　(5)选择自动产生批量读及批量写程序代码;
　　(6)在I/O请求IRP处理方式中选择None，即IRP不排队;
　　(7)在接口的打开方式中选择Symbolic link:UsbdioDevice，即应用程序以符号链接名打开设备;
　　(8)定义应用程序调用DeviceIo Control 函数对WDM驱动程序通信的控制命令，结果如图2所示。
　　(9)最后选择完成并确认生成新的项目信息，向导程序就会在usbdio目录中生成一个名为USBDIO的项目文件，其中包括了ISP1581驱动程序框架、模块及部分源代码。
　　USB设备驱动程序的编程
　　在使用DriverWizard生成驱动程序框架、模块及部分程序源代码后，开发者只需完成图2中三个控制代码所对应的三个功能模块的编程：模块USBDIO_IOCTL_ ID_CODE_Handler的功能是从控制端点0读取数据，模块USBDIO_IOCTL_ TEST_COMMAND_Handler的功能是向控制端点0发送一个控制命令，模块USBDIO_IOCTL_DMA_COMMAND _Handler的功能是向控制端点0发送一个要求USB设备进行DMA传输的控制命令，下面是第一个模块的编程实例。
　　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();
　　//设置读取的数据个数
　　pUrb=m_Lower.BuildVendorRequest(
　　(PUCHAR)I.IoctlBuffer(),//驱动程
　　序存放读取的数据的内存区
　　numData,//wLength，读取的数据个数
　　0,
　　0x0c,//bRequest 0,//wValue
　　TRUE,//input
　　TRUE,
　　NULL,
　　0x0472,//wIndex,传输到固件程序
　　的读数命令码
　　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;
　　}
　　对象I包含了应用程序下传的IRP内容，包括命令或数据等参数，函数BuildVendorRequest用来分配并初始化一个用于厂商请求的URB(USB Request Block)，该URB将作为下传IRP的一个参数，通过函数SubmitUrb发送给总线驱动程序，以便完成与硬件的通信。
　　在初始化URB时需要了解USB的传输方式及传输协议，该功能使用了USB的控制传输方式，该方式包括三个阶段：设置阶段、数据阶段和状态阶段，其中数据阶段可选，开发者主要关注设置阶段中的8个关键字节的定义，8字节分成了5个字段，定义了传输请求及相关信息。
　　BmRequestType：1字节，用来指定数据流动的方向，请求的类型，以及接收者。
　　bRequest：1字节，用来指定请求。
　　wValue：2字节，主机用来传输信息给设备，开发者可以根据情况自己定义。
　　wIndex：2字节，主机用来传输信息给设备，开发者可以根据情况自己定义。
　　wLength：2字节，包含数据阶段中接下来要传输的数据字节数目。
　　以上字段的应用已经在程序注释中标出，在此不再赘述。
　　USB设备驱动程序的安装及调用
　　USB设备驱动程序的安装
　　驱动程序编译完成后会生成一个名为USBDIO.SYS的文件，即USB设备驱动程序，另外在使用向导程序WizardDriver生成驱动程序时会产生一个名为USBDIO.INF的驱动程序安装程序，对此程序只需稍做修改就能正常使用，具体是将类改为USB，即Class=USB，由于本驱动程序使用符号链接名打开设备，所以删除ClassGUID选项，注意设备标识符必需为：%DeviceDesc%=USBDIO_DDI, USBVID_0471&PID_0821，其中0471是USB控制芯片的厂商识别码，0821是USB设备标识码。
　　驱动程序安装过程是：将USB设备加电，连入计算机的USB接口，这时候会看到Windows操作系统提示发现新硬件，提问是否安装驱动程序，选择是，然后选择驱动程序所在文件夹，选择文件USBDIO.INF即可完成安装。
　　USB设备驱动程序的调用
　　为了完成对驱动程序的调用，笔者使用VC++6.0编写了USB应用程序包，程序包共由五个功能模块组成，用户通过调用这些模块即可方便的完成对USB外设的控制及读写，这些模块如下。
　　● int CTRLReadData(unsigned char usbSelect，unsigned char *rbuffer，unsigned char numData)，主要功能是读取ISP1581控制端点0发来的数据，数据存放在缓冲区rbuffer中。
　　● int CTRLSendTestCommand (unsigned char usbSelect，unsigned short int testCommand)，主要功能是发送测试命令，变量testCommand定义了测试命令。

　　● int CTRLSendDMACommand (unsigned char usbSelect，unsigned char dmaDirection，unsigned char ramSelect,unsigned long dmaLength)，主要功能是发送DMA传输命令，变量dmaDirection定义数据传输方向，ramSelect定义将要操作的USB外设的存储器，dmaLength定义了数据传输总数。
　　● int DMARead(unsigned char usbSelect，unsigned char *rbuffer，int len，int waitTime)，主要功能是计算机批量读取ISP1581中的数据，而ISP1581以DMA方式从外部RAM读取数据。
　　● int DMAWrite(unsigned char usbSelect，unsigned char *rbuffer，int len， int waitTime)，主要功能是计算机批量写数据到ISP1581，而ISP1581将以DMA方式写数据到外部RAM。