1 .. SPDX-License-Identifier: BSD-3-Clause
2 Copyright(c) 2021 HiSilicon Limited.
4 HISILICON Kunpeng DMA Driver
5 ============================
7 Kunpeng SoC has an internal DMA unit which can be used by application
8 to accelerate data copies.
9 The DMA PF function supports multiple DMA channels.
12 Supported Kunpeng SoCs
13 ----------------------
22 Kunpeng DMA devices will need to be bound to a suitable DPDK-supported
23 user-space IO driver such as ``vfio-pci`` in order to be used by DPDK.
25 Device Probing and Initialization
26 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
28 Once probed successfully, the device will appear as four ``dmadev``
29 which can be accessed using API from the ``rte_dmadev`` library.
31 The name of the ``dmadev`` created is like "B:D.F-chX", e.g. DMA 0000:7b:00.0
32 will create four ``dmadev``,
33 the 1st ``dmadev`` name is "0000:7b:00.0-ch0",
34 and the 2nd ``dmadev`` name is "0000:7b:00.0-ch1".
39 Kunpeng DMA configuration requirements:
41 * ``ring_size`` must be a power of two, between 32 and 8192.
42 * Only one ``vchan`` is supported per ``dmadev``.
43 * Silent mode is not supported.
44 * The transfer direction must be set to ``RTE_DMA_DIR_MEM_TO_MEM``.