I2SCC32XXDMA.h

Go to the documentation of this file.

/*
 * Copyright (c) 2015-2018, Texas Instruments Incorporated
 * All rights reserved.
 *
 * 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 ti_drivers_i2s_I2SCC32XXDMA__include
#define ti_drivers_i2s_I2SCC32XXDMA__include

#ifdef __cplusplus
extern "C" {
#endif

#include <stdint.h>
#include <stdbool.h>
#include <ti/drivers/I2S.h>
#include <ti/drivers/dpl/HwiP.h>
#include <ti/drivers/dpl/SemaphoreP.h>
#include <ti/drivers/utils/List.h>
#include <ti/drivers/dma/UDMACC32XX.h>

/*
 *  Macros defining possible I2S signal pin mux options
 *
 *  The bits in the pin mode macros are as follows:
 *  The lower 8 bits of the macro refer to the pin, offset by 1, to match
 *  driverlib pin defines.  For example, I2SCC32XXDMA_PIN_02_McAFSX & 0xff = 1,
 *  which equals PIN_02 in driverlib pin.h.  By matching the PIN_xx defines in
 *  driverlib pin.h, we can pass the pin directly to the driverlib functions.
 *  The upper 8 bits of the macro correspond to the pin mux confg mode
 *  value for the pin to operate in the I2S mode.  For example, pin 2 is
 *  configured with mode 13 to operate as McAFSX.
 */
#define I2SCC32XXDMA_PIN_02_McAFSX  0x0d01 
#define I2SCC32XXDMA_PIN_03_McACLK  0x0302 
#define I2SCC32XXDMA_PIN_15_McAFSX  0x070e 
#define I2SCC32XXDMA_PIN_17_McAFSX  0x0610 
#define I2SCC32XXDMA_PIN_21_McAFSX  0x0214 
#define I2SCC32XXDMA_PIN_45_McAXR0  0x062c 
#define I2SCC32XXDMA_PIN_45_McAFSX  0x0c2c 
#define I2SCC32XXDMA_PIN_50_McAXR0  0x0431 
#define I2SCC32XXDMA_PIN_50_McAXR1  0x0631 
#define I2SCC32XXDMA_PIN_52_McACLK  0x0233 
#define I2SCC32XXDMA_PIN_52_McAXR0  0x0433 
#define I2SCC32XXDMA_PIN_53_McACLK  0x0234 
#define I2SCC32XXDMA_PIN_53_McAFSX  0x0334 
#define I2SCC32XXDMA_PIN_60_McAXR1  0x063b 
#define I2SCC32XXDMA_PIN_62_McACLKX 0x0d3d 
#define I2SCC32XXDMA_PIN_63_McAFSX  0x073e 
#define I2SCC32XXDMA_PIN_64_McAXR0  0x073f 
/* Add I2SCC32XXDMA_STATUS_* macros here */

#define I2SCC32XXDMA_CMD_SET_ZEROBUF_LEN      (I2S_CMD_RESERVED + 0)
#define I2SCC32XXDMA_CMD_SET_EMPTYBUF_LEN     (I2S_CMD_RESERVED + 1)

/* BACKWARDS COMPATIBILITY */
#define I2SCC32XXDMA_SET_ZEROBUF_LEN      I2SCC32XXDMA_CMD_SET_ZEROBUF_LEN
#define I2SCC32XXDMA_SET_EMPTYBUF_LEN     I2SCC32XXDMA_CMD_SET_EMPTYBUF_LEN
/* END BACKWARDS COMPATIBILITY */

/* Value for Invalid Index */
#define I2SCC32XXDMA_INDEX_INVALID      0xFF

/*Number of Serial data pins supported*/
#define I2SCC32XXDMA_NUM_SERIAL_PINS    2

typedef enum I2SCC32XXDMA_DataSize {
    I2SCC32XXDMA_16bit = 0,
    I2SCC32XXDMA_32bit = 1
} I2SCC32XXDMA_DataSize;


/* I2S function table pointer */
extern const I2S_FxnTable I2SCC32XXDMA_fxnTable;


typedef struct I2SCC32XXDMA_HWAttrsV1 {
    uint32_t baseAddr;
    uint32_t intNum;
    uint32_t intPriority;
    unsigned long rxChannelIndex;
    unsigned long txChannelIndex;
    uint16_t xr0Pin;
    uint16_t xr1Pin;
    uint16_t clkxPin;
    uint16_t clkPin;
    uint16_t fsxPin;
} I2SCC32XXDMA_HWAttrsV1;

typedef struct I2SCC32XXDMA_SerialPinConfig {
    unsigned char         pinNumber;

    I2S_PinMode           pinMode;

    I2S_SerInActiveConfig inActiveConfig;

} I2SCC32XXDMA_SerialPinConfig;

typedef struct I2SCC32XXDMA_SerialPinParams {

    I2SCC32XXDMA_SerialPinConfig serialPinConfig[I2SCC32XXDMA_NUM_SERIAL_PINS];

} I2SCC32XXDMA_SerialPinParams;

typedef struct I2SCC32XXDMA_SerialPinVars {
    I2S_DataMode        readWriteMode;
    /* Pointer to read/write callback */
    I2S_Callback        readWriteCallback;
    /* Timeout for read/write semaphore */
    uint32_t            readWriteTimeout;

}I2SCC32XXDMA_SerialPinVars;

typedef struct I2SCC32XXDMA_Object {
    /* I2S control variables */
    bool                   opened;              /* Has the obj been opened */
    uint32_t               operationMode;       /* Mode of operation of I2S */

    /* I2S serial pin variables */
    I2SCC32XXDMA_SerialPinVars serialPinVars[I2SCC32XXDMA_NUM_SERIAL_PINS];

    uint16_t               readIndex;           /* read channel Index */
    uint16_t               writeIndex;          /* write channel Index */

    I2SCC32XXDMA_DataSize  dmaSize;             /* Config DMA word size  */

    /* I2S OSAL objects */
    SemaphoreP_Handle      writeSem;            /* I2S write semaphore*/
    SemaphoreP_Handle      readSem;             /* I2S read semaphore */
    HwiP_Handle            hwiHandle;

    /* Length of zero buffer to write in case of no data */
    unsigned long          zeroWriteBufLength;

    /* Length of empty buffer to read in case of no data
       requested */
    unsigned long          emptyReadBufLength;

    /* Current Write buffer descriptor pointer */
    I2S_BufDesc            *currentWriteBufDesc;

    /* Previous Write Buffer descriptor pointer */
    I2S_BufDesc            *prevWriteBufDesc;

    /* Current Read buffer descriptor pointer */
    I2S_BufDesc            *currentReadBufDesc;

    /* Previous Read Buffer descriptor pointer */
    I2S_BufDesc            *prevReadBufDesc;

    /* UDMA */
    UDMACC32XX_Handle    dmaHandle;

    /* Lists for issue-reclaim mode */
    List_List             readActiveQueue;
    List_List             readDoneQueue;
    List_List             writeActiveQueue;
    List_List             writeDoneQueue;
} I2SCC32XXDMA_Object, *I2SCC32XXDMA_Handle;

extern void I2SCC32XXDMA_Params_init(I2SCC32XXDMA_SerialPinParams *params);

#ifdef __cplusplus
}
#endif

#endif /* ti_drivers_i2s_I2SCC32XXDMA__include */