360 lines
12 KiB
C
360 lines
12 KiB
C
//#############################################################################
|
|
// FILE: usbdma.c
|
|
// TITLE: USB Library DMA handling functions.
|
|
//#############################################################################
|
|
// $TI Release: $
|
|
// $Release Date: $
|
|
// $Copyright:
|
|
// Copyright (C) 2009-2023 Texas Instruments Incorporated - http://www.ti.com/
|
|
//
|
|
// Redistribution and use in source and binary forms, with or without
|
|
// modification, are permitted 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 Texas Instruments Incorporated nor the names of
|
|
// its contributors may be used to endorse or promote products derived
|
|
// from this software without specific prior written permission.
|
|
//
|
|
// 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.
|
|
// $
|
|
//#############################################################################
|
|
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include "inc/hw_memmap.h"
|
|
#include "inc/hw_types.h"
|
|
#include "inc/hw_ints.h"
|
|
#include "driverlib/debug.h"
|
|
#include "driverlib/interrupt.h"
|
|
#include "driverlib/rtos_bindings.h"
|
|
#include "driverlib/usb.h"
|
|
#include "driverlib/rom.h"
|
|
#include "driverlib/rom_map.h"
|
|
#include "include/usblib.h"
|
|
#include "include/usblibpriv.h"
|
|
|
|
//*****************************************************************************
|
|
//
|
|
//! \addtogroup usblib_dma_api Internal USB DMA functions
|
|
//! @{
|
|
//
|
|
//*****************************************************************************
|
|
|
|
static tUSBDMAInstance g_psUSBDMAInst[1];
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Macros used to determine if a uDMA endpoint configuration is used for
|
|
// receive or transmit.
|
|
//
|
|
//*****************************************************************************
|
|
#define UDMAConfigIsRx(ui32Config) \
|
|
((ui32Config & UDMA_SRC_INC_NONE) == UDMA_SRC_INC_NONE)
|
|
#define UDMAConfigIsTx(ui32Config) \
|
|
((ui32Config & UDMA_DEST_INC_NONE) == UDMA_DEST_INC_NONE)
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMAChannelStatus() for USB controllers that use the uDMA for DMA.
|
|
//
|
|
//*****************************************************************************
|
|
static uint32_t
|
|
uDMAUSBChannelStatus(tUSBDMAInstance *psUSBDMAInst, uint32_t ui32Channel)
|
|
{
|
|
uint32_t ui32Status;
|
|
|
|
//
|
|
// Initialize the current status to no events.
|
|
//
|
|
ui32Status = USBLIBSTATUS_DMA_IDLE;
|
|
|
|
|
|
return(ui32Status);
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMAIntStatus() for USB controllers that use uDMA.
|
|
//
|
|
//*****************************************************************************
|
|
static uint32_t
|
|
uDMAUSBIntStatus(tUSBDMAInstance *psUSBDMAInst)
|
|
{
|
|
|
|
return(0);
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMAIntStatusClear() for USB controllers that use uDMA for DMA.
|
|
//
|
|
//*****************************************************************************
|
|
static void
|
|
DMAUSBIntStatusClear(tUSBDMAInstance *psUSBDMAInst, uint32_t ui32Status)
|
|
{
|
|
//
|
|
// Clear out the requested interrupts. Since the USB interface does not
|
|
// have a true interrupt clear, this clears the current completed
|
|
// status for the requested channels.
|
|
//
|
|
psUSBDMAInst->ui32Complete &= ~ui32Status;
|
|
|
|
return;
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMAIntHandler() for USB controllers that use uDMA for DMA.
|
|
//
|
|
//*****************************************************************************
|
|
static void
|
|
DMAUSBIntHandler(tUSBDMAInstance *psUSBDMAInst, uint32_t ui32DMAIntStatus)
|
|
{
|
|
uint32_t ui32Channel;
|
|
|
|
if(ui32DMAIntStatus == 0)
|
|
{
|
|
return;
|
|
}
|
|
|
|
//
|
|
// Determine if the uDMA is used or the USB DMA controller.
|
|
//
|
|
for(ui32Channel = 0; ui32Channel < USB_MAX_DMA_CHANNELS; ui32Channel++)
|
|
{
|
|
//
|
|
// Mark any pending interrupts as completed.
|
|
//
|
|
if(ui32DMAIntStatus & 1)
|
|
{
|
|
psUSBDMAInst->ui32Pending &= ~((uint32_t)1 << ui32Channel);
|
|
psUSBDMAInst->ui32Complete |= ((uint32_t)1 << ui32Channel);
|
|
}
|
|
|
|
//
|
|
// Check the next channel.
|
|
//
|
|
ui32DMAIntStatus >>= 1;
|
|
|
|
//
|
|
// Break if there are no more pending DMA interrupts.
|
|
//
|
|
if(ui32DMAIntStatus == 0)
|
|
{
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMAChannelEnable() for USB controllers that use uDMA.
|
|
//
|
|
//*****************************************************************************
|
|
static void
|
|
uDMAUSBChannelEnable(tUSBDMAInstance *psUSBDMAInst, uint32_t ui32Channel)
|
|
{
|
|
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMAChannelDisable() for USB controllers that use uDMA.
|
|
//
|
|
//*****************************************************************************
|
|
static void
|
|
uDMAUSBChannelDisable(tUSBDMAInstance *psUSBDMAInst, uint32_t ui32Channel)
|
|
{
|
|
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMAChannelIntEnable() for USB controllers that use uDMA.
|
|
//
|
|
//*****************************************************************************
|
|
static void
|
|
uDMAUSBChannelIntEnable(tUSBDMAInstance *psUSBDMAInst, uint32_t ui32Channel)
|
|
{
|
|
//
|
|
// There is no way to Enable channel interrupts when using uDMA.
|
|
//
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMAChannelIntDisable() for USB controllers that use uDMA.
|
|
//
|
|
//*****************************************************************************
|
|
static void
|
|
uDMAUSBChannelIntDisable(tUSBDMAInstance *psUSBDMAInst, uint32_t ui32Channel)
|
|
{
|
|
//
|
|
// There is no way to Disable channel interrupts when using uDMA.
|
|
//
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMATransfer() for USB controllers that use the uDMA controller.
|
|
//
|
|
//*****************************************************************************
|
|
static uint32_t
|
|
uDMAUSBTransfer(tUSBDMAInstance *psUSBDMAInst, uint32_t ui32Channel,
|
|
void *pvBuffer, uint32_t ui32Size)
|
|
{
|
|
|
|
return(0);
|
|
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMAChannelAllocate() for USB controllers that use uDMA for DMA.
|
|
//
|
|
//*****************************************************************************
|
|
static uint32_t
|
|
uDMAUSBChannelAllocate(tUSBDMAInstance *psUSBDMAInst, uint8_t ui8Endpoint,
|
|
uint32_t ui32MaxPacketSize, uint32_t ui32Config)
|
|
{
|
|
|
|
return(0);
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMAChannelRelease() for USB controllers that use uDMA for DMA.
|
|
//
|
|
//*****************************************************************************
|
|
static void
|
|
uDMAUSBChannelRelease(tUSBDMAInstance *psUSBDMAInst, uint8_t ui32Channel)
|
|
{
|
|
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMAUnitSizeSet() for USB controllers that use uDMA for DMA.
|
|
//
|
|
//*****************************************************************************
|
|
static void
|
|
uDMAUSBUnitSizeSet(tUSBDMAInstance *psUSBDMAInst, uint32_t ui32Channel,
|
|
uint32_t ui32BitSize)
|
|
{
|
|
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMAArbSizeSet() for USB controllers that use uDMA for DMA.
|
|
//
|
|
//*****************************************************************************
|
|
static void
|
|
uDMAUSBArbSizeSet(tUSBDMAInstance *psUSBDMAInst, uint32_t ui32Channel,
|
|
uint32_t ui32ArbSize)
|
|
{
|
|
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// USBLibDMAStatus() for USB controllers that use uDMA for DMA.
|
|
//
|
|
//*****************************************************************************
|
|
static uint32_t
|
|
DMAUSBStatus(tUSBDMAInstance *psUSBDMAInst)
|
|
{
|
|
return(0);
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
//! This function is used to initialize the DMA interface for a USB instance.
|
|
//!
|
|
//! \param ui32Index is the index of the USB controller for this instance.
|
|
//!
|
|
//! This function performs any initialization and configuration of the DMA
|
|
//! portions of the USB controller. This function returns a pointer that
|
|
//! is used with the remaining USBLibDMA APIs or the function returns zero
|
|
//! if the requested controller cannot support DMA. If this function is called
|
|
//! when already initialized it will not reinitialize the DMA controller and
|
|
//! will instead return the previously initialized DMA instance.
|
|
//!
|
|
//! \return A pointer to use with USBLibDMA APIs.
|
|
//
|
|
//*****************************************************************************
|
|
tUSBDMAInstance *
|
|
USBLibDMAInit(uint32_t ui32Index)
|
|
{
|
|
uint32_t ui32Channel;
|
|
|
|
ASSERT(ui32Index == 0);
|
|
|
|
|
|
//
|
|
// Save the base address of the USB controller.
|
|
//
|
|
g_psUSBDMAInst[0].ui32Base = USB0_BASE;
|
|
|
|
//
|
|
// Save the interrupt number for the USB controller.
|
|
//
|
|
g_psUSBDMAInst[0].ui32IntNum = INT_USB0;
|
|
|
|
//
|
|
// Initialize the function pointers.
|
|
//
|
|
g_psUSBDMAInst[0].pfnArbSizeSet = uDMAUSBArbSizeSet;
|
|
g_psUSBDMAInst[0].pfnChannelAllocate = uDMAUSBChannelAllocate;
|
|
g_psUSBDMAInst[0].pfnChannelDisable = uDMAUSBChannelDisable;
|
|
g_psUSBDMAInst[0].pfnChannelEnable = uDMAUSBChannelEnable;
|
|
g_psUSBDMAInst[0].pfnChannelIntEnable = uDMAUSBChannelIntEnable;
|
|
g_psUSBDMAInst[0].pfnChannelIntDisable = uDMAUSBChannelIntDisable;
|
|
g_psUSBDMAInst[0].pfnChannelRelease = uDMAUSBChannelRelease;
|
|
g_psUSBDMAInst[0].pfnChannelStatus = uDMAUSBChannelStatus;
|
|
g_psUSBDMAInst[0].pfnIntHandler = DMAUSBIntHandler;
|
|
g_psUSBDMAInst[0].pfnIntStatus = uDMAUSBIntStatus;
|
|
g_psUSBDMAInst[0].pfnIntStatusClear = DMAUSBIntStatusClear;
|
|
g_psUSBDMAInst[0].pfnStatus = DMAUSBStatus;
|
|
g_psUSBDMAInst[0].pfnTransfer = uDMAUSBTransfer;
|
|
g_psUSBDMAInst[0].pfnUnitSizeSet = uDMAUSBUnitSizeSet;
|
|
|
|
//
|
|
// Clear out the endpoint and the current configuration.
|
|
//
|
|
for(ui32Channel = 0; ui32Channel < USB_MAX_DMA_CHANNELS; ui32Channel++)
|
|
{
|
|
g_psUSBDMAInst[0].pui8Endpoint[ui32Channel] = 0;
|
|
g_psUSBDMAInst[0].pui32Config[ui32Channel] = 0;
|
|
g_psUSBDMAInst[0].ui32Pending = 0;
|
|
g_psUSBDMAInst[0].ui32Complete = 0;
|
|
}
|
|
return(&g_psUSBDMAInst[0]);
|
|
}
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Close the Doxygen group.
|
|
//! @}
|
|
//
|
|
//*****************************************************************************
|