Run-Time Interfaces/Integration Guide
I-A-43
3.3.3.13
EDMA3_DRV_chainChannel ()
Prototype
EDMA3_DRV_Result EDMA3_DRV_chainChannel
(EDMA3_DRV_Handle hEdma, unsigned int lCh1,
unsigned int lCh2, const EDMA3_DRV_ChainOptions
*chainOptions);
Description
Chain the two specified channels.
This API is used to chain two previously allocated
logical (DMA/QDMA) channels.
Chaining is different from Linking. The EDMA3 link
feature reloads the current channel parameter set
with the linked parameter set. The EDMA3 chaining
feature does not modify or update any channel
parameter set; it provides a synchronization event to
the chained channel.
<arg1>
hEdma
[IN] Handle to the EDMA3 Driver
Instance.
<arg2>
lCh1
[IN]
Channel to which particular
channel will be chained.
A
rg
u
m
e
n
ts
<arg3>
lCh2
[IN]
Channel which needs to be
chained to the first channel.
<arg4>
chainOptions [IN]
Options such as
intermediate/final interrupts are
required or not, intermediate/final chaining is
enabled or not etc.
Return value
EDMA3_DRV_SOK or EDMA3_DRV Error Code in case
of error.
Calling
constraints
Example
result = EDMA3_DRV_chainChannel (hEdma, ch1Id,
ch2Id, chainOpt);
Comments
a) The channel chaining capability allows the
completion of an EDMA3 channel transfer to
trigger another EDMA3 channel transfer. The
purpose is to provide the ability to chain several
events through one event occurrence.
Chaining is different from linking. The EDMA3 link
feature reloads the current channel parameter set
with the linked parameter set. The EDMA3
chaining feature does not modify or update any
channel
parameter
set;
it
provides
a
synchronization event to the chained channel.
b) This function is re-entrant for unique lCh1 & lCh2
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 ...