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 ----------------------
21 Kunpeng DMA devices will need to be bound to a suitable DPDK-supported
22 user-space IO driver such as ``vfio-pci`` in order to be used by DPDK.
24 Device Probing and Initialization
25 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
27 Once probed successfully, the device will appear as four ``dmadev``
28 which can be accessed using API from the ``rte_dmadev`` library.
30 The name of the ``dmadev`` created is like "B:D.F-chX", e.g. DMA 0000:7b:00.0
31 will create four ``dmadev``,
32 the 1st ``dmadev`` name is "7b:00.0-ch0",
33 and the 2nd ``dmadev`` name is "7b:00.0-ch1".
38 Kunpeng DMA configuration requirements:
40 * ``ring_size`` must be a power of two, between 32 and 8192.
41 * Only one ``vchan`` is supported per ``dmadev``.
42 * Silent mode is not supported.
43 * The transfer direction must be set to ``RTE_DMA_DIR_MEM_TO_MEM``.