NIM_DSP6748/extern/include/cppi41dma.h

/**
 *  \file   cppi41dma.h
 *
 *  \brief  CPPI 4.1 DMA related function prototypes
 *
 *  This file contains the API prototypes for CPPI 4.1 DMA
*/

/*
* Copyright (C) 2010 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.
*
*/

#ifndef __CPPI41DMA_H
#define __CPPI41DMA_H

#ifdef __cplusplus
extern "C"
{
#endif

#include "usb.h"
#include "hw_usb.h"

#ifndef NULL
#define NULL ((void *)0)
#endif

#define USB_TX_MODE_SHIFT(n)       (((((n) - 1) << 1) * 2))
#define USB_RX_MODE_SHIFT(n)       ((((((n) - 1) << 1) * 2) + 16))

#if defined (am335x_15x15) || defined(am335x) || defined(c6a811x)
#define USB_OTGBASE USBSS_BASE

//Interrupt status macros
#define CPDMA_TX_PENDING 0x60000000
#define CPDMA_RX_PENDING 0x00006000

#define NUMOF_USB_INSTANCE                    2
#else
#define USB_OTGBASE USB_0_OTGBASE

//Interrupt status macros
#define CPDMA_TX_PENDING 0x03000000
#define CPDMA_RX_PENDING 0x0C000000

#define NUMOF_USB_INSTANCE                    USB_CONTROLLER_NUM_INSTANCES
#endif

#define CPDMA_STAR_0_PEND    0x1
#define CPDMA_STAR_1_PEND    0x2

//Link RAM size
#define LINK_RAM_SIZE                        1024
#define DESC_REGION_SIZE                    (1024 * 20) + SOC_CACHELINE_SIZE_MAX

// Maximum packet length for GRNDS mode
#define GRNDIS_MAX_PACKET_LENGTH            512 * 8

#define  CPDMA_NUMOF_BUFFERS                512

#ifdef USB_MODE_FULLSPEED
    #define USB_PACKET_LENGTH                64
#else
    #define USB_PACKET_LENGTH                512
#endif /* USB_MODE_FULLSPEED */

#define QUEUE_MGR_DESCSIZE                  0x100
#define QUEUE_MGR_REGSIZE                   0x3

//Maximum number of data endpoints in one USB Intance
#define MAX_NUM_EP                           15

#define MAX_BD_NUM                           512
#define NUM_OF_RX_BDs                        20

#define BYTE_ALIGNMENT                      SOC_CACHELINE_SIZE_MAX

#define SCHEDULER_ENABLE_SHFT               31
#define CLAER_INTDO_STATUS                  0x03

#define SIZE_OF_SINGLE_BD                   0X0A

#define    CPDMA_BUFFER_NOT_USED            0
#define CPDMA_BUFFER_USED                   1

#define CPDMA_BD_PACKET_TYPE                16

#define SOP                                 1
#define MOP                                 2
#define EOP                                 4

#define DMA_TX_IN_PROGRESS                  1
#define DMA_TX_COMPLETED                    0

#if defined (am335x_15x15) || defined(am335x) || defined(c6a811x)
//DMA registers
#define CPDMA_TX_CHANNEL_CONFIG_REG         0x2800 
#define CPDMA_RX_CHANNEL_CONFIG_REG         0x2808 
#define CPDMA_RX_CHANNEL_REG_A              0x280C
#define CPDMA_RX_CHANNEL_REG_B              0x2810
#define CPDMA_SCHED_CONTROL_REG             0x3000
#define CPDMA_SCHED_TABLE_0                 0x3800
#define CPDMA_SCHED_TABLE_1                 0x3804
#define CPDMA_SCHED_TABLE_2                 0x3808
#define CPDMA_SCHED_TABLE_3                 0x380C

#define NUM_OF_SCHEDULER_ENTRIES            16
#else
//DMA registers
#define CPDMA_TX_CHANNEL_CONFIG_REG         0x1800 
#define CPDMA_RX_CHANNEL_CONFIG_REG         0x1808 
#define CPDMA_RX_CHANNEL_REG_A              0x180C
#define CPDMA_RX_CHANNEL_REG_B              0x1810
#define CPDMA_SCHED_CONTROL_REG             0x2000
#define CPDMA_SCHED_TABLE_0                 0x2800
#define CPDMA_SCHED_TABLE_1                 0x2804
#define NUM_OF_SCHEDULER_ENTRIES            8
#endif

#define CPDMA_INTD_0_REGISTER                0x3200
#define CPDMA_CLEAR_INTD_0_STATUS            0x3280
#define    CPDMA_LRAM_0_BASE                 0x4080
#define    CPDMA_LRAM_0_SIZE                 0x4084
#define    CPDMA_LRAM_1_BASE                 0x4088
#define CPDMA_PEND_0_REGISTER                0x4090
#define CPDMA_PEND_1_REGISTER                0x4094
#define CPDMA_PEND_2_REGISTER                0x4098
#define CPDMA_PEND_3_REGISTER                0x409C
#define CPDMA_PEND_4_REGISTER                0x40A0
#define CPDMA_QUEUEMGR_REGION_0              0x5000
#define CPDMA_QUEUEMGR_REGION_0_CONTROL      0x5004

#define CPDMA_QUEUE_REGISTER_D               0x600C


//Bit Fields for Channel Config
#define SCHEDULE_RX_CHANNEL                 0x83828180
#define SCHEDULE_TX_CHANNEL                 0x03020100

#define SCHEDULE_RX1_CHANNEL                0x9291908F
#define SCHEDULE_TX1_CHANNEL                0x1211100F

#define CPDMA_RX_CHANNEL_ENABLE             0x81004000
#define CPDMA_TX_CHANNEL_ENABLE             0x80000000

//Clear Auto set for TX endpoint
#define CPDMA_TX_CLR_AUTO_SET               0x7FFF

// Set DMAReqEnab & DMAReqMode for TX
#define CPDMA_TX_SET_REQ_ENABLE             0x1400

// Clear AUTOCLEAR and DMAReqMode
#define CPDMA_RX_CLR_AUTO_CLEAR             0x77FF

// Set DMAReqEnab
#define CPDMA_RX_SET_REQ_ENABLE             0x2000
// Clear DMAReqEnab & DMAReqMode
#define CPDMA_RX_CLR_REQ_ENABLE             0xDFFF

// Clear DMAReqEnab & DMAReqMode
#define CPDMA_TX_CLR_REQ_ENABLE             0xEBFF

// Bit fields  for Schduler controll reg
#define ENABLE_CPPIDMA                      0x1
#define DISABLE_CPPIDMA                     0x0

//DMA directions
#define CPDMA_DIR_RX                        0x1
#define CPDMA_DIR_TX                        0x0

//Bit Fields to set the DMA Mode
#define CPDMA_MODE_ENABLE_GLOBAL_RNDIS       0x00000010

//DMA mode
#define CPDMA_MODE_SET_TRANSPARENT            0x0
#define CPDMA_MODE_SET_RNDIS                0x1
#define CPDMA_MODE_SET_LINUXCDC                0x2
#define CPDMA_MODE_SET_GRNDIS                0x3

#if defined (am335x_15x15) || defined(am335x) || defined(c6a811x)
#define NUM_TX_SUBMITQ                      60
#define NUM_TX_COMPQ                        30
#define NUM_RX_COMPQ                        30

//TX submit q
#define    TX_SUBMITQ1                      32
#define TX_SUBMITQ2                         33
#define TX_SUBMITQ3                         34
#define TX_SUBMITQ4                         35
#define TX_SUBMITQ5                         36
#define TX_SUBMITQ6                         37
#define TX_SUBMITQ7                         38
#define TX_SUBMITQ8                         39
#define TX_SUBMITQ9                         40
#define TX_SUBMITQ10                        41
#define TX_SUBMITQ11                        42
#define TX_SUBMITQ12                        43
#define TX_SUBMITQ13                        44
#define TX_SUBMITQ14                        45
#define TX_SUBMITQ15                        46
#define TX_SUBMITQ16                        47
#define TX_SUBMITQ17                        48
#define TX_SUBMITQ18                        49
#define TX_SUBMITQ19                        50
#define TX_SUBMITQ20                        51
#define    TX_SUBMITQ21                     52
#define TX_SUBMITQ22                        53
#define TX_SUBMITQ23                        54
#define TX_SUBMITQ24                        55
#define TX_SUBMITQ25                        56
#define TX_SUBMITQ26                        57
#define TX_SUBMITQ27                        58
#define TX_SUBMITQ28                        59
#define TX_SUBMITQ29                        60
#define TX_SUBMITQ30                        61

//TX Completion queue
#define TX_COMPQ1                           93
#define TX_COMPQ2                           94
#define TX_COMPQ3                           95
#define TX_COMPQ4                           96
#define TX_COMPQ5                           97
#define TX_COMPQ6                           98
#define TX_COMPQ7                           99
#define TX_COMPQ8                           100
#define TX_COMPQ9                           101
#define TX_COMPQ10                          102
#define TX_COMPQ11                          103
#define TX_COMPQ12                          104
#define TX_COMPQ13                          105
#define TX_COMPQ14                          106
#define TX_COMPQ15                          107

#define TX_COMPQ16                          125

//RX Completion queue
#define RX_COMPQ1                           109
#define RX_COMPQ2                           110
#define RX_COMPQ3                           111
#define RX_COMPQ4                           112
#define RX_COMPQ5                           113
#define RX_COMPQ6                           114
#define RX_COMPQ7                           115
#define RX_COMPQ8                           116
#define RX_COMPQ9                           117
#define RX_COMPQ10                          118
#define RX_COMPQ11                          119
#define RX_COMPQ12                          120
#define RX_COMPQ13                          121
#define RX_COMPQ14                          122
#define RX_COMPQ15                          123

#define RX_COMPQ16                          141

#else
#define NUM_TX_SUBMITQ                      8
#define NUM_TX_COMPQ                        4
#define NUM_RX_COMPQ                        4

//TX submit q
#define    TX_SUBMITQ1                      16
#define TX_SUBMITQ2                         17
#define TX_SUBMITQ3                         18
#define TX_SUBMITQ4                         19
#define TX_SUBMITQ5                         20
#define TX_SUBMITQ6                         21
#define TX_SUBMITQ7                         22
#define TX_SUBMITQ8                         23

//TX Completion queue
#define TX_COMPQ1                           24
#define TX_COMPQ2                           25

//RX Completion queue
#define RX_COMPQ1                           26
#define RX_COMPQ2                           27

#endif

//BD-PD structure
typedef struct {
    unsigned int pktLength:22;
    unsigned int protSize:5;
    unsigned int hostPktType:5;     // This should be 16
}hPDWord0;

typedef struct {
    unsigned int dstTag:16;         //bits[15:0] always Zero
    unsigned int srcSubChNum:5;    //bits[20:16] always Zero
    unsigned int srcChNum:6;         //bits[26:21]
    unsigned int srcPrtNum:5;         //bits[31:27]
}hPDWord1;

typedef struct {
    unsigned int pktRetQueue:12;     //bits[11:0]
    unsigned int pktRetQM:2;         //bits[13:12]
    unsigned int onChip:1;         //bit[14]
    unsigned int retPolicy:1;         //bit[15]
    unsigned int protoSpecific:4;    //bits[19:16]
    unsigned int rsv:6;             //bits[25:20]
    unsigned int pktType:5;         //bits[30:26]
    unsigned int pktErr:1;         //bit[31]
}hPDWord2;

typedef struct hostPacketDesc {
    hPDWord0 hPDword0;
    hPDWord1 hPDword1;
    hPDWord2 hPDword2;
    unsigned int buffLength;
    unsigned int buffAdd;
    struct hostPacketDesc *nextHBDptr;
    unsigned int gBuffLength;
    unsigned int gBuffAdd;

    unsigned char packetId;
    unsigned short endPoint;
    unsigned short channel;
    unsigned char devInst;
    void * reqContext;
    unsigned char reserved[18];
    
} hostPacketDesc ;

// End point info structure for the application
typedef struct  
{
     unsigned int endPoint;
     unsigned short direction;
     unsigned short dmaMode;

}endpointInfo;

//End point inf for internal USB configuration.
typedef struct
{
    unsigned int submitq;
    unsigned int complettionq;
    unsigned short channel;
    unsigned short mode;
}configEndPointInfo;

typedef struct
{
unsigned int usbBaseAddress;
unsigned int otgBaseAddress;
configEndPointInfo rxEndPoint[NUM_USB_EP/2];
configEndPointInfo txEndPoint[NUM_USB_EP/2];

}usbInstance;

typedef struct
{
    //TX submit queues
    unsigned int txSubmitq[NUM_TX_SUBMITQ/2][2];

    //TX Completion queues
    unsigned int txCompletionq[NUM_TX_COMPQ];

    //RX Completion queues
    unsigned int rxCompletionq[NUM_RX_COMPQ];

    //Pointers for BD Management
    hostPacketDesc *tail_bd ;
    hostPacketDesc *head_bd;    
    unsigned int *region0DescriptorAddress;
    
    //Array of USB Instances
    usbInstance usbInst[NUMOF_USB_INSTANCE];
}cppi41DmaInfo;


extern endpointInfo epInfo[];

void Cppi41DmaInit(unsigned short usbDevInst, endpointInfo *epInfo, unsigned short numOfEndPoints);

unsigned int dmaTxCompletion(unsigned short usbDevInst, unsigned int ulEndpoint);
unsigned int  dmaRxCompletion(unsigned short usbDevInst, unsigned int ulEndpoint);

void doDmaTxTransfer(unsigned short usbDevInst, unsigned char *buff, 
                                unsigned int length, unsigned int endPoint);

void doDmaRxTransfer(unsigned short usbDevInst, unsigned int length, 
                                unsigned char *buff, unsigned int endPoint);

void enableCoreTxDMA(unsigned short usbDevInst, unsigned int ulEndpoint);
void enableCoreRxDMA(unsigned short usbDevInst, unsigned int ulEndpoint);
void disableCoreRxDMA(unsigned short usbDevIns, unsigned int ulEndpoint);
void disableCoreTxDMA(unsigned short usbDevIns, unsigned int ulEndpoint);

unsigned int CppiDmaGetPendStatus(unsigned short usbDevInst);
unsigned int CppiDmaGetINTD0Status(unsigned short usbDevInst);

unsigned int * cppiDmaAllocBuffer();
void cppiDmaFreeBuffer(unsigned int *dataBuffer);
unsigned int * cppiDmaAllocnBuffer(unsigned int numOfBlocks);
void cppiDmaFreenBuffer(unsigned int *dataBuffer);
void cppiDmaHandleError(unsigned int usbDevInst); 


#ifdef __cplusplus
}
#endif
#endif