📄 descriptor.h
字号:
/****************************************Copyright (c)**************************************************
** Guangzou ZLG-MCU Development Co.,LTD.
** graduate school
** http://www.zlgmcu.com
**
**--------------File Info-------------------------------------------------------------------------------
** File name: Descriptor.h
** Last modified Date: 2005-8-6
** Last Version: V1.0
** Descriptions: USB 设备描述符结构体和取值
** USB Descriptor structure define and their value
**------------------------------------------------------------------------------------------------------
** Created by: 郑明远 MingYuan Zheng
** Created date: 2005-8-6
** Version: V1.0
** Descriptions: 初始版本 The original version
**
**------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
** Version:
** Descriptions:
**
**------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
** Version:
** Descriptions:
**
********************************************************************************************************/
#ifndef __DESCRIPTOR_H__
#define __DESCRIPTOR_H__
/*
*********************************************************************************************
* USB Descriptor structure and their member value
*********************************************************************************************
*/
/*********** USB device descriptor structure ****************/
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;
/*********** USB configuration descriptor structure **********/
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;
/*********** USB interface descriptor structure **********/
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;
/*********** USB endpoint descriptor structure **********/
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;
/*********** USB string descriptor structure *************/
typedef struct _USB_STRING_DESCRIPTOR {
INT8U bLength;
INT8U bDescriptorType;
INT8U bString[1];
} USB_STRING_DESCRIPTOR, *PUSB_STRING_DESCRIPTOR;
//USB max string length
#define MAXIMUM_USB_STRING_LENGTH 255
/*********** USB power descriptor structure *************/
typedef struct _USB_POWER_DESCRIPTOR {
INT8U bLength;
INT8U bDescriptorType;
INT8U bCapabilitiesFlags;
INT16U EventNotification;
INT16U D1LatencyTime;
INT16U D2LatencyTime;
INT16U D3LatencyTime;
INT8U PowerUnit;
INT16U D0PowerConsumption;
INT16U D1PowerConsumption;
INT16U D2PowerConsumption;
} USB_POWER_DESCRIPTOR, *PUSB_POWER_DESCRIPTOR;
// USB Power descriptor value
#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 common descriptor structure *************/
typedef struct _USB_COMMON_DESCRIPTOR {
INT8U bLength;
INT8U bDescriptorType;
} USB_COMMON_DESCRIPTOR, *PUSB_COMMON_DESCRIPTOR;
/*********** USB HUB descriptor structure *************/
typedef struct _USB_HUB_DESCRIPTOR {
INT8U bDescriptorLength; // Length of this descriptor
INT8U bDescriptorType; // Hub configuration type
INT8U bNumberOfPorts; // number of ports on this hub
INT16U wHubCharacteristics; // Hub Charateristics
INT8U bPowerOnToPowerGood; // port power on till power good in 2ms
INT8U bHubControlCurrent; // max current in mA
//
// room for 255 ports power control and removable bitmask
INT8U bRemoveAndPowerMask[64];
} USB_HUB_DESCRIPTOR, *PUSB_HUB_DESCRIPTOR;
/*
*********************************************************************************************
* common descriptor struture member value
*********************************************************************************************
*/
//*******************************************************
// USB device request type mask
//*******************************************************
//(1) Receiver: 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
//(2) Type: 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
//(3) data direction: D7
#define DEVICE_ADDRESS_MASK 0x7F
//(4) USB request mask
#define USB_REQUEST_MASK (INT8U)0x0F
//(5) USB endpoint direction mask
#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)
//*******************************************************
// USB device request type
//*******************************************************
#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
//*******************************************************
// correct value based on USB1.0 specification
//*******************************************************
#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 feather select
********************************************************/
#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))
/*******************************************************
** USB configuration descriptor
********************************************************/
#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
/*******************************************************
** USB endpoint descriptor structure: endpoint attribute
********************************************************/
#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
/*******************************************************
** USB device class
********************************************************/
#define USB_DEVICE_CLASS_RESERVED 0x00
#define USB_DEVICE_CLASS_AUDIO 0x01
#define USB_DEVICE_CLASS_COMMUNICATIONS 0x02
#define USB_DEVICE_CLASS_HUMAN_INTERFACE 0x03
#define USB_DEVICE_CLASS_MONITOR 0x04
#define USB_DEVICE_CLASS_PHYSICAL_INTERFACE 0x05
#define USB_DEVICE_CLASS_POWER 0x06
#define USB_DEVICE_CLASS_PRINTER 0x07
#define USB_DEVICE_CLASS_STORAGE 0x08
#define USB_DEVICE_CLASS_HUB 0x09
#define USB_DEVICE_CLASS_VENDOR_SPECIFIC 0xFF
/*
*********************************************************************************************
* LPC214x USB various descriptor members value
*/
/*********** LPC214x USB various descriptor structure collect *********************/
typedef struct _USB_DESCRIPTOR {
USB_CONFIGURATION_DESCRIPTOR ConfigDescr; //configuration descriptor
USB_INTERFACE_DESCRIPTOR InterfaceDescr; //interface descriptor
USB_ENDPOINT_DESCRIPTOR EP1_TXDescr; //logic endpoint 1 IN descriptor
USB_ENDPOINT_DESCRIPTOR EP1_RXDescr; //logic endpoint 1 OUT descriptor
USB_ENDPOINT_DESCRIPTOR EP2_TXDescr; //logic endpoint 2 IN descriptor
USB_ENDPOINT_DESCRIPTOR EP2_RXDescr; //logic endpoint 2 OUT descriptor
} USB_DESCRIPTOR, *PUSB_DESCRIPTOR;
/***** In LPC214x USB descriptor, the physical endpoint number except for logic enpoint 0 ******/
#define NUM_ENDPOINTS 4
/***** LPC214x USB descriptor collect length ******/
#define CONFIG_DESCRIPTOR_LENGTH sizeof(USB_CONFIGURATION_DESCRIPTOR) \
+ sizeof(USB_INTERFACE_DESCRIPTOR) \
+ (NUM_ENDPOINTS * sizeof(USB_ENDPOINT_DESCRIPTOR))
//(1) logic endpoint 0 MaxPacketSize
#define EP0_TX_FIFO_SIZE 64
#define EP0_RX_FIFO_SIZE 64
#define EP0_PACKET_SIZE 64
//(2) logic endpoint 1 MaxPacketSize
#define EP1_TX_FIFO_SIZE 16
#define EP1_RX_FIFO_SIZE 16
#define EP1_PACKET_SIZE 16
//(3) logic endpoint 2 MaxPacketSize
#define EP2_TX_FIFO_SIZE 64
#define EP2_RX_FIFO_SIZE 64
#define EP2_PACKET_SIZE 64
extern const USB_DEVICE_DESCRIPTOR DeviceDescr;
extern const USB_DESCRIPTOR usb_descr;
#endif
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -