Dma Manager Termination - Analog Devices VisualDSP++ 5.0 Service Manual

When called, the initialization function,
memory that was passed in. Like all functions within the DMA manager,
the initialization function returns a return code that indicates success or
the specific error that occurred during the function call. All DMA API
functions return the
All error codes are of the form
In addition to the return code, the
count of the number of channels it can manage simultaneously and a
handle to the DMA manager. The channel count can be tested to ensure
that the DMA manager can control the requested number of channels.
The DMA manager handle value that is returned is later passed into the
adi_dma_Open
handle to identify the DMA manager that is to control the channel.
Passing in this handle allows these functions to quickly identify the mem-
ory that is used to manage the open channel(s). After the DMA manager is
initialized, DMA channels and memory streams can be opened for use.
Although it is possible to create multiple DMA managers in a single-core
Blackfin system, there is no practical advantage in doing so.

DMA Manager Termination

When the DMA manager is no longer needed, the client can terminate the
DMA manager with the
passed the DMA manager handle given to the client in the
function. The DMA manager closes any open channels and streams and
then returns to the caller. After the return from the
function, the memory that was supplied to the DMA manager via the
adi_dma_Init()
In many embedded systems, the DMA manager is never
terminated.
VisualDSP++ 5.0 Device Drivers and System
Services Manual for Blackfin Processors
ADI_DMA_RESULT_SUCCESS
ADI_DMA_RESULT_XXXX
and
adi_dma_MemoryOpen
adi_dma_Terminate
function can be reused by the client.
adi_dma_Init()
value to indicate success.
.
function returns a
adi_dma_Init()
functions which use the manager
function. This function is
adi_dma_Terminate()
DMA Manager
, initializes the
adi_dma_Init
6-5