|
AM62Ax MCU+ SDK
09.02.00
|
|
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>
91 #define MCASP_GBLCTL_TIMEOUT (30000U)
97 #define MCASP_DATA_TIMEOUT (30000U)
100 #define MCASP_RESET ((uint32_t) 0x00U)
101 #define MCASP_ENABLE ((uint32_t) 0x01U)
102 #define MCASP_DISABLE ((uint32_t) 0x00U)
107 #define MCASP_REG_OFFSET ((uint32_t)0x4U)
118 #define MCASP_TRANSFER_STATUS_COMPLETED (0U)
120 #define MCASP_TRANSFER_STATUS_STARTED (1U)
122 #define MCASP_TRANSFER_STATUS_CANCELLED (2U)
124 #define MCASP_TRANSFER_STATUS_FAILED (3U)
126 #define MCASP_TRANSFER_STATUS_TIMEOUT (4U)
139 #define MCASP_TRANSFER_MODE_POLLING (0U)
145 #define MCASP_TRANSFER_MODE_INTERRUPT (1U)
150 #define MCASP_TRANSFER_MODE_DMA (2U)
162 #define MCASP_OPMODE_MASTER (0U)
164 #define MCASP_OPMODE_SLAVE (1U)
176 #define MCASP_CHANNEL_INPUT (0x0001U)
178 #define MCASP_CHANNEL_OUTPUT (0x0002U)
180 #define MCASP_CHANNEL_INOUT (MCASP_CHANNEL_INPUT | MCASP_CHANNEL_OUTPUT)
191 #define MCASP_DRIVER_STATE_DELETED (0U)
192 #define MCASP_DRIVER_STATE_CREATED (1U)
193 #define MCASP_DRIVER_STATE_INITIALIZED (2U)
194 #define MCASP_DRIVER_STATE_OPENED (3U)
195 #define MCASP_DRIVER_STATE_CLOSED (4U)
196 #define MCASP_DRIVER_STATE_DEINITIALIZED (5U)
197 #define MCASP_DRIVER_STATE_POWERED_DOWN (6U)
198 #define MCASP_DRIVER_STATE_PWRM_SUSPEND (7U)
209 #define MCASP_SERIALIZER_STATUS_FREE (0U)
210 #define MCASP_SERIALIZER_STATUS_XMT (1U)
211 #define MCASP_SERIALIZER_STATUS_RCV (2U)
222 #define MCASP_CHANNEL_MODE_FREE (0U)
223 #define MCASP_CHANNEL_MODE_XMT_DIT (1U)
224 #define MCASP_CHANNEL_MODE_XMT_TDM (2U)
225 #define MCASP_CHANNEL_MODE_RCV (3U)
236 #define MCASP_WORD_SELECT_LSW (0U)
237 #define MCASP_WORD_SELECT_MSW (1U)
254 #define MCASP_AUDBUFF_FORMAT_1SER_MULTISLOT_NON_INTERLEAVED (0U)
260 #define MCASP_AUDBUFF_FORMAT_1SER_MULTISLOT_INTERLEAVED (1U)
267 #define MCASP_AUDBUFF_FORMAT_MULTISER_MULTISLOT_SEMI_INTERLEAVED_1 (2U)
274 #define MCASP_AUDBUFF_FORMAT_MULTISER_MULTISLOT_SEMI_INTERLEAVED_2 (3U)
285 #define MCASP_TRANSMIT_STATE_TX_RESET (0U)
286 #define MCASP_TRANSMIT_STATE_TX_FLUSH (1U)
287 #define MCASP_TRANSMIT_STATE_LOAD_INIT_BUFFER (2U)
288 #define MCASP_TRANSMIT_STATE_RELEASE_FROM_RESET (3U)
289 #define MCASP_TRANSMIT_STATE_WAIT_EVENT (4U)
290 #define MCASP_TRANSMIT_STATE_PROCESS_EVENT (5U)
291 #define MCASP_TRANSMIT_STATE_LOAD_ACTIVE_BUFFER (6U)
292 #define MCASP_TRANSMIT_STATE_DONE (7U)
293 #define MCASP_TRANSMIT_STATE_SPIN_IDLE (8U)
294 #define MCASP_TRANSMIT_STATE_ERROR (9U)
295 #define MCASP_TRANSMIT_STATE_EXIT (10U)
306 #define MCASP_RECEIVE_STATE_RX_RESET (0U)
307 #define MCASP_RECEIVE_STATE_RX_FLUSH (1U)
308 #define MCASP_RECEIVE_STATE_RELEASE_FROM_RESET (2U)
309 #define MCASP_RECEIVE_STATE_WAIT_EVENT (3U)
310 #define MCASP_RECEIVE_STATE_PROCESS_EVENT (4U)
311 #define MCASP_RECEIVE_STATE_DONE (5U)
312 #define MCASP_RECEIVE_STATE_SPIN_IDLE (6U)
313 #define MCASP_RECEIVE_STATE_ERROR (7U)
314 #define MCASP_RECEIVE_STATE_EXIT (8U)
317 #define MCASP_DIR_OUT 0
318 #define MCASP_DIR_IN 1
320 #define MCASP_TRPD_INVALID_PTR (0xFFFFFFFF)
397 uint32_t serSetup[16u];
450 typedef struct MCASP_DMAChConfig_s
680 uint16_t serStatus[16];
867 if (openPrms != NULL)
uint32_t amute
Definition: mcasp/v1/mcasp.h:395
MCASP_Transaction txnLoopjob
Definition: mcasp/v1/mcasp.h:584
uint32_t txLoopjobEnable
Definition: mcasp/v1/mcasp.h:516
const MCASP_Attrs * attrs
Definition: mcasp/v1/mcasp.h:696
void * cqRxEvtHandle
Definition: mcasp/v1/mcasp.h:458
void * args
Definition: mcasp/v1/mcasp.h:346
uint32_t aClk
Definition: mcasp/v1/mcasp.h:368
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:532
MCASP driver object.
Definition: mcasp/v1/mcasp.h:595
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:423
void * rxChHandle
Definition: mcasp/v1/mcasp.h:454
uint32_t pfunc
Definition: mcasp/v1/mcasp.h:385
uint8_t txSlotCount
Definition: mcasp/v1/mcasp.h:508
void * txCbParams
Definition: mcasp/v1/mcasp.h:470
uint8_t frameIndex
Definition: mcasp/v1/mcasp.h:571
MCASP_Handle handle
Definition: mcasp/v1/mcasp.h:599
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:565
void * rxCbParams
Definition: mcasp/v1/mcasp.h:472
uint8_t txSerUsedCount
Definition: mcasp/v1/mcasp.h:500
int32_t status
Definition: mcasp/v1/mcasp.h:561
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:504
HwiP_Object hwiObjTx
Definition: mcasp/v1/mcasp.h:633
uint32_t txLoopjobBufLength
Definition: mcasp/v1/mcasp.h:520
void * txChHandle
Definition: mcasp/v1/mcasp.h:452
uint32_t isTxStarted
Definition: mcasp/v1/mcasp.h:625
SemaphoreP_Object transferSemObj
Definition: mcasp/v1/mcasp.h:631
SemaphoreP_Object lockObj
Definition: mcasp/v1/mcasp.h:629
uint32_t txSlotSize
Definition: mcasp/v1/mcasp.h:688
uint8_t frameCount
Definition: mcasp/v1/mcasp.h:569
void * mcaspPktDmaHandle
Definition: mcasp/v1/mcasp.h:609
MCASP_DmaChConfig * dmaChCfg
Definition: mcasp/v1/mcasp.h:529
MCASP_RxCallbackFxn rxCallbackFxn
Definition: mcasp/v1/mcasp.h:514
uint32_t rxLoopjobBufLength
Definition: mcasp/v1/mcasp.h:526
QueueP_Handle reqQueueHandleTx
Definition: mcasp/v1/mcasp.h:640
uint32_t state
Definition: mcasp/v1/mcasp.h:559
Hardware fifo setup structure.
Definition: mcasp/v1/mcasp.h:405
MCASP_ClockConfig clk
Definition: mcasp/v1/mcasp.h:431
uint32_t isOpen
Definition: mcasp/v1/mcasp.h:478
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:678
MCASP_HwConfig hwCfg
Definition: mcasp/v1/mcasp.h:682
uint32_t fifoStatus
Definition: mcasp/v1/mcasp.h:408
uint32_t dlbCtl
Definition: mcasp/v1/mcasp.h:393
Hardware setup data structure.
Definition: mcasp/v1/mcasp.h:416
void * txTrpdMem
Definition: mcasp/v1/mcasp.h:460
void * mcaspPktDmaDrvObj
Definition: mcasp/v1/mcasp.h:534
uint8_t serCount
Definition: mcasp/v1/mcasp.h:573
uint32_t lastPlayed
Definition: mcasp/v1/mcasp.h:648
uint8_t rxFifoEnable
Definition: mcasp/v1/mcasp.h:659
MCASP_TxCallbackFxn cbFxn
Definition: mcasp/v1/mcasp.h:581
Data structure used with transfer call.
Definition: mcasp/v1/mcasp.h:331
void * cqTxEvtHandle
Definition: mcasp/v1/mcasp.h:456
MCASP Parameters.
Definition: mcasp/v1/mcasp.h:493
int32_t MCASP_stopTransferRx(MCASP_Handle handle)
Function to stop McASP reception.
uint32_t transferMode
Definition: mcasp/v1/mcasp.h:494
MCASP_TransferObj XmtObj
Definition: mcasp/v1/mcasp.h:615
MCASP instance attributes - used during init time.
Definition: mcasp/v1/mcasp.h:666
uint16_t evntNum
Definition: mcasp/v1/mcasp.h:545
uint32_t count
Definition: mcasp/v1/mcasp.h:338
Hardware setup global structure.
Definition: mcasp/v1/mcasp.h:384
uint8_t intrPriority
Definition: mcasp/v1/mcasp.h:547
MCASP_DataConfig tx
Definition: mcasp/v1/mcasp.h:446
Definition: mcasp/v1/mcasp.h:695
void(* MCASP_RxCallbackFxn)(MCASP_Handle handle, MCASP_Transaction *transaction)
Definition: mcasp/v1/mcasp.h:360
void * rxRingMem
Definition: mcasp/v1/mcasp.h:468
uint32_t lastRecQueued
Definition: mcasp/v1/mcasp.h:654
void MCASP_deinit(void)
This function de-initializes the MCASP module.
MCASP_Transaction * transaction
Definition: mcasp/v1/mcasp.h:579
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:577
uint32_t count
Definition: mcasp/v1/mcasp.h:563
void * txRingMem
Definition: mcasp/v1/mcasp.h:466
void * mcaspDmaHandle
Definition: mcasp/v1/mcasp.h:607
uint8_t rxBufferFormat
Definition: mcasp/v1/mcasp.h:498
uint32_t ditCtl
Definition: mcasp/v1/mcasp.h:391
uint32_t evtCtl
Definition: mcasp/v1/mcasp.h:429
MCASP_TransferObj RcvObj
Definition: mcasp/v1/mcasp.h:617
uint32_t rxSlotSize
Definition: mcasp/v1/mcasp.h:690
uint32_t loopjobEnable
Definition: mcasp/v1/mcasp.h:586
MCASP_DataConfig rx
Definition: mcasp/v1/mcasp.h:444
uint32_t hiClk
Definition: mcasp/v1/mcasp.h:370
MCASP_TxCallbackFxn txCallbackFxn
Definition: mcasp/v1/mcasp.h:512
uint32_t trpdMemSize
Definition: mcasp/v1/mcasp.h:464
QueueP_Elem qElem
Definition: mcasp/v1/mcasp.h:332
uintptr_t baseAddr
Definition: mcasp/v1/mcasp.h:672
int32_t status
Definition: mcasp/v1/mcasp.h:344
uint8_t rxSlotCount
Definition: mcasp/v1/mcasp.h:510
Opaque task object used with the task APIs.
Definition: QueueP.h:92
Hardware setup data clock structure.
Definition: mcasp/v1/mcasp.h:367
uint32_t inProgress
Definition: mcasp/v1/mcasp.h:557
uint32_t gblCtl
Definition: mcasp/v1/mcasp.h:389
uint32_t frSyncCtl
Definition: mcasp/v1/mcasp.h:421
QueueP_Object completedQueueObjRx
Definition: mcasp/v1/mcasp.h:643
uintptr_t dataBaseAddr
Definition: mcasp/v1/mcasp.h:674
uint8_t isHClkExt
Definition: mcasp/v1/mcasp.h:374
uint32_t isOpen
Definition: mcasp/v1/mcasp.h:623
uint32_t intCtl
Definition: mcasp/v1/mcasp.h:425
void * QueueP_Handle
Opaque client reference to an instance of a QueueP.
Definition: QueueP.h:68
uint32_t txEvtNum
Definition: mcasp/v1/mcasp.h:476
uint32_t rxLoopjobEnable
Definition: mcasp/v1/mcasp.h:522
uint8_t txFifoEnable
Definition: mcasp/v1/mcasp.h:657
uint32_t stat
Definition: mcasp/v1/mcasp.h:427
static void MCASP_openParamsInit(MCASP_OpenParams *openPrms)
Function to initialize the MCASP_OpenParams struct to its defaults.
Definition: mcasp/v1/mcasp.h:865
MCASP_GlobalConfig gbl
Definition: mcasp/v1/mcasp.h:442
void * MCASP_Handle
A handle that is returned from a MCASP_open() call.
Definition: mcasp/v1/mcasp.h:85
QueueP_Handle completedQueueHandleRx
Definition: mcasp/v1/mcasp.h:645
uint32_t pdir
Definition: mcasp/v1/mcasp.h:387
Opaque Hwi object used with the Hwi APIs.
Definition: HwiP.h:93
QueueP_Object reqQueueObjTx
Definition: mcasp/v1/mcasp.h:638
uint32_t transferMode
Definition: mcasp/v1/mcasp.h:605
UDMA Driver API/interface file.
uint32_t intrNum
Definition: mcasp/v1/mcasp.h:543
McASP Interrupt structures.
Definition: mcasp/v1/mcasp.h:542
int32_t MCASP_startTransferRx(MCASP_Handle handle)
Function to start McASP reception.
uint32_t fmt
Definition: mcasp/v1/mcasp.h:419
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:357
McASP Transfer Data structure stored in driver object.
Definition: mcasp/v1/mcasp.h:556
MCASP_DmaChConfig * dmaChCfg
Definition: mcasp/v1/mcasp.h:612
MCASP_HwIntConfig intCfgRx
Definition: mcasp/v1/mcasp.h:686
Opaque semaphore object used with the semaphore APIs.
Definition: SemaphoreP.h:59
uint32_t rxEvtNum
Definition: mcasp/v1/mcasp.h:474
uint32_t clkChk
Definition: mcasp/v1/mcasp.h:372
uint32_t lastFilled
Definition: mcasp/v1/mcasp.h:650
uint8_t rxSerUsedCount
Definition: mcasp/v1/mcasp.h:502
uint8_t isSynchronous
Definition: mcasp/v1/mcasp.h:676
MCASP_HwIntConfig intCfgTx
Definition: mcasp/v1/mcasp.h:684
uint32_t instNum
Definition: mcasp/v1/mcasp.h:670
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:575
uint32_t timeout
Definition: mcasp/v1/mcasp.h:342
uint8_t * rxLoopjobBuf
Definition: mcasp/v1/mcasp.h:524
MCASP_FifoConfig fifoCfg
Definition: mcasp/v1/mcasp.h:433
uint16_t instNum
Definition: mcasp/v1/mcasp.h:601
uint8_t slotIndex
Definition: mcasp/v1/mcasp.h:567
void * buf
Definition: mcasp/v1/mcasp.h:335
void * rxTrpdMem
Definition: mcasp/v1/mcasp.h:462
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:451
HwiP_Object hwiObjRx
Definition: mcasp/v1/mcasp.h:635
uint32_t isRxStarted
Definition: mcasp/v1/mcasp.h:627
MCASP_Object * object
Definition: mcasp/v1/mcasp.h:698
uint32_t hClkExt
Definition: mcasp/v1/mcasp.h:376
void MCASP_init(void)
This function initializes the MCASP module.
uint32_t fifoCtl
Definition: mcasp/v1/mcasp.h:406
uint8_t * txLoopjobBuf
Definition: mcasp/v1/mcasp.h:518
Hardware setup structure.
Definition: mcasp/v1/mcasp.h:441
uint8_t * rxSerUsedArray
Definition: mcasp/v1/mcasp.h:506
uint32_t mask
Definition: mcasp/v1/mcasp.h:417
uint32_t drvState
Definition: mcasp/v1/mcasp.h:603
uint8_t txBufferFormat
Definition: mcasp/v1/mcasp.h:496
uint32_t lastReceived
Definition: mcasp/v1/mcasp.h:652
int32_t MCASP_stopTransferTx(MCASP_Handle handle)
Function to stop McASP transmission.