descriptor.h

PDIUSBD12的固件程序可能对开发USB1.1的兄弟有用

//USB协议层有关描述符结构体定义及取值
 
#ifndef __DESCRIPTOR_H__
#define __DESCRIPTOR_H__

//USB  设备描述符结构体
typedef struct _USB_DEVICE_DESCRIPTOR {
    INT8U bLength;
    INT8U bDescriptorType;
    INT8U bcdUSB0;
    INT8U bcdUSB1;
    INT8U bDeviceClass;
    INT8U bDeviceSubClass;
    INT8U bDeviceProtocol;
    INT8U bMaxPacketSize0;
    INT8U idVendor0;
    INT8U idVendor1;
    INT8U idProduct0;
    INT8U idProduct1;
    INT8U bcdDevice0;
    INT8U bcdDevice1;
    INT8U iManufacturer;
    INT8U iProduct;
    INT8U iSerialNumber;
    INT8U bNumConfigurations;
} USB_DEVICE_DESCRIPTOR, *PUSB_DEVICE_DESCRIPTOR;

typedef struct _USB_CONFIGURATION_DESCRIPTOR {
    INT8U bLength;
    INT8U bDescriptorType;
    INT8U wTotalLength0;
    INT8U wTotalLength1;
    INT8U bNumInterfaces;
    INT8U bConfigurationValue;
    INT8U iConfiguration;
    INT8U bmAttributes;
    INT8U MaxPower;
} USB_CONFIGURATION_DESCRIPTOR, *PUSB_CONFIGURATION_DESCRIPTOR;

typedef struct _USB_INTERFACE_DESCRIPTOR {
    INT8U bLength;
    INT8U bDescriptorType;
    INT8U bInterfaceNumber;
    INT8U bAlternateSetting;
    INT8U bNumEndpoints;
    INT8U bInterfaceClass;
    INT8U bInterfaceSubClass;
    INT8U bInterfaceProtocol;
    INT8U iInterface;
} USB_INTERFACE_DESCRIPTOR, *PUSB_INTERFACE_DESCRIPTOR;

typedef struct _USB_ENDPOINT_DESCRIPTOR {
    INT8U bLength;
    INT8U bDescriptorType;
    INT8U bEndpointAddress;
    INT8U bmAttributes;
    INT8U wMaxPacketSize0;
    INT8U wMaxPacketSize1;
    INT8U bInterval;
} USB_ENDPOINT_DESCRIPTOR, *PUSB_ENDPOINT_DESCRIPTOR;


typedef struct _USB_STRING_DESCRIPTOR {
    INT8U bLength;
    INT8U bDescriptorType;
    INT8U bString[1];
} USB_STRING_DESCRIPTOR, *PUSB_STRING_DESCRIPTOR;

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

// USB 设备请求类型掩码 masks 
//接收方: D4...D0 
#define USB_RECIPIENT  (INT8U)0x1F
#define USB_RECIPIENT_DEVICE  (INT8U)0x00
#define USB_RECIPIENT_INTERFACE  (INT8U)0x01
#define USB_RECIPIENT_ENDPOINT  (INT8U)0x02

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

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

//USB 请求
#define USB_REQUEST_MASK  (INT8U)0x0F

//USB端点方向掩码
#define USB_ENDPOINT_DIRECTION_MASK  0x80
#define USB_ENDPOINT_DIRECTION_OUT(addr)  (!((addr) & USB_ENDPOINT_DIRECTION_MASK))
#define USB_ENDPOINT_DIRECTION_IN(addr)  ((addr) & USB_ENDPOINT_DIRECTION_MASK)



#define USB_DEVICE_DESCRIPTOR_TYPE  0x01
#define USB_CONFIGURATION_DESCRIPTOR_TYPE  0x02
#define USB_STRING_DESCRIPTOR_TYPE  0x03
#define USB_INTERFACE_DESCRIPTOR_TYPE  0x04
#define USB_ENDPOINT_DESCRIPTOR_TYPE  0x05
#define USB_POWER_DESCRIPTOR_TYPE  0x06


//基于USB 1.0规范的正确值
#define USB_REQUEST_GET_STATUS  0x00
#define USB_REQUEST_CLEAR_FEATURE  0x01

#define USB_REQUEST_SET_FEATURE  0x03

#define USB_REQUEST_SET_ADDRESS   0x05
#define USB_REQUEST_GET_DESCRIPTOR  0x06
#define USB_REQUEST_SET_DESCRIPTOR  0x07
#define USB_REQUEST_GET_CONFIGURATION  0x08
#define USB_REQUEST_SET_CONFIGURATION  0x09
#define USB_REQUEST_GET_INTERFACE  0x0A
#define USB_REQUEST_SET_INTERFACE  0x0B
#define USB_REQUEST_SYNC_FRAME  0x0C


//USB 特性选择符
#define USB_FEATURE_ENDPOINT_STALL  0x0000
#define USB_FEATURE_REMOTE_WAKEUP  0x0001
#define USB_FEATURE_POWER_D0  0x0002
#define USB_FEATURE_POWER_D1  0x0003
#define USB_FEATURE_POWER_D2  0x0004
#define USB_FEATURE_POWER_D3  0x0005

#define USB_DESCRIPTOR_MAKE_TYPE_AND_INDEX(d, i) ((INT16U)((INT16U)d<<8 | i))


#define USB_CONFIG_POWERED_MASK  0xc0

#define USB_CONFIG_BUS_POWERED  0x80
#define USB_CONFIG_SELF_POWERED  0x40
#define USB_CONFIG_REMOTE_WAKEUP  0x20

#define BUS_POWERED  0x80
#define SELF_POWERED   0x40
#define REMOTE_WAKEUP   0x20


#define USB_ENDPOINT_TYPE_MASK  0x03

#define USB_ENDPOINT_TYPE_CONTROL   0x00
#define USB_ENDPOINT_TYPE_ISOCHRONOUS   0x01
#define USB_ENDPOINT_TYPE_BULK  0x02
#define USB_ENDPOINT_TYPE_INTERRUPT  0x03




typedef struct _USB_DESCRIPTOR {
	USB_CONFIGURATION_DESCRIPTOR ConfigDescr;//配置描述符
	USB_INTERFACE_DESCRIPTOR InterfaceDescr;//接口描述符
	USB_ENDPOINT_DESCRIPTOR EP1_TXDescr;//端点1输入描述符
	USB_ENDPOINT_DESCRIPTOR EP1_RXDescr;//端点1输出描述符
	USB_ENDPOINT_DESCRIPTOR EP2_TXDescr;//端点2输入描述符
	USB_ENDPOINT_DESCRIPTOR EP2_RXDescr;//端点2输出描述符
} USB_DESCRIPTOR, *PUSB_DESCRIPTOR;


#define NUM_ENDPOINTS	4


#define CONFIG_DESCRIPTOR_LENGTH  sizeof(USB_CONFIGURATION_DESCRIPTOR)+sizeof(USB_INTERFACE_DESCRIPTOR)+(NUM_ENDPOINTS*sizeof(USB_ENDPOINT_DESCRIPTOR))

//端点0最大分组大小
#define EP0_TX_FIFO_SIZE   16
#define EP0_RX_FIFO_SIZE   16
#define EP0_PACKET_SIZE    16

//端点1接收或发送的最大信息包大小
#define EP1_TX_FIFO_SIZE   16
#define EP1_RX_FIFO_SIZE   16
#define EP1_PACKET_SIZE    16

//端点2接收或发送的最大信息包大小
#define EP2_TX_FIFO_SIZE   64
#define EP2_RX_FIFO_SIZE   64
#define EP2_PACKET_SIZE    64

extern code USB_DEVICE_DESCRIPTOR DeviceDescr;
extern code USB_DESCRIPTOR usb_descr;

#endif