![Logo](ti_logo.svg) |
AM62Px MCU+ SDK
09.02.01
|
|
Go to the documentation of this file.
63 #include <drivers/hw_include/cslr_mcasp.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_AM62DX)
73 #include <drivers/mcasp/v1/soc/am62dx/mcasp_soc.h>
76 #if defined (SOC_AM62PX)
77 #include <drivers/mcasp/v1/soc/am62px/mcasp_soc.h>
80 #if defined (SOC_AM62X)
81 #include <drivers/mcasp/v1/soc/am62x/mcasp_soc.h>
99 #define MCASP_GBLCTL_TIMEOUT (30000U)
105 #define MCASP_DATA_TIMEOUT (30000U)
108 #define MCASP_RESET ((uint32_t) 0x00U)
109 #define MCASP_ENABLE ((uint32_t) 0x01U)
110 #define MCASP_DISABLE ((uint32_t) 0x00U)
115 #define MCASP_REG_OFFSET ((uint32_t)0x4U)
126 #define MCASP_TRANSFER_STATUS_COMPLETED (0U)
128 #define MCASP_TRANSFER_STATUS_STARTED (1U)
130 #define MCASP_TRANSFER_STATUS_CANCELLED (2U)
132 #define MCASP_TRANSFER_STATUS_FAILED (3U)
134 #define MCASP_TRANSFER_STATUS_TIMEOUT (4U)
147 #define MCASP_TRANSFER_MODE_POLLING (0U)
153 #define MCASP_TRANSFER_MODE_INTERRUPT (1U)
158 #define MCASP_TRANSFER_MODE_DMA (2U)
170 #define MCASP_OPMODE_MASTER (0U)
172 #define MCASP_OPMODE_SLAVE (1U)
184 #define MCASP_CHANNEL_INPUT (0x0001U)
186 #define MCASP_CHANNEL_OUTPUT (0x0002U)
188 #define MCASP_CHANNEL_INOUT (MCASP_CHANNEL_INPUT | MCASP_CHANNEL_OUTPUT)
199 #define MCASP_DRIVER_STATE_DELETED (0U)
200 #define MCASP_DRIVER_STATE_CREATED (1U)
201 #define MCASP_DRIVER_STATE_INITIALIZED (2U)
202 #define MCASP_DRIVER_STATE_OPENED (3U)
203 #define MCASP_DRIVER_STATE_CLOSED (4U)
204 #define MCASP_DRIVER_STATE_DEINITIALIZED (5U)
205 #define MCASP_DRIVER_STATE_POWERED_DOWN (6U)
206 #define MCASP_DRIVER_STATE_PWRM_SUSPEND (7U)
217 #define MCASP_SERIALIZER_STATUS_FREE (0U)
218 #define MCASP_SERIALIZER_STATUS_XMT (1U)
219 #define MCASP_SERIALIZER_STATUS_RCV (2U)
230 #define MCASP_CHANNEL_MODE_FREE (0U)
231 #define MCASP_CHANNEL_MODE_XMT_DIT (1U)
232 #define MCASP_CHANNEL_MODE_XMT_TDM (2U)
233 #define MCASP_CHANNEL_MODE_RCV (3U)
244 #define MCASP_WORD_SELECT_LSW (0U)
245 #define MCASP_WORD_SELECT_MSW (1U)
262 #define MCASP_AUDBUFF_FORMAT_1SER_MULTISLOT_NON_INTERLEAVED (0U)
268 #define MCASP_AUDBUFF_FORMAT_1SER_MULTISLOT_INTERLEAVED (1U)
275 #define MCASP_AUDBUFF_FORMAT_MULTISER_MULTISLOT_SEMI_INTERLEAVED_1 (2U)
282 #define MCASP_AUDBUFF_FORMAT_MULTISER_MULTISLOT_SEMI_INTERLEAVED_2 (3U)
293 #define MCASP_TRANSMIT_STATE_TX_RESET (0U)
294 #define MCASP_TRANSMIT_STATE_TX_FLUSH (1U)
295 #define MCASP_TRANSMIT_STATE_LOAD_INIT_BUFFER (2U)
296 #define MCASP_TRANSMIT_STATE_RELEASE_FROM_RESET (3U)
297 #define MCASP_TRANSMIT_STATE_WAIT_EVENT (4U)
298 #define MCASP_TRANSMIT_STATE_PROCESS_EVENT (5U)
299 #define MCASP_TRANSMIT_STATE_LOAD_ACTIVE_BUFFER (6U)
300 #define MCASP_TRANSMIT_STATE_DONE (7U)
301 #define MCASP_TRANSMIT_STATE_SPIN_IDLE (8U)
302 #define MCASP_TRANSMIT_STATE_ERROR (9U)
303 #define MCASP_TRANSMIT_STATE_EXIT (10U)
314 #define MCASP_RECEIVE_STATE_RX_RESET (0U)
315 #define MCASP_RECEIVE_STATE_RX_FLUSH (1U)
316 #define MCASP_RECEIVE_STATE_RELEASE_FROM_RESET (2U)
317 #define MCASP_RECEIVE_STATE_WAIT_EVENT (3U)
318 #define MCASP_RECEIVE_STATE_PROCESS_EVENT (4U)
319 #define MCASP_RECEIVE_STATE_DONE (5U)
320 #define MCASP_RECEIVE_STATE_SPIN_IDLE (6U)
321 #define MCASP_RECEIVE_STATE_ERROR (7U)
322 #define MCASP_RECEIVE_STATE_EXIT (8U)
325 #define MCASP_DIR_OUT 0
326 #define MCASP_DIR_IN 1
328 #define MCASP_TRPD_INVALID_PTR (0xFFFFFFFF)
405 uint32_t serSetup[16u];
458 typedef struct MCASP_DMAChConfig_s
688 uint16_t serStatus[16];
875 if (openPrms !=
NULL)
uint32_t amute
Definition: mcasp/v1/mcasp.h:403
MCASP_Transaction txnLoopjob
Definition: mcasp/v1/mcasp.h:592
uint32_t txLoopjobEnable
Definition: mcasp/v1/mcasp.h:524
const MCASP_Attrs * attrs
Definition: mcasp/v1/mcasp.h:704
void * cqRxEvtHandle
Definition: mcasp/v1/mcasp.h:466
void * args
Definition: mcasp/v1/mcasp.h:354
uint32_t aClk
Definition: mcasp/v1/mcasp.h:376
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:540
MCASP driver object.
Definition: mcasp/v1/mcasp.h:603
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:431
void * rxChHandle
Definition: mcasp/v1/mcasp.h:462
uint32_t pfunc
Definition: mcasp/v1/mcasp.h:393
uint8_t txSlotCount
Definition: mcasp/v1/mcasp.h:516
void * txCbParams
Definition: mcasp/v1/mcasp.h:478
uint8_t frameIndex
Definition: mcasp/v1/mcasp.h:579
MCASP_Handle handle
Definition: mcasp/v1/mcasp.h:607
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:573
void * rxCbParams
Definition: mcasp/v1/mcasp.h:480
uint8_t txSerUsedCount
Definition: mcasp/v1/mcasp.h:508
int32_t status
Definition: mcasp/v1/mcasp.h:569
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:512
HwiP_Object hwiObjTx
Definition: mcasp/v1/mcasp.h:641
#define NULL
Define NULL if not defined.
Definition: csl_types.h:100
uint32_t txLoopjobBufLength
Definition: mcasp/v1/mcasp.h:528
void * txChHandle
Definition: mcasp/v1/mcasp.h:460
uint32_t isTxStarted
Definition: mcasp/v1/mcasp.h:633
SemaphoreP_Object transferSemObj
Definition: mcasp/v1/mcasp.h:639
SemaphoreP_Object lockObj
Definition: mcasp/v1/mcasp.h:637
uint32_t txSlotSize
Definition: mcasp/v1/mcasp.h:696
uint8_t frameCount
Definition: mcasp/v1/mcasp.h:577
void * mcaspPktDmaHandle
Definition: mcasp/v1/mcasp.h:617
MCASP_DmaChConfig * dmaChCfg
Definition: mcasp/v1/mcasp.h:537
MCASP_RxCallbackFxn rxCallbackFxn
Definition: mcasp/v1/mcasp.h:522
uint32_t rxLoopjobBufLength
Definition: mcasp/v1/mcasp.h:534
QueueP_Handle reqQueueHandleTx
Definition: mcasp/v1/mcasp.h:648
uint32_t state
Definition: mcasp/v1/mcasp.h:567
Hardware fifo setup structure.
Definition: mcasp/v1/mcasp.h:413
MCASP_ClockConfig clk
Definition: mcasp/v1/mcasp.h:439
uint32_t isOpen
Definition: mcasp/v1/mcasp.h:486
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:686
MCASP_HwConfig hwCfg
Definition: mcasp/v1/mcasp.h:690
uint32_t fifoStatus
Definition: mcasp/v1/mcasp.h:416
uint32_t dlbCtl
Definition: mcasp/v1/mcasp.h:401
Hardware setup data structure.
Definition: mcasp/v1/mcasp.h:424
void * txTrpdMem
Definition: mcasp/v1/mcasp.h:468
void * mcaspPktDmaDrvObj
Definition: mcasp/v1/mcasp.h:542
uint8_t serCount
Definition: mcasp/v1/mcasp.h:581
uint32_t lastPlayed
Definition: mcasp/v1/mcasp.h:656
uint8_t rxFifoEnable
Definition: mcasp/v1/mcasp.h:667
MCASP_TxCallbackFxn cbFxn
Definition: mcasp/v1/mcasp.h:589
Data structure used with transfer call.
Definition: mcasp/v1/mcasp.h:339
This file contains the Register Desciptions for CSL types.
void * cqTxEvtHandle
Definition: mcasp/v1/mcasp.h:464
MCASP Parameters.
Definition: mcasp/v1/mcasp.h:501
int32_t MCASP_stopTransferRx(MCASP_Handle handle)
Function to stop McASP reception.
uint32_t transferMode
Definition: mcasp/v1/mcasp.h:502
MCASP_TransferObj XmtObj
Definition: mcasp/v1/mcasp.h:623
MCASP instance attributes - used during init time.
Definition: mcasp/v1/mcasp.h:674
uint16_t evntNum
Definition: mcasp/v1/mcasp.h:553
uint32_t count
Definition: mcasp/v1/mcasp.h:346
Hardware setup global structure.
Definition: mcasp/v1/mcasp.h:392
uint8_t intrPriority
Definition: mcasp/v1/mcasp.h:555
MCASP_DataConfig tx
Definition: mcasp/v1/mcasp.h:454
Definition: mcasp/v1/mcasp.h:703
void(* MCASP_RxCallbackFxn)(MCASP_Handle handle, MCASP_Transaction *transaction)
Definition: mcasp/v1/mcasp.h:368
void * rxRingMem
Definition: mcasp/v1/mcasp.h:476
uint32_t lastRecQueued
Definition: mcasp/v1/mcasp.h:662
void MCASP_deinit(void)
This function de-initializes the MCASP module.
MCASP_Transaction * transaction
Definition: mcasp/v1/mcasp.h:587
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:585
uint32_t count
Definition: mcasp/v1/mcasp.h:571
void * txRingMem
Definition: mcasp/v1/mcasp.h:474
void * mcaspDmaHandle
Definition: mcasp/v1/mcasp.h:615
uint8_t rxBufferFormat
Definition: mcasp/v1/mcasp.h:506
uint32_t ditCtl
Definition: mcasp/v1/mcasp.h:399
uint32_t evtCtl
Definition: mcasp/v1/mcasp.h:437
MCASP_TransferObj RcvObj
Definition: mcasp/v1/mcasp.h:625
uint32_t rxSlotSize
Definition: mcasp/v1/mcasp.h:698
uint32_t loopjobEnable
Definition: mcasp/v1/mcasp.h:594
MCASP_DataConfig rx
Definition: mcasp/v1/mcasp.h:452
uint32_t hiClk
Definition: mcasp/v1/mcasp.h:378
MCASP_TxCallbackFxn txCallbackFxn
Definition: mcasp/v1/mcasp.h:520
uint32_t trpdMemSize
Definition: mcasp/v1/mcasp.h:472
QueueP_Elem qElem
Definition: mcasp/v1/mcasp.h:340
uintptr_t baseAddr
Definition: mcasp/v1/mcasp.h:680
int32_t status
Definition: mcasp/v1/mcasp.h:352
uint8_t rxSlotCount
Definition: mcasp/v1/mcasp.h:518
Opaque task object used with the task APIs.
Definition: QueueP.h:92
Hardware setup data clock structure.
Definition: mcasp/v1/mcasp.h:375
uint32_t inProgress
Definition: mcasp/v1/mcasp.h:565
uint32_t gblCtl
Definition: mcasp/v1/mcasp.h:397
uint32_t frSyncCtl
Definition: mcasp/v1/mcasp.h:429
QueueP_Object completedQueueObjRx
Definition: mcasp/v1/mcasp.h:651
uintptr_t dataBaseAddr
Definition: mcasp/v1/mcasp.h:682
uint8_t isHClkExt
Definition: mcasp/v1/mcasp.h:382
uint32_t isOpen
Definition: mcasp/v1/mcasp.h:631
uint32_t intCtl
Definition: mcasp/v1/mcasp.h:433
void * QueueP_Handle
Opaque client reference to an instance of a QueueP.
Definition: QueueP.h:68
uint32_t txEvtNum
Definition: mcasp/v1/mcasp.h:484
uint32_t rxLoopjobEnable
Definition: mcasp/v1/mcasp.h:530
uint8_t txFifoEnable
Definition: mcasp/v1/mcasp.h:665
uint32_t stat
Definition: mcasp/v1/mcasp.h:435
static void MCASP_openParamsInit(MCASP_OpenParams *openPrms)
Function to initialize the MCASP_OpenParams struct to its defaults.
Definition: mcasp/v1/mcasp.h:873
MCASP_GlobalConfig gbl
Definition: mcasp/v1/mcasp.h:450
void * MCASP_Handle
A handle that is returned from a MCASP_open() call.
Definition: mcasp/v1/mcasp.h:93
QueueP_Handle completedQueueHandleRx
Definition: mcasp/v1/mcasp.h:653
uint32_t pdir
Definition: mcasp/v1/mcasp.h:395
Opaque Hwi object used with the Hwi APIs.
Definition: HwiP.h:93
QueueP_Object reqQueueObjTx
Definition: mcasp/v1/mcasp.h:646
uint32_t transferMode
Definition: mcasp/v1/mcasp.h:613
UDMA Driver API/interface file.
uint32_t intrNum
Definition: mcasp/v1/mcasp.h:551
McASP Interrupt structures.
Definition: mcasp/v1/mcasp.h:550
int32_t MCASP_startTransferRx(MCASP_Handle handle)
Function to start McASP reception.
uint32_t fmt
Definition: mcasp/v1/mcasp.h:427
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:365
McASP Transfer Data structure stored in driver object.
Definition: mcasp/v1/mcasp.h:564
MCASP_DmaChConfig * dmaChCfg
Definition: mcasp/v1/mcasp.h:620
MCASP_HwIntConfig intCfgRx
Definition: mcasp/v1/mcasp.h:694
Opaque semaphore object used with the semaphore APIs.
Definition: SemaphoreP.h:59
uint32_t rxEvtNum
Definition: mcasp/v1/mcasp.h:482
uint32_t clkChk
Definition: mcasp/v1/mcasp.h:380
uint32_t lastFilled
Definition: mcasp/v1/mcasp.h:658
uint8_t rxSerUsedCount
Definition: mcasp/v1/mcasp.h:510
uint8_t isSynchronous
Definition: mcasp/v1/mcasp.h:684
MCASP_HwIntConfig intCfgTx
Definition: mcasp/v1/mcasp.h:692
uint32_t instNum
Definition: mcasp/v1/mcasp.h:678
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:583
uint32_t timeout
Definition: mcasp/v1/mcasp.h:350
uint8_t * rxLoopjobBuf
Definition: mcasp/v1/mcasp.h:532
MCASP_FifoConfig fifoCfg
Definition: mcasp/v1/mcasp.h:441
uint16_t instNum
Definition: mcasp/v1/mcasp.h:609
uint8_t slotIndex
Definition: mcasp/v1/mcasp.h:575
void * buf
Definition: mcasp/v1/mcasp.h:343
void * rxTrpdMem
Definition: mcasp/v1/mcasp.h:470
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:459
HwiP_Object hwiObjRx
Definition: mcasp/v1/mcasp.h:643
uint32_t isRxStarted
Definition: mcasp/v1/mcasp.h:635
MCASP_Object * object
Definition: mcasp/v1/mcasp.h:706
uint32_t hClkExt
Definition: mcasp/v1/mcasp.h:384
void MCASP_init(void)
This function initializes the MCASP module.
uint32_t fifoCtl
Definition: mcasp/v1/mcasp.h:414
uint8_t * txLoopjobBuf
Definition: mcasp/v1/mcasp.h:526
Hardware setup structure.
Definition: mcasp/v1/mcasp.h:449
uint8_t * rxSerUsedArray
Definition: mcasp/v1/mcasp.h:514
uint32_t mask
Definition: mcasp/v1/mcasp.h:425
uint32_t drvState
Definition: mcasp/v1/mcasp.h:611
uint8_t txBufferFormat
Definition: mcasp/v1/mcasp.h:504
uint32_t lastReceived
Definition: mcasp/v1/mcasp.h:660
int32_t MCASP_stopTransferTx(MCASP_Handle handle)
Function to stop McASP transmission.