
E-2
DINK32 PowerPC ISA Debugger User’s Manual
For More Information On This Product,
Go to: www.freescale.com
MOTOROLA
MPC8240 DMA Memory Controller
NOTE
The DMA driver software is currently under development. The
only mode that is functional is a direct transfer (chaining is not
yet implemented). Only transfers to and from local memory has
been tested. Controlling a remote agent processor is not yet
implemented. Of the various DMA transfer control options
implemented in Kahlua, the only ones currently available in
this release of the DMA library are source address, destination
address, length, channel, interrupt steering and snoop enable.
E.1.2
Overview
This document consists of these parts:
An Application Program Interface (API) which provides a very simple, "generic",
application level programmatic interface to the DMA driver library that hides all
details of the Kahlua-specific implementation of the interface (i.e., control register,
status register, embedded utilities memory block, etc.). Features provided by the
Kahlua implementation that may or may not be common with other implementations
(i.e., not "generic" DMA operations) are made available to the application; however,
the interface is controlled by passing parameters defined in the API rather than the
application having to have any knowledge of the Kahlua implementation (i.e.,
registers, embedded utilities memory block, etc.) The API will be expanded to
include chaining mode and additional DMA transfer control features in future
releases.
DMA API functions showing the following:
— how the function is called (i.e., function prototype) parameter definition possible
return values brief description of what the function does
— an explanation of how the functions are used by an application program
(DINK32 usage employed as examples)
A DMA Driver Library Internals (DLI) which provides information about the lower
level software that is accessing the Kahlua-specific implementation of the DMA
interface.
DMA DLI functions showing the following:
— how the function is called (i.e., function prototype)
— parameter definition possible
— return values
— brief description of what the function does
F
n
.