move sboot to the root directory
[open-ath9k-htc-firmware.git] / target_firmware / magpie_fw_dev / build / magpie_1_1 / sboot / hif / usb / src / HIF_usb.c
diff --git a/target_firmware/magpie_fw_dev/build/magpie_1_1/sboot/hif/usb/src/HIF_usb.c b/target_firmware/magpie_fw_dev/build/magpie_1_1/sboot/hif/usb/src/HIF_usb.c
deleted file mode 100755 (executable)
index 6294961..0000000
+++ /dev/null
@@ -1,675 +0,0 @@
-/*
- * Copyright (c) 2013 Qualcomm Atheros, Inc.
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted (subject to the limitations in the
- * disclaimer below) provided that the following conditions are met:
- *
- *  * Redistributions of source code must retain the above copyright
- *    notice, this list of conditions and the following disclaimer.
- *
- *  * Redistributions in binary form must reproduce the above copyright
- *    notice, this list of conditions and the following disclaimer in the
- *    documentation and/or other materials provided with the
- *    distribution.
- *
- *  * Neither the name of Qualcomm Atheros nor the names of its
- *    contributors may be used to endorse or promote products derived
- *    from this software without specific prior written permission.
- *
- * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE
- * GRANTED BY THIS LICENSE.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT
- * HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
- * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
- * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
- * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
- * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
- * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
- * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
- * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-/*
- * @File: HIF_usb.c
- * 
- * @Abstract: USB implementation of HIF
- * 
- * @Notes:
- */
-#include "sys_cfg.h"
-#include "dt_defs.h"
-#include "reg_defs.h"
-
-#include <osapi.h>
-//#include <hif_api.h>
-#include <Magpie_api.h>
-#include <vdesc_api.h>
-#include <adf_os_mem.h> 
-#include <adf_os_io.h>
-//#include <desc.h>
-#include <dma_engine_api.h>
-
-#include "hif_usb.h"
-
-HIF_USB_CONTEXT g_hifUSBCtx;
-
-
-static void send_buffer_via_fifo(VBUF *buf);
-static int _HIFusb_get_reserved_headroom(hif_handle_t handle);
-static struct zsDmaQueue* get_queue_from_pipe(int pipe);
-
-int _HIFusb_get_max_msg_len(hif_handle_t handle, int pipe);
-
-//#define OTUS_USB
-
-static VBUF* usbfifo_get_command_buf()
-{
-    VBUF *buf;
-     
-    buf = g_hifUSBCtx.cmdQueue;
-    g_hifUSBCtx.cmdQueue = buf->next_buf;
-    buf->next_buf = NULL;
-    return buf;
-}
-
-static void usbfifo_recv_command(VBUF *buf)
-{
-#if ENABLE_SW_SWAP_DATA_MODE
-    VDESC *currVdesc;
-    struct zsDmaDesc* usbDesc;
-#endif
-    
-    #if ZM_FM_LOOPBACK == 1
-    send_buffer_via_fifo(buf);
-    #else
-    
-#if ENABLE_SW_SWAP_DATA_MODE
-    currVdesc = (VDESC *)buf->desc_list;
-    usbDesc = (struct zsDmaDesc *)currVdesc->hw_desc_buf;    
-    usbDesc->dataSize = currVdesc->data_size;
-    usbDesc->dataAddr = (volatile u32_t)(currVdesc->buf_addr + currVdesc->data_offset);
-            
-    DMA_Engine_swap_data(usbDesc);
-#endif    
-    g_hifUSBCtx.hifCb.recv_buf(NULL, buf, g_hifUSBCtx.hifCb.context);
-    #endif
-}
-
-static VBUF* usbfifo_get_event_buf()
-{
-    VBUF *buf;
-
-    buf = g_hifUSBCtx.eventBufQ.head;
-    if ( g_hifUSBCtx.eventBufQ.head == g_hifUSBCtx.eventBufQ.tail ) {
-        g_hifUSBCtx.eventBufQ.head = NULL;
-        g_hifUSBCtx.eventBufQ.tail = NULL;
-    } else {
-        g_hifUSBCtx.eventBufQ.head = buf->next_buf;
-    }
-
-    buf->next_buf = NULL;    
-    return buf;    
-}
-
-static void usbfifo_send_event_done(VBUF *buf)
-{
-    #if ZM_FM_LOOPBACK == 1    
-        ; // LOOPBACK? 
-    _HIFusb_return_recv_buf(NULL, HIF_USB_PIPE_COMMAND, buf);
-    #else
-    g_hifUSBCtx.hifCb.send_buf_done(buf, g_hifUSBCtx.hifCb.context); 
-    #endif
-}
-
-#define MAGPIE_ENABLE_USBFIFO
-
-hif_handle_t _HIFusb_init(HIF_CONFIG *pConfig) 
-{
-    USB_FIFO_CONFIG usbfifo;
-    
-#ifdef MAGPIE_ENABLE_USBFIFO    
-    usbfifo.get_command_buf = usbfifo_get_command_buf;
-    usbfifo.recv_command    = usbfifo_recv_command;
-    usbfifo.get_event_buf   = usbfifo_get_event_buf;
-    usbfifo.send_event_done = usbfifo_send_event_done;
-    USBFIFO_init(&usbfifo);
-#endif
-    
-    // Initialize the terminator descriptor for dnQ & upQ
-    DMA_Engine_init_rx_queue(&g_hifUSBCtx.dnQ);
-    DMA_Engine_init_tx_queue(&g_hifUSBCtx.upQ);
-            
-#if SYSTEM_MODULE_HP_EP5
-    DMA_Engine_init_rx_queue(&g_hifUSBCtx.hpdnQ);    
-#endif
-
-#if SYSTEM_MODULE_HP_EP6
-    DMA_Engine_init_rx_queue(&g_hifUSBCtx.mpdnQ); 
-#endif
-
-    g_hifUSBCtx.eventBufQ.head = NULL;
-    g_hifUSBCtx.eventBufQ.tail = NULL;
-    g_hifUSBCtx.cmdQueue = NULL;
-    
-    return NULL;
-}
-
-void _HIFusb_shutdown(hif_handle_t handle) 
-{
-    // nothing to do in FW
-}
-
-void _HIFusb_register_callback(hif_handle_t handle, HIF_CALLBACK *pConfig) 
-{
-    //HIF_INPROC_CONTEXT *hifInprocCtx = (HIF_INPROC_CONTEXT *)handle;        
-    
-    g_hifUSBCtx.hifCb.send_buf_done = pConfig->send_buf_done;
-    g_hifUSBCtx.hifCb.recv_buf      = pConfig->recv_buf;
-    g_hifUSBCtx.hifCb.context       = pConfig->context;
-        
-    return;
-}
-
-//#define MAGPIE_REG_USB_
-void _HIFusb_start(hif_handle_t handle) 
-{
-#ifdef OTUS_USB    
-    ZM_PTA_DN_DMA_ADDRH_REG = (u32_t)g_hifUSBCtx.dnQ.head >> 16;
-    ZM_PTA_DN_DMA_ADDRL_REG = (u32_t)g_hifUSBCtx.dnQ.head & 0xffff;
-    
-    ZM_PTA_UP_DMA_ADDRH_REG = (u32_t)g_hifUSBCtx.upQ.head >> 16;
-    ZM_PTA_UP_DMA_ADDRL_REG = (u32_t)g_hifUSBCtx.upQ.head & 0xffff;       
-#else
-    A_PRINTF("\n\r\t=>[dnQ] 0x%08x \n[", (u32_t)g_hifUSBCtx.dnQ.head);
-    A_PRINTF("\t=>[upQ] 0x%08x \n[", (u32_t)g_hifUSBCtx.upQ.head);
-    
-    MAGPIE_REG_USB_RX0_DESC_START = (u32_t)g_hifUSBCtx.dnQ.head;
-    MAGPIE_REG_USB_TX0_DESC_START = (u32_t)g_hifUSBCtx.upQ.head;
-#if SYSTEM_MODULE_HP_EP5
-    A_PRINTF("\t=>[hp dnQ] 0x%08x \n[", (u32_t)g_hifUSBCtx.hpdnQ.head);
-    MAGPIE_REG_USB_RX1_DESC_START = (u32_t)g_hifUSBCtx.hpdnQ.head;
-#endif
-
-#if SYSTEM_MODULE_HP_EP6
-    A_PRINTF("\t=>[mp dnQ] 0x%08x \n[", (u32_t)g_hifUSBCtx.mpdnQ.head);
-    MAGPIE_REG_USB_RX2_DESC_START = (u32_t)g_hifUSBCtx.mpdnQ.head;
-#endif
-
-    MAGPIE_REG_USB_INTERRUPT_MASK =  0xffffffff;    // enable all interrupt, refer to 7-34, Ryan
-    MAGPIE_REG_USB_RX0_DMA_START = 1; 
-
-#if SYSTEM_MODULE_HP_EP5
-    MAGPIE_REG_USB_RX1_DMA_START = 1;
- #endif
-
-#if SYSTEM_MODULE_HP_EP6
-    MAGPIE_REG_USB_RX2_DMA_START = 1;
-#endif
-#endif    
-}
-
-static int _HIFusb_get_reserved_headroom(hif_handle_t handle)
-{
-    return 0;
-}
-
-static void config_command_pipe(VDESC *desc_list)
-{
-    VDESC *theDesc;
-    VBUF  *buf;
-    
-    theDesc = desc_list;
-    while ( theDesc != NULL ) {
-        buf = VBUF_alloc_vbuf();
-        
-        buf->desc_list = theDesc;
-        theDesc = theDesc->next_desc;
-        buf->desc_list->next_desc = NULL;
-        
-        if ( g_hifUSBCtx.cmdQueue == NULL ) {
-            g_hifUSBCtx.cmdQueue = buf;
-        } else {
-            buf->next_buf = g_hifUSBCtx.cmdQueue;
-            g_hifUSBCtx.cmdQueue = buf;
-        }
-    }    
-}
-
-static void enable_rx(int pipe)
-{
-    if ( pipe == HIF_USB_PIPE_TX ) {
-        #ifdef OTUS_USB      
-        ZM_PTA_DN_DMA_TRIGGER_REG = 1;
-        #else
-        MAGPIE_REG_USB_RX0_DMA_START = 1;
-        #endif    
-    }
-#if SYSTEM_MODULE_HP_EP5
-    else if ( pipe == HIF_USB_PIPE_HP_TX ) {
-        MAGPIE_REG_USB_RX1_DMA_START = 1;
-    }
-#endif
-#if SYSTEM_MODULE_HP_EP6
-    else if ( pipe == HIF_USB_PIPE_MP_TX ) {
-        MAGPIE_REG_USB_RX2_DMA_START = 1;
-    }
-#endif      
-}
-
-static struct zsDmaQueue* get_queue_from_pipe(int pipe)
-{   
-    struct zsDmaQueue* q = NULL;
-    
-    if ( pipe == HIF_USB_PIPE_TX ) {
-        q = &g_hifUSBCtx.dnQ;      
-    } 
-#if SYSTEM_MODULE_HP_EP5
-    else if ( pipe == HIF_USB_PIPE_HP_TX )
-    {
-        q = &g_hifUSBCtx.hpdnQ;
-    }
-#endif
-#if SYSTEM_MODULE_HP_EP6
-    else if ( pipe == HIF_USB_PIPE_MP_TX )
-    {
-        q = &g_hifUSBCtx.mpdnQ; 
-    }
-#endif
-    else {
-        adf_os_assert(0);
-    }
-    
-    return q;
-}
-
-//#define MAX_TX_BUF_SIZE            ZM_BLOCK_SIZE
-//#define MAX_TX_BUF_SIZE            1600
-
-//void _HIFusb_config_pipe(hif_handle_t handle, int pipe, VDESC *desc_list)
-void _HIFusb_config_pipe(hif_handle_t handle, int pipe, int creditCount)
-{
-    int i;
-    VDESC *desc;
-    VDESC *head = NULL;
-    struct zsDmaQueue *q;
-    
-    if ( pipe != HIF_USB_PIPE_COMMAND ) {
-        goto config_pipe;
-    }
-    
-    // USB command pipe doesn't use FIFO
-    for(i=0; i < creditCount; i++)
-    {
-        desc = VDESC_alloc_vdesc();
-        
-        adf_os_assert(desc != NULL);
-        
-        desc->buf_addr = (A_UINT8 *)adf_os_mem_alloc(HIF_get_max_msg_len(handle, pipe));
-        desc->buf_size = HIF_get_max_msg_len(handle, pipe);
-        desc->next_desc = NULL;
-        desc->data_offset = 0;
-        desc->data_size = 0;
-        desc->control = 0;
-               
-        if ( head == NULL )
-        {
-            head = desc;
-        }
-        else
-        {
-            desc->next_desc = head;
-            head = desc;
-        }
-    }         
-    
-    config_command_pipe(head);
-    return;
-    
-config_pipe:    
-    q = get_queue_from_pipe(pipe);   
-    DMA_Engine_config_rx_queue(q, creditCount, HIF_get_max_msg_len(handle, pipe));
-    enable_rx(pipe);
-    return;
-}
-
-static void send_buffer_via_fifo(VBUF *buf)
-{
-#if ENABLE_SW_SWAP_DATA_MODE
-    VDESC *currVdesc;
-    struct zsDmaDesc* usbDesc;
-    
-    //A_PRINTF("send_buffer_via_fifo buf len %d\n", buf->buf_length);
-    currVdesc = (VDESC *)buf->desc_list;
-    usbDesc = (struct zsDmaDesc *)currVdesc->hw_desc_buf;    
-    usbDesc->dataSize = currVdesc->data_size;
-    usbDesc->dataAddr = (volatile u32_t)(currVdesc->buf_addr + currVdesc->data_offset);
-            
-    DMA_Engine_swap_data(usbDesc);
-#endif
-    
-    if ( g_hifUSBCtx.eventBufQ.head == NULL ) {
-        g_hifUSBCtx.eventBufQ.head = buf;
-        g_hifUSBCtx.eventBufQ.tail = buf;
-    } else {
-        g_hifUSBCtx.eventBufQ.tail->next_buf = buf;
-        g_hifUSBCtx.eventBufQ.tail = buf;
-    }
-    
-    USBFIFO_enable_event_isr();
-}
-
-int _HIFusb_send_buffer(hif_handle_t handle, int pipe, VBUF *buf)
-{ 
-    if ( pipe == HIF_USB_PIPE_INTERRUPT ) {
-        send_buffer_via_fifo(buf);     
-    } else {
-        DMA_Engine_xmit_buf(&g_hifUSBCtx.upQ, buf);
-#ifdef OTUS_USB                  
-        ZM_PTA_UP_DMA_TRIGGER_REG = 1;
-#else
-        MAGPIE_REG_USB_TX0_DMA_START = 1;
-#endif          
-    }
-
-    return 0;
-}
-
-
-void _HIFusb_return_recv_buf(hif_handle_t handle, int pipe, VBUF *buf)
-{    
-    struct zsDmaQueue *q;
-    
-    if ( pipe == HIF_USB_PIPE_COMMAND ) {
-        if ( g_hifUSBCtx.cmdQueue == NULL ) {
-            g_hifUSBCtx.cmdQueue = buf;
-        } else {
-            buf->next_buf = g_hifUSBCtx.cmdQueue;
-            g_hifUSBCtx.cmdQueue = buf;
-        }        
-    } else {
-        q = get_queue_from_pipe(pipe);
-        DMA_Engine_return_recv_buf(q, buf);   
-        enable_rx(pipe);              
-    }
-}
-                           
-void _HIFusb_set_recv_bufsz(hif_handle_t handle, int pipe, int bufsz)
-{
-    (void)pipe;
-    (void)bufsz;    
-}
-
-void _HIFusb_pause_recv(hif_handle_t handle, int pipe)
-{
-    (void)pipe;
-}
-
-void _HIFusb_resume_recv(hif_handle_t handle, int pipe)
-{
-    (void)pipe;
-}
-
-int  _HIFusb_is_pipe_supported(hif_handle_t handle, int pipe)
-{
-    if ( pipe < HIF_USB_PIPE_TX || pipe > HIF_USB_PIPE_MP_TX ) {
-        return 0;
-    } else {    
-        return 1;
-    }
-}
-    
-int _HIFusb_get_max_msg_len(hif_handle_t handle, int pipe)
-{
-    switch(pipe) {
-        case HIF_USB_PIPE_INTERRUPT:
-        case HIF_USB_PIPE_COMMAND:
-            return 64;
-            
-        default:
-            return 1600;
-    }
-}
-    
-static void handle_tx_complete_isr()
-{
-    VBUF *buf;
-    
-    //A_PRINTF("USB Tx complete\n\r");                           
-    #if ZM_FM_LOOPBACK == 1
-    VDESC *vdesc;
-    struct zsDmaDesc* desc;
-        
-    desc = DMA_Engine_get_packet(&g_hifUSBCtx.upQ);
-    vdesc = VDESC_HW_TO_VDESC(desc);
-    
-    if ( vdesc->control == HIF_USB_PIPE_TX ) {
-        DMA_Engine_reclaim_packet(&g_hifUSBCtx.dnQ, desc);
-    }
-    #if SYSTEM_MODULE_HP_EP5  
-    else if ( vdesc->control == HIF_USB_PIPE_HP_TX ) {
-        DMA_Engine_reclaim_packet(&g_hifUSBCtx.hpdnQ, desc);
-    }
-    #endif
-    #if SYSTEM_MODULE_HP_EP6
-    else if ( vdesc->control == HIF_USB_PIPE_MP_TX ) {
-        DMA_Engine_reclaim_packet(&g_hifUSBCtx.mpdnQ, desc);
-    }    
-    #endif
-    
-    #ifdef OTUS_USB            
-    ZM_PTA_DN_DMA_TRIGGER_REG = 1;
-    #else
-    MAGPIE_REG_USB_RX0_DMA_START = 1;
-    #endif            
-    
-    #else                              
-       buf = DMA_Engine_reap_xmited_buf(&g_hifUSBCtx.upQ);
-       g_hifUSBCtx.hifCb.send_buf_done(buf, g_hifUSBCtx.hifCb.context);
-    #endif /* ZM_FM_LOOPBACK == 1 */    
-}
-    
-static void handle_rx_complete_isr()
-{
-    VBUF *buf;
-    
-    #if ZM_FM_LOOPBACK == 1
-    VDESC *vdesc;
-    struct zsDmaDesc* desc;
-               
-    //A_PRINTF("USB Rx complete\n\r");    
-    desc = DMA_Engine_get_packet(&g_hifUSBCtx.dnQ);
-    vdesc = VDESC_HW_TO_VDESC(desc);
-    vdesc->control = HIF_USB_PIPE_TX;
-    
-    DMA_Engine_put_packet(&g_hifUSBCtx.upQ, desc);
-            
-    #ifdef OTUS_USB 
-    ZM_PTA_UP_DMA_TRIGGER_REG = 1;
-    #else
-    MAGPIE_REG_USB_TX0_DMA_START = 1;
-    #endif
-            
-    #else
-    buf = DMA_Engine_reap_recv_buf(&g_hifUSBCtx.dnQ);
-    g_hifUSBCtx.hifCb.recv_buf(NULL, buf, g_hifUSBCtx.hifCb.context);
-    #endif    
-}
-    
-#if SYSTEM_MODULE_HP_EP5    
-static void handle_hp_rx_complete_isr()
-{
-    VBUF *buf;
-    
-    #if ZM_FM_LOOPBACK == 1
-    VDESC *vdesc;
-    struct zsDmaDesc* desc;    
-               
-    desc = DMA_Engine_get_packet(&g_hifUSBCtx.hpdnQ);
-    vdesc = VDESC_HW_TO_VDESC(desc);
-    vdesc->control = HIF_USB_PIPE_HP_TX;
-        
-    DMA_Engine_put_packet(&g_hifUSBCtx.upQ, desc);
-    MAGPIE_REG_USB_TX0_DMA_START = 1;
-
-    #else
-    buf = DMA_Engine_reap_recv_buf(&g_hifUSBCtx.hpdnQ);
-    g_hifUSBCtx.hifCb.recv_buf(NULL, buf, g_hifUSBCtx.hifCb.context);
-    #endif
-}
-#endif
-
-#if SYSTEM_MODULE_HP_EP6
-static void handle_mp_rx_complete_isr()
-{
-    VBUF *buf;
-        
-    #if ZM_FM_LOOPBACK == 1
-    VDESC *vdesc;
-    struct zsDmaDesc* desc;
-               
-    desc = DMA_Engine_get_packet(&g_hifUSBCtx.mpdnQ);
-    vdesc = VDESC_HW_TO_VDESC(desc);
-    vdesc->control = HIF_USB_PIPE_MP_TX;
-        
-    DMA_Engine_put_packet(&g_hifUSBCtx.upQ, desc);
-    MAGPIE_REG_USB_TX0_DMA_START = 1;
-
-    #else
-    buf = DMA_Engine_reap_recv_buf(&g_hifUSBCtx.mpdnQ);
-    g_hifUSBCtx.hifCb.recv_buf(NULL, buf, g_hifUSBCtx.hifCb.context);
-    #endif
-}
-#endif
-    
-void _HIFusb_isr_handler(hif_handle_t h)
-{
-    //struct zsDmaDesc* desc;
-    u32_t intr;
-
-#ifdef OTUS_USB      
-    intr = ZM_PTA_INT_FLAG_REG;
-#else
-    intr = MAGPIE_REG_USB_INTERRUPT;
-#endif
-    
-#ifdef OTUS_USB     
-    if ((intr & (ZM_PTA_DOWN_INT_BIT|ZM_PTA_UP_INT_BIT))!=0)
-#else
-    if ((intr & (MAGPIE_REG_USB_INTERRUPT_TX0_COMPL|MAGPIE_REG_USB_INTERRUPT_RX0_COMPL| 
-        MAGPIE_REG_USB_INTERRUPT_RX1_COMPL|MAGPIE_REG_USB_INTERRUPT_RX2_COMPL)) != 0)
-#endif        
-    {       
-#if SYSTEM_MODULE_HP_EP5
-        do
-        {
-            if ( DMA_Engine_has_compl_packets(&g_hifUSBCtx.hpdnQ) )                  
-            {
-                handle_hp_rx_complete_isr();
-            }       
-            else
-            {
-                break;
-            }
-        }
-        while(1);
-#endif // endif SYSTEM_MODULE_HP_EP5               
-         
-#if SYSTEM_MODULE_HP_EP6
-        do
-        {
-            if ( DMA_Engine_has_compl_packets(&g_hifUSBCtx.mpdnQ) )                
-            {
-                handle_mp_rx_complete_isr();
-            }
-            else
-            {
-                break;
-            }           
-        }
-        while(1);
-#endif // endif SYSTEM_MODULE_HP_EP5  
-                 
-        do
-        {
-            int check = 0;
-            
-            /* zgUpQ own bits changed */
-            if ( DMA_Engine_has_compl_packets((struct zsDmaQueue *)&g_hifUSBCtx.upQ) )           
-            {
-                handle_tx_complete_isr();                       
-                check = 1;
-            }/* end of while */
-                
-            /* zgDnQ own bits changed */
-            if ( DMA_Engine_has_compl_packets(&g_hifUSBCtx.dnQ) )                          
-            {
-                handle_rx_complete_isr();
-                check = 1;
-            }       
-            
-            if ( check == 0 )
-            {
-                break;
-            }
-        }       
-        while(1);               
-    }        
-}
-
-void _HIFusb_get_default_pipe(hif_handle_t handle, A_UINT8 *pipe_uplink, A_UINT8 *pipe_downlink)
-{
-    *pipe_uplink = HIF_USB_PIPE_COMMAND;            // Host   -> Target
-    *pipe_downlink = HIF_USB_PIPE_INTERRUPT;        // Target -> Host
-}
-    
-/* the exported entry point into this module. All apis are accessed through
- * function pointers */
-void hif_usb_module_install(struct hif_api *apis)
-{    
-        /* hook in APIs */
-    apis->_init = _HIFusb_init;
-    apis->_start = _HIFusb_start;
-    apis->_config_pipe = _HIFusb_config_pipe;
-    apis->_isr_handler = _HIFusb_isr_handler;
-    apis->_send_buffer = _HIFusb_send_buffer;
-    apis->_return_recv_buf = _HIFusb_return_recv_buf;
-    apis->_is_pipe_supported = _HIFusb_is_pipe_supported;
-    apis->_get_max_msg_len = _HIFusb_get_max_msg_len;
-    apis->_register_callback = _HIFusb_register_callback;
-    apis->_shutdown = _HIFusb_shutdown;
-    apis->_get_reserved_headroom = _HIFusb_get_reserved_headroom;
-    apis->_get_default_pipe = _HIFusb_get_default_pipe;
-        
-        /* save ptr to the ptr to the context for external code to inspect/modify internal module state */
-    //apis->pReserved = &g_pMboxHWContext;
-}
-
-void HIFusb_DescTraceDump(void )
-{    
-#if SYSTEM_MODULE_HP_EP5
-    A_PRINTF("\n\r[hp dnQ] 0x%08x, ", (u32_t)g_hifUSBCtx.hpdnQ.head);
-    A_PRINTF("DMA TRACE 0x%08x\n\r    [", HAL_WORD_REG_READ(MAGPIE_REG_USB_RX1_CUR_TRACE_ADDR));
-
-    DMA_Engine_desc_dump(&g_hifUSBCtx.hpdnQ);
-#endif
-
-#if SYSTEM_MODULE_HP_EP6
-    A_PRINTF("\n\r[mp dnQ] 0x%08x, ", (u32_t)g_hifUSBCtx.mpdnQ.head);
-    A_PRINTF("DMA TRACE 0x%08x\n\r    [", HAL_WORD_REG_READ(MAGPIE_REG_USB_RX2_CUR_TRACE_ADDR));
-
-    DMA_Engine_desc_dump(&g_hifUSBCtx.mpdnQ);
-#endif
-
-    A_PRINTF("\n\r[dnQ] 0x%08x, ", (u32_t)g_hifUSBCtx.dnQ.head);
-    A_PRINTF("DMA TRACE 0x%08x\n\r    [", HAL_WORD_REG_READ(MAGPIE_REG_USB_RX0_CUR_TRACE_ADDR));
-    DMA_Engine_desc_dump(&g_hifUSBCtx.dnQ);
-
-    A_PRINTF("\n\n\r[upQ] 0x%08x, ", (u32_t)g_hifUSBCtx.upQ.head);
-    A_PRINTF("DMA TRACE 0x%08x\n\r    [", HAL_WORD_REG_READ(MAGPIE_REG_USB_TX0_CUR_TRACE_ADDR));
-    DMA_Engine_desc_dump((struct zsDmaQueue *)&g_hifUSBCtx.upQ);
-}
-
-