doc/guides/nics/ice.rst

   1 ..  SPDX-License-Identifier: BSD-3-Clause
   2     Copyright(c) 2018 Intel Corporation.
   3
   4 ICE Poll Mode Driver
   5 ======================
   6
   7 The ice PMD (librte_pmd_ice) provides poll mode driver support for
   8 10/25 Gbps Intel® Ethernet 810 Series Network Adapters based on
   9 the Intel Ethernet Controller E810.
  10
  11
  12 Prerequisites
  13 -------------
  14
  15 - Identifying your adapter using `Intel Support
  16   <http://www.intel.com/support>`_ and get the latest NVM/FW images.
  17
  18 - Follow the DPDK :ref:`Getting Started Guide for Linux <linux_gsg>` to setup the basic DPDK environment.
  19
  20 - To get better performance on Intel platforms, please follow the "How to get best performance with NICs on Intel platforms"
  21   section of the :ref:`Getting Started Guide for Linux <linux_gsg>`.
  22
  23
  24 Pre-Installation Configuration
  25 ------------------------------
  26
  27 Config File Options
  28 ~~~~~~~~~~~~~~~~~~~
  29
  30 The following options can be modified in the ``config`` file.
  31 Please note that enabling debugging options may affect system performance.
  32
  33 - ``CONFIG_RTE_LIBRTE_ICE_PMD`` (default ``y``)
  34
  35   Toggle compilation of the ``librte_pmd_ice`` driver.
  36
  37 - ``CONFIG_RTE_LIBRTE_ICE_DEBUG_*`` (default ``n``)
  38
  39   Toggle display of generic debugging messages.
  40
  41 Runtime Config Options
  42 ~~~~~~~~~~~~~~~~~~~~~~
  43
  44 - ``Maximum Number of Queue Pairs``
  45
  46   The maximum number of queue pairs is decided by HW. If not configured, APP
  47   uses the number from HW. Users can check the number by calling the API
  48   ``rte_eth_dev_info_get``.
  49   If users want to limit the number of queues, they can set a smaller number
  50   using EAL parameter like ``max_queue_pair_num=n``.
  51
  52
  53 Driver compilation and testing
  54 ------------------------------
  55
  56 Refer to the document :ref:`compiling and testing a PMD for a NIC <pmd_build_and_test>`
  57 for details.
  58
  59
  60 Limitations or Known issues
  61 ---------------------------
  62
  63 19.02 limitation
  64 ~~~~~~~~~~~~~~~~
  65
  66 Ice code released in 19.02 is for evaluation only.
  67
  68
  69 Promiscuous mode not supported
  70 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  71 As promiscuous mode is not supported as this stage, a port can only receive the
  72 packets which destination MAC address is this port's own.
  73
  74
  75 TX anti-spoofing cannot be disabled
  76 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  77 TX anti-spoofing is enabled by default. At this stage it's not supported to
  78 disable it. So any TX packet which source MAC address is not this port's own
  79 will be dropped by HW. It means io-fwd is not supported now. Recommand to use
  80 MAC-fwd for evaluation.