Run-Time Interfaces/Integration Guide
I-A-29
3.3.3
Control
This section lists all the
EDMA3 Driver
APIs that are intended for
use in
controlling
the functioning of
EDMA3 Driver
during run-
time.
3.3.3.1
EDMA3_DRV_requestChannel ()
Prototype
EDMA3_DRV_Result EDMA3_DRV_requestChannel
(EDMA3_DRV_Handle hEdma, unsigned int *pLCh,
unsigned int *pTcc, EDMA3_RM_EventQueue
evtQueue, EDMA3_RM_TccCallback tccCb, void
*cbData)
Description
This API is used to request for a DMA channel. Each
channel (DMA/QDMA/Link) must be requested before
initiating a DMA transfer on that channel. The event
queue to which the requested channel should be
mapped is also specified. Generally, event queue 0
has higher priority than event queue 1.
<arg1>
hEdma
[IN] Handle to the EDMA3 Driver
Instance.
<arg2>
pLch
[IN/OUT]
Requested logical
channel number.
<arg3>
pTcc
[IN/OUT]
The channel number on
which the
completion/error interrupt is generated.
<arg4>
evtQueue
[IN]
Event Queue Number to which
the channel will be mapped
(valid only for the Master Channel request).
A
rg
u
m
e
n
ts
<arg5>
tccCb
[IN]
TCC callback - caters to
channel-specific events like
"Event Miss Error" or "Transfer Complete".
<arg6>
cbData
[IN]
Data which will be passed
directly to the tccCb callback
function.
Return value
EDMA3_DRV_SOK or EDMA3_DRV Error Code in case
of error.
Calling
constraints
This function internally uses EDMA3 Resource
Manager, which acquires a RM Instance specific
semaphore to prevent simultaneous access to the
global pool of resources.
It also disables the global
interrupts while modifying the global CC registers. It
is re-entrant, but SHOULD NOT be called from the
Summary of Contents for EDMA3
Page 12: ......
Page 17: ...EDMA3 Driver Introduction I 1 5 ...
Page 20: ......
Page 40: ...Run Time Interfaces Integration Guide A 12 EDMA3_DRV_IOCTL_MAX_IOCTL Max IOCTL ...
Page 75: ...Run Time Interfaces Integration Guide I A 47 Errors EDMA3_DRV_E_INVALID_PARAM ...
Page 107: ...Run Time Interfaces Integration Guide I A 79 ...