dma/hisilicon: introduce driver skeleton

Add the basic device probe and remove functions and initial
documentation for new hisilicon DMA drivers.

Signed-off-by: Chengwen Feng <fengchengwen@huawei.com>

diff --git a/MAINTAINERS b/MAINTAINERS
index 1bfd68962bd73bac1e362ad3b299afa2ed3a63b1..2c02a15a15a4364e42090137103ba333364ec79d 100644 (file)
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -1206,6 +1206,11 @@ M: Conor Walsh <conor.walsh@intel.com>
 F: drivers/dma/ioat/
 F: doc/guides/dmadevs/ioat.rst
 
+HiSilicon DMA
+M: Chengwen Feng <fengchengwen@huawei.com>
+F: drivers/dma/hisilicon/
+F: doc/guides/dmadevs/hisilicon.rst
+
 
 RegEx Drivers
 -------------

diff --git a/doc/guides/dmadevs/hisilicon.rst b/doc/guides/dmadevs/hisilicon.rst
new file mode 100644 (file)
index 0000000..a19bec0
--- /dev/null
+++ b/doc/guides/dmadevs/hisilicon.rst
@@ -0,0 +1,22 @@
+..  SPDX-License-Identifier: BSD-3-Clause
+    Copyright(c) 2021 HiSilicon Limited.
+
+HISILICON Kunpeng DMA Driver
+============================
+
+Kunpeng SoC has an internal DMA unit which can be used by application
+to accelerate data copies.
+The DMA PF function supports multiple DMA channels.
+
+
+Supported Kunpeng SoCs
+----------------------
+
+* Kunpeng 920
+
+
+Device Setup
+-------------
+
+Kunpeng DMA devices will need to be bound to a suitable DPDK-supported
+user-space IO driver such as ``vfio-pci`` in order to be used by DPDK.

diff --git a/doc/guides/dmadevs/index.rst b/doc/guides/dmadevs/index.rst
index 20476039a5ae4883fcaf892641477fdffec5b273..5d6f9da1842ff0cb2b6eff0122e91b70fb1a4360 100644 (file)
--- a/doc/guides/dmadevs/index.rst
+++ b/doc/guides/dmadevs/index.rst
@@ -11,5 +11,6 @@ an application through DMA API.
    :maxdepth: 2
    :numbered:
 
+   hisilicon
    idxd
    ioat

diff --git a/doc/guides/rel_notes/release_21_11.rst b/doc/guides/rel_notes/release_21_11.rst
index 771122f05f58d82d788a8172e9aa1cf614ea7a63..55379825ee2d575651c18a02829325b77493ed4c 100644 (file)
--- a/doc/guides/rel_notes/release_21_11.rst
+++ b/doc/guides/rel_notes/release_21_11.rst
@@ -75,6 +75,11 @@ New Features
     operations.
   * Added multi-process support.
 
+* **Added HiSilicon DMA driver.**
+
+  The HiSilicon DMA driver provides device drivers for the Kunpeng's DMA devices.
+  This device driver can be used through the generic dmadev API.
+
 * **Added IDXD dmadev driver implementation.**
 
   The IDXD dmadev driver provide device drivers for the Intel DSA devices.

diff --git a/drivers/dma/hisilicon/hisi_dmadev.c b/drivers/dma/hisilicon/hisi_dmadev.c
new file mode 100644 (file)
index 0000000..e6fb8a0
--- /dev/null
+++ b/drivers/dma/hisilicon/hisi_dmadev.c
@@ -0,0 +1,119 @@
+/* SPDX-License-Identifier: BSD-3-Clause
+ * Copyright(C) 2021 HiSilicon Limited
+ */
+
+#include <inttypes.h>
+#include <string.h>
+
+#include <rte_bus_pci.h>
+#include <rte_eal.h>
+#include <rte_log.h>
+#include <rte_pci.h>
+#include <rte_dmadev_pmd.h>
+
+#include "hisi_dmadev.h"
+
+RTE_LOG_REGISTER_DEFAULT(hisi_dma_logtype, INFO);
+#define HISI_DMA_LOG(level, fmt, args...) \
+               rte_log(RTE_LOG_ ## level, hisi_dma_logtype, \
+               "%s(): " fmt "\n", __func__, ##args)
+#define HISI_DMA_LOG_RAW(hw, level, fmt, args...) \
+               rte_log(RTE_LOG_ ## level, hisi_dma_logtype, \
+               "%s %s(): " fmt "\n", (hw)->data->dev_name, \
+               __func__, ##args)
+#define HISI_DMA_DEBUG(hw, fmt, args...) \
+               HISI_DMA_LOG_RAW(hw, DEBUG, fmt, ## args)
+#define HISI_DMA_INFO(hw, fmt, args...) \
+               HISI_DMA_LOG_RAW(hw, INFO, fmt, ## args)
+#define HISI_DMA_WARN(hw, fmt, args...) \
+               HISI_DMA_LOG_RAW(hw, WARNING, fmt, ## args)
+#define HISI_DMA_ERR(hw, fmt, args...) \
+               HISI_DMA_LOG_RAW(hw, ERR, fmt, ## args)
+
+static uint8_t
+hisi_dma_reg_layout(uint8_t revision)
+{
+       if (revision == HISI_DMA_REVISION_HIP08B)
+               return HISI_DMA_REG_LAYOUT_HIP08;
+       else
+               return HISI_DMA_REG_LAYOUT_INVALID;
+}
+
+static void
+hisi_dma_gen_pci_device_name(const struct rte_pci_device *pci_dev,
+                            char *name, size_t size)
+{
+       memset(name, 0, size);
+       (void)snprintf(name, size, "%x:%x.%x",
+                pci_dev->addr.bus, pci_dev->addr.devid,
+                pci_dev->addr.function);
+}
+
+static int
+hisi_dma_check_revision(struct rte_pci_device *pci_dev, const char *name,
+                       uint8_t *out_revision)
+{
+       uint8_t revision;
+       int ret;
+
+       ret = rte_pci_read_config(pci_dev, &revision, 1,
+                                 HISI_DMA_PCI_REVISION_ID_REG);
+       if (ret != 1) {
+               HISI_DMA_LOG(ERR, "%s read PCI revision failed!", name);
+               return -EINVAL;
+       }
+       if (hisi_dma_reg_layout(revision) == HISI_DMA_REG_LAYOUT_INVALID) {
+               HISI_DMA_LOG(ERR, "%s revision: 0x%x not supported!",
+                            name, revision);
+               return -EINVAL;
+       }
+
+       *out_revision = revision;
+       return 0;
+}
+
+static int
+hisi_dma_probe(struct rte_pci_driver *pci_drv __rte_unused,
+              struct rte_pci_device *pci_dev)
+{
+       char name[RTE_DEV_NAME_MAX_LEN] = { 0 };
+       uint8_t revision;
+       int ret;
+
+       hisi_dma_gen_pci_device_name(pci_dev, name, sizeof(name));
+
+       if (pci_dev->mem_resource[2].addr == NULL) {
+               HISI_DMA_LOG(ERR, "%s BAR2 is NULL!\n", name);
+               return -ENODEV;
+       }
+
+       ret = hisi_dma_check_revision(pci_dev, name, &revision);
+       if (ret)
+               return ret;
+       HISI_DMA_LOG(DEBUG, "%s read PCI revision: 0x%x", name, revision);
+
+       return ret;
+}
+
+static int
+hisi_dma_remove(struct rte_pci_device *pci_dev)
+{
+       RTE_SET_USED(pci_dev);
+       return 0;
+}
+
+static const struct rte_pci_id pci_id_hisi_dma_map[] = {
+       { RTE_PCI_DEVICE(PCI_VENDOR_ID_HUAWEI, HISI_DMA_DEVICE_ID) },
+       { .vendor_id = 0, }, /* sentinel */
+};
+
+static struct rte_pci_driver hisi_dma_pmd_drv = {
+       .id_table  = pci_id_hisi_dma_map,
+       .drv_flags = RTE_PCI_DRV_NEED_MAPPING,
+       .probe     = hisi_dma_probe,
+       .remove    = hisi_dma_remove,
+};
+
+RTE_PMD_REGISTER_PCI(dma_hisilicon, hisi_dma_pmd_drv);
+RTE_PMD_REGISTER_PCI_TABLE(dma_hisilicon, pci_id_hisi_dma_map);
+RTE_PMD_REGISTER_KMOD_DEP(dma_hisilicon, "vfio-pci");

diff --git a/drivers/dma/hisilicon/hisi_dmadev.h b/drivers/dma/hisilicon/hisi_dmadev.h
new file mode 100644 (file)
index 0000000..114b9dc
--- /dev/null
+++ b/drivers/dma/hisilicon/hisi_dmadev.h
@@ -0,0 +1,24 @@
+/* SPDX-License-Identifier: BSD-3-Clause
+ * Copyright(c) 2021 HiSilicon Limited
+ */
+
+#ifndef HISI_DMADEV_H
+#define HISI_DMADEV_H
+
+#define PCI_VENDOR_ID_HUAWEI                   0x19e5
+#define HISI_DMA_DEVICE_ID                     0xA122
+#define HISI_DMA_PCI_REVISION_ID_REG           0x08
+#define HISI_DMA_REVISION_HIP08B               0x21
+
+/**
+ * The HIP08B(HiSilicon IP08) and later Chip(e.g. HiSilicon IP09) are DMA iEPs,
+ * they have the same pci device id but with different pci revision.
+ * Unfortunately, they have different register layouts, so the layout
+ * enumerations are defined.
+ */
+enum {
+       HISI_DMA_REG_LAYOUT_INVALID = 0,
+       HISI_DMA_REG_LAYOUT_HIP08
+};
+
+#endif /* HISI_DMADEV_H */

diff --git a/drivers/dma/hisilicon/meson.build b/drivers/dma/hisilicon/meson.build
new file mode 100644 (file)
index 0000000..0786772
--- /dev/null
+++ b/drivers/dma/hisilicon/meson.build
@@ -0,0 +1,19 @@
+# SPDX-License-Identifier: BSD-3-Clause
+# Copyright(c) 2021 HiSilicon Limited
+
+if not is_linux
+    build = false
+    reason = 'only supported on Linux'
+    subdir_done()
+endif
+
+if (arch_subdir != 'x86' and arch_subdir != 'arm') or (not dpdk_conf.get('RTE_ARCH_64'))
+    build = false
+    reason = 'only supported on x86_64 and aarch64'
+    subdir_done()
+endif
+
+deps += ['bus_pci', 'dmadev']
+sources = files(
+        'hisi_dmadev.c',
+)

diff --git a/drivers/dma/hisilicon/version.map b/drivers/dma/hisilicon/version.map
new file mode 100644 (file)
index 0000000..c2e0723
--- /dev/null
+++ b/drivers/dma/hisilicon/version.map
@@ -0,0 +1,3 @@
+DPDK_22 {
+       local: *;
+};

diff --git a/drivers/dma/meson.build b/drivers/dma/meson.build
index a69418ce9b684b72cd27fd1112688031b89e478c..4d3f1a31025e9482b450f3a7a6cf744979edb478 100644 (file)
--- a/drivers/dma/meson.build
+++ b/drivers/dma/meson.build
@@ -2,6 +2,7 @@
 # Copyright 2021 HiSilicon Limited
 
 drivers = [
+        'hisilicon',
         'idxd',
         'ioat',
         'skeleton',