|
AM62Ax MCU+ SDK
09.00.00
|
|
Go to the documentation of this file.
63 #include <drivers/hw_include/cslr_mcasp.h>
64 #include <drivers/hw_include/csl_types.h>
82 #define MCASP_GBLCTL_TIMEOUT (30000U)
88 #define MCASP_DATA_TIMEOUT (30000U)
91 #define MCASP_RESET ((uint32_t) 0x00U)
92 #define MCASP_ENABLE ((uint32_t) 0x01U)
93 #define MCASP_DISABLE ((uint32_t) 0x00U)
98 #define MCASP_REG_OFFSET ((uint32_t)0x4U)
109 #define MCASP_TRANSFER_STATUS_COMPLETED (0U)
111 #define MCASP_TRANSFER_STATUS_STARTED (1U)
113 #define MCASP_TRANSFER_STATUS_CANCELLED (2U)
115 #define MCASP_TRANSFER_STATUS_FAILED (3U)
117 #define MCASP_TRANSFER_STATUS_TIMEOUT (4U)
130 #define MCASP_TRANSFER_MODE_POLLING (0U)
136 #define MCASP_TRANSFER_MODE_INTERRUPT (1U)
141 #define MCASP_TRANSFER_MODE_DMA (2U)
153 #define MCASP_OPMODE_MASTER (0U)
155 #define MCASP_OPMODE_SLAVE (1U)
167 #define MCASP_CHANNEL_INPUT (0x0001U)
169 #define MCASP_CHANNEL_OUTPUT (0x0002U)
171 #define MCASP_CHANNEL_INOUT (MCASP_CHANNEL_INPUT | MCASP_CHANNEL_OUTPUT)
182 #define MCASP_DRIVER_STATE_DELETED (0U)
183 #define MCASP_DRIVER_STATE_CREATED (1U)
184 #define MCASP_DRIVER_STATE_INITIALIZED (2U)
185 #define MCASP_DRIVER_STATE_OPENED (3U)
186 #define MCASP_DRIVER_STATE_CLOSED (4U)
187 #define MCASP_DRIVER_STATE_DEINITIALIZED (5U)
188 #define MCASP_DRIVER_STATE_POWERED_DOWN (6U)
189 #define MCASP_DRIVER_STATE_PWRM_SUSPEND (7U)
200 #define MCASP_SERIALIZER_STATUS_FREE (0U)
201 #define MCASP_SERIALIZER_STATUS_XMT (1U)
202 #define MCASP_SERIALIZER_STATUS_RCV (2U)
213 #define MCASP_CHANNEL_MODE_FREE (0U)
214 #define MCASP_CHANNEL_MODE_XMT_DIT (1U)
215 #define MCASP_CHANNEL_MODE_XMT_TDM (2U)
216 #define MCASP_CHANNEL_MODE_RCV (3U)
227 #define MCASP_WORD_SELECT_LSW (0U)
228 #define MCASP_WORD_SELECT_MSW (1U)
245 #define MCASP_AUDBUFF_FORMAT_1SER_MULTISLOT_NON_INTERLEAVED (0U)
251 #define MCASP_AUDBUFF_FORMAT_1SER_MULTISLOT_INTERLEAVED (1U)
258 #define MCASP_AUDBUFF_FORMAT_MULTISER_MULTISLOT_SEMI_INTERLEAVED_1 (2U)
265 #define MCASP_AUDBUFF_FORMAT_MULTISER_MULTISLOT_SEMI_INTERLEAVED_2 (3U)
276 #define MCASP_TRANSMIT_STATE_TX_RESET (0U)
277 #define MCASP_TRANSMIT_STATE_TX_FLUSH (1U)
278 #define MCASP_TRANSMIT_STATE_LOAD_INIT_BUFFER (2U)
279 #define MCASP_TRANSMIT_STATE_RELEASE_FROM_RESET (3U)
280 #define MCASP_TRANSMIT_STATE_WAIT_EVENT (4U)
281 #define MCASP_TRANSMIT_STATE_PROCESS_EVENT (5U)
282 #define MCASP_TRANSMIT_STATE_LOAD_ACTIVE_BUFFER (6U)
283 #define MCASP_TRANSMIT_STATE_DONE (7U)
284 #define MCASP_TRANSMIT_STATE_SPIN_IDLE (8U)
285 #define MCASP_TRANSMIT_STATE_ERROR (9U)
286 #define MCASP_TRANSMIT_STATE_EXIT (10U)
297 #define MCASP_RECEIVE_STATE_RX_RESET (0U)
298 #define MCASP_RECEIVE_STATE_RX_FLUSH (1U)
299 #define MCASP_RECEIVE_STATE_RELEASE_FROM_RESET (2U)
300 #define MCASP_RECEIVE_STATE_WAIT_EVENT (3U)
301 #define MCASP_RECEIVE_STATE_PROCESS_EVENT (4U)
302 #define MCASP_RECEIVE_STATE_DONE (5U)
303 #define MCASP_RECEIVE_STATE_SPIN_IDLE (6U)
304 #define MCASP_RECEIVE_STATE_ERROR (7U)
305 #define MCASP_RECEIVE_STATE_EXIT (8U)
308 #define MCASP_DIR_OUT 0
309 #define MCASP_DIR_IN 1
311 #define MCASP_TRPD_INVALID_PTR (0xFFFFFFFF)
384 uint32_t serSetup[16u];
437 typedef struct MCASP_DMAChConfig_s
728 uint16_t serStatus[16];
915 if (openPrms != NULL)
Udma_DrvHandle bcdmaDrvHandle
Definition: mcasp/v1/mcasp.h:707
uint32_t amute
Definition: mcasp/v1/mcasp.h:382
MCASP_Transaction txnLoopjob
Definition: mcasp/v1/mcasp.h:607
uint32_t txLoopjobEnable
Definition: mcasp/v1/mcasp.h:509
const MCASP_Attrs * attrs
Definition: mcasp/v1/mcasp.h:744
uint8_t txTrCompletionIdx
Definition: mcasp/v1/mcasp.h:698
uint32_t cyclicBuffCntTx
Definition: mcasp/v1/mcasp.h:532
void * cqRxEvtHandle
Definition: mcasp/v1/mcasp.h:445
void * args
Definition: mcasp/v1/mcasp.h:337
uint32_t cyclicBuffSizeTx
Definition: mcasp/v1/mcasp.h:530
uint32_t aClk
Definition: mcasp/v1/mcasp.h:359
uint32_t cyclicBuffCntRx
Definition: mcasp/v1/mcasp.h:680
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:525
Udma_EventHandle bcdmaRxCqEvtHandle
Definition: mcasp/v1/mcasp.h:549
MCASP driver object.
Definition: mcasp/v1/mcasp.h:618
void MCASP_close(MCASP_Handle handle)
Function to close a MCASP peripheral specified by the MCASP handle.
Definition: mcasp/v1/mcasp.h:470
MCASP_DmaTrpdMemAlloc * trpdMemAllocRx
Definition: mcasp/v1/mcasp.h:557
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:410
void * rxChHandle
Definition: mcasp/v1/mcasp.h:441
uint32_t pfunc
Definition: mcasp/v1/mcasp.h:372
uint8_t txSlotCount
Definition: mcasp/v1/mcasp.h:501
uint8_t frameIndex
Definition: mcasp/v1/mcasp.h:594
MCASP_Handle handle
Definition: mcasp/v1/mcasp.h:622
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:588
uint8_t txSerUsedCount
Definition: mcasp/v1/mcasp.h:493
int32_t status
Definition: mcasp/v1/mcasp.h:584
void * Udma_ChHandle
UDMA channel handle.
Definition: udma_types.h:67
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:497
HwiP_Object hwiObjTx
Definition: mcasp/v1/mcasp.h:654
uint32_t txLoopjobBufLength
Definition: mcasp/v1/mcasp.h:513
void * txChHandle
Definition: mcasp/v1/mcasp.h:439
uint32_t isTxStarted
Definition: mcasp/v1/mcasp.h:646
SemaphoreP_Object transferSemObj
Definition: mcasp/v1/mcasp.h:652
SemaphoreP_Object lockObj
Definition: mcasp/v1/mcasp.h:650
uint32_t txSlotSize
Definition: mcasp/v1/mcasp.h:736
uint8_t frameCount
Definition: mcasp/v1/mcasp.h:592
MCASP_DmaChConfig * dmaChCfg
Definition: mcasp/v1/mcasp.h:522
MCASP_RxCallbackFxn rxCallbackFxn
Definition: mcasp/v1/mcasp.h:507
uint32_t rxLoopjobBufLength
Definition: mcasp/v1/mcasp.h:519
QueueP_Handle reqQueueHandleTx
Definition: mcasp/v1/mcasp.h:661
uint32_t state
Definition: mcasp/v1/mcasp.h:582
Hardware fifo setup structure.
Definition: mcasp/v1/mcasp.h:392
Udma_ChHandle * cyclicTxFeedDMAHandle
Definition: mcasp/v1/mcasp.h:542
MCASP_ClockConfig clk
Definition: mcasp/v1/mcasp.h:418
uint32_t isOpen
Definition: mcasp/v1/mcasp.h:465
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:726
MCASP_HwConfig hwCfg
Definition: mcasp/v1/mcasp.h:730
uint32_t fifoStatus
Definition: mcasp/v1/mcasp.h:395
uint32_t dlbCtl
Definition: mcasp/v1/mcasp.h:380
Hardware setup data structure.
Definition: mcasp/v1/mcasp.h:403
void * txTrpdMem
Definition: mcasp/v1/mcasp.h:447
uint8_t serCount
Definition: mcasp/v1/mcasp.h:596
uint32_t currTxTransRemCnt
Definition: mcasp/v1/mcasp.h:688
MCASP_Transaction * currTransRx
Definition: mcasp/v1/mcasp.h:685
MCASP_TxCallbackFxn cbFxn
Definition: mcasp/v1/mcasp.h:604
uint8_t inUse
Definition: mcasp/v1/mcasp.h:472
MCASP_DmaTrpdMemAlloc * trpdMemAllocTx
Definition: mcasp/v1/mcasp.h:555
Data structure used with transfer call.
Definition: mcasp/v1/mcasp.h:322
uint32_t cyclicBuffSizeRx
Definition: mcasp/v1/mcasp.h:537
void * cqTxEvtHandle
Definition: mcasp/v1/mcasp.h:443
MCASP Parameters.
Definition: mcasp/v1/mcasp.h:486
int32_t MCASP_stopTransferRx(MCASP_Handle handle)
Function to stop McASP reception.
uint32_t transferMode
Definition: mcasp/v1/mcasp.h:487
uint32_t currRxTransRemCnt
Definition: mcasp/v1/mcasp.h:690
MCASP_TransferObj XmtObj
Definition: mcasp/v1/mcasp.h:636
MCASP instance attributes - used during init time.
Definition: mcasp/v1/mcasp.h:718
uint32_t count
Definition: mcasp/v1/mcasp.h:329
Hardware setup global structure.
Definition: mcasp/v1/mcasp.h:371
uint8_t intrPriority
Definition: mcasp/v1/mcasp.h:570
MCASP_DataConfig tx
Definition: mcasp/v1/mcasp.h:433
Definition: mcasp/v1/mcasp.h:743
void(* MCASP_RxCallbackFxn)(MCASP_Handle handle, MCASP_Transaction *transaction)
Definition: mcasp/v1/mcasp.h:351
void * rxRingMem
Definition: mcasp/v1/mcasp.h:455
void MCASP_deinit(void)
This function de-initializes the MCASP module.
MCASP_Transaction * transaction
Definition: mcasp/v1/mcasp.h:602
int32_t MCASP_startTransferTx(MCASP_Handle handle)
Function to start McASP transmission.
uint32_t gMcaspConfigNum
Externally defined driver configuration array size.
Udma_DrvHandle bcdmaDrvHandle
Definition: mcasp/v1/mcasp.h:552
uint8_t bufferFormat
Definition: mcasp/v1/mcasp.h:600
uint32_t count
Definition: mcasp/v1/mcasp.h:586
void * txRingMem
Definition: mcasp/v1/mcasp.h:453
void * mcaspDmaHandle
Definition: mcasp/v1/mcasp.h:630
uint8_t rxBufferFormat
Definition: mcasp/v1/mcasp.h:491
uint32_t ditCtl
Definition: mcasp/v1/mcasp.h:378
uint32_t evtCtl
Definition: mcasp/v1/mcasp.h:416
MCASP_TransferObj RcvObj
Definition: mcasp/v1/mcasp.h:638
uint32_t rxSlotSize
Definition: mcasp/v1/mcasp.h:738
uint32_t loopjobEnable
Definition: mcasp/v1/mcasp.h:609
MCASP_DataConfig rx
Definition: mcasp/v1/mcasp.h:431
uint32_t hiClk
Definition: mcasp/v1/mcasp.h:361
Udma_ChHandle * cyclicRxFeedDMAHandle
Definition: mcasp/v1/mcasp.h:544
void * Udma_EventHandle
UDMA event handle.
Definition: udma_types.h:69
MCASP_TxCallbackFxn txCallbackFxn
Definition: mcasp/v1/mcasp.h:505
uint32_t trpdMemSize
Definition: mcasp/v1/mcasp.h:451
QueueP_Elem qElem
Definition: mcasp/v1/mcasp.h:323
uintptr_t baseAddr
Definition: mcasp/v1/mcasp.h:722
int32_t status
Definition: mcasp/v1/mcasp.h:335
uint8_t rxSlotCount
Definition: mcasp/v1/mcasp.h:503
Opaque task object used with the task APIs.
Definition: QueueP.h:92
Hardware setup data clock structure.
Definition: mcasp/v1/mcasp.h:358
uint32_t inProgress
Definition: mcasp/v1/mcasp.h:580
uint32_t gblCtl
Definition: mcasp/v1/mcasp.h:376
uint32_t frSyncCtl
Definition: mcasp/v1/mcasp.h:408
uint8_t * cyclicBuffRx
Definition: mcasp/v1/mcasp.h:676
QueueP_Object completedQueueObjRx
Definition: mcasp/v1/mcasp.h:664
uintptr_t dataBaseAddr
Definition: mcasp/v1/mcasp.h:724
uint32_t isOpen
Definition: mcasp/v1/mcasp.h:644
uint32_t intCtl
Definition: mcasp/v1/mcasp.h:412
void * QueueP_Handle
Opaque client reference to an instance of a QueueP.
Definition: QueueP.h:68
Udma_ChHandle cyclicTxFeedDMAHandle
Definition: mcasp/v1/mcasp.h:693
uint32_t txEvtNum
Definition: mcasp/v1/mcasp.h:463
uint32_t rxLoopjobEnable
Definition: mcasp/v1/mcasp.h:515
uint32_t stat
Definition: mcasp/v1/mcasp.h:414
static void MCASP_openParamsInit(MCASP_OpenParams *openPrms)
Function to initialize the MCASP_OpenParams struct to its defaults.
Definition: mcasp/v1/mcasp.h:913
MCASP_GlobalConfig gbl
Definition: mcasp/v1/mcasp.h:429
void * MCASP_Handle
A handle that is returned from a MCASP_open() call.
Definition: mcasp/v1/mcasp.h:76
Udma_EventHandle bcdmaTxCyclicEvtHandle
Definition: mcasp/v1/mcasp.h:703
QueueP_Handle completedQueueHandleRx
Definition: mcasp/v1/mcasp.h:666
uint32_t pdir
Definition: mcasp/v1/mcasp.h:374
Opaque Hwi object used with the Hwi APIs.
Definition: HwiP.h:93
MCASP_DmaTrpdMemAlloc * trpdMemAllocTx
Definition: mcasp/v1/mcasp.h:710
QueueP_Object reqQueueObjTx
Definition: mcasp/v1/mcasp.h:659
uint32_t transferMode
Definition: mcasp/v1/mcasp.h:628
UDMA Driver API/interface file.
Udma_EventHandle bcdmaRxCyclicEvtHandle
Definition: mcasp/v1/mcasp.h:705
uint32_t intrNum
Definition: mcasp/v1/mcasp.h:566
McASP Interrupt structures.
Definition: mcasp/v1/mcasp.h:565
void * Udma_DrvHandle
UDMA driver handle.
Definition: udma_types.h:65
MCASP_Transaction * currTransTx
Definition: mcasp/v1/mcasp.h:683
int32_t MCASP_startTransferRx(MCASP_Handle handle)
Function to start McASP reception.
uint32_t fmt
Definition: mcasp/v1/mcasp.h:406
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:348
uint8_t rxTrCompletionIdx
Definition: mcasp/v1/mcasp.h:700
McASP Transfer Data structure stored in driver object.
Definition: mcasp/v1/mcasp.h:579
MCASP_DmaChConfig * dmaChCfg
Definition: mcasp/v1/mcasp.h:633
uint32_t cyclicBuffSizeTx
Definition: mcasp/v1/mcasp.h:671
MCASP_HwIntConfig intCfgRx
Definition: mcasp/v1/mcasp.h:734
Opaque semaphore object used with the semaphore APIs.
Definition: SemaphoreP.h:59
uint32_t rxEvtNum
Definition: mcasp/v1/mcasp.h:461
uint32_t cyclicBuffCntTx
Definition: mcasp/v1/mcasp.h:673
uint32_t clkChk
Definition: mcasp/v1/mcasp.h:363
uint8_t rxSerUsedCount
Definition: mcasp/v1/mcasp.h:495
MCASP_HwIntConfig intCfgTx
Definition: mcasp/v1/mcasp.h:732
uint32_t evntNum
Definition: mcasp/v1/mcasp.h:568
uint32_t ringElemCnt
Definition: mcasp/v1/mcasp.h:459
Udma_EventHandle bcdmaTxCqEvtHandle
Definition: mcasp/v1/mcasp.h:547
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:598
uint32_t timeout
Definition: mcasp/v1/mcasp.h:333
uint8_t * rxLoopjobBuf
Definition: mcasp/v1/mcasp.h:517
MCASP_FifoConfig fifoCfg
Definition: mcasp/v1/mcasp.h:420
uint16_t instNum
Definition: mcasp/v1/mcasp.h:624
uint32_t cyclicBuffCntRx
Definition: mcasp/v1/mcasp.h:539
uint32_t ringMemSize
Definition: mcasp/v1/mcasp.h:457
uint8_t slotIndex
Definition: mcasp/v1/mcasp.h:590
void * buf
Definition: mcasp/v1/mcasp.h:326
uint8_t * cyclicBuffTx
Definition: mcasp/v1/mcasp.h:669
uint8_t * cyclicBuffRx
Definition: mcasp/v1/mcasp.h:535
void * rxTrpdMem
Definition: mcasp/v1/mcasp.h:449
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...
MCASP_DmaTrpdMemAlloc * trpdMemAllocRx
Definition: mcasp/v1/mcasp.h:712
Definition: mcasp/v1/mcasp.h:438
HwiP_Object hwiObjRx
Definition: mcasp/v1/mcasp.h:656
uint32_t isRxStarted
Definition: mcasp/v1/mcasp.h:648
Udma_ChHandle cyclicRxFeedDMAHandle
Definition: mcasp/v1/mcasp.h:695
MCASP_Object * object
Definition: mcasp/v1/mcasp.h:746
uint32_t cyclicBuffSizeRx
Definition: mcasp/v1/mcasp.h:678
uint8_t * cyclicBuffTx
Definition: mcasp/v1/mcasp.h:528
void MCASP_init(void)
This function initializes the MCASP module.
uint32_t fifoCtl
Definition: mcasp/v1/mcasp.h:393
uint8_t * txLoopjobBuf
Definition: mcasp/v1/mcasp.h:511
Hardware setup structure.
Definition: mcasp/v1/mcasp.h:428
uint8_t * rxSerUsedArray
Definition: mcasp/v1/mcasp.h:499
uint8_t * pTrpdMem
Definition: mcasp/v1/mcasp.h:471
uint32_t mask
Definition: mcasp/v1/mcasp.h:404
uint32_t drvState
Definition: mcasp/v1/mcasp.h:626
uint8_t txBufferFormat
Definition: mcasp/v1/mcasp.h:489
int32_t MCASP_stopTransferTx(MCASP_Handle handle)
Function to stop McASP transmission.