2019-09-26 14:01:47 +00:00
|
|
|
.. SPDX-License-Identifier: BSD-3-Clause
|
|
|
|
|
Copyright(c) 2018-2019 Hisilicon Limited.
|
|
|
|
|
|
|
|
|
|
HNS3 Poll Mode Driver
|
|
|
|
|
===============================
|
|
|
|
|
|
2020-11-03 12:36:02 +00:00
|
|
|
The hns3 PMD (**librte_net_hns3**) provides poll mode driver support
|
2019-09-26 14:01:47 +00:00
|
|
|
for the inbuilt Hisilicon Network Subsystem(HNS) network engine
|
|
|
|
|
found in the Hisilicon Kunpeng 920 SoC.
|
|
|
|
|
|
|
|
|
|
Features
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
Features of the HNS3 PMD are:
|
|
|
|
|
|
|
|
|
|
- Multiple queues for TX and RX
|
|
|
|
|
- Receive Side Scaling (RSS)
|
|
|
|
|
- Packet type information
|
|
|
|
|
- Checksum offload
|
2020-03-09 09:32:39 +00:00
|
|
|
- TSO offload
|
2020-07-01 11:54:34 +00:00
|
|
|
- LRO offload
|
2019-09-26 14:01:47 +00:00
|
|
|
- Promiscuous mode
|
|
|
|
|
- Multicast mode
|
|
|
|
|
- Port hardware statistics
|
|
|
|
|
- Jumbo frames
|
|
|
|
|
- Link state information
|
2019-12-21 10:32:45 +00:00
|
|
|
- Interrupt mode for RX
|
2020-07-04 10:09:51 +00:00
|
|
|
- VLAN stripping and inserting
|
|
|
|
|
- QinQ inserting
|
|
|
|
|
- DCB
|
|
|
|
|
- Scattered and gather for TX and RX
|
|
|
|
|
- Flow director
|
|
|
|
|
- Dump register
|
|
|
|
|
- SR-IOV VF
|
|
|
|
|
- Multi-process
|
|
|
|
|
- MAC/VLAN filter
|
|
|
|
|
- MTU update
|
2019-09-26 14:01:47 +00:00
|
|
|
- NUMA support
|
|
|
|
|
|
|
|
|
|
Prerequisites
|
|
|
|
|
-------------
|
|
|
|
|
- Get the information about Kunpeng920 chip using
|
|
|
|
|
`<http://www.hisilicon.com/en/Products/ProductList/Kunpeng>`_.
|
|
|
|
|
|
|
|
|
|
- Follow the DPDK :ref:`Getting Started Guide for Linux <linux_gsg>` to setup the basic DPDK environment.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
---------------------------
|
|
|
|
|
Currently, we only support VF device is bound to vfio_pci or
|
|
|
|
|
igb_uio and then driven by DPDK driver when PF is driven by
|
|
|
|
|
kernel mode hns3 ethdev driver, VF is not supported when PF
|
|
|
|
|
is driven by DPDK driver.
|
|
|
|
|
|
|
|
|
|
Build with ICC is not supported yet.
|
|
|
|
|
X86-32, Power8, ARMv7 and BSD are not supported yet.
|
