Xilinx KCU105 User Manual page 98

Table D-1: APIs Provided by the XDMA Driver (Cont'd)
API Prototype
int
xlnx_activate_dma_channe
l(
ps_pcie_dma_desc_t
*ptr_dma_desc,
ps_pcie_dma_chann_desc
_t *ptr_chann_desc,
unsigned int
data_q_addr_hi,
unsigned int
data_q_addr_lo,
unsigned int data_q_sz,
unsigned int
sta_q_addr_hi,
unsigned int
sta_q_addr_lo,
unsigned int sta_q_sz,
unsigned char
coalesce_cnt,
bool warm_activate );
int
xlnx_deactivate_dma_chan
nel(
ps_pcie_dma_chann_desc
_t *ptr_chann_desc)
PCIe Streaming Data Plane TRD
UG920 (v2017.1) June 01, 2017
Appendix D:
Details
Activates acquired DMA
channel for usage.
Deactivates the activated
DMA channel.
www.xilinx.com
APIs Provided by the XDMA Driver in Linux
Parameters
ptr_chann_desc –
Channel descriptor
pointer acquired by an
earlier call to
xlnx_get_dma_channel
data_q_addr_hi – Upper
32 bits of data queue
address
data_q_addr_lo – Lower
32 bits of data queue
address
data_q_sz – Number of
elements in the data
queue. This is typically the
same as q_num_elements
passed in a call to
xlnx_alloc_queues.
sta_q_addr_hi – Upper 32
bits of status queue
address
sta_q_addr_lo – Lower 32
bits of status queue
address
sta_q_sz - Number of
elements in the status
queue. This is typically the
same as q_num_elements
passed in a call to
xlnx_alloc_queues.
coalesce_cnt – Interrupt
coalesce count
warm_activate – Set to
true if an API is called
after an earlier call to
xlnx_deactivate_dma_chan
nel.
ptr_chann_desc –
Channel descriptor
pointer
Return
Returns XLNX_SUCCESS
on success. On failure, a
negative value is returned.
Check "/* Xilinx DMA
driver status messages */"
in
ps_pcie_dma_driver.
h for more information on
error codes.
Returns XLNX_SUCCESS
on success. On failure, a
negative value is returned.
Check "/* Xilinx DMA
driver status messages */"
in
ps_pcie_dma_driver.
h for more information on
error codes.
98
Send Feedback