Data Structures
struct	XCsuDma_Config
	This typedef contains configuration information for a CSU_DMA core. More...

struct	XCsuDma
	The XCsuDma driver instance data structure. More...

struct	XCsuDma_Configure
	This typedef contains all the configuration feilds which must be set before the start of the data transfer. More...

Macros
#define	XCSUDMA_H_
	Prevent circular inclusions by using protection macros. More...

#define	XCsuDma_Reset()
	This function resets the CSU_DMA core. More...

#define	XCsuDma_WaitForDone(InstancePtr, Channel)
	This function will be in busy while loop until the data transfer is completed. More...

#define	XCsuDma_GetDoneCount(InstancePtr, Channel)
	This function returns the number of completed SRC/DST DMA transfers that have not been acknowledged by software based on the channel selection. More...

#define	XCsuDma_GetFIFOLevel(InstancePtr, Channel)
	This function returns the current SRC/DST FIFO level in 32 bit words of the selected channel. More...

#define	XCsuDma_GetWROutstandCount(InstancePtr, Channel)
	This function returns the current number of read(src)/write(dst) outstanding commands based on the type of channel selected. More...

#define	XCsuDma_IsBusy(InstancePtr, Channel)
	This function returns the status of Channel either it is busy or not. More...

Ranges of Size
#define	XCSUDMA_SIZE_MAX 0x07FFFFFFU
	Maximum allowed no of words. More...

#define	XCSUDMA_DMATYPEIS_CSUDMA 0U
	DMA is CSUDMA. More...

#define	XCSUDMA_DMATYPEIS_PMCDMA0 1U
	DMA is PMCDMA0. More...

#define	XCSUDMA_DMATYPEIS_PMCDMA1 2U
	DMA is PMCDMA1. More...

#define	XCSUDMA_DMATYPEIS_ASUDMA0 3U
	DMA is ASUDMA0. More...

#define	XCSUDMA_DMATYPEIS_ASUDMA1 4U
	DMA is ASUDMA1. More...

Enumerations
enum	XCsuDma_Channel { XCSUDMA_SRC_CHANNEL = 0U, XCSUDMA_DST_CHANNEL }
	This typedef contains CSU_DMA Channel Types. More...

enum	XCsuDma_PauseType { XCSUDMA_PAUSE_MEMORY, XCSUDMA_PAUSE_STREAM }
	This typedef contains CSU_DMA Pause Types. More...

Functions
XCsuDma_Config *	XCsuDma_LookupConfig (u16 DeviceId)
	XCsuDma_LookupConfig returns a reference to an XCsuDma_Config structure based on the unique device id, DeviceId. More...

s32	XCsuDma_CfgInitialize (XCsuDma InstancePtr, XCsuDma_Config CfgPtr, UINTPTR EffectiveAddr)
	This function initializes CSU_DMA core. More...

void	XCsuDma_Transfer (XCsuDma *InstancePtr, XCsuDma_Channel Channel, u64 Addr, u32 Size, u8 EnDataLast)
	This function sets the starting address and size of the data to be transferred from/to the memory through the AXI interface. More...

void	XCsuDma_64BitTransfer (XCsuDma *InstancePtr, XCsuDma_Channel Channel, u32 AddrLow, u32 AddrHigh, u32 Size, u8 EnDataLast)
	This function sets the starting address and size of the data to be transferred from/to the memory through the AXI interface. More...

u64	XCsuDma_GetAddr (XCsuDma *InstancePtr, XCsuDma_Channel Channel)
	This function returns the current address location of the memory, from where it has to read the data(SRC) or the location where it has to write the data (DST) based on the channel selection. More...

u32	XCsuDma_GetSize (XCsuDma *InstancePtr, XCsuDma_Channel Channel)
	This function returns the size of the data yet to be transferred from memory to CSU_DMA or CSU_DMA to memory based on the channel selection. More...

void	XCsuDma_Pause (XCsuDma *InstancePtr, XCsuDma_Channel Channel, XCsuDma_PauseType Type)
	This function pauses the Channel data transfer to/from memory or to/from stream based on pause type. More...

s32	XCsuDma_IsPaused (XCsuDma *InstancePtr, XCsuDma_Channel Channel, XCsuDma_PauseType Type)
	This function checks whether Channel memory/stream is paused based on the given pause type. More...

void	XCsuDma_Resume (XCsuDma *InstancePtr, XCsuDma_Channel Channel, XCsuDma_PauseType Type)
	This function resumes the channel if it is in paused state and continues where it has left. More...

u32	XCsuDma_GetCheckSum (XCsuDma *InstancePtr)
	This function returns the sum of all the data read from AXI memory. More...

void	XCsuDma_ClearCheckSum (XCsuDma *InstancePtr)
	This function clears the check sum of the data read from AXI memory. More...

void	XCsuDma_SetConfig (XCsuDma InstancePtr, XCsuDma_Channel Channel, XCsuDma_Configure ConfigurValues)
	This function configures all the values of CSU_DMA Channels with the values of updated XCsuDma_Configure structure. More...

void	XCsuDma_GetConfig (XCsuDma InstancePtr, XCsuDma_Channel Channel, XCsuDma_Configure ConfigurValues)
	This function updates XCsuDma_Configure structure members with the configured values of CSU_DMA's Channel. More...

u32	XCsuDma_WaitForDoneTimeout (XCsuDma *InstancePtr, XCsuDma_Channel Channel)
	This function polls for completion of data transfer periodically until the DMA done bit set or until the timeout occurs. More...

u32	XCsuDma_IntrGetStatus (XCsuDma *InstancePtr, XCsuDma_Channel Channel)
	This function returns interrupt status read from Interrupt Status Register. More...

void	XCsuDma_IntrClear (XCsuDma *InstancePtr, XCsuDma_Channel Channel, u32 Mask)
	This function clears interrupt(s). More...

void	XCsuDma_EnableIntr (XCsuDma *InstancePtr, XCsuDma_Channel Channel, u32 Mask)
	This function enables the interrupt(s). More...

void	XCsuDma_DisableIntr (XCsuDma *InstancePtr, XCsuDma_Channel Channel, u32 Mask)
	This function disables the interrupt(s). More...

u32	XCsuDma_GetIntrMask (XCsuDma *InstancePtr, XCsuDma_Channel Channel)
	This function returns the interrupt mask to know which interrupts are enabled and which of them were disaled. More...

s32	XCsuDma_SelfTest (XCsuDma *InstancePtr)
	This function runs a self-test on the driver and hardware device. More...

Macro Definition Documentation

#define XCSUDMA_DMATYPEIS_ASUDMA0 3U

DMA is ASUDMA0.

#define XCSUDMA_DMATYPEIS_ASUDMA1 4U

DMA is ASUDMA1.

#define XCSUDMA_DMATYPEIS_CSUDMA 0U

DMA is CSUDMA.

Referenced by XCsuDma_CfgInitialize(), XCsuDma_IntrExample(), and XCsuDma_PolledExample().

#define XCSUDMA_DMATYPEIS_PMCDMA0 1U

DMA is PMCDMA0.

Referenced by XCsuDma_IntrExample(), and XCsuDma_PolledExample().

#define XCSUDMA_DMATYPEIS_PMCDMA1 2U

DMA is PMCDMA1.

#define XCsuDma_GetDoneCount	(	InstancePtr,
		Channel
	)

Value:

((XCsuDma_ReadReg(((InstancePtr)->Config.BaseAddress), \
                        ((u32)(XCSUDMA_STS_OFFSET) + \
                        ((u32)(Channel) * (u32)(XCSUDMA_OFFSET_DIFF)))) & \
                        (u32)(XCSUDMA_STS_DONE_CNT_MASK)) >> \
                                (u32)(XCSUDMA_STS_DONE_CNT_SHIFT))

This function returns the number of completed SRC/DST DMA transfers that have not been acknowledged by software based on the channel selection.

Parameters

InstancePtr	Pointer to XCsuDma instance to be worked on.
Channel	Type of channel. Source channel - XCSUDMA_SRC_CHANNEL Destination Channel - XCSUDMA_DST_CHANNEL

Returns

Count is number of completed DMA transfers but not acknowledged (Range is 0 to 7).

000 - All finished transfers have been acknowledged.
Count - Count number of finished transfers are still outstanding.

Note: C-style signature: u8 XCsuDma_GetDoneCount(XCsuDma *InstancePtr, XCsuDma_Channel Channel)

#define XCsuDma_GetFIFOLevel	(	InstancePtr,
		Channel
	)

Value:

((XCsuDma_ReadReg(((InstancePtr)->Config.BaseAddress), \
                        ((u32)(XCSUDMA_STS_OFFSET) + \
                        ((u32)(Channel) * (u32)(XCSUDMA_OFFSET_DIFF)))) & \
                        (u32)(XCSUDMA_STS_FIFO_LEVEL_MASK)) >> \
                                        (u32)(XCSUDMA_STS_FIFO_LEVEL_SHIFT))

This function returns the current SRC/DST FIFO level in 32 bit words of the selected channel.

Parameters

InstancePtr	Pointer to XCsuDma instance to be worked on.
Channel	Type of channel Source channel - XCSUDMA_SRC_CHANNEL Destination Channel - XCSUDMA_DST_CHANNEL

Returns

FIFO level. (Range is 0 to 128)

0 Indicates empty
Any number 1 to 128 indicates the number of entries in FIFO.

Note: C-style signature: u8 XCsuDma_GetFIFOLevel(XCsuDma *InstancePtr, XCsuDma_Channel Channel)

#define XCsuDma_GetWROutstandCount	(	InstancePtr,
		Channel
	)

Value:

((XCsuDma_ReadReg(((InstancePtr)->Config.BaseAddress), \
                                ((u32)(XCSUDMA_STS_OFFSET) + \
                        ((u32)(Channel) * (u32)(XCSUDMA_OFFSET_DIFF)))) & \
                        (u32)(XCUSDMA_STS_OUTSTDG_MASK)) >> \
                                (u32)(XCUSDMA_STS_OUTSTDG_SHIFT))

This function returns the current number of read(src)/write(dst) outstanding commands based on the type of channel selected.

Parameters

InstancePtr	Pointer to XCsuDma instance to be worked on.
Channel	Type of channel Source channel - XCSUDMA_SRC_CHANNEL Destination Channel - XCSUDMA_DST_CHANNEL

Returns: Count of outstanding commands. (Range is 0 to 9).

Note: C-style signature: u8 XCsuDma_GetWROutstandCount(XCsuDma *InstancePtr, XCsuDma_Channel Channel)

#define XCsuDma_IsBusy	(	InstancePtr,
		Channel
	)

Value:

(((XCsuDma_ReadReg(((InstancePtr)->Config.BaseAddress), \
                                        ((u32)(XCSUDMA_STS_OFFSET) + \
                        ((u32)(Channel) * (u32)(XCSUDMA_OFFSET_DIFF)))) & \
                (u32)(XCSUDMA_STS_BUSY_MASK)) == (XCSUDMA_STS_BUSY_MASK)) ? \
                                TRUE : FALSE)

This function returns the status of Channel either it is busy or not.

Parameters

InstancePtr	Pointer to XCsuDma instance to be worked on.
Channel	Type of channel Source channel - XCSUDMA_SRC_CHANNEL Destination Channel - XCSUDMA_DST_CHANNEL

Returns

Returns the current status of the core.

TRUE represents core is currently busy.
FALSE represents core is not involved in any transfers.

Note: C-style signature: s32 XCsuDma_IsBusy(XCsuDma *InstancePtr, XCsuDma_Channel Channel)

#define XCsuDma_Reset ( )

Value:

Xil_Out32(((u32)(XCSU_BASEADDRESS) + (u32)(XCSU_DMA_RESET_OFFSET)), \
                                (u32)(XCSUDMA_RESET_SET_MASK)); \
        Xil_Out32(((u32)(XCSU_BASEADDRESS) + (u32)(XCSU_DMA_RESET_OFFSET)), \
                                        (u32)(XCSUDMA_RESET_UNSET_MASK));

This function resets the CSU_DMA core.

Returns: None.

Note: None. C-style signature: void XCsuDma_Reset()

Referenced by XCsuDma_CfgInitialize().

#define XCSUDMA_SIZE_MAX 0x07FFFFFFU

Maximum allowed no of words.

Referenced by XCsuDma_64BitTransfer(), and XCsuDma_Transfer().

#define XCsuDma_WaitForDone	(	InstancePtr,
		Channel
	)

Value:

while((XCsuDma_ReadReg(((InstancePtr)->Config.BaseAddress), \
                        ((u32)(XCSUDMA_I_STS_OFFSET) + \
                        ((u32)(Channel) * (u32)(XCSUDMA_OFFSET_DIFF)))) & \
                        (u32)(XCSUDMA_IXR_DONE_MASK)) != (XCSUDMA_IXR_DONE_MASK))

This function will be in busy while loop until the data transfer is completed.

Parameters

InstancePtr	Pointer to XCsuDma instance to be worked on.
Channel	Represents the type of channel either it is Source or Destination. Source channel - XCSUDMA_SRC_CHANNEL Destination Channel - XCSUDMA_DST_CHANNEL

Returns: None.

Note: This function should be called after XCsuDma_Transfer in polled mode to wait until the data gets transferred completely. C-style signature: void XCsuDma_WaitForDone(XCsuDma *InstancePtr, XCsuDma_Channel Channel)

Referenced by XCsuDma_PolledExample().

Enumeration Type Documentation

enum XCsuDma_PauseType

This typedef contains CSU_DMA Pause Types.

Enumerator
XCSUDMA_PAUSE_MEMORY	Pauses memory data transfer to/from CSU_DMA.
XCSUDMA_PAUSE_STREAM	Pauses stream data transfer to/from CSU_DMA.

Data Structures

Macros

Enumerations

Functions

Macro Definition Documentation

Enumeration Type Documentation