xref: /dpdk/doc/guides/nics/ionic.rst (revision 9de21005e201af6ba8dc3836c09384e0b40b4a89)
1..  SPDX-License-Identifier: BSD-3-Clause
2    Copyright 2018-2022 Advanced Micro Devices, Inc.
3
4IONIC Driver
5============
6
7The ionic driver provides support for AMD Pensando server adapters.
8It currently supports the below models:
9
10- DSC-25 dual-port 25G Distributed Services Card `(pdf) <https://pensandoio.secure.force.com/DownloadFile?id=a0L4T000004IKurUAG>`__
11- DSC-100 dual-port 100G Distributed Services Card `(pdf) <https://pensandoio.secure.force.com/DownloadFile?id=a0L4T000004IKuwUAG>`__
12- DSC-200 dual-port 200G Distributed Services Card `(pdf) <https://www.amd.com/system/files/documents/pensando-dsc-200-product-brief.pdf>`__
13
14Please visit the AMD Pensando web site at https://www.amd.com/en/accelerators/pensando for more information.
15
16Identifying the Adapter
17-----------------------
18
19To determine if one or more AMD Pensando DSC Ethernet devices are installed
20on the host, check for the PCI devices:
21
22   .. code-block:: console
23
24      lspci -d 1dd8:
25      b5:00.0 Ethernet controller: Device 1dd8:1002
26      b6:00.0 Ethernet controller: Device 1dd8:1002
27
28Firmware Support
29----------------
30
31The ionic PMD requires firmware which supports 16 segment transmit SGLs.
32This support was added prior to version 1.0. For help upgrading older versions,
33please contact AMD Pensando support.
34
35Runtime Configuration
36---------------------
37
38- ``Queue in CMB support`` (default ``0``)
39
40  Queue memory can be allocated from the Controller Memory Buffer (CMB) using
41  the ``ionic_cmb`` ``devargs`` parameter.
42
43  For example::
44
45    -a 0000:b5:00.0,ionic_cmb=1
46
47Building DPDK
48-------------
49
50The ionic PMD supports UIO and VFIO. Please refer to the
51:ref:`DPDK documentation that comes with the DPDK suite <linux_gsg>`
52for instructions on how to build DPDK.
53