EDMA3 Driver Introduction
1-2
1.1
Overview
This section describes the functional scope of the
EDMA3 Driver
and its
feature set.
A brief definition of the component is provided at this point – its main
characteristics and purpose.
1.1.1
System Partitioning
EDMA3 peripheral supports data transfers between two memory mapped
devices. It supports EDMA as well as QDMA channels for data transfer.
This peripheral IP is being re-used in different SoCs with only a few
configuration changes like number of DMA and QDMA channels supported,
number of PARAM sets available, number of event queues and transfer
controllers etc.
The EDMA3 peripheral is used by other peripherals for their DMA needs
thus the EDMA3 Driver needs to cater to the requirements of device
drivers of these peripherals as well as other application software that may
need to use the 3
rd
party DMA services.
The
EDMA3 Driver
provides functionality that allows device drivers and
applications for submitting and synchronizing with EDMA3 based DMA
transfers. In order to simplify the usage, this component internally uses
the services of the
EDMA3 Resource Manager
and provides one
consistent interface for applications or device drivers.
The
EDMA3 Resource Manager
comprises of the following two parts:
Physical Driver
: This component is responsible for the management
of several resources within the EDMA3 peripheral like DMA and QDMA
channels, TCC codes, PARAM entry, all global EDMA3 registers, queues
etc.
Interrupt Manager
: This module provides the different interrupt
handlers (ISRs) for various EDMA3 interrupts like transfer completion
interrupt, CC error interrupt and TC error interrupt. Since interrupts
could be associated with TCC codes in EDMA3, this module also
provides the functionality of accepting application registration callbacks
for TCC codes and calls the callback functions upon receipt of the given
interrupt (TCC).
Moreover, these ISRs are NOT registered with the underlying OS, since
Resource Manager is an OS-agnostic module. The user application has
to do the registration / un-registration of ISRs by itself.
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 ...