** Input:*dvi_ptr: 設備描述信息結構指針
** Output : 接口協議代碼
********************************************************************************************************/
extern uint8 Get_bInterfaceProtocol(device_instance *dvi_ptr);

/*********************************************************************************************************
** Function name: Get_bInterfaceSubClass
** Descriptions: 獲取接口子類代碼
** Input:*dvi_ptr: 設備描述信息結構指針
** Output :接口子類代碼
********************************************************************************************************/
extern uint8 Get_bInterfaceSubClass(device_instance *dvi_ptr);

/*********************************************************************************************************
** Function name: atl_open_transfer_instance
** Descriptions: 在傳描述符數據結構列表中，查找空閑的傳輸描述符數據結構
** Input: epi_ptr，端點描述數據結構
** Output : 正常返回：transfer_instance指針
**                出錯返回：ATL_ENDPOINT_ERR
**                                  NO_OPEN_ATL_TRANSFER
********************************************************************************************************/
#define     NO_OPEN_ATL_TRANSFER            (void *)0xFFFFFFFF
#define     ATL_ENDPOINT_ERR                NO_OPEN_ATL_TRANSFER
extern transfer_instance *atl_open_transfer_instance( endpoint_info * epi_ptr);


/*********************************************************************************************************
** Function name: atl_close_transfer_instance
** Descriptions: 通過atl_open_transfer_instance()申請的資源,通過該函數釋放.
** Input: tr_instance_ptr，傳輸描述符數據結構指針
** Output : 無
********************************************************************************************************/
extern void atl_close_transfer_instance(transfer_instance *tr_instance_ptr);

/*********************************************************************************************************
** Function name: h_get_epi_from_tr
** Descriptions: 從傳輸描述符中獲取端點描述信息
** Input:*tr_ptr: 傳輸描述信息結構指針
** Output :端點描述信息數據結構指針
********************************************************************************************************/
extern endpoint_info *h_get_epi_from_tr(transfer_instance *tr_ptr);

/*******************************************************************************************************
** 控制傳輸\批量傳輸\中斷傳輸 使用的宏
********************************************************************************************************/
#define     CompletionCode_NoEror               0x0
#define     CompletionCode_CRC                  0x1
#define     CompletionCode_BitStuffing          0x2
#define     CompletionCode_DataToggleMismatch   0x3
#define     CompletionCode_Stall                0x4
#define     CompletionCode_DeviceNotResponding  0x5
#define     CompletionCode_PIDCheckFailure      0x6
#define     CompletionCode_UnexpectedPID        0x7
#define     CompletionCode_DataOverrun          0x8
#define     CompletionCode_DataUnderrun         0x9
#define     CompletionCode_BufferOverrun        0xC
#define     CompletionCode_BufferUnderrun       0xD


#define     DirectionPID_OUT            1     // 傳輸方向,主機到設備
#define     DirectionPID_IN             2     // 傳輸方向,設備到主機
#define     NoDirection_Just_Hold       3     // 中斷傳輸時使用，無數據傳輸

/*******************************************************************************************************
** 控制傳輸 使用的數據結構
********************************************************************************************************/
typedef struct      req         {
                                    unsigned char   bmRequestType;
                                    unsigned char   bRequest;
                                    unsigned short  wValue;
                                    unsigned short  wIndex;
                                    unsigned short  wLength;
                                } 
                                USB_Device_Request;


/*********************************************************************************************************
** Function name: control_transfer
** Descriptions: 通過該函數處理控制傳輸。
** Input: *dev_req，設備請求數據結構指針
**          *dvi_ptr，設備描述結構指針
**          *data_ptr， 數據傳輸指針
** Output :正常返回0，出錯返回：
**           error @ SETUP    0x-0--
**           error @ DataStage    0x-1--
**           error @ StatusStage  0x-2--
**           error @ CC       0x--CC    (CC=value 0x01-0x0D)
**           retry over       0x--FF
**           data short       0x8000 | (0x7FFF & DataLength)
********************************************************************************************************/
extern unsigned short control_transfer(USB_Device_Request *dev_req, 
                                                                    device_instance *dvi_ptr, 
                                                                    unsigned char *data_ptr);

/*********************************************************************************************************
** Function name: bulk_transaction
** Descriptions: 批量傳輸處理函數
** Input: direction，傳輸方向(DirectionPID_OUT,DirectionPID_IN)
**              *data_ptr，傳輸數據緩沖區指針
**              *size_ptr，傳輸數據長度變量指針
**              *hTrInstance，傳輸描述符數據結構指針
** Output : 正常返回0，
**          出錯返回非0，如：completion_code，完成代碼
********************************************************************************************************/
extern unsigned char bulk_transaction( unsigned char direction, unsigned char *data_ptr, 
                                                                unsigned short *size_ptr, transfer_instance *hTrInstance);
                        
/*********************************************************************************************************
** Function name: interrupt_transaction
** Descriptions: 中斷傳輸處理函數
** Input:  direction，傳輸方向(DirectionPID_OUT,DirectionPID_IN)
**               *data_ptr，傳輸數據緩沖區指針
**               *size_ptr，傳輸數據長度變量指針
**               *hTrInstance，傳輸描述符數據結構指針
** Output : 正常返回0，
**          出錯返回非0，如：completion_code，完成代碼
********************************************************************************************************/
extern unsigned char interrupt_transaction(unsigned char direction, unsigned char *data_ptr, 
                                      unsigned short *size_ptr, transfer_instance *hTrInstance);

/*********************************************************************************************************
** Function name: ClearEndpointSTALL
** Descriptions:  清除端點停止狀態
** Input:         dvi_ptr: USB設備描述信息數據結構
**                epi_ptr: 端點描述信息數據結構
** Output :       TRUE：   正常返回
**                FALSE:   出錯返回。
********************************************************************************************************/
extern unsigned char ClearEndpointSTALL(device_instance *dvi_ptr, endpoint_info *epi_ptr);
        
/*********************************************************************************************************
** Function name: MassDriverIni
** Descriptions:  大容量類初始化
** Input:         none
** Output :       none
********************************************************************************************************/
extern void MassDriverIni(void);

/*********************************************************************************************************
** Function name: USB_Host_init
** Descriptions:  USB主機初始化
** Input:         none
** Output :       none
********************************************************************************************************/
extern void USB_Host_init(void);


    #ifdef __cplusplus
    }
    #endif
                        
#endif

/*********************************************************************************************************
**                            End Of File
********************************************************************************************************/