666 lines
24 KiB
C
666 lines
24 KiB
C
|
/*****************************************************************************
|
||
|
** FILE NAME : ifxusb_cif.h
|
||
|
** PROJECT : IFX USB sub-system V3
|
||
|
** MODULES : IFX USB sub-system Host and Device driver
|
||
|
** SRC VERSION : 1.0
|
||
|
** DATE : 1/Jan/2009
|
||
|
** AUTHOR : Chen, Howard
|
||
|
** DESCRIPTION : The Core Interface provides basic services for accessing and
|
||
|
** managing the IFX USB hardware. These services are used by both the
|
||
|
** Host Controller Driver and the Peripheral Controller Driver.
|
||
|
** FUNCTIONS :
|
||
|
** COMPILER : gcc
|
||
|
** REFERENCE : IFX hardware ref handbook for each plateforms
|
||
|
** COPYRIGHT :
|
||
|
** Version Control Section **
|
||
|
** $Author$
|
||
|
** $Date$
|
||
|
** $Revisions$
|
||
|
** $Log$ Revision history
|
||
|
*****************************************************************************/
|
||
|
|
||
|
/*!
|
||
|
\defgroup IFXUSB_DRIVER_V3 IFX USB SS Project
|
||
|
\brief IFX USB subsystem V3.x
|
||
|
*/
|
||
|
|
||
|
/*!
|
||
|
\defgroup IFXUSB_CIF Core Interface APIs
|
||
|
\ingroup IFXUSB_DRIVER_V3
|
||
|
\brief The Core Interface provides basic services for accessing and
|
||
|
managing the IFXUSB hardware. These services are used by both the
|
||
|
Host Controller Driver and the Peripheral Controller Driver.
|
||
|
*/
|
||
|
|
||
|
|
||
|
/*!
|
||
|
\file ifxusb_cif.h
|
||
|
\ingroup IFXUSB_DRIVER_V3
|
||
|
\brief This file contains the interface to the IFX USB Core.
|
||
|
*/
|
||
|
|
||
|
#if !defined(__IFXUSB_CIF_H__)
|
||
|
#define __IFXUSB_CIF_H__
|
||
|
|
||
|
#include <linux/workqueue.h>
|
||
|
|
||
|
#include <linux/version.h>
|
||
|
#include <asm/param.h>
|
||
|
|
||
|
#include "ifxusb_plat.h"
|
||
|
#include "ifxusb_regs.h"
|
||
|
|
||
|
#ifdef __DEBUG__
|
||
|
#include "linux/timer.h"
|
||
|
#endif
|
||
|
|
||
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
||
|
#define IFXUSB_PARAM_SPEED_HIGH 0
|
||
|
#define IFXUSB_PARAM_SPEED_FULL 1
|
||
|
|
||
|
#define IFXUSB_EP_SPEED_LOW 0
|
||
|
#define IFXUSB_EP_SPEED_FULL 1
|
||
|
#define IFXUSB_EP_SPEED_HIGH 2
|
||
|
|
||
|
#define IFXUSB_EP_TYPE_CTRL 0
|
||
|
#define IFXUSB_EP_TYPE_ISOC 1
|
||
|
#define IFXUSB_EP_TYPE_BULK 2
|
||
|
#define IFXUSB_EP_TYPE_INTR 3
|
||
|
|
||
|
#define IFXUSB_HC_PID_DATA0 0
|
||
|
#define IFXUSB_HC_PID_DATA2 1
|
||
|
#define IFXUSB_HC_PID_DATA1 2
|
||
|
#define IFXUSB_HC_PID_MDATA 3
|
||
|
#define IFXUSB_HC_PID_SETUP 3
|
||
|
|
||
|
|
||
|
/*!
|
||
|
\addtogroup IFXUSB_CIF
|
||
|
*/
|
||
|
/*@{*/
|
||
|
|
||
|
/*!
|
||
|
\struct ifxusb_params
|
||
|
\brief IFXUSB Parameters structure.
|
||
|
This structure is used for both importing from insmod stage and run-time storage.
|
||
|
These parameters define how the IFXUSB controller should be configured.
|
||
|
*/
|
||
|
typedef struct ifxusb_params
|
||
|
{
|
||
|
int32_t dma_burst_size; /*!< The DMA Burst size (applicable only for Internal DMA
|
||
|
Mode). 0(for single), 1(incr), 4(incr4), 8(incr8) 16(incr16)
|
||
|
*/
|
||
|
/* Translate this to GAHBCFG values */
|
||
|
int32_t speed; /*!< Specifies the maximum speed of operation in host and device mode.
|
||
|
The actual speed depends on the speed of the attached device and
|
||
|
the value of phy_type. The actual speed depends on the speed of the
|
||
|
attached device.
|
||
|
0 - High Speed (default)
|
||
|
1 - Full Speed
|
||
|
*/
|
||
|
|
||
|
int32_t data_fifo_size; /*!< Total number of dwords in the data FIFO memory. This
|
||
|
memory includes the Rx FIFO, non-periodic Tx FIFO, and periodic
|
||
|
Tx FIFOs.
|
||
|
32 to 32768
|
||
|
*/
|
||
|
#ifdef __IS_DEVICE__
|
||
|
int32_t rx_fifo_size; /*!< Number of dwords in the Rx FIFO in device mode.
|
||
|
16 to 32768
|
||
|
*/
|
||
|
|
||
|
|
||
|
int32_t tx_fifo_size[MAX_EPS_CHANNELS]; /*!< Number of dwords in each of the Tx FIFOs in device mode.
|
||
|
4 to 768
|
||
|
*/
|
||
|
#ifdef __DED_FIFO__
|
||
|
int32_t thr_ctl; /*!< Threshold control on/off */
|
||
|
int32_t tx_thr_length; /*!< Threshold length for Tx */
|
||
|
int32_t rx_thr_length; /*!< Threshold length for Rx*/
|
||
|
#endif
|
||
|
#else //__IS_HOST__
|
||
|
int32_t host_channels; /*!< The number of host channel registers to use.
|
||
|
1 to 16
|
||
|
*/
|
||
|
|
||
|
int32_t rx_fifo_size; /*!< Number of dwords in the Rx FIFO in host mode.
|
||
|
16 to 32768
|
||
|
*/
|
||
|
|
||
|
int32_t nperio_tx_fifo_size;/*!< Number of dwords in the non-periodic Tx FIFO in host mode.
|
||
|
16 to 32768
|
||
|
*/
|
||
|
|
||
|
int32_t perio_tx_fifo_size; /*!< Number of dwords in the host periodic Tx FIFO.
|
||
|
16 to 32768
|
||
|
*/
|
||
|
#endif //__IS_HOST__
|
||
|
|
||
|
int32_t max_transfer_size; /*!< The maximum transfer size supported in bytes.
|
||
|
2047 to 65,535
|
||
|
*/
|
||
|
|
||
|
int32_t max_packet_count; /*!< The maximum number of packets in a transfer.
|
||
|
15 to 511 (default 511)
|
||
|
*/
|
||
|
int32_t phy_utmi_width; /*!< Specifies the UTMI+ Data Width.
|
||
|
8 or 16 bits (default 16)
|
||
|
*/
|
||
|
|
||
|
int32_t turn_around_time_hs; /*!< Specifies the Turn-Around time at HS*/
|
||
|
int32_t turn_around_time_fs; /*!< Specifies the Turn-Around time at FS*/
|
||
|
|
||
|
int32_t timeout_cal_hs; /*!< Specifies the Timeout_Calibration at HS*/
|
||
|
int32_t timeout_cal_fs; /*!< Specifies the Timeout_Calibration at FS*/
|
||
|
} ifxusb_params_t;
|
||
|
|
||
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
||
|
/*!
|
||
|
\struct ifxusb_core_if
|
||
|
\brief The ifx_core_if structure contains information needed to manage
|
||
|
the IFX USB controller acting in either host or device mode. It
|
||
|
represents the programming view of the controller as a whole.
|
||
|
*/
|
||
|
typedef struct ifxusb_core_if
|
||
|
{
|
||
|
ifxusb_params_t params; /*!< Run-time Parameters */
|
||
|
|
||
|
uint8_t core_no; /*!< core number (used as id when multi-core case */
|
||
|
char *core_name; /*!< core name used for registration and informative purpose*/
|
||
|
int irq; /*!< irq number this core is hooked */
|
||
|
|
||
|
/*****************************************************************
|
||
|
* Structures and pointers to physical register interface.
|
||
|
*****************************************************************/
|
||
|
/** Core Global registers starting at offset 000h. */
|
||
|
ifxusb_core_global_regs_t *core_global_regs; /*!< pointer to Core Global Registers, offset at 000h */
|
||
|
|
||
|
/** Host-specific registers */
|
||
|
#ifdef __IS_HOST__
|
||
|
/** Host Global Registers starting at offset 400h.*/
|
||
|
ifxusb_host_global_regs_t *host_global_regs; /*!< pointer to Host Global Registers, offset at 400h */
|
||
|
#define IFXUSB_HOST_GLOBAL_REG_OFFSET 0x400
|
||
|
/** Host Port 0 Control and Status Register */
|
||
|
volatile uint32_t *hprt0; /*!< pointer to HPRT0 Registers, offset at 440h */
|
||
|
#define IFXUSB_HOST_PORT_REGS_OFFSET 0x440
|
||
|
/** Host Channel Specific Registers at offsets 500h-5FCh. */
|
||
|
ifxusb_hc_regs_t *hc_regs[MAX_EPS_CHANNELS]; /*!< pointer to Host-Channel n Registers, offset at 500h */
|
||
|
#define IFXUSB_HOST_CHAN_REGS_OFFSET 0x500
|
||
|
#define IFXUSB_CHAN_REGS_OFFSET 0x20
|
||
|
#endif
|
||
|
|
||
|
/** Device-specific registers */
|
||
|
#ifdef __IS_DEVICE__
|
||
|
/** Device Global Registers starting at offset 800h */
|
||
|
ifxusb_device_global_regs_t *dev_global_regs; /*!< pointer to Device Global Registers, offset at 800h */
|
||
|
#define IFXUSB_DEV_GLOBAL_REG_OFFSET 0x800
|
||
|
|
||
|
/** Device Logical IN Endpoint-Specific Registers 900h-AFCh */
|
||
|
ifxusb_dev_in_ep_regs_t *in_ep_regs[MAX_EPS_CHANNELS]; /*!< pointer to Device IN-EP Registers, offset at 900h */
|
||
|
#define IFXUSB_DEV_IN_EP_REG_OFFSET 0x900
|
||
|
#define IFXUSB_EP_REG_OFFSET 0x20
|
||
|
/** Device Logical OUT Endpoint-Specific Registers B00h-CFCh */
|
||
|
ifxusb_dev_out_ep_regs_t *out_ep_regs[MAX_EPS_CHANNELS];/*!< pointer to Device OUT-EP Registers, offset at 900h */
|
||
|
#define IFXUSB_DEV_OUT_EP_REG_OFFSET 0xB00
|
||
|
#endif
|
||
|
|
||
|
/** Power and Clock Gating Control Register */
|
||
|
volatile uint32_t *pcgcctl; /*!< pointer to Power and Clock Gating Control Registers, offset at E00h */
|
||
|
#define IFXUSB_PCGCCTL_OFFSET 0xE00
|
||
|
|
||
|
/** Push/pop addresses for endpoints or host channels.*/
|
||
|
uint32_t *data_fifo[MAX_EPS_CHANNELS]; /*!< pointer to FIFO access windows, offset at 1000h */
|
||
|
#define IFXUSB_DATA_FIFO_OFFSET 0x1000
|
||
|
#define IFXUSB_DATA_FIFO_SIZE 0x1000
|
||
|
|
||
|
uint32_t *data_fifo_dbg; /*!< pointer to FIFO debug windows, offset at 1000h */
|
||
|
|
||
|
/** Hardware Configuration -- stored here for convenience.*/
|
||
|
hwcfg1_data_t hwcfg1; /*!< preserved Hardware Configuration 1 */
|
||
|
hwcfg2_data_t hwcfg2; /*!< preserved Hardware Configuration 2 */
|
||
|
hwcfg3_data_t hwcfg3; /*!< preserved Hardware Configuration 3 */
|
||
|
hwcfg4_data_t hwcfg4; /*!< preserved Hardware Configuration 3 */
|
||
|
uint32_t snpsid; /*!< preserved SNPSID */
|
||
|
|
||
|
/*****************************************************************
|
||
|
* Run-time informations.
|
||
|
*****************************************************************/
|
||
|
/* Set to 1 if the core PHY interface bits in USBCFG have been initialized. */
|
||
|
uint8_t phy_init_done; /*!< indicated PHY is initialized. */
|
||
|
|
||
|
#ifdef __IS_HOST__
|
||
|
uint8_t queuing_high_bandwidth; /*!< Host mode, Queueing High Bandwidth. */
|
||
|
#endif
|
||
|
} ifxusb_core_if_t;
|
||
|
|
||
|
/*@}*//*IFXUSB_CIF*/
|
||
|
|
||
|
|
||
|
/*!
|
||
|
\fn void *ifxusb_alloc_buf(size_t size, int clear)
|
||
|
\brief This function is called to allocate buffer of specified size.
|
||
|
The allocated buffer is mapped into DMA accessable address.
|
||
|
\param size Size in BYTE to be allocated
|
||
|
\param clear 0: don't do clear after buffer allocated, other: do clear to zero
|
||
|
\return 0/NULL: Fail; uncached pointer of allocated buffer
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void *ifxusb_alloc_buf(size_t size, int clear);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_free_buf(void *vaddr)
|
||
|
\brief This function is called to free allocated buffer.
|
||
|
\param vaddr the uncached pointer of the buffer
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_free_buf(void *vaddr);
|
||
|
|
||
|
/*!
|
||
|
\fn int ifxusb_core_if_init(ifxusb_core_if_t *_core_if,
|
||
|
int _irq,
|
||
|
uint32_t _reg_base_addr,
|
||
|
uint32_t _fifo_base_addr,
|
||
|
uint32_t _fifo_dbg_addr)
|
||
|
\brief This function is called to initialize the IFXUSB CSR data
|
||
|
structures. The register addresses in the device and host
|
||
|
structures are initialized from the base address supplied by the
|
||
|
caller. The calling function must make the OS calls to get the
|
||
|
base address of the IFXUSB controller registers.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\param _irq irq number
|
||
|
\param _reg_base_addr Base address of IFXUSB core registers
|
||
|
\param _fifo_base_addr Fifo base address
|
||
|
\param _fifo_dbg_addr Fifo debug address
|
||
|
\return 0: success;
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern int ifxusb_core_if_init(ifxusb_core_if_t *_core_if,
|
||
|
int _irq,
|
||
|
uint32_t _reg_base_addr,
|
||
|
uint32_t _fifo_base_addr,
|
||
|
uint32_t _fifo_dbg_addr);
|
||
|
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_core_if_remove(ifxusb_core_if_t *_core_if)
|
||
|
\brief This function free the mapped address in the IFXUSB CSR data structures.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_core_if_remove(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_enable_global_interrupts( ifxusb_core_if_t *_core_if )
|
||
|
\brief This function enbles the controller's Global Interrupt in the AHB Config register.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
*/
|
||
|
extern void ifxusb_enable_global_interrupts( ifxusb_core_if_t *_core_if );
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_disable_global_interrupts( ifxusb_core_if_t *_core_if )
|
||
|
\brief This function disables the controller's Global Interrupt in the AHB Config register.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_disable_global_interrupts( ifxusb_core_if_t *_core_if );
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_flush_tx_fifo( ifxusb_core_if_t *_core_if, const int _num )
|
||
|
\brief Flush a Tx FIFO.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\param _num Tx FIFO to flush. ( 0x10 for ALL TX FIFO )
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_flush_tx_fifo( ifxusb_core_if_t *_core_if, const int _num );
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_flush_rx_fifo( ifxusb_core_if_t *_core_if )
|
||
|
\brief Flush Rx FIFO.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_flush_rx_fifo( ifxusb_core_if_t *_core_if );
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_flush_both_fifo( ifxusb_core_if_t *_core_if )
|
||
|
\brief Flush ALL Rx and Tx FIFO.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_flush_both_fifo( ifxusb_core_if_t *_core_if );
|
||
|
|
||
|
|
||
|
/*!
|
||
|
\fn int ifxusb_core_soft_reset(ifxusb_core_if_t *_core_if)
|
||
|
\brief Do core a soft reset of the core. Be careful with this because it
|
||
|
resets all the internal state machines of the core.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern int ifxusb_core_soft_reset(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
|
||
|
/*!
|
||
|
\brief Turn on the USB Core Power
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_power_on (ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_power_off (ifxusb_core_if_t *_core_if)
|
||
|
\brief Turn off the USB Core Power
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_power_off (ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_phy_power_on (ifxusb_core_if_t *_core_if)
|
||
|
\brief Turn on the USB PHY Power
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_phy_power_on (ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_phy_power_off (ifxusb_core_if_t *_core_if)
|
||
|
\brief Turn off the USB PHY Power
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_phy_power_off (ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_hard_reset(ifxusb_core_if_t *_core_if)
|
||
|
\brief Reset on the USB Core RCU
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_hard_reset(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
||
|
|
||
|
#ifdef __IS_HOST__
|
||
|
/*!
|
||
|
\fn void ifxusb_host_core_init(ifxusb_core_if_t *_core_if, ifxusb_params_t *_params)
|
||
|
\brief This function initializes the IFXUSB controller registers for Host mode.
|
||
|
This function flushes the Tx and Rx FIFOs and it flushes any entries in the
|
||
|
request queues.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\param _params parameters to be set
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_host_core_init(ifxusb_core_if_t *_core_if, ifxusb_params_t *_params);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_host_enable_interrupts(ifxusb_core_if_t *_core_if)
|
||
|
\brief This function enables the Host mode interrupts.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_host_enable_interrupts(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_host_disable_interrupts(ifxusb_core_if_t *_core_if)
|
||
|
\brief This function disables the Host mode interrupts.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_host_disable_interrupts(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
#if defined(__IS_TWINPASS__)
|
||
|
extern void ifxusb_enable_afe_oc(void);
|
||
|
#endif
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_vbus_init(ifxusb_core_if_t *_core_if)
|
||
|
\brief This function init the VBUS control.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_vbus_init(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_vbus_free(ifxusb_core_if_t *_core_if)
|
||
|
\brief This function free the VBUS control.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_vbus_free(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_vbus_on(ifxusb_core_if_t *_core_if)
|
||
|
\brief Turn on the USB 5V VBus Power
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_vbus_on(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_vbus_off(ifxusb_core_if_t *_core_if)
|
||
|
\brief Turn off the USB 5V VBus Power
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_vbus_off(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn int ifxusb_vbus(ifxusb_core_if_t *_core_if)
|
||
|
\brief Read Current VBus status
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern int ifxusb_vbus(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
#if defined(__DO_OC_INT__) && defined(__DO_OC_INT_ENABLE__)
|
||
|
/*!
|
||
|
\fn void ifxusb_oc_int_on(void)
|
||
|
\brief Turn on the OC interrupt
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_oc_int_on(void);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_oc_int_off(void)
|
||
|
\brief Turn off the OC interrupt
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_oc_int_off(void);
|
||
|
#endif //defined(__DO_OC_INT__) && defined(__DO_OC_INT_ENABLE__)
|
||
|
#endif
|
||
|
|
||
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
||
|
|
||
|
#ifdef __IS_DEVICE__
|
||
|
/*!
|
||
|
\fn void ifxusb_dev_enable_interrupts(ifxusb_core_if_t *_core_if)
|
||
|
\brief This function enables the Device mode interrupts.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_dev_enable_interrupts(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn uint32_t ifxusb_dev_get_frame_number(ifxusb_core_if_t *_core_if)
|
||
|
\brief Gets the current USB frame number. This is the frame number from the last SOF packet.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern uint32_t ifxusb_dev_get_frame_number(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_dev_ep_set_stall(ifxusb_core_if_t *_core_if, uint8_t _epno, uint8_t _is_in)
|
||
|
\brief Set the EP STALL.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\param _epno EP number
|
||
|
\param _is_in 1: is IN transfer
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_dev_ep_set_stall(ifxusb_core_if_t *_core_if, uint8_t _epno, uint8_t _is_in);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_dev_ep_clear_stall(ifxusb_core_if_t *_core_if, uint8_t _epno, uint8_t _ep_type, uint8_t _is_in)
|
||
|
\brief Set the EP STALL.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\param _epno EP number
|
||
|
\param _ep_type EP Type
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_dev_ep_clear_stall(ifxusb_core_if_t *_core_if, uint8_t _epno, uint8_t _ep_type, uint8_t _is_in);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_dev_core_init(ifxusb_core_if_t *_core_if, ifxusb_params_t *_params)
|
||
|
\brief This function initializes the IFXUSB controller registers for Device mode.
|
||
|
This function flushes the Tx and Rx FIFOs and it flushes any entries in the
|
||
|
request queues.
|
||
|
This function validate the imported parameters and store the result in the CIF structure.
|
||
|
After
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\param _params structure of inported parameters
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_dev_core_init(ifxusb_core_if_t *_core_if, ifxusb_params_t *_params);
|
||
|
#endif
|
||
|
|
||
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
||
|
#if defined(__GADGET_LED__) || defined(__HOST_LED__)
|
||
|
/*!
|
||
|
\fn void ifxusb_led_init(ifxusb_core_if_t *_core_if)
|
||
|
\brief This function init the LED control.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_led_init(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_led_free(ifxusb_core_if_t *_core_if)
|
||
|
\brief This function free the LED control.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_led_free(ifxusb_core_if_t *_core_if);
|
||
|
|
||
|
/*!
|
||
|
\fn void ifxusb_led(ifxusb_core_if_t *_core_if)
|
||
|
\brief This function trigger the LED access.
|
||
|
\param _core_if Pointer of core_if structure
|
||
|
\ingroup IFXUSB_CIF
|
||
|
*/
|
||
|
extern void ifxusb_led(ifxusb_core_if_t *_core_if);
|
||
|
#endif
|
||
|
|
||
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
||
|
/* internal routines for debugging */
|
||
|
extern void ifxusb_dump_msg(const u8 *buf, unsigned int length);
|
||
|
extern void ifxusb_dump_spram(ifxusb_core_if_t *_core_if);
|
||
|
extern void ifxusb_dump_registers(ifxusb_core_if_t *_core_if);
|
||
|
extern void ifxusb_clean_spram(ifxusb_core_if_t *_core_if,uint32_t dwords);
|
||
|
|
||
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
||
|
static inline uint32_t ifxusb_read_core_intr(ifxusb_core_if_t *_core_if)
|
||
|
{
|
||
|
return (ifxusb_rreg(&_core_if->core_global_regs->gintsts) &
|
||
|
(ifxusb_rreg(&_core_if->core_global_regs->gintmsk)
|
||
|
#ifdef __USE_TIMER_4_SOF__
|
||
|
| IFXUSB_SOF_INTR_MASK
|
||
|
#endif
|
||
|
));
|
||
|
}
|
||
|
|
||
|
static inline uint32_t ifxusb_read_otg_intr (ifxusb_core_if_t *_core_if)
|
||
|
{
|
||
|
return (ifxusb_rreg (&_core_if->core_global_regs->gotgint));
|
||
|
}
|
||
|
|
||
|
static inline uint32_t ifxusb_mode(ifxusb_core_if_t *_core_if)
|
||
|
{
|
||
|
return (ifxusb_rreg( &_core_if->core_global_regs->gintsts ) & 0x1);
|
||
|
}
|
||
|
static inline uint8_t ifxusb_is_device_mode(ifxusb_core_if_t *_core_if)
|
||
|
{
|
||
|
return (ifxusb_mode(_core_if) != 1);
|
||
|
}
|
||
|
static inline uint8_t ifxusb_is_host_mode(ifxusb_core_if_t *_core_if)
|
||
|
{
|
||
|
return (ifxusb_mode(_core_if) == 1);
|
||
|
}
|
||
|
|
||
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
||
|
#ifdef __IS_HOST__
|
||
|
static inline uint32_t ifxusb_read_hprt0(ifxusb_core_if_t *_core_if)
|
||
|
{
|
||
|
hprt0_data_t hprt0;
|
||
|
hprt0.d32 = ifxusb_rreg(_core_if->hprt0);
|
||
|
hprt0.b.prtena = 0;
|
||
|
hprt0.b.prtconndet = 0;
|
||
|
hprt0.b.prtenchng = 0;
|
||
|
hprt0.b.prtovrcurrchng = 0;
|
||
|
return hprt0.d32;
|
||
|
}
|
||
|
|
||
|
static inline uint32_t ifxusb_read_host_all_channels_intr (ifxusb_core_if_t *_core_if)
|
||
|
{
|
||
|
return (ifxusb_rreg (&_core_if->host_global_regs->haint));
|
||
|
}
|
||
|
|
||
|
static inline uint32_t ifxusb_read_host_channel_intr (ifxusb_core_if_t *_core_if, int hc_num)
|
||
|
{
|
||
|
return (ifxusb_rreg (&_core_if->hc_regs[hc_num]->hcint));
|
||
|
}
|
||
|
#endif
|
||
|
|
||
|
#ifdef __IS_DEVICE__
|
||
|
static inline uint32_t ifxusb_read_dev_all_in_ep_intr(ifxusb_core_if_t *_core_if)
|
||
|
{
|
||
|
uint32_t v;
|
||
|
v = ifxusb_rreg(&_core_if->dev_global_regs->daint) &
|
||
|
ifxusb_rreg(&_core_if->dev_global_regs->daintmsk);
|
||
|
return (v & 0xffff);
|
||
|
}
|
||
|
|
||
|
static inline uint32_t ifxusb_read_dev_all_out_ep_intr(ifxusb_core_if_t *_core_if)
|
||
|
{
|
||
|
uint32_t v;
|
||
|
v = ifxusb_rreg(&_core_if->dev_global_regs->daint) &
|
||
|
ifxusb_rreg(&_core_if->dev_global_regs->daintmsk);
|
||
|
return ((v & 0xffff0000) >> 16);
|
||
|
}
|
||
|
|
||
|
static inline uint32_t ifxusb_read_dev_in_ep_intr(ifxusb_core_if_t *_core_if, int _ep_num)
|
||
|
{
|
||
|
uint32_t v;
|
||
|
v = ifxusb_rreg(&_core_if->in_ep_regs[_ep_num]->diepint) &
|
||
|
ifxusb_rreg(&_core_if->dev_global_regs->diepmsk);
|
||
|
return v;
|
||
|
}
|
||
|
|
||
|
static inline uint32_t ifxusb_read_dev_out_ep_intr(ifxusb_core_if_t *_core_if, int _ep_num)
|
||
|
{
|
||
|
uint32_t v;
|
||
|
v = ifxusb_rreg(&_core_if->out_ep_regs[_ep_num]->doepint) &
|
||
|
ifxusb_rreg(&_core_if->dev_global_regs->doepmsk);
|
||
|
return v;
|
||
|
}
|
||
|
|
||
|
#endif
|
||
|
|
||
|
extern void ifxusb_attr_create (void *_dev);
|
||
|
|
||
|
extern void ifxusb_attr_remove (void *_dev);
|
||
|
|
||
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
||
|
#endif // !defined(__IFXUSB_CIF_H__)
|
||
|
|
||
|
|