#ifndef __USB_H__

#define __USB_H__

//usb傳輸數據的宏定義描述

#include "sys.h"

typedef__packed union{

U16 W;

__packed struct{

U8 L;

U8 H;

}WB;

}U16_8;//定義一個16位長度的結構體并且內部分成兩個八位,因為wvalue windex經常要做分開處理

//請求類型方向定義

#define REQUEST_HOST_TO_DEVICE 0 //主機到設備的請求

#define REQUEST_DEVICE_TO_HOST 1 //設備到主機的請求

/*請求類型的具體類型定義*/

#define REQUEST_STANDARD 0 //標準請求

#define REQUEST_CLASS 1 //類請求

#define REQUEST_VENDOR 2 //廠商請求

#define REQUEST_RESERVED 3 //保留請求

/* 請求的接受者定義 */

#define REQUEST_TO_DEVICE 0 //請求設備

#define REQUEST_TO_INTERFACE 1 //請求接口

#define REQUEST_TO_ENDPOINT 2 //請求端點

#define REQUEST_TO_OTHER 3 //3-41保留請求

/* 請求類型字節(jié)定義*/

typedef__packed union _REQUEST_TYPE{

__packed struct _BM{

U8 Recipient:5; //請求的對象,接受者 0-4

U8 Type:2; //請求的類型 5-6

U8 Dir:1; //請求的方向 7位

}BM;

U8 B;

}REQUEST_TYPE;

/* usb標準請求的請求代碼 brequest */

#define USB_REQUEST_GET_STATUS 0 //獲取設備狀態(tài)

#define USB_REQUEST_CLEAR_FEATURE 1 //清除設備特性

#define USB_REQUEST_SET_FEATURE 3 //設置設備特性

#define USB_REQUEST_SET_ADDRESS 5 //設置設備地址(地址是帶方向的)

#define USB_REQUEST_GET_DESCRIPTOR 6 //獲取描述符

#define USB_REQUEST_SET_DESCRIPTOR 7 //設置描述符

#define USB_REQUEST_GET_CONFIGURATION 8 //獲取配置

#define USB_REQUEST_SET_CONFIGURATION 9 //設置配置

#define USB_REQUEST_GET_INTERFACE 10 //獲取接口

#define USB_REQUEST_SET_INTERFACE 11 //設置接口

#define USB_REQUEST_SYNC_FRAME 12 //同步幀請求

/* usb獲取狀態(tài)的命令描述 */

#define USB_GETSTATUS_SELF_POWERED 0x01 //電源狀態(tài)

#define USB_GETSTATUS_REMOTE_WAKEUP 0x02 //遠程喚醒設備

#define USB_GETSTATUS_ENDPOINT_STALL 0x01 //端點stall(休眠,暫停,知道下一個setup包發(fā)送)

/* usb標準特性請求 */

#define USB_FEATURE_ENDPOINT_STALL 0 //端點暫停

#define USB_FEATURE_REMOTE_WAKEUP 1 //遠程喚醒

/* usb setup包的數據定義 */

typedef__packed struct _USB_SETUP_PACKET{

REQUEST_TYPE bmRequestType; //請求類型

U8 bRequest; //請求代碼

U16_8 wValue;

U16_8 wIndex;

U16 wLength;//這個數據長度需要注意(獲取描述符中過程中,這個代表我們能返回的最大包長度,不得超過這個值)

}USB_SETUP_PACKET;

/* wvalue的低字節(jié) 獲取描述符的分類 */

#define USB_DEVICE_DESCRIPTOR_TYPE 1 //獲取設備描述符

#define USB_CONFIGURATION_DESCRIPTOR_TYPE 2 //獲取配置描述符

#define USB_STRING_DESCRIPTOR_TYPE 3 //獲取字符串描述符

#define USB_INTERFACE_DESCRIPTOR_TYPE 4 //獲取接口描述符

#define USB_ENDPOINT_DESCRIPTOR_TYPE 5 //獲取端點描述符

#define USB_DEVICE_QUALIFIER_DESCRIPTOR_TYPE 6 //不知道是啥

#define USB_OTHER_SPEED_CONFIG_DESCRIPTOR_TYPE 7 //不知道是啥

#define USB_INTERFACE_POWER_DESCRIPTOR_TYPE 8 //不知道是啥

#define USB_OTG_DESCRIPTOR_TYPE 9 //獲取otg描述符

#define USB_DEBUG_DESCRIPTOR_TYPE 10 //獲取調試描述符

#define USB_INTERFACE_ASSOCIATION_DESCRIPTOR_TYPE 11 //不知道

/* usb的設備類定義(在描述符中有用) */

#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 //HID設備

#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 //hub設備

#define USB_DEVICE_CLASS_MISCELLANEOUS 0xEF //

#define USB_DEVICE_CLASS_VENDOR_SPECIFIC 0xFF

/* 設備屬性值定義*/

#define USB_CONFIG_POWERED_MASK 0x40 //開機狀態(tài)?

#define USB_CONFIG_BUS_POWERED 0x80 //總線供電

#define USB_CONFIG_SELF_POWERED 0xC0 //自身帶電

#define USB_CONFIG_REMOTE_WAKEUP 0x20 //使能遠程喚醒

/* 最大總線需求電流(未識別的情況下統(tǒng)一是100MA,識別之后才根據實際配置選擇電流,不大于800MA) */

#define USB_CONFIG_POWER_MA(mA) ((mA)/2)

/* 端點地址描述 */

#define USB_ENDPOINT_DIRECTION_MASK 0x80

#define USB_ENDPOINT_OUT(addr) ((addr) | 0x00)

#define USB_ENDPOINT_IN(addr) ((addr) | 0x80) //輸入端點,最高位應該為1,用于向主機輸入數據

/* 端點特性描述*/

#define USB_ENDPOINT_TYPE_MASK 0x03 //端點類型掩碼

#define USB_ENDPOINT_TYPE_CONTROL 0x00 //控制端點