#ifndef __USB_Descriptor_H__
#define __USB_Descriptor_H__

/*     USB描述符的定義     */
/*編寫者：章其波 2006-10-10*/

#define  U8 unsigned char
#define U16 unsigned int
#define U32 unsigned long

/*設(shè)備描述符*/
typedef struct
{
	U8  bLength;			//描述符大小Descriptor Size =12H
#define USB_Device_Descriptor_Size	0x12
	U8  bDescriptorType;	//設(shè)備描述符類型Device Descriptor Type =01H
#define USB_Device_Descriptor_Type	0x01
	U16 bcdUSB;				//USB規(guī)劃發(fā)布號(hào)BCD碼
#define USB_11						0x0110
#define USB_20						0x0200
	U8  bDeviceClass;		//類型代碼（由USB指定）Device Class
#define Default_DeviceClass			0x00
	U8  bDeviceSubClass;	//子類型代碼（由USB分配）Device SubClass
#define Default_DeviceSubClass		0x00
	U8  bDeviceProtocol;	//協(xié)議代碼（由USB分配）Device protocol
#define Default_DeviceProtocol		0x00
	U8  bMaxPacketSize0;	//端點(diǎn)0的最大分組大小（8，16，32或64）Max Packet Size of End Point 0
#define	Endpoint0_Packet_Size		0x10
	U16 idVendor;			//供應(yīng)商ID（由USB分配）Vendor ID
#define Philip_IdVendor				0x0471
	U16 idProduct;			//產(chǎn)品ID（由廠商分配）Product ID
#define Default_IdProduct			0x0001
	U16 bcdDevice;			//設(shè)備出廠編碼BCD碼Device code BCD
#define Default_BcdDevice			0x0001
	U8  iManufacturer;		//廠商描述符字符串索引 Index of Manufacturer Descriptor
#define No_Index					0x00
	U8  iProduct;			//產(chǎn)品描述符字符串索引 Index of Product Descriptor
	U8  iSerialNumber;		//設(shè)備序列號(hào)字符串索引 index of Serial Number Descriptor
	U8  bNumConfigurations;	//可能的配置數(shù) The Number of Configuations
}USB_Device_Descriptor;


/*接口描述符*/
typedef struct
{
	U8  bLength;			//描述符的大小=09H
#define USB_Interface_Descriptor_Size	0x09
	U8  bDescriptorType;	//接口描述符類型=04H
#define USB_Interface_Descriptor_Type	0x04
	U8  bInterfaceNumber;	//接口的編號(hào)
	U8  bAlternateSetting;	//用于為上一個(gè)字段選擇可供替換的設(shè)置
	U8  bNumEndpoint;		//使用的端點(diǎn)數(shù)目（端點(diǎn)0除外）
#define Endpoint_Count					0x02
	U8  bInterfaceClass;	//類型代碼（由USB分配）
#define	UsbClassMassStorage				0x08
	U8  bInterfaceSubClass;	//子類型代碼（由USB分配）
#define	UsbSubClassRbc					0x01
#define	UsbSubClassSff8020i				0x02
#define	UsbSubClassQic157				0x03
#define	UsbSubClassUfi					0x04
#define	UsbSubClassSff8070i				0x05
#define	UsbSubClassScsi					0x06
	U8  bInterfaceProtocol;	//協(xié)議代碼（由USB分配）
#define	UsbProtocolCbi0					0x00
#define	UsbProtocolCbi1					0x01
#define	UsbProtocolBulk					0x50
	U8  iInterface;			//字符串描述符的索引
}USB_Interface_Descriptor;

/*端點(diǎn)描述符*/
typedef struct
{
	U8  bLength;			//描述符的大小=07H
#define	USB_Endpoint_Descriptor_Size        0x07
	U8  bDescriptorType;	//端點(diǎn)描述符類型=05H
#define	USB_Endpoint_Descriptor_Type        0x05
	U8  bEndpointAddress;	//USB設(shè)備的端點(diǎn)地址: Bit0~3:端點(diǎn)號(hào); Bit4~6:保留 復(fù)位為0; Bit7:方向，對(duì)于控制端點(diǎn)可忽略 0:Out 1:In
#define Endpoint_In(n)						0x80|n
#define Endpoint_Out(n)						0x00|n
	U8  bmAttributes;		//端點(diǎn)屬性 Bit0~1: 0:控制;1:同步;2:批量;3:中斷.其他位保留
#define	UsbEndpControl						0x00
#define	UsbEndpIsochronous					0x01
#define	UsbEndpBulk							0x02
#define	UsbEndpInterrupt					0x03 
	U16 wMaxPacketSize;		//本端點(diǎn)接收或發(fā)送的最大信息包的大小
#define	Endpoint2_Packet_Size				0x0040
	U8  bInterval;			//輪詢數(shù)據(jù)傳送端點(diǎn)的時(shí)間間隔
#define Default_Interval					0x00
}USB_Endpoint_Descriptor;

/*字符串描述符*/ //可選描述符

typedef struct
{
	U8  bLength;			//描述符的大小
	U8  bDescriptorType;	//字符串描述符類型
#define USB_String_Descriptor_Type          0x03
	U16 * bString;			//Unicode編碼字符串
}USB_String_Descriptor;


/*配置描述符*/
typedef struct
{
	U8  bLength;			//描述符的大小=09H
#define USB_Configuration_Descriptor_Size	0x09
	U8  bDescriptorType;	//配置描述符類型=02H
#define USB_Configuration_Descriptor_Type	0x02
	U16 wTotalLength;		//返回整個(gè)數(shù)據(jù)的長(zhǎng)度，包括該配置所返回的所有描述符的聯(lián)合長(zhǎng)度
#define USB_Total_Configuration_Descriptor_Size	USB_Configuration_Descriptor_Size+USB_Interface_Descriptor_Size+Endpoint_Count*USB_Endpoint_Descriptor_Size
	U8  bNumInterfaces;		//配置所支持的接口數(shù)
	U8  bConfigurationValue;//作為Set Configuration 的一個(gè)參數(shù)選擇配置值
	U8  iConfiguration;		//用于描述該配置字符串描述符的索引
	U8  bmAttributes;		//配置特性:D7--Bus Power; D6--Self Power; D5--Remote Awake; D4-D0 Reserved 0 at reset.
#define Bus_Power							0x80
#define Self_Power							0x40
#define Remote_Awake						0x20
	U8  MaxPower;			//當(dāng)設(shè)備完全可操作時(shí)，在此配置下的最大消耗電流，以2mA為單位
#define PowerConsumption_Nma(n)				(U8)(n/2)
}USB_Configuraton_Descriptor;

#endif