![Logo](ti_logo.svg) |
AM62x MCU+ SDK
09.02.01
|
|
Go to the documentation of this file.
63 #include <drivers/hw_include/cslr_mcasp.h>
64 #include <drivers/hw_include/csl_types.h>
66 #include <drivers/mcasp/v1/mcasp_drv_configs/mcasp_drv_config.h>
68 #if defined (SOC_AM62AX)
69 #include <drivers/mcasp/v1/soc/am62ax/mcasp_soc.h>
72 #if defined (SOC_AM62PX)
73 #include <drivers/mcasp/v1/soc/am62px/mcasp_soc.h>
76 #if defined (SOC_AM62X)
77 #include <drivers/mcasp/v1/soc/am62x/mcasp_soc.h>
95 #define MCASP_GBLCTL_TIMEOUT (30000U)
101 #define MCASP_DATA_TIMEOUT (30000U)
104 #define MCASP_RESET ((uint32_t) 0x00U)
105 #define MCASP_ENABLE ((uint32_t) 0x01U)
106 #define MCASP_DISABLE ((uint32_t) 0x00U)
111 #define MCASP_REG_OFFSET ((uint32_t)0x4U)
122 #define MCASP_TRANSFER_STATUS_COMPLETED (0U)
124 #define MCASP_TRANSFER_STATUS_STARTED (1U)
126 #define MCASP_TRANSFER_STATUS_CANCELLED (2U)
128 #define MCASP_TRANSFER_STATUS_FAILED (3U)
130 #define MCASP_TRANSFER_STATUS_TIMEOUT (4U)
143 #define MCASP_TRANSFER_MODE_POLLING (0U)
149 #define MCASP_TRANSFER_MODE_INTERRUPT (1U)
154 #define MCASP_TRANSFER_MODE_DMA (2U)
166 #define MCASP_OPMODE_MASTER (0U)
168 #define MCASP_OPMODE_SLAVE (1U)
180 #define MCASP_CHANNEL_INPUT (0x0001U)
182 #define MCASP_CHANNEL_OUTPUT (0x0002U)
184 #define MCASP_CHANNEL_INOUT (MCASP_CHANNEL_INPUT | MCASP_CHANNEL_OUTPUT)
195 #define MCASP_DRIVER_STATE_DELETED (0U)
196 #define MCASP_DRIVER_STATE_CREATED (1U)
197 #define MCASP_DRIVER_STATE_INITIALIZED (2U)
198 #define MCASP_DRIVER_STATE_OPENED (3U)
199 #define MCASP_DRIVER_STATE_CLOSED (4U)
200 #define MCASP_DRIVER_STATE_DEINITIALIZED (5U)
201 #define MCASP_DRIVER_STATE_POWERED_DOWN (6U)
202 #define MCASP_DRIVER_STATE_PWRM_SUSPEND (7U)
213 #define MCASP_SERIALIZER_STATUS_FREE (0U)
214 #define MCASP_SERIALIZER_STATUS_XMT (1U)
215 #define MCASP_SERIALIZER_STATUS_RCV (2U)
226 #define MCASP_CHANNEL_MODE_FREE (0U)
227 #define MCASP_CHANNEL_MODE_XMT_DIT (1U)
228 #define MCASP_CHANNEL_MODE_XMT_TDM (2U)
229 #define MCASP_CHANNEL_MODE_RCV (3U)
240 #define MCASP_WORD_SELECT_LSW (0U)
241 #define MCASP_WORD_SELECT_MSW (1U)
258 #define MCASP_AUDBUFF_FORMAT_1SER_MULTISLOT_NON_INTERLEAVED (0U)
264 #define MCASP_AUDBUFF_FORMAT_1SER_MULTISLOT_INTERLEAVED (1U)
271 #define MCASP_AUDBUFF_FORMAT_MULTISER_MULTISLOT_SEMI_INTERLEAVED_1 (2U)
278 #define MCASP_AUDBUFF_FORMAT_MULTISER_MULTISLOT_SEMI_INTERLEAVED_2 (3U)
289 #define MCASP_TRANSMIT_STATE_TX_RESET (0U)
290 #define MCASP_TRANSMIT_STATE_TX_FLUSH (1U)
291 #define MCASP_TRANSMIT_STATE_LOAD_INIT_BUFFER (2U)
292 #define MCASP_TRANSMIT_STATE_RELEASE_FROM_RESET (3U)
293 #define MCASP_TRANSMIT_STATE_WAIT_EVENT (4U)
294 #define MCASP_TRANSMIT_STATE_PROCESS_EVENT (5U)
295 #define MCASP_TRANSMIT_STATE_LOAD_ACTIVE_BUFFER (6U)
296 #define MCASP_TRANSMIT_STATE_DONE (7U)
297 #define MCASP_TRANSMIT_STATE_SPIN_IDLE (8U)
298 #define MCASP_TRANSMIT_STATE_ERROR (9U)
299 #define MCASP_TRANSMIT_STATE_EXIT (10U)
310 #define MCASP_RECEIVE_STATE_RX_RESET (0U)
311 #define MCASP_RECEIVE_STATE_RX_FLUSH (1U)
312 #define MCASP_RECEIVE_STATE_RELEASE_FROM_RESET (2U)
313 #define MCASP_RECEIVE_STATE_WAIT_EVENT (3U)
314 #define MCASP_RECEIVE_STATE_PROCESS_EVENT (4U)
315 #define MCASP_RECEIVE_STATE_DONE (5U)
316 #define MCASP_RECEIVE_STATE_SPIN_IDLE (6U)
317 #define MCASP_RECEIVE_STATE_ERROR (7U)
318 #define MCASP_RECEIVE_STATE_EXIT (8U)
321 #define MCASP_DIR_OUT 0
322 #define MCASP_DIR_IN 1
324 #define MCASP_TRPD_INVALID_PTR (0xFFFFFFFF)
401 uint32_t serSetup[16u];
454 typedef struct MCASP_DMAChConfig_s
684 uint16_t serStatus[16];
871 if (openPrms != NULL)
uint32_t amute
Definition: mcasp/v1/mcasp.h:399
MCASP_Transaction txnLoopjob
Definition: mcasp/v1/mcasp.h:588
uint32_t txLoopjobEnable
Definition: mcasp/v1/mcasp.h:520
const MCASP_Attrs * attrs
Definition: mcasp/v1/mcasp.h:700
void * cqRxEvtHandle
Definition: mcasp/v1/mcasp.h:462
void * args
Definition: mcasp/v1/mcasp.h:350
uint32_t aClk
Definition: mcasp/v1/mcasp.h:372
MCASP_Transaction * MCASP_withdrawRx(MCASP_Handle handle)
Function to withdraw the buffer submitted to McASP driver for reception. This should be called after ...
void * mcaspDmaDrvObj
Definition: mcasp/v1/mcasp.h:536
MCASP driver object.
Definition: mcasp/v1/mcasp.h:599
void MCASP_close(MCASP_Handle handle)
Function to close a MCASP peripheral specified by the MCASP handle.
int32_t MCASP_submitRx(MCASP_Handle handle, MCASP_Transaction *txn)
Function to submit the buffer to McASP driver for reception. Transaction object is held by the driver...
Opaque QueueP element.
Definition: QueueP.h:77
uint32_t tdm
Definition: mcasp/v1/mcasp.h:427
void * rxChHandle
Definition: mcasp/v1/mcasp.h:458
uint32_t pfunc
Definition: mcasp/v1/mcasp.h:389
uint8_t txSlotCount
Definition: mcasp/v1/mcasp.h:512
void * txCbParams
Definition: mcasp/v1/mcasp.h:474
uint8_t frameIndex
Definition: mcasp/v1/mcasp.h:575
MCASP_Handle handle
Definition: mcasp/v1/mcasp.h:603
MCASP_Config gMcaspConfig[]
Externally defined driver configuration array.
uint16_t index
Definition: tisci_rm_proxy.h:3
uint8_t slotCount
Definition: mcasp/v1/mcasp.h:569
void * rxCbParams
Definition: mcasp/v1/mcasp.h:476
uint8_t txSerUsedCount
Definition: mcasp/v1/mcasp.h:504
int32_t status
Definition: mcasp/v1/mcasp.h:565
MCASP_Transaction * MCASP_withdrawTx(MCASP_Handle handle)
Function to withdraw the buffer submitted to McASP driver for transmission. This should be called aft...
uint8_t * txSerUsedArray
Definition: mcasp/v1/mcasp.h:508
HwiP_Object hwiObjTx
Definition: mcasp/v1/mcasp.h:637
uint32_t txLoopjobBufLength
Definition: mcasp/v1/mcasp.h:524
void * txChHandle
Definition: mcasp/v1/mcasp.h:456
uint32_t isTxStarted
Definition: mcasp/v1/mcasp.h:629
SemaphoreP_Object transferSemObj
Definition: mcasp/v1/mcasp.h:635
SemaphoreP_Object lockObj
Definition: mcasp/v1/mcasp.h:633
uint32_t txSlotSize
Definition: mcasp/v1/mcasp.h:692
uint8_t frameCount
Definition: mcasp/v1/mcasp.h:573
void * mcaspPktDmaHandle
Definition: mcasp/v1/mcasp.h:613
MCASP_DmaChConfig * dmaChCfg
Definition: mcasp/v1/mcasp.h:533
MCASP_RxCallbackFxn rxCallbackFxn
Definition: mcasp/v1/mcasp.h:518
uint32_t rxLoopjobBufLength
Definition: mcasp/v1/mcasp.h:530
QueueP_Handle reqQueueHandleTx
Definition: mcasp/v1/mcasp.h:644
uint32_t state
Definition: mcasp/v1/mcasp.h:563
Hardware fifo setup structure.
Definition: mcasp/v1/mcasp.h:409
MCASP_ClockConfig clk
Definition: mcasp/v1/mcasp.h:435
uint32_t isOpen
Definition: mcasp/v1/mcasp.h:482
MCASP_Handle MCASP_open(uint32_t index, const MCASP_OpenParams *openParams)
This function opens a given MCASP peripheral.
uint16_t numOfSerializers
Definition: mcasp/v1/mcasp.h:682
MCASP_HwConfig hwCfg
Definition: mcasp/v1/mcasp.h:686
uint32_t fifoStatus
Definition: mcasp/v1/mcasp.h:412
uint32_t dlbCtl
Definition: mcasp/v1/mcasp.h:397
Hardware setup data structure.
Definition: mcasp/v1/mcasp.h:420
void * txTrpdMem
Definition: mcasp/v1/mcasp.h:464
void * mcaspPktDmaDrvObj
Definition: mcasp/v1/mcasp.h:538
uint8_t serCount
Definition: mcasp/v1/mcasp.h:577
uint32_t lastPlayed
Definition: mcasp/v1/mcasp.h:652
uint8_t rxFifoEnable
Definition: mcasp/v1/mcasp.h:663
MCASP_TxCallbackFxn cbFxn
Definition: mcasp/v1/mcasp.h:585
Data structure used with transfer call.
Definition: mcasp/v1/mcasp.h:335
void * cqTxEvtHandle
Definition: mcasp/v1/mcasp.h:460
MCASP Parameters.
Definition: mcasp/v1/mcasp.h:497
int32_t MCASP_stopTransferRx(MCASP_Handle handle)
Function to stop McASP reception.
uint32_t transferMode
Definition: mcasp/v1/mcasp.h:498
MCASP_TransferObj XmtObj
Definition: mcasp/v1/mcasp.h:619
MCASP instance attributes - used during init time.
Definition: mcasp/v1/mcasp.h:670
uint16_t evntNum
Definition: mcasp/v1/mcasp.h:549
uint32_t count
Definition: mcasp/v1/mcasp.h:342
Hardware setup global structure.
Definition: mcasp/v1/mcasp.h:388
uint8_t intrPriority
Definition: mcasp/v1/mcasp.h:551
MCASP_DataConfig tx
Definition: mcasp/v1/mcasp.h:450
Definition: mcasp/v1/mcasp.h:699
void(* MCASP_RxCallbackFxn)(MCASP_Handle handle, MCASP_Transaction *transaction)
Definition: mcasp/v1/mcasp.h:364
void * rxRingMem
Definition: mcasp/v1/mcasp.h:472
uint32_t lastRecQueued
Definition: mcasp/v1/mcasp.h:658
void MCASP_deinit(void)
This function de-initializes the MCASP module.
MCASP_Transaction * transaction
Definition: mcasp/v1/mcasp.h:583
int32_t MCASP_startTransferTx(MCASP_Handle handle)
Function to start McASP transmission.
uint32_t gMcaspConfigNum
Externally defined driver configuration array size.
uint8_t bufferFormat
Definition: mcasp/v1/mcasp.h:581
uint32_t count
Definition: mcasp/v1/mcasp.h:567
void * txRingMem
Definition: mcasp/v1/mcasp.h:470
void * mcaspDmaHandle
Definition: mcasp/v1/mcasp.h:611
uint8_t rxBufferFormat
Definition: mcasp/v1/mcasp.h:502
uint32_t ditCtl
Definition: mcasp/v1/mcasp.h:395
uint32_t evtCtl
Definition: mcasp/v1/mcasp.h:433
MCASP_TransferObj RcvObj
Definition: mcasp/v1/mcasp.h:621
uint32_t rxSlotSize
Definition: mcasp/v1/mcasp.h:694
uint32_t loopjobEnable
Definition: mcasp/v1/mcasp.h:590
MCASP_DataConfig rx
Definition: mcasp/v1/mcasp.h:448
uint32_t hiClk
Definition: mcasp/v1/mcasp.h:374
MCASP_TxCallbackFxn txCallbackFxn
Definition: mcasp/v1/mcasp.h:516
uint32_t trpdMemSize
Definition: mcasp/v1/mcasp.h:468
QueueP_Elem qElem
Definition: mcasp/v1/mcasp.h:336
uintptr_t baseAddr
Definition: mcasp/v1/mcasp.h:676
int32_t status
Definition: mcasp/v1/mcasp.h:348
uint8_t rxSlotCount
Definition: mcasp/v1/mcasp.h:514
Opaque task object used with the task APIs.
Definition: QueueP.h:92
Hardware setup data clock structure.
Definition: mcasp/v1/mcasp.h:371
uint32_t inProgress
Definition: mcasp/v1/mcasp.h:561
uint32_t gblCtl
Definition: mcasp/v1/mcasp.h:393
uint32_t frSyncCtl
Definition: mcasp/v1/mcasp.h:425
QueueP_Object completedQueueObjRx
Definition: mcasp/v1/mcasp.h:647
uintptr_t dataBaseAddr
Definition: mcasp/v1/mcasp.h:678
uint8_t isHClkExt
Definition: mcasp/v1/mcasp.h:378
uint32_t isOpen
Definition: mcasp/v1/mcasp.h:627
uint32_t intCtl
Definition: mcasp/v1/mcasp.h:429
void * QueueP_Handle
Opaque client reference to an instance of a QueueP.
Definition: QueueP.h:68
uint32_t txEvtNum
Definition: mcasp/v1/mcasp.h:480
uint32_t rxLoopjobEnable
Definition: mcasp/v1/mcasp.h:526
uint8_t txFifoEnable
Definition: mcasp/v1/mcasp.h:661
uint32_t stat
Definition: mcasp/v1/mcasp.h:431
static void MCASP_openParamsInit(MCASP_OpenParams *openPrms)
Function to initialize the MCASP_OpenParams struct to its defaults.
Definition: mcasp/v1/mcasp.h:869
MCASP_GlobalConfig gbl
Definition: mcasp/v1/mcasp.h:446
void * MCASP_Handle
A handle that is returned from a MCASP_open() call.
Definition: mcasp/v1/mcasp.h:89
QueueP_Handle completedQueueHandleRx
Definition: mcasp/v1/mcasp.h:649
uint32_t pdir
Definition: mcasp/v1/mcasp.h:391
Opaque Hwi object used with the Hwi APIs.
Definition: HwiP.h:93
QueueP_Object reqQueueObjTx
Definition: mcasp/v1/mcasp.h:642
uint32_t transferMode
Definition: mcasp/v1/mcasp.h:609
UDMA Driver API/interface file.
uint32_t intrNum
Definition: mcasp/v1/mcasp.h:547
McASP Interrupt structures.
Definition: mcasp/v1/mcasp.h:546
int32_t MCASP_startTransferRx(MCASP_Handle handle)
Function to start McASP reception.
uint32_t fmt
Definition: mcasp/v1/mcasp.h:423
void(* MCASP_TxCallbackFxn)(MCASP_Handle handle, MCASP_Transaction *transaction)
The definition of a callback function used by the MCASP driver when used in Callback Mode.
Definition: mcasp/v1/mcasp.h:361
McASP Transfer Data structure stored in driver object.
Definition: mcasp/v1/mcasp.h:560
MCASP_DmaChConfig * dmaChCfg
Definition: mcasp/v1/mcasp.h:616
MCASP_HwIntConfig intCfgRx
Definition: mcasp/v1/mcasp.h:690
Opaque semaphore object used with the semaphore APIs.
Definition: SemaphoreP.h:59
uint32_t rxEvtNum
Definition: mcasp/v1/mcasp.h:478
uint32_t clkChk
Definition: mcasp/v1/mcasp.h:376
uint32_t lastFilled
Definition: mcasp/v1/mcasp.h:654
uint8_t rxSerUsedCount
Definition: mcasp/v1/mcasp.h:506
uint8_t isSynchronous
Definition: mcasp/v1/mcasp.h:680
MCASP_HwIntConfig intCfgTx
Definition: mcasp/v1/mcasp.h:688
uint32_t instNum
Definition: mcasp/v1/mcasp.h:674
MCASP_Handle MCASP_getHandle(uint32_t index)
This function returns the handle of an open MCASP Instance from the instance index.
uint8_t * serArray
Definition: mcasp/v1/mcasp.h:579
uint32_t timeout
Definition: mcasp/v1/mcasp.h:346
uint8_t * rxLoopjobBuf
Definition: mcasp/v1/mcasp.h:528
MCASP_FifoConfig fifoCfg
Definition: mcasp/v1/mcasp.h:437
uint16_t instNum
Definition: mcasp/v1/mcasp.h:605
uint8_t slotIndex
Definition: mcasp/v1/mcasp.h:571
void * buf
Definition: mcasp/v1/mcasp.h:339
void * rxTrpdMem
Definition: mcasp/v1/mcasp.h:466
int32_t MCASP_submitTx(MCASP_Handle handle, MCASP_Transaction *txn)
Function to submit the buffer to McASP driver for transmission. Transaction object is held by the dri...
Definition: mcasp/v1/mcasp.h:455
HwiP_Object hwiObjRx
Definition: mcasp/v1/mcasp.h:639
uint32_t isRxStarted
Definition: mcasp/v1/mcasp.h:631
MCASP_Object * object
Definition: mcasp/v1/mcasp.h:702
uint32_t hClkExt
Definition: mcasp/v1/mcasp.h:380
void MCASP_init(void)
This function initializes the MCASP module.
uint32_t fifoCtl
Definition: mcasp/v1/mcasp.h:410
uint8_t * txLoopjobBuf
Definition: mcasp/v1/mcasp.h:522
Hardware setup structure.
Definition: mcasp/v1/mcasp.h:445
uint8_t * rxSerUsedArray
Definition: mcasp/v1/mcasp.h:510
uint32_t mask
Definition: mcasp/v1/mcasp.h:421
uint32_t drvState
Definition: mcasp/v1/mcasp.h:607
uint8_t txBufferFormat
Definition: mcasp/v1/mcasp.h:500
uint32_t lastReceived
Definition: mcasp/v1/mcasp.h:656
int32_t MCASP_stopTransferTx(MCASP_Handle handle)
Function to stop McASP transmission.