descriptor.h

44b0中USB slave端程序

#ifndef _DESCRIPTOR_H_
#define _DESCRIPTOR_H_
/*
*********************************************************************************************
*        					USB 描述符结构体及其成员取值宏定义
*********************************************************************************************
*/
/***********  USB  设备描述符结构体  ****************/
typedef struct _USB_DEVICE_DESCRIPTOR {
    U8 bLength;
    U8 bDescriptorType;
    U8 bcdUSB0;
    U8 bcdUSB1;
    U8 bDeviceClass;
    U8 bDeviceSubClass;
    U8 bDeviceProtocol;
    U8 bMaxPacketSize0;
    U8 idVendor0;
    U8 idVendor1;
    U8 idProduct0;
    U8 idProduct1;
    U8 bcdDevice0;
    U8 bcdDevice1;
    U8 iManufacturer;
    U8 iProduct;
    U8 iSerialNumber;
    U8 bNumConfigurations;
} USB_DEVICE_DESCRIPTOR, *PUSB_DEVICE_DESCRIPTOR;

/***********  USB  配置描述符结构体  ****************/
typedef struct _USB_CONFIGURATION_DESCRIPTOR {
    U8 bLength;
    U8 bDescriptorType;
    U8 wTotalLength0;
    U8 wTotalLength1;
    U8 bNumInterfaces;
    U8 bConfigurationValue;
    U8 iConfiguration;
    U8 bmAttributes;
    U8 MaxPower;
} USB_CONFIGURATION_DESCRIPTOR, *PUSB_CONFIGURATION_DESCRIPTOR;

/***********  USB  接口描述符结构体  ****************/
typedef struct _USB_INTERFACE_DESCRIPTOR {
    U8 bLength;
    U8 bDescriptorType;
    U8 bInterfaceNumber;
    U8 bAlternateSetting;
    U8 bNumEndpoints;
    U8 bInterfaceClass;
    U8 bInterfaceSubClass;
    U8 bInterfaceProtocol;
    U8 iInterface;
} USB_INTERFACE_DESCRIPTOR, *PUSB_INTERFACE_DESCRIPTOR;

/***********  USB  端点描述符结构体  ****************/
typedef struct _USB_ENDPOINT_DESCRIPTOR {
    U8 bLength;
    U8 bDescriptorType;
    U8 bEndpointAddress;
    U8 bmAttributes;
    U8 wMaxPacketSize0;
    U8 wMaxPacketSize1;
    U8 bInterval;
} USB_ENDPOINT_DESCRIPTOR, *PUSB_ENDPOINT_DESCRIPTOR;


/***********  USB 字符串描述符结构体  ****************/
typedef struct _USB_STRING_DESCRIPTOR {
    U8 bLength;
    U8 bDescriptorType;
    U8 bString[1];
} USB_STRING_DESCRIPTOR, *PUSB_STRING_DESCRIPTOR;

//USB最大字符长度
#define MAXIMUM_USB_STRING_LENGTH 255

/***********  USB 电源描述符结构体  ****************/
typedef struct _USB_POWER_DESCRIPTOR {
    U8  bLength;
    U8  bDescriptorType;
    U8  bCapabilitiesFlags;
    U16 EventNotification;
    U16 D1LatencyTime;
    U16 D2LatencyTime;
    U16 D3LatencyTime;
    U8  PowerUnit;
    U16 D0PowerConsumption;
    U16 D1PowerConsumption;
    U16 D2PowerConsumption;
} USB_POWER_DESCRIPTOR, *PUSB_POWER_DESCRIPTOR;

// USB 供电描述符取值
#define USB_SUPPORT_D0_COMMAND      0x01
#define USB_SUPPORT_D1_COMMAND      0x02
#define USB_SUPPORT_D2_COMMAND      0x04
#define USB_SUPPORT_D3_COMMAND      0x08

#define USB_SUPPORT_D1_WAKEUP       0x10
#define USB_SUPPORT_D2_WAKEUP       0x20

/***********  USB 通用描述符结构体  ****************/
typedef struct _USB_COMMON_DESCRIPTOR {
    U8 bLength;
    U8 bDescriptorType;
} USB_COMMON_DESCRIPTOR, *PUSB_COMMON_DESCRIPTOR;


/***********  USB HUB 描述符结构体  ***************/
typedef struct _USB_HUB_DESCRIPTOR {
    U8        bDescriptorLength;      // Length of this descriptor
    U8        bDescriptorType;        // Hub configuration type
    U8        bNumberOfPorts;         // number of ports on this hub
    U16       wHubCharacteristics;    // Hub Charateristics
    U8        bPowerOnToPowerGood;    // port power on till power good in 2ms
    U8        bHubControlCurrent;     // max current in mA
    //
    // room for 255 ports power control and removable bitmask
    U8        bRemoveAndPowerMask[64];
} USB_HUB_DESCRIPTOR, *PUSB_HUB_DESCRIPTOR;

/*
*********************************************************************************************
*                  	 通用 描述符结构体成员取值宏定义
*********************************************************************************************
*/
	//*******************************************************
	// USB 设备请求类型掩码 masks 
	//*******************************************************
//(1) 接收方: D4...D0 
#define USB_RECIPIENT            (U8)0x1F
#define USB_RECIPIENT_DEVICE     (U8)0x00
#define USB_RECIPIENT_INTERFACE  (U8)0x01
#define USB_RECIPIENT_ENDPOINT   (U8)0x02

//(2) 类型: D6...D5
#define USB_REQUEST_TYPE_MASK    (U8)0x60
#define USB_STANDARD_REQUEST     (U8)0x00
#define USB_CLASS_REQUEST        (U8)0x20
#define USB_VENDOR_REQUEST       (U8)0x40

//(3) 数据传输方向: D7
#define DEVICE_ADDRESS_MASK      0x7F

//(4) USB 请求