2021-07-08 09:32:21 +00:00
|
|
|
.. SPDX-License-Identifier: BSD-3-Clause
|
|
|
|
|
Copyright(c) 2018-2021 Beijing WangXun Technology Co., Ltd.
|
|
|
|
|
|
|
|
|
|
NGBE Poll Mode Driver
|
|
|
|
|
=====================
|
|
|
|
|
|
|
|
|
|
The NGBE PMD (librte_pmd_ngbe) provides poll mode driver support
|
|
|
|
|
for Wangxun 1 Gigabit Ethernet NICs.
|
|
|
|
|
|
|
|
|
|
|
2021-07-08 09:32:30 +00:00
|
|
|
Features
|
|
|
|
|
--------
|
|
|
|
|
|
2021-10-21 09:50:13 +00:00
|
|
|
- Multiple queues for Tx and Rx
|
|
|
|
|
- Receiver Side Scaling (RSS)
|
2021-10-21 09:50:12 +00:00
|
|
|
- MAC/VLAN filtering
|
2021-10-21 09:49:58 +00:00
|
|
|
- Packet type information
|
2021-10-21 09:50:00 +00:00
|
|
|
- Checksum offload
|
2021-10-21 09:50:05 +00:00
|
|
|
- VLAN/QinQ stripping and inserting
|
2021-10-21 09:50:01 +00:00
|
|
|
- TSO offload
|
2021-10-21 09:50:09 +00:00
|
|
|
- Promiscuous mode
|
|
|
|
|
- Multicast mode
|
2021-10-21 09:50:06 +00:00
|
|
|
- Port hardware statistics
|
2021-10-21 09:50:04 +00:00
|
|
|
- Jumbo frames
|
2021-07-08 09:32:30 +00:00
|
|
|
- Link state information
|
2021-10-21 09:50:16 +00:00
|
|
|
- Link flow control
|
2021-10-21 09:50:01 +00:00
|
|
|
- Scattered and gather for TX and RX
|
2021-10-21 09:50:20 +00:00
|
|
|
- IEEE 1588
|
2021-10-21 09:50:10 +00:00
|
|
|
- FW version
|
2021-07-08 09:32:30 +00:00
|
|
|
|
|
|
|
|
|
2021-07-08 09:32:21 +00:00
|
|
|
Prerequisites
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
- Learning about Wangxun 1 Gigabit Ethernet NICs using
|
|
|
|
|
`<https://www.net-swift.com/a/386.html>`_.
|
|
|
|
|
|
|
|
|
|
- Follow the DPDK :ref:`Getting Started Guide for Linux <linux_gsg>` to setup the basic DPDK environment.
|
|
|
|
|
|
|
|
|
|
|
2021-07-08 09:32:23 +00:00
|
|
|
Pre-Installation Configuration
|
|
|
|
|
------------------------------
|
|
|
|
|
|
|
|
|
|
Dynamic Logging Parameters
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
One may leverage EAL option "--log-level" to change default levels
|
|
|
|
|
for the log types supported by the driver. The option is used with
|
|
|
|
|
an argument typically consisting of two parts separated by a colon.
|
|
|
|
|
|
|
|
|
|
NGBE PMD provides the following log types available for control:
|
|
|
|
|
|
|
|
|
|
- ``pmd.net.ngbe.driver`` (default level is **notice**)
|
|
|
|
|
|
|
|
|
|
Affects driver-wide messages unrelated to any particular devices.
|
|
|
|
|
|
|
|
|
|
- ``pmd.net.ngbe.init`` (default level is **notice**)
|
|
|
|
|
|
|
|
|
|
Extra logging of the messages during PMD initialization.
|
|
|
|
|
|
|
|
|
|
|
2021-07-08 09:32:21 +00:00
|
|
|
Driver compilation and testing
|
|
|
|
|
------------------------------
|
|
|
|
|
|
|
|
|
|
Refer to the document :ref:`compiling and testing a PMD for a NIC <pmd_build_and_test>`
|
|
|
|
|
for details.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Limitations or Known issues
|
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
|
|
Build with ICC is not supported yet.
|
|
|
|
|
Power8, ARMv7 and BSD are not supported yet.
|
