00的USB书籍 第五章 用户自定义的USB HID设备驱动和界面代码

/****************************************************************** 本程序只供学习使用，未经作者许可，不得用于其它任何用途 欢迎访问我的USB专区：http://group.ednchina.com/93/ 欢迎访问我的blog： http://www.ednchina.com/blog/computer00 http://computer00.21ic.org 感谢PCB赞助商——电子园： http://bbs.cepark.com/ UsbCore.c file 作者：电脑圈圈 建立日期: 2008.06.29 修改日期: 2008.07.14 版本：V1.1 版权所有，盗版必究。 Copyright(C) 电脑圈圈 2008-2018 All rights reserved *******************************************************************/ #include "config.h" #include "pdiusbd12.h" #include "uart.h" #include "usbcore.h" #include "led.h" idata uint8 Buffer[16]; //读端点0用的缓冲区 //USB设备请求的各字段 uint8 bmRequestType; uint8 bRequest; uint16 wValue; uint16 wIndex; uint16 wLength; //当前发送数据的位置 uint8 * pSendData; //需要发送数据的长度 uint16 SendLength; //是否需要发送0数据包的标志。在USB控制传输的数据过程中， //当返回的数据包字节数少于最大包长时，会认为数据过程结束。 //当请求的字节数比实际需要返回的字节数长，而实际返回的字节 //数又刚好是端点0大小的整数倍时，就需要返回一个0长度的数据包 //来结束数据过程。因此这里增加一个标志，供程序决定是否需要返回 //一个0长度的数据包。 uint8 NeedZeroPacket; //当前的配置值。只有在设置非0配置后 uint8 ConfigValue; //端点1缓冲是否忙的标志。当缓冲区中有数据时，该标志为真。 //当缓冲区中空闲时，该标志为假。 uint8 Ep1InIsBusy; //返回了多少次报告的计数器 uint32 Count=0; //USB设备描述符的定义 code uint8 DeviceDescriptor[0x12]= //设备描述符为18字节 { //bLength字段。设备描述符的长度为18(0x12)字节 0x12, //bDescriptorType字段。设备描述符的编号为0x01 0x01, //bcdUSB字段。这里设置版本为USB1.1，即0x0110。 //由于是小端结构，所以低字节在先，即0x10，0x01。 0x10, 0x01, //bDeviceClass字段。我们不在设备描述符中定义设备类， //而在接口描述符中定义设备类，所以该字段的值为0。 0x00, //bDeviceSubClass字段。bDeviceClass字段为0时，该字段也为0。 0x00, //bDeviceProtocol字段。bDeviceClass字段为0时，该字段也为0。 0x00, //bMaxPacketSize0字段。PDIUSBD12的端点0大小的16字节。 0x10, //idVender字段。厂商ID号，我们这里取0x8888，仅供实验用。 //实际产品不能随便使用厂商ID号，必须跟USB协会申请厂商ID号。 //注意小端模式，低字节在先。 0x88, 0x88, //idProduct字段。产品ID号，由于是第六个实验，我们这里取0x0006。 //注意小端模式，低字节应该在前。 0x06, 0x00, //bcdDevice字段。设备版本号，取1.0版，即0x0100。 //小端模式，低字节在先。 0x00, 0x01, //iManufacturer字段。厂商字符串的索引值，为了方便记忆和管理， //字符串索引就从1开始吧。 0x01, //iProduct字段。产品字符串的索引值。刚刚用了1，这里就取2吧。 //注意字符串索引值不要使用相同的值。 0x02, //iSerialNumber字段。设备的序列号字符串索引值。 //这里取3就可以了。 0x03, //bNumConfigurations字段。该设备所具有的配置数。 //我们只需要一种配置就行了，因此该值设置为1。 0x01 }; //////////////////////////设备描述符完毕////////////////////////////// //USB报告描述符的定义 code uint8 ReportDescriptor[]= { //每行开始的第一字节为该条目的前缀，前缀的格式为： //D7~D4：bTag。D3~D2：bType；D1~D0：bSize。以下分别对每个条目注释。 //这是一个全局（bType为1）条目，将用途页选择为普通桌面Generic Desktop Page。 //后面跟1字节数据（bSize为1），后面的字节数就不注释了，自己根据bSize来判断。 0x05, 0x01, // USAGE_PAGE (Generic Desktop) //这是一个局部（bType为2）条目，用途选择为0x00。在普通桌面页中， //该用途是未定义的，如果使用该用途来开集合，那么系统将不会把它 //当作标准系统设备，从而就成了一个用户自定义的HID设备。 0x09, 0x00, // USAGE (0) //这是一个主条目（bType为0）条目，开集合，后面跟的数据0x01表示 //该集合是一个应用集合。它的性质在前面由用途页和用途定义为 //用户自定义。 0xa1, 0x01, // COLLECTION (Application) //这是一个全局条目，说明逻辑值最小值为0。 0x15, 0x00, // LOGICAL_MINIMUM (0) //这是一个全局条目，说明逻辑值最大为255。 0x25, 0xff, // LOGICAL_MAXIMUM (255) //这是一个局部条目，说明用途的最小值为1。 0x19, 0x01, // USAGE_MINIMUM (1) //这是一个局部条目，说明用途的最大值8。 0x29, 0x08, // USAGE_MAXIMUM (8) //这是一个全局条目，说明数据域的数量为八个。 0x95, 0x08, // REPORT_COUNT (8) //这是一个全局条目，说明每个数据域的长度为8bit，即1字节。 0x75, 0x08, // REPORT_SIZE (8) //这是一个主条目，说明有8个长度为8bit的数据域做为输入。 0x81, 0x02, // INPUT (Data,Var,Abs) //这是一个局部条目，说明用途的最小值为1。 0x19, 0x01, // USAGE_MINIMUM (1) //这是一个局部条目，说明用途的最大值8。 0x29, 0x08, // USAGE_MAXIMUM (8) //这是一个主条目。定义输出数据（8字节，注意前面的全局条目）。 0x91, 0x02, // OUTPUT (Data,Var,Abs) //下面这个主条目用来关闭前面的集合。bSize为0，所以后面没数据。 0xc0 // END_COLLECTION }; //通过上面的报告描述符的定义，我们知道返回的输入报告具有8字节。 //输出报告也有8字节。至于这8字节的数据是干什么用的，就要由用户 //自己来决定了。像我们这个实验，输入报告的第一字节用来描述8个按键 //的状态，第二到第五字节返回返回报告的次数（增加一个长整型的变量Count， //每发送一次报告就加1）。而输出报告的第一字节则用来控制板上8个LED //的状态，第二字节（非0时）用来清除上面的报告计数器Count。 ///////////////////////////报告描述符完毕//////////////////////////// //USB配置描述符集合的定义 //配置描述符总长度为9+9+9+7+7字节 code uint8 ConfigurationDescriptor[9+9+9+7+7]= { /***************配置描述符***********************/ //bLength字段。配置描述符的长度为9字节。 0x09, //bDescriptorType字段。配置描述符编号为0x02。 0x02, //wTotalLength字段。配置描述符集合的总长度， //包括配置描述符本身、接口描述符、类描述符、端点描述符等。 sizeof(ConfigurationDescriptor)&0xFF, //低字节 (sizeof(ConfigurationDescriptor)>>8)&0xFF, //高字节 //bNumInterfaces字段。该配置包含的接口数，只有一个接口。 0x01, //bConfiguration字段。该配置的值为1。 0x01, //iConfigurationz字段，该配置的字符串索引。这里没有，为0。 0x00, //bmAttributes字段，该设备的属性。由于我们的板子是总线供电的， //并且我们不想实现远程唤醒的功能，所以该字段的值为0x80。 0x80, //bMaxPower字段，该设备需要的最大电流量。由于我们的板子 //需要的电流不到100mA，因此我们这里设置为100mA。由于每单位 //电流为2mA，所以这里设置为50(0x32)。 0x32, /*******************接口描述符*********************/ //bLength字段。接口描述符的长度为9字节。 0x09, //bDescriptorType字段。接口描述符的编号为0x04。 0x04, //bInterfaceNumber字段。该接口的编号，第一个接口，编号为0。 0x00, //bAlternateSetting字段。该接口的备用编号，为0。 0x00, //bNumEndpoints字段。非0端点的数目。本实例需要二个 //中断端点（一个输入一个输出），因此该值为2。 0x02, //bInterfaceClass字段。该接口所使用的类。本实例是HID类， //HID类的编码为0x03。 0x03, //bInterfaceSubClass字段。该接口所使用的子类。在HID1.1协议中， //只规定了一种子类：支持BIOS引导启动的子类。 //USB键盘、鼠标属于该子类，子类代码为0x01。 //但这里我们是自定义的HID设备，所以不使用子类。 0x00, //bInterfaceProtocol字段。如果子类为支持引导启动的子类， //则协议可选择鼠标和键盘。键盘代码为0x01，鼠标代码为0x02。 //自定义的HID设备，也不使用协议。 0x00, //iConfiguration字段。该接口的字符串索引值。这里没有，为0。 0x00, /******************HID描述符************************/ //bLength字段。本HID描述符下只有一个下级描述符。所以长度为9字节。 0x09, //bDescriptorType字段。HID描述符的编号为0x21。 0x21, //bcdHID字段。本协议使用的HID1.1协议。注意低字节在先。 0x10, 0x01, //bCountyCode字段。设备适用的国家代码，这里选择为美国，代码0x21。 0x21, //bNumDescriptors字段。下级描述符的数目。我们只有一个报告描述符。 0x01, //bDescritporType字段。下级描述符的类型，为报告描述符，编号为0x22。 0x22, //bDescriptorLength字段。下级描述符的长度。下级描述符为报告描述符。 sizeof(ReportDescriptor)&0xFF, (sizeof(ReportDescriptor)>>8)&0xFF, /**********************输入端点描述符********