14d0d4cf3SChengwen Feng.. SPDX-License-Identifier: BSD-3-Clause 24d0d4cf3SChengwen Feng Copyright(c) 2021 HiSilicon Limited. 34d0d4cf3SChengwen Feng 44d0d4cf3SChengwen FengHISILICON Kunpeng DMA Driver 54d0d4cf3SChengwen Feng============================ 64d0d4cf3SChengwen Feng 74d0d4cf3SChengwen FengKunpeng SoC has an internal DMA unit which can be used by application 84d0d4cf3SChengwen Fengto accelerate data copies. 94d0d4cf3SChengwen FengThe DMA PF function supports multiple DMA channels. 104d0d4cf3SChengwen Feng 114d0d4cf3SChengwen Feng 124d0d4cf3SChengwen FengSupported Kunpeng SoCs 134d0d4cf3SChengwen Feng---------------------- 144d0d4cf3SChengwen Feng 154d0d4cf3SChengwen Feng* Kunpeng 920 164d0d4cf3SChengwen Feng 174d0d4cf3SChengwen Feng 184d0d4cf3SChengwen FengDevice Setup 194d0d4cf3SChengwen Feng------------- 204d0d4cf3SChengwen Feng 214d0d4cf3SChengwen FengKunpeng DMA devices will need to be bound to a suitable DPDK-supported 224d0d4cf3SChengwen Fenguser-space IO driver such as ``vfio-pci`` in order to be used by DPDK. 239e16317aSChengwen Feng 249e16317aSChengwen FengDevice Probing and Initialization 259e16317aSChengwen Feng~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 269e16317aSChengwen Feng 279e16317aSChengwen FengOnce probed successfully, the device will appear as four ``dmadev`` 289e16317aSChengwen Fengwhich can be accessed using API from the ``rte_dmadev`` library. 299e16317aSChengwen Feng 309e16317aSChengwen FengThe name of the ``dmadev`` created is like "B:D.F-chX", e.g. DMA 0000:7b:00.0 319e16317aSChengwen Fengwill create four ``dmadev``, 32*03390445SChengwen Fengthe 1st ``dmadev`` name is "0000:7b:00.0-ch0", 33*03390445SChengwen Fengand the 2nd ``dmadev`` name is "0000:7b:00.0-ch1". 343c5f5f03SChengwen Feng 353c5f5f03SChengwen FengDevice Configuration 363c5f5f03SChengwen Feng~~~~~~~~~~~~~~~~~~~~~ 373c5f5f03SChengwen Feng 383c5f5f03SChengwen FengKunpeng DMA configuration requirements: 393c5f5f03SChengwen Feng 403c5f5f03SChengwen Feng* ``ring_size`` must be a power of two, between 32 and 8192. 413c5f5f03SChengwen Feng* Only one ``vchan`` is supported per ``dmadev``. 423c5f5f03SChengwen Feng* Silent mode is not supported. 433c5f5f03SChengwen Feng* The transfer direction must be set to ``RTE_DMA_DIR_MEM_TO_MEM``. 44