usbmain.pp

在CCS开发环境下的DSP 5509A的固件程序

/*                                                                            */
/* Purpose  :  Disconnect the USB module from the upstream port               */
/*             (D+ pullup disabled)                                           */
/*                                                                            */
/*                                                                            */
/* Author   :  MH                                                             */
/*                                                                            */
/* Based on :                                                                 */
/*                                                                            */
/*                                                                            */
/*============================================================================*/
/* Arguments:                                                                 */
/*                                                                            */
/* DevNum:    USB device number, enumerated data type of USB_DevNum.          */
/*            Only USB0 is active currently                                   */
/*                                                                            */
/*                                                                            */
/*                                                                            */
/*                                                                            */
/*                                                                            */
/*                                                                            */
/*============================================================================*/
/* Return Value:                                                              */
/*                                                                            */
/* None                                                                       */
/*                                                                            */
/*============================================================================*/
/* Comments:                                                                  */
/*                                                                            */
/*                                                                            */
/*                                                                            */
/*============================================================================*/
/* History:                                                                   */
/*                                                                            */
/* Created:    30 Mar 2001                                                    */
/*                                                                            */
/******************************************************************************/

extern void USB_disconnectDev(USB_DevNum DevNum);
        
        
/******************************************************************************/
/* Name     : USB_issueRemoteWakeup                                            */
/*                                                                            */
/* Catagory : Device Control                                                  */
/*                                                                            */
/* Purpose  : Issue a remote wakeup signal to the host.                       */
/*                                                                            */
/*                                                                            */
/* Author   : MH                                                              */
/*                                                                            */
/* Based on :                                                                 */
/*                                                                            */
/*                                                                            */
/*============================================================================*/
/* Arguments:                                                                 */
/*                                                                            */
/* DevNum:    USB device number, enumerated data type of USB_DevNum.          */
/*            Only USB0 is active currently                                   */
/*                                                                            */
/*                                                                            */
/*                                                                            */
/*                                                                            */
/*                                                                            */
/*============================================================================*/
/* Return Value:                                                              */
/*                                                                            */
/* USB_TRUE if successfull, else USB_FASLE (specailly if remote wakeup feature*/
/* is not set prior to calling this function)                                 */
/*                                                                            */
/*============================================================================*/
/* Comments:                                                                  */
/*                                                                            */
/* The USB driver will generate a remote wakeup signal on the bus if and only */
/* if the remote wakeup is enabled.  User's application must enable the remote*/
/* wakeup feature by calling the USB_setRemoteWakeup( ) routine if a Set      */
/* Remote Wakeup request is received from the  host.                          */
/*                                                                            */
/*============================================================================*/
/* History:                                                                   */
/*                                                                            */
/* Created:    30 Mar 2001                                                    */
/*                                                                            */
/******************************************************************************/

extern USB_Boolean USB_issueRemoteWakeup(USB_DevNum DevNum);

/******************************************************************************/
/* Name     : USB_setRemoteWakeup                                             */
/*                                                                            */
/* Catagory : Software Control                                                */
/*                                                                            */
/* Purpose  : Set or clear Remote Wakeup Feature                              */
/*                                                                            */
/*                                                                            */
/* Author   : MH                                                              */
/*                                                                            */
/* Based on :                                                                 */
/*                                                                            */
/*                                                                            */
/*============================================================================*/
/* Arguments:                                                                 */
/*                                                                            */
/* DevNum:    USB device number, enumerated data type of USB_DevNum.          */
/*            Only USB0 is active currently                                   */
/*                                                                            */
/* RmtWkpStat:  If USB_TRUE the driver will set remote wakeup feature         */
/*              and a subsequent call to USB_issueRemoteWakeup( ) will cause  */
/*              the driver to generate a remote signal on the bus             */
/*                                                                            */
/*              If USB_FALSE the driver will clear remote wakeup feature      */
/*              and a subsequent call to USB_issueRemoteWakeup( ) will not    */
/*              generate a remote signal on the bus                           */           
/*                                                                            */
/*                                                                            */
/*                                                                            */
/*============================================================================*/
/* Return Value:                                                              */
/*                                                                            */
/* None                                                                       */
/*                                                                            */
/*============================================================================*/
/* Comments:                                                                  */
/*                                                                            */
/* Host must set the remote wake up feature first. An application must verify */
/* if the remote wake-up feature is set before generating a remote wake-up    */
/* signal.                                                                    */
/*                                                                            */
/*============================================================================*/
/* History:                                                                   */
/*                                                                            */
/* Created:    31 Mar 2001                                                    */
/*                                                                            */
/******************************************************************************/

extern void USB_setRemoteWakeup(USB_DevNum DevNum, USB_Boolean RmtWkpStat);

/******************************************************************************/
/* Name     : USB_getRemoteWakeupStat                                         */
/*                                                                            */
/* Catagory : Status / Query                                                  */
/*                                                                            */
/* Purpose  : get the status of the Remote Wakeup Feature (whether the        */
/*            the feature is set or clear in the software)                    */
/*                                                                            */
/*                                                                            */
/* Author   : MH                                                              */
/*                                                                            */
/* Based on :                                                                 */
/*                                                                            */
/*                                                                            */
/*============================================================================*/
/* Arguments:                                                                 */
/*                                                                            */
/* DevNum:    USB device number, enumerated data type of USB_DevNum.          */
/*            Only USB0 is active currently                                   */
/*                                                                            */
/*============================================================================*/
/* Return Value:                                                              */
/*                                                                            */
/* USB_TRUE if the Remote Wakeup Feature is enabled in the software.          */
/* USB_FALSE if the Remote Wakeup Feature is disabled in the software.        */
/*                                                                            */
/*============================================================================*/
/* Comments:                                                                  */
/*                                                                            */
/* An application must verify if the remote wakeup feature is set by the host */
/* before calling USB_issueRemoteWakeup( )                                    */
/*                                                                            */
/*============================================================================*/
/* History:                                                                   */
/*                                                                            */
/* Created:    31 Mar 2001                                                    */
/*                                                                            */
/******************************************************************************/

extern USB_Boolean USB_getRemoteWakeupStat(USB_DevNum DevNum);

/******************************************************************************/
/* Name     :  USB_resetDev                                                   */
/*                                                                            */
/* Catagory :  Device Control                                                 */
/*                                                                            */
/* Purpose  :  Reset the USB module.                                          */
/*                                                                            */
/*                                                                            */
/* Author   :  MH                                                             */
/*                                                                            */
/* Based on :                                                                 */
/*                                                                            */
/*                                                                            */
/*============================================================================*/
/* Arguments:                                                                 */
/*                                                                            */
/* DevNum:    USB device number, enumerated data type of USB_DevNum.          */
/*            Only USB0 is active currently                                   */