AXI CDMA Standalone Driver


Table of Contents

AXI CDMA Standalone Driver


Introduction

This page gives an overview of axi cdma driver which is available as part of the Xilinx Vivado and SDK distribution.

The Xilinx LogiCORE™ IP AXI Central Direct Memory Access (CDMA) core is a soft Xilinx Intellectual Property (IP) core for use with the Vivado® Design Suite. The AXI CDMA provides high-bandwidth Direct Memory Access (DMA) between a memory-mapped source address and a memory-mapped destination address using the AXI4 protocol. An optional Scatter Gather (SG) feature can be used to offload control and sequencing tasks from the system CPU. Initialization, status, and control registers are accessed through an AXI4-Lite slave interface.

How to enable

Source Path for the driver
https://github.com/Xilinx/embeddedsw/tree/master/XilinxProcessorIPLib/drivers/axicdma

Driver source code is organized into different folders. Below diagram shows the axicdma driver source organization

AXI CDMA
|
- doc - Provides the API and data structure details

- data - Driver tcl and MDD file.

|
- examples - Reference application to show how to use the driver APIs and calling sequence
|
- src- Driver source files

Features Supported

Controller Features


Standalone Driver Supported Features

The AXI CDMA Standalone driver supports the below things.


Test cases

https://github.com/Xilinx/embeddedsw/tree/master/XilinxProcessorIPLib/drivers/axicdma/examples

xaxicdma_example_sg_intr.c : This example demonstrates how to transfer packets in interrupt mode when the core is configured in SG Mode.
xaxicdma_example_sg_poll.c : This example demonstrates how to transfer packets in the polled mode when the core is configured in SG Mode.
xaxicdma_example_simple_intr.c : This example demonstrates how to transfer packets in interrupt mode when the core is configured in simple DMA Mode.
xaxicdma_example_simple_poll.c : This example demonstrates how to transfer packets in the polled mode when the core is configured in simple DMA Mode.
xaxicdma_example_hybrid_intr.c : This example demonstrates how to transfer packets in interrupt mode when the core is configured in hybrid(SG + simple) transfer Mode.
xaxicdma_example_hybrid_poll.c : This example demonstrates how to transfer packets in the polled mode when the core is configured in hybrid(SG + simple) transfer Mode.

Known issues and Limitations

Change Log

2019.2

Commit Id's

67fe31f   axicdma: examples: Fix cache maintenance operation for data buffers
320aa07 axicdma: examples: Add errors prints for failing scenarios

2019.1

2018.3

Commit Id's

20df53d Fix typos in peripheral app generation tcl
394e44f examples: Reset error and done states before starting DMA
5e68393 examples: Fix compilation error in DEBUG mode
da70e17 Fix gcc warning in peripheral test application
f80f1ad Fix cppcheck warning
cd5bc3d Include missing initializers for 'XAxiCdma_Config' fields

2018.2

2018.1

Commit Id's
9fab83a axicdma: Extend AXI CDMA examples to support data buffers above 4GB
2017.4

2017.3


Related Links