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