doc/guides/nics/ngbe.rst

   1 ..  SPDX-License-Identifier: BSD-3-Clause
   2     Copyright(c) 2018-2021 Beijing WangXun Technology Co., Ltd.
   3
   4 NGBE Poll Mode Driver
   5 =====================
   6
   7 The NGBE PMD (librte_pmd_ngbe) provides poll mode driver support
   8 for Wangxun 1 Gigabit Ethernet NICs.
   9
  10
  11 Features
  12 --------
  13
  14 - Multiple queues for Tx and Rx
  15 - Receiver Side Scaling (RSS)
  16 - MAC/VLAN filtering
  17 - Packet type information
  18 - Checksum offload
  19 - VLAN/QinQ stripping and inserting
  20 - TSO offload
  21 - Promiscuous mode
  22 - Multicast mode
  23 - Port hardware statistics
  24 - Jumbo frames
  25 - Link state information
  26 - Link flow control
  27 - Scattered and gather for TX and RX
  28 - IEEE 1588
  29 - FW version
  30
  31
  32 Prerequisites
  33 -------------
  34
  35 - Learning about Wangxun 1 Gigabit Ethernet NICs using
  36   `<https://www.net-swift.com/a/386.html>`_.
  37
  38 - Follow the DPDK :ref:`Getting Started Guide for Linux <linux_gsg>` to setup the basic DPDK environment.
  39
  40
  41 Pre-Installation Configuration
  42 ------------------------------
  43
  44 Dynamic Logging Parameters
  45 ~~~~~~~~~~~~~~~~~~~~~~~~~~
  46
  47 One may leverage EAL option "--log-level" to change default levels
  48 for the log types supported by the driver. The option is used with
  49 an argument typically consisting of two parts separated by a colon.
  50
  51 NGBE PMD provides the following log types available for control:
  52
  53 - ``pmd.net.ngbe.driver`` (default level is **notice**)
  54
  55   Affects driver-wide messages unrelated to any particular devices.
  56
  57 - ``pmd.net.ngbe.init`` (default level is **notice**)
  58
  59   Extra logging of the messages during PMD initialization.
  60
  61
  62 Driver compilation and testing
  63 ------------------------------
  64
  65 Refer to the document :ref:`compiling and testing a PMD for a NIC <pmd_build_and_test>`
  66 for details.
  67
  68
  69 Limitations or Known issues
  70 ---------------------------
  71
  72 Build with ICC is not supported yet.
  73 Power8, ARMv7 and BSD are not supported yet.