Sg-dma api, Sg-dma api -17 – Altera Embedded Peripherals IP User Manual

Page 208

Advertising
background image

Table 21-14: Descriptor Data Structure

typedef struct {
alt_u32 *read_addr;
alt_u32 read_addr_pad;
alt_u32 *write_addr;
alt_u32 write_addr_pad;
alt_u32 *next;
alt_u32 next_pad;
alt_u16 bytes_to_transfer;
alt_u8 read_burst; /* Reserved field. Set to 0. */
alt_u8 write_burst;/* Reserved field. Set to 0. */
alt_u16 actual_bytes_transferred;
alt_u8 status;
alt_u8 control;
} alt_avalon_sgdma_packed alt_sgdma_descriptor;

SG-DMA API

Table 21-15: Function List

Name

Description

alt_avalon_sgdma_do_async_transfer()

Starts a non-blocking transfer of a descriptor chain.

alt_avalon_sgdma_do_sync_transfer()

Starts a blocking transfer of a descriptor chain. This

function blocks both before transfer if the controller

is busy and until the requested transfer has

completed.

alt_avalon_sgdma_construct_mem_to_

mem_desc

()

Constructs a single SG-DMA descriptor in the

specified memory for an Avalon-MM to Avalon-

MM transfer.

alt_avalon_sgdma_construct_stream_

to_mem_desc

()

Constructs a single SG-DMA descriptor in the

specified memory for an Avalon-ST to Avalon-MM

transfer. The function automatically terminates the

descriptor chain with a NULL descriptor.

alt_avalon_sgdma_construct_mem_to_

stream_desc

()

Constructs a single SG-DMA descriptor in the

specified memory for an Avalon-MM to Avalon-ST

transfer.

alt_avalon_sgdma_check_descriptor_

status()

Reads the status of a given descriptor.

UG-01085

2014.24.07

SG-DMA API

21-17

Scatter-Gather DMA Controller Core

Altera Corporation

Send Feedback

Advertising