/****************************************Copyright (c)**************************************************
**                               CH374做主機操作U盤讀寫程序
**                                      USB主機協議棧
**                                         頭文件
**
**                                        VBeat 0.2
**
**--------------文件信息--------------------------------------------------------------------------------
**文   件   名: USBhost.H
**創   建   人: 徐亦朱
**最后修改日期: 2007年9月25日
**描        述: USB主機協議棧頭文件
**              
**--------------歷史版本信息----------------------------------------------------------------------------
** 創建人: 徐亦朱
** 版  本: VBeat 0.1
** 日　期: 2007年9月24日
** 描　述: 原始版本
**
**--------------當前版本修訂------------------------------------------------------------------------------
** 修改人: 徐亦朱
** 日　期: 2007年9月25日
** 描　述: 優化頭文件
**
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/

//  USB標準請求
const UINT8C  SetupGetDevDescr [ ] = { 0x80, 0x06, 0x00, 0x01, 0x00, 0x00, 0x12, 0x00 } ; //Get_Descriptor -- Device
static const UINT8C  SetupGetCfgDescr [ ] = { 0x80, 0x06, 0x00, 0x02, 0x00, 0x00, 0x04, 0x00 } ; //Get_Descriptor -- Configuration
static const UINT8C  SetupSetUsbAddr  [ ] = { 0x00, 0x05, 0x02, 0x00, 0x00, 0x00, 0x00, 0x00 } ; //Set_Address
static const UINT8C  SetupSetUsbConfig[ ] = { 0x00, 0x09, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 } ; //Set_Configuration
static const UINT8C  SetupClrEndpStall[ ] = { 0x02, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 } ; //Clear_Feature

//  定義默認控制傳輸端點
#define  mDiskDefaultEndp  0x00 
//  USB設備的端點0的最大包尺寸
UINT8  UsbDevEndpSize = DEFAULT_ENDP0_SIZE ;
//  當前USB設備狀態，通常用于中斷方式的全局變量，本程序未使用
UINT8  FlagDeviceStatus;
//  保存最近一次執行的事務PID
UINT8  mSaveUsbPid ;

/*********************************************************************************************************
** 函數名稱: Init374Host
** 功能描述: 初始化USB主機
**
** 輸　入: 
** 輸　出: 
**         
** 全局變量: 無
** 調用模塊: 無
** 調試碼:   無
**  
**
** 作　者: 徐亦朱
** 日　期: 2007年9月24日
**-------------------------------------------------------------------------------------------------------
** 修改人: 
** 日　期: 
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
void  Init374Host( void ) ;                   

/*********************************************************************************************************
** 函數名稱: HostSetBusFree
** 功能描述: USB總線空閑
**
** 輸　入: 
** 輸　出: 
**         
** 全局變量: 無
** 調用模塊: 無
** 調試碼:   無
**  
**
** 作　者: 徐亦朱
** 日　期: 2007年9月24日
**-------------------------------------------------------------------------------------------------------
** 修改人: 
** 日　期: 
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
void  HostSetBusFree( void ) ;

/*********************************************************************************************************
** 函數名稱: HostSetBusReset
** 功能描述: USB總線復位
**
** 輸　入: 
** 輸　出: 
**         
** 全局變量: 無
** 調用模塊: 無
** 調試碼:   無
**  
**
** 作　者: 徐亦朱
** 日　期: 2007年9月24日
**-------------------------------------------------------------------------------------------------------
** 修改人: 
** 日　期: 
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
void  HostSetBusReset( ) ; 

/*********************************************************************************************************
** 函數名稱: HostSetFullSpeed
** 功能描述: 設定全速USB設備運行環境
**
** 輸　入: 
** 輸　出: 
**         
** 全局變量: 無
** 調用模塊: 無
** 調試碼:   無
**  
**
** 作　者: 徐亦朱
** 日　期: 2007年9月24日
**-------------------------------------------------------------------------------------------------------
** 修改人: 
** 日　期: 
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
void  HostSetFullSpeed( void ) ; 

/*********************************************************************************************************
** 函數名稱: HostSetLowSpeed
** 功能描述: 設定低速USB設備運行環境
**
** 輸　入: 
** 輸　出: 
**         
** 全局變量: 無
** 調用模塊: 無
** 調試碼:   無
**  
**
** 作　者: 徐亦朱
** 日　期: 2007年9月24日
**-------------------------------------------------------------------------------------------------------
** 修改人: 
** 日　期: 
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
void  HostSetLowSpeed( void ) ;             

/*********************************************************************************************************
** 函數名稱: SetHostUsbAddr
** 功能描述: 設置USB主機當前操作的USB設備地址
**
** 輸　入: 要設置的設備地址
** 輸　出: 
**         
** 全局變量: 無
** 調用模塊: 無
** 調試碼:   無
**  
**
** 作　者: 徐亦朱
** 日　期: 2007年9月24日
**-------------------------------------------------------------------------------------------------------
** 修改人: 
** 日　期: 
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
void  SetHostUsbAddr( UINT8 addr ) ;

/*********************************************************************************************************
** 函數名稱: HostDetectInterrupt
** 功能描述: 處理USB插拔事件中斷
**
** 輸　入: 
** 輸　出: 
**         
** 全局變量: 無
** 調用模塊: 無
** 調試碼:   無
**  
**
** 作　者: 徐亦朱
** 日　期: 2007年9月24日
**-------------------------------------------------------------------------------------------------------
** 修改人: 
** 日　期: 
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
void  HostDetectInterrupt( void ) ;

/*********************************************************************************************************
** 函數名稱: mSetControlSetup
** 功能描述: 設置默認控制數據SETUP
**
** 輸　入: 
** 輸　出: 
**         
** 全局變量: 無
** 調用模塊: 無
** 調試碼:   無
**  
**
** 作　者: 徐亦朱
** 日　期: 2007年9月24日
**-------------------------------------------------------------------------------------------------------
** 修改人: 
** 日　期: 
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
static void  mSetControlSetup( void ) ;

/*********************************************************************************************************
** 函數名稱: mSetControlIn
** 功能描述: 設置默認控制數據輸入
**
** 輸　入: 
** 輸　出: 
**         
** 全局變量: 無
** 調用模塊: 無
** 調試碼:   無
**  
**
** 作　者: 徐亦朱
** 日　期: 2007年9月24日
**-------------------------------------------------------------------------------------------------------
** 修改人: 
** 日　期: 
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
static void  mSetControlIn( void ) ;