/******************************************************************
   本程序只供學習使用，未經作者許可，不得用于其它任何用途
      我的郵箱：computer-lov@tom.com
        歡迎訪問我的blog：  http://computer00.21ic.org

   USB.H  文件包含了一些USB定義和USB描述符


Created by Computer-lov
Date: 2004.9.21

Edit date:2006.2.24

Version V1.1
Copyright(C) Computer-lov 2005-2015
All rigths reserved
             
*******************************************************************/

#ifndef __USB_H__
#define __USB_H__


#define BYTE unsigned char
#define WORD unsigned int

// 定義標準的描述符類型，也就是USB分配的各種描述符的編號，即bDescriptorType 字段的值

#define DEVICE_DESCRIPTOR               0x01  //設備描述符
#define CONFIGURATION_DESCRIPTOR        0x02  //配置描述符
#define STRING_DESCRIPTOR               0x03  //字符串描述符
#define INTERFACE_DESCRIPTOR            0x04  //接口描述符
#define ENDPOINT_DESCRIPTOR             0x05  //端點描述符


//定義標準的USB請求命令，即USB分配的各種請求的編號，即bRequest字段的值

#define GET_STATUS                      0x00  //獲取狀態請求
#define CLEAR_FEATURE                   0x01  //清除特性請求
#define SET_FEATURE                     0x03  //設置特性請求
#define SET_ADDRESS                     0x05  //設置地址請求
#define GET_DESCRIPTOR                  0x06  //獲取描述符請求
#define SET_DESCRIPTOR                  0x07  //設置描述符請求
#define GET_CONFIGURATION               0x08  //獲取配置請求
#define SET_CONFIGURATION               0x09  //設置配置請求
#define GET_INTERFACE                   0x0A  //獲取接口請求
#define SET_INTERFACE                   0x0B  //設置接口請求
#define SYNCH_FRAME                     0x0C  //同步幀請求


//定義特性選擇器

#define ENDPOINT_HALT                   0x00  //端點的禁止特性
#define DEVICE_REMOTE_WAKEUP            0x01  //設備的遠程喚醒特性


//使用的端點數

//#define Number_Endpoint               0x05  //端點數量為5


//定義的端點類型
#define ENDPOINT_TYPE_CONTROL           0x00  //控制傳輸
#define ENDPOINT_TYPE_ISOCHRONOUS       0x01  //同步傳輸
#define ENDPOINT_TYPE_BULK              0x02  //批量傳輸
#define ENDPOINT_TYPE_INTERRUPT         0x03  //中斷傳輸



//定義標準的設備描述符結構

typedef struct _DEVICE_DCESCRIPTOR_STRUCT
{
 BYTE blength;                               //設備描述符的字節數大小
 BYTE bDescriptorType;	                      //設備描述符類型編號
 WORD bcdUSB;                                //USB版本號
 BYTE bDeviceClass;                          //USB分配的設備類代碼
 BYTE bDeviceSubClass;                       //USB分配的子類代碼
 BYTE bDeviceProtocol;                       //USB分配的設備協議代碼
 BYTE bMaxPacketSize0;                       //端點0的最大包大小
 WORD idVendor;                              //廠商編號
 WORD idProduct;                             //產品編號
 WORD bcdDevice;                             //設備出廠編號
 BYTE iManufacturer;                         //設備廠商字符串的索引
 BYTE iProduct;                              //描述產品字符串的索引
 BYTE iSerialNumber;                         //描述設備序列號字符串的索引
 BYTE bNumConfigurations;                    //可能的配置數量
}
DEVICE_DESCRIPTOR_STRUCT, * pDEVICE_DESCRIPTOR_STRUCT;


//定義標準的配置描述符結構

typedef struct _CONFIGURATION_DESCRIPTOR_STRUCT
{
 BYTE bLength;                               //配置描述符的字節數大小
 BYTE bDescriptorType;                       //配置描述符類型編號
 WORD wTotalLength;                          //此配置返回的所有數據大小
 BYTE bNumInterfaces;                        //此配置所支持的接口數量
 BYTE bConfigurationValue;                   //Set_Configuration命令所需要的參數值
 BYTE iConfiguration;                        //描述該配置的字符串的索引值
 BYTE bmAttributes;                          //供電模式的選擇
 BYTE MaxPower;                              //設備從總線提取的最大電流
}
CONFIGURATION_DESCRIPTOR_STRUCT, * pCONFIGURATION_DESCRIPTOR_STRUCT;


//定義標準的接口描述符結構

typedef struct _INTERFACE_DESCRIPTOR_STRUCT
{
 BYTE bLength;                               //接口描述符的字節數大小
 BYTE bDescriptorType;                       //接口描述符的類型編號
 BYTE bInterfaceNumber;                      //該接口的編號
 BYTE bAlternateSetting;                     //備用的接口描述符編號
 BYTE bNumEndpoints;                         //該接口使用的端點數，不包括端點0
 BYTE bInterfaceClass;                       //接口類型
 BYTE bInterfaceSubClass;                    //接口子類型
 BYTE bInterfaceProtocol;                    //接口遵循的協議
 BYTE iInterface;                            //描述該接口的字符串索引值
}
INTERFACE_DESCRIPTOR_STRUCT, * pINTERFACE_DESCRIPTOR_STRUCT;


//定義標準的端點描述符結構

typedef struct _ENDPOINT_DESCRIPTOR_STRUCT
{
 BYTE bLegth;                                //端點描述符字節數大小
 BYTE bDescriptorType;                       //端點描述符類型編號
 BYTE bEndpointAddress;                      //端點地址及輸入輸出屬性
 BYTE bmAttributes;                          //端點的傳輸類型屬性
 WORD wMaxPacketSize;                        //端點收、發的最大包大小
 BYTE bInterval;                             //主機查詢端點的時間間隔
}
ENDPOINT_DESCRIPTOR_STRUCT, * pENDPOINT_DESCRIPTOR_STRUCT;


//一個字符串描述符結構

typedef struct _STRING_DESCRIPTOR_STRUCT
{
 BYTE bLength;                               //字符串描述符的字節數大小
 BYTE bDescriptorType;                        //字符串描述符類型編號
 BYTE SomeDesriptor[36];                     //UNICODE編碼的字符串
}
STRING_DESCRIPTOR_STRUCT, * pSTRING_DESCRIPTOR_STRUCT;


//標準設備請求命令結構

typedef struct _REQUESTCMD
{
 BYTE bmRequestType;                         //請求命令類型
 BYTE bRequest;                              //請求命令代碼
 WORD wValue;                                //命令信息
 WORD wIndex;                                //索引信息
 WORD wLength;                               //傳輸數據大小
}
REQUESTCMD, * pREQUESTCMD;
   

//setup_packet緩沖區

#define MAX_CONTROL_DATA_SIZE 16

typedef struct _control_data_buff
{
 REQUESTCMD DeviceRequest;                    //USB設備請求
 unsigned int wLength;
 unsigned int wCount;
 unsigned char * pData;
 unsigned char dataBuffer[MAX_CONTROL_DATA_SIZE];
}CONTROL_DATA_BUFF;
 
#endif