1.37.5.11 DMAC_ChannelLinkedListTransfer Function

C

bool DMAC_ChannelLinkedListTransfer ( DMAC_CHANNEL channel,
dmacdescriptor_registers_t * channelDesc );

Summary

The function submit a list of DMA transfers.

Description

The function will submit a list of DMA transfers. The DMA channel will process all transfers in the list. The transfers will be processed in the order in which they added to the list. Each transfer in the list is specified by a DmacDescriptor type descriptor. The list is formed by linking of the descriptors. While processing each descriptor in the linked list, the DMA transfer settings will be updated based on the settings contained in the descriptor.

It is possible to link the last descriptor in the list to the first descriptor. This results in an continuous transfer sequence. Such type of circular linked descriptor list are useful in audio applications. The DMAC module will generate a callback for each transfer in the descriptor list. The application must keep track of transfer being completed and should only modify the descriptors which have been processed.

The application must submit the entire list while calling the function. Adding or inserting of descriptors to a submitted list is not supported. The application can change the transfer parameters such as transfer beat size, source and address increment step size. This will override the transfer setting defined in MHC.

The BLOCKACT field of the last DMA transfer descriptor in the descriptor linked list should be set to the value 0x0 i.e. this should be set to disable the channel when the last transfer has been completed. Setting this field to any other value will interfere with the operation of the DMAC peripheral library.

When already a transfer is in progress, this API will return false indicating that transfer request is not accepted.

Precondition

DMAC should have been initialized by calling DMAC_Initialize. The Transfer Linked Option in MHC should have been enabled.

Parameters

Returns

- True - If transfer request is accepted.

- False - If previous transfer is in progress and the request is rejected.

Example

// Process a transfer list called transferList. Refer to the DMAC PLIB demo
// application example for more details on usage.
if (DMAC_ChannelLinkedListTransfer(DMAC_CHANNEL_0, transferList) == true)
{
    // do something else
}
else
{
    // try again?
}

Remarks

None.