 |
AM275 FreeRTOS SDK
10.01.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_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>
84 #if defined (SOC_AM275X)
85 #include <drivers/mcasp/v1/soc/am275x/mcasp_soc.h>
103 #define MCASP_GBLCTL_TIMEOUT (30000U)
109 #define MCASP_DATA_TIMEOUT (30000U)
112 #define MCASP_RESET ((uint32_t) 0x00U)
113 #define MCASP_ENABLE ((uint32_t) 0x01U)
114 #define MCASP_DISABLE ((uint32_t) 0x00U)
119 #define MCASP_REG_OFFSET ((uint32_t)0x4U)
130 #define MCASP_TRANSFER_STATUS_COMPLETED (0U)
132 #define MCASP_TRANSFER_STATUS_STARTED (1U)
134 #define MCASP_TRANSFER_STATUS_CANCELLED (2U)
136 #define MCASP_TRANSFER_STATUS_FAILED (3U)
138 #define MCASP_TRANSFER_STATUS_TIMEOUT (4U)
151 #define MCASP_TRANSFER_MODE_POLLING (0U)
157 #define MCASP_TRANSFER_MODE_INTERRUPT (1U)
162 #define MCASP_TRANSFER_MODE_DMA (2U)
174 #define MCASP_OPMODE_MASTER (0U)
176 #define MCASP_OPMODE_SLAVE (1U)
188 #define MCASP_CHANNEL_INPUT (0x0001U)
190 #define MCASP_CHANNEL_OUTPUT (0x0002U)
192 #define MCASP_CHANNEL_INOUT (MCASP_CHANNEL_INPUT | MCASP_CHANNEL_OUTPUT)
203 #define MCASP_DRIVER_STATE_DELETED (0U)
204 #define MCASP_DRIVER_STATE_CREATED (1U)
205 #define MCASP_DRIVER_STATE_INITIALIZED (2U)
206 #define MCASP_DRIVER_STATE_OPENED (3U)
207 #define MCASP_DRIVER_STATE_CLOSED (4U)
208 #define MCASP_DRIVER_STATE_DEINITIALIZED (5U)
209 #define MCASP_DRIVER_STATE_POWERED_DOWN (6U)
210 #define MCASP_DRIVER_STATE_PWRM_SUSPEND (7U)
221 #define MCASP_SERIALIZER_STATUS_FREE (0U)
222 #define MCASP_SERIALIZER_STATUS_XMT (1U)
223 #define MCASP_SERIALIZER_STATUS_RCV (2U)
234 #define MCASP_CHANNEL_MODE_FREE (0U)
235 #define MCASP_CHANNEL_MODE_XMT_DIT (1U)
236 #define MCASP_CHANNEL_MODE_XMT_TDM (2U)
237 #define MCASP_CHANNEL_MODE_RCV (3U)
248 #define MCASP_WORD_SELECT_LSW (0U)
249 #define MCASP_WORD_SELECT_MSW (1U)
266 #define MCASP_AUDBUFF_FORMAT_1SER_MULTISLOT_NON_INTERLEAVED (0U)
272 #define MCASP_AUDBUFF_FORMAT_1SER_MULTISLOT_INTERLEAVED (1U)
279 #define MCASP_AUDBUFF_FORMAT_MULTISER_MULTISLOT_SEMI_INTERLEAVED_1 (2U)
286 #define MCASP_AUDBUFF_FORMAT_MULTISER_MULTISLOT_SEMI_INTERLEAVED_2 (3U)
297 #define MCASP_TRANSMIT_STATE_TX_RESET (0U)
298 #define MCASP_TRANSMIT_STATE_TX_FLUSH (1U)
299 #define MCASP_TRANSMIT_STATE_LOAD_INIT_BUFFER (2U)
300 #define MCASP_TRANSMIT_STATE_RELEASE_FROM_RESET (3U)
301 #define MCASP_TRANSMIT_STATE_WAIT_EVENT (4U)
302 #define MCASP_TRANSMIT_STATE_PROCESS_EVENT (5U)
303 #define MCASP_TRANSMIT_STATE_LOAD_ACTIVE_BUFFER (6U)
304 #define MCASP_TRANSMIT_STATE_DONE (7U)
305 #define MCASP_TRANSMIT_STATE_SPIN_IDLE (8U)
306 #define MCASP_TRANSMIT_STATE_ERROR (9U)
307 #define MCASP_TRANSMIT_STATE_EXIT (10U)
318 #define MCASP_RECEIVE_STATE_RX_RESET (0U)
319 #define MCASP_RECEIVE_STATE_RX_FLUSH (1U)
320 #define MCASP_RECEIVE_STATE_RELEASE_FROM_RESET (2U)
321 #define MCASP_RECEIVE_STATE_WAIT_EVENT (3U)
322 #define MCASP_RECEIVE_STATE_PROCESS_EVENT (4U)
323 #define MCASP_RECEIVE_STATE_DONE (5U)
324 #define MCASP_RECEIVE_STATE_SPIN_IDLE (6U)
325 #define MCASP_RECEIVE_STATE_ERROR (7U)
326 #define MCASP_RECEIVE_STATE_EXIT (8U)
329 #define MCASP_DIR_OUT 0
330 #define MCASP_DIR_IN 1
332 #define MCASP_TRPD_INVALID_PTR (0xFFFFFFFF)
409 uint32_t serSetup[16u];
462 typedef struct MCASP_DMAChConfig_s
695 uint16_t serStatus[16];
882 if (openPrms != NULL)
uint32_t amute
Definition: mcasp/v1/mcasp.h:407
MCASP_Transaction txnLoopjob
Definition: mcasp/v1/mcasp.h:599
uint32_t txLoopjobEnable
Definition: mcasp/v1/mcasp.h:528
const MCASP_Attrs * attrs
Definition: mcasp/v1/mcasp.h:711
void * cqRxEvtHandle
Definition: mcasp/v1/mcasp.h:470
void * args
Definition: mcasp/v1/mcasp.h:358
uint32_t aClk
Definition: mcasp/v1/mcasp.h:380
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:544
MCASP driver object.
Definition: mcasp/v1/mcasp.h:610
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:435
void * rxChHandle
Definition: mcasp/v1/mcasp.h:466
uint32_t pfunc
Definition: mcasp/v1/mcasp.h:397
uint8_t txSlotCount
Definition: mcasp/v1/mcasp.h:520
void * txCbParams
Definition: mcasp/v1/mcasp.h:482
uint8_t frameIndex
Definition: mcasp/v1/mcasp.h:586
MCASP_Handle handle
Definition: mcasp/v1/mcasp.h:614
MCASP_Config gMcaspConfig[]
Externally defined driver configuration array.
uint16_t index
Definition: tisci_rm_proxy.h:3
uint8_t skipDriverOpen
Definition: mcasp/v1/mcasp.h:549
uint8_t slotCount
Definition: mcasp/v1/mcasp.h:580
void * rxCbParams
Definition: mcasp/v1/mcasp.h:484
uint8_t txSerUsedCount
Definition: mcasp/v1/mcasp.h:512
int32_t status
Definition: mcasp/v1/mcasp.h:576
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:516
HwiP_Object hwiObjTx
Definition: mcasp/v1/mcasp.h:648
uint32_t txLoopjobBufLength
Definition: mcasp/v1/mcasp.h:532
void * txChHandle
Definition: mcasp/v1/mcasp.h:464
uint32_t isTxStarted
Definition: mcasp/v1/mcasp.h:640
SemaphoreP_Object transferSemObj
Definition: mcasp/v1/mcasp.h:646
SemaphoreP_Object lockObj
Definition: mcasp/v1/mcasp.h:644
uint32_t txSlotSize
Definition: mcasp/v1/mcasp.h:703
uint8_t frameCount
Definition: mcasp/v1/mcasp.h:584
void * mcaspPktDmaHandle
Definition: mcasp/v1/mcasp.h:624
MCASP_DmaChConfig * dmaChCfg
Definition: mcasp/v1/mcasp.h:541
MCASP_RxCallbackFxn rxCallbackFxn
Definition: mcasp/v1/mcasp.h:526
uint32_t rxLoopjobBufLength
Definition: mcasp/v1/mcasp.h:538
QueueP_Handle reqQueueHandleTx
Definition: mcasp/v1/mcasp.h:655
uint32_t state
Definition: mcasp/v1/mcasp.h:574
Hardware fifo setup structure.
Definition: mcasp/v1/mcasp.h:417
MCASP_ClockConfig clk
Definition: mcasp/v1/mcasp.h:443
uint32_t isOpen
Definition: mcasp/v1/mcasp.h:490
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:693
MCASP_HwConfig hwCfg
Definition: mcasp/v1/mcasp.h:697
uint32_t fifoStatus
Definition: mcasp/v1/mcasp.h:420
uint32_t dlbCtl
Definition: mcasp/v1/mcasp.h:405
Hardware setup data structure.
Definition: mcasp/v1/mcasp.h:428
void * txTrpdMem
Definition: mcasp/v1/mcasp.h:472
void * mcaspPktDmaDrvObj
Definition: mcasp/v1/mcasp.h:546
uint8_t serCount
Definition: mcasp/v1/mcasp.h:588
uint32_t lastPlayed
Definition: mcasp/v1/mcasp.h:663
uint8_t rxFifoEnable
Definition: mcasp/v1/mcasp.h:674
MCASP_TxCallbackFxn cbFxn
Definition: mcasp/v1/mcasp.h:596
Data structure used with transfer call.
Definition: mcasp/v1/mcasp.h:343
void * cqTxEvtHandle
Definition: mcasp/v1/mcasp.h:468
MCASP Parameters.
Definition: mcasp/v1/mcasp.h:505
int32_t MCASP_stopTransferRx(MCASP_Handle handle)
Function to stop McASP reception.
uint32_t transferMode
Definition: mcasp/v1/mcasp.h:506
MCASP_TransferObj XmtObj
Definition: mcasp/v1/mcasp.h:630
MCASP instance attributes - used during init time.
Definition: mcasp/v1/mcasp.h:681
uint16_t evntNum
Definition: mcasp/v1/mcasp.h:560
uint32_t count
Definition: mcasp/v1/mcasp.h:350
Hardware setup global structure.
Definition: mcasp/v1/mcasp.h:396
uint8_t intrPriority
Definition: mcasp/v1/mcasp.h:562
MCASP_DataConfig tx
Definition: mcasp/v1/mcasp.h:458
Definition: mcasp/v1/mcasp.h:710
void(* MCASP_RxCallbackFxn)(MCASP_Handle handle, MCASP_Transaction *transaction)
Definition: mcasp/v1/mcasp.h:372
void * rxRingMem
Definition: mcasp/v1/mcasp.h:480
uint32_t lastRecQueued
Definition: mcasp/v1/mcasp.h:669
void MCASP_deinit(void)
This function de-initializes the MCASP module.
MCASP_Transaction * transaction
Definition: mcasp/v1/mcasp.h:594
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:592
uint32_t count
Definition: mcasp/v1/mcasp.h:578
void * txRingMem
Definition: mcasp/v1/mcasp.h:478
void * mcaspDmaHandle
Definition: mcasp/v1/mcasp.h:622
uint8_t rxBufferFormat
Definition: mcasp/v1/mcasp.h:510
uint32_t ditCtl
Definition: mcasp/v1/mcasp.h:403
uint32_t evtCtl
Definition: mcasp/v1/mcasp.h:441
MCASP_TransferObj RcvObj
Definition: mcasp/v1/mcasp.h:632
uint32_t rxSlotSize
Definition: mcasp/v1/mcasp.h:705
uint32_t loopjobEnable
Definition: mcasp/v1/mcasp.h:601
MCASP_DataConfig rx
Definition: mcasp/v1/mcasp.h:456
uint32_t hiClk
Definition: mcasp/v1/mcasp.h:382
MCASP_TxCallbackFxn txCallbackFxn
Definition: mcasp/v1/mcasp.h:524
uint32_t trpdMemSize
Definition: mcasp/v1/mcasp.h:476
QueueP_Elem qElem
Definition: mcasp/v1/mcasp.h:344
uintptr_t baseAddr
Definition: mcasp/v1/mcasp.h:687
int32_t status
Definition: mcasp/v1/mcasp.h:356
uint8_t rxSlotCount
Definition: mcasp/v1/mcasp.h:522
Opaque task object used with the task APIs.
Definition: QueueP.h:92
Hardware setup data clock structure.
Definition: mcasp/v1/mcasp.h:379
uint32_t inProgress
Definition: mcasp/v1/mcasp.h:572
uint32_t gblCtl
Definition: mcasp/v1/mcasp.h:401
uint32_t frSyncCtl
Definition: mcasp/v1/mcasp.h:433
QueueP_Object completedQueueObjRx
Definition: mcasp/v1/mcasp.h:658
uintptr_t dataBaseAddr
Definition: mcasp/v1/mcasp.h:689
uint8_t isHClkExt
Definition: mcasp/v1/mcasp.h:386
uint32_t isOpen
Definition: mcasp/v1/mcasp.h:638
uint32_t intCtl
Definition: mcasp/v1/mcasp.h:437
void * QueueP_Handle
Opaque client reference to an instance of a QueueP.
Definition: QueueP.h:68
uint32_t txEvtNum
Definition: mcasp/v1/mcasp.h:488
uint32_t rxLoopjobEnable
Definition: mcasp/v1/mcasp.h:534
uint8_t txFifoEnable
Definition: mcasp/v1/mcasp.h:672
uint32_t stat
Definition: mcasp/v1/mcasp.h:439
static void MCASP_openParamsInit(MCASP_OpenParams *openPrms)
Function to initialize the MCASP_OpenParams struct to its defaults.
Definition: mcasp/v1/mcasp.h:880
MCASP_GlobalConfig gbl
Definition: mcasp/v1/mcasp.h:454
void * MCASP_Handle
A handle that is returned from a MCASP_open() call.
Definition: mcasp/v1/mcasp.h:97
QueueP_Handle completedQueueHandleRx
Definition: mcasp/v1/mcasp.h:660
uint32_t pdir
Definition: mcasp/v1/mcasp.h:399
Opaque Hwi object used with the Hwi APIs.
Definition: HwiP.h:93
QueueP_Object reqQueueObjTx
Definition: mcasp/v1/mcasp.h:653
uint32_t transferMode
Definition: mcasp/v1/mcasp.h:620
UDMA Driver API/interface file.
uint32_t intrNum
Definition: mcasp/v1/mcasp.h:558
McASP Interrupt structures.
Definition: mcasp/v1/mcasp.h:557
int32_t MCASP_startTransferRx(MCASP_Handle handle)
Function to start McASP reception.
uint32_t fmt
Definition: mcasp/v1/mcasp.h:431
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:369
McASP Transfer Data structure stored in driver object.
Definition: mcasp/v1/mcasp.h:571
MCASP_DmaChConfig * dmaChCfg
Definition: mcasp/v1/mcasp.h:627
MCASP_HwIntConfig intCfgRx
Definition: mcasp/v1/mcasp.h:701
Opaque semaphore object used with the semaphore APIs.
Definition: SemaphoreP.h:59
uint32_t rxEvtNum
Definition: mcasp/v1/mcasp.h:486
uint32_t clkChk
Definition: mcasp/v1/mcasp.h:384
uint32_t lastFilled
Definition: mcasp/v1/mcasp.h:665
uint8_t rxSerUsedCount
Definition: mcasp/v1/mcasp.h:514
uint8_t isSynchronous
Definition: mcasp/v1/mcasp.h:691
MCASP_HwIntConfig intCfgTx
Definition: mcasp/v1/mcasp.h:699
uint32_t instNum
Definition: mcasp/v1/mcasp.h:685
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:590
uint32_t timeout
Definition: mcasp/v1/mcasp.h:354
uint8_t * rxLoopjobBuf
Definition: mcasp/v1/mcasp.h:536
MCASP_FifoConfig fifoCfg
Definition: mcasp/v1/mcasp.h:445
uint16_t instNum
Definition: mcasp/v1/mcasp.h:616
uint8_t slotIndex
Definition: mcasp/v1/mcasp.h:582
void * buf
Definition: mcasp/v1/mcasp.h:347
void * rxTrpdMem
Definition: mcasp/v1/mcasp.h:474
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:463
HwiP_Object hwiObjRx
Definition: mcasp/v1/mcasp.h:650
uint32_t isRxStarted
Definition: mcasp/v1/mcasp.h:642
MCASP_Object * object
Definition: mcasp/v1/mcasp.h:713
uint32_t hClkExt
Definition: mcasp/v1/mcasp.h:388
void MCASP_init(void)
This function initializes the MCASP module.
uint32_t fifoCtl
Definition: mcasp/v1/mcasp.h:418
uint8_t * txLoopjobBuf
Definition: mcasp/v1/mcasp.h:530
Hardware setup structure.
Definition: mcasp/v1/mcasp.h:453
uint8_t * rxSerUsedArray
Definition: mcasp/v1/mcasp.h:518
uint32_t mask
Definition: mcasp/v1/mcasp.h:429
uint32_t drvState
Definition: mcasp/v1/mcasp.h:618
uint8_t txBufferFormat
Definition: mcasp/v1/mcasp.h:508
uint32_t lastReceived
Definition: mcasp/v1/mcasp.h:667
int32_t MCASP_stopTransferTx(MCASP_Handle handle)
Function to stop McASP transmission.