Xilinx KCU105 User Manual page 63

Driver Configuration with Linux
This section is only applicable to host computers running Linux.
Note:
The driver for Expresso DMA is developed to be highly configurable, depending on the
design of the end application using the Expresso DMA. Supported configurations are
detailed in Table
Table 5-7: Driver Configuration Modes
Operating Mode
No Endpoint In this mode, there is no firmware operation on the
processor (firmware) Scatter Gather queues of the Expresso DMA inside the
based DMA PCIe Endpoint. The Expresso driver running on the host
operation manages the source-side and destination-side Scatter
Gather queues. The host driver has to be aware of the
source/destination address on the Endpoint from/to
which data is to be moved into the host/endpoint.
In this mode, the driver needs to be built for deployment
on the host only.
Endpoint hardware In this mode, hardware logic inside the Endpoint
logic based DMA operates source-/destination-side Scatter Gather
operation queues of a DMA channel (Hardware-SGL), while the
host-side DMA driver manages destination-/source-side
Scatter Gather queues of the channel. In this mode, the
Endpoint hardware logic is aware of the working of
Expresso DMA.
In this mode, the driver needs to be built for deployment
on the host only.
The macros PFORM_NO_EP_PROCESSOR and HW_SGL_DESIGN are mutually exclusive (only
one can be enabled). Enabling more than one of the macros can result in unpredictable
results.
MSIx Support
The driver, when built for the host machine, supports MSIx mode. To disable MSIx mode,
comment out macro USE_MSIX in file ps_pcie_dma_driver.h.
API List
APIs are provided by the Expresso DMA (XDMA) driver to facilitate I/Os over the Expresso
DMA channels. Refer to
information on the APIs for Linux and
Windows for more information on the APIs for Windows.
PCIe Streaming Data Plane TRD
UG920 (v2017.1) June 01, 2017
Chapter 5: Targeted Reference Design Details and Modifications
5-7.
Details
Appendix D, APIs Provided by the XDMA Driver in Linux
Appendix E, APIs Provided by the XDMA Driver in
www.xilinx.com
Driver Macro to Enable
PFORM_NO_EP_PROCESSOR
HW_SGL_DESIGN
for more
Send Feedback
63