.. SPDX-License-Identifier: BSD-3-Clause
- Copyright(c) 2018-2019 Hisilicon Limited.
+ Copyright(c) 2018-2019 HiSilicon Limited.
HNS3 Poll Mode Driver
===============================
The hns3 PMD (**librte_net_hns3**) provides poll mode driver support
-for the inbuilt Hisilicon Network Subsystem(HNS) network engine
-found in the Hisilicon Kunpeng 920 SoC.
+for the inbuilt HiSilicon Network Subsystem(HNS) network engine
+found in the HiSilicon Kunpeng 920 SoC and Kunpeng 930 SoC .
Features
--------
- MTU update
- NUMA support
- Generic flow API
+- IEEE1588/802.1AS timestamping
Prerequisites
-------------
``sve``, if supported use the ``sve`` Rx function which indicates the
sve algorithm.
``simple``, if supported use the ``simple`` Rx function which indicates
- the scalar algorithm.
+ the scalar simple algorithm.
``common``, if supported use the ``common`` Rx function which indicates
the scalar scattered algorithm.
be first checked, if meets, use the ``vec``. Then, ``simple``, at last
``common``.
+ For example::
+ -a 0000:7d:00.0,rx_func_hint=simple
+
- ``tx_func_hint`` (default ``none``)
Used to select Tx burst function, supported value are ``vec``, ``sve``,
be first checked, if meets, use the ``vec``. Then, ``simple``, at last
``common``.
+ For example::
+ -a 0000:7d:00.0,tx_func_hint=common
+
+- ``dev_caps_mask`` (default ``0``)
+
+ Used to mask the capability which queried from firmware.
+ This args take hexadecimal bitmask where each bit represents whether mask
+ corresponding capability. eg. If the capability is 0xFFFF queried from
+ firmware, and the args value is 0xF which means the bit0~bit3 should be
+ masked off, then the capability will be 0xFFF0.
+ Its main purpose is to debug and avoid problems.
+
+ For example::
+ -a 0000:7d:00.0,dev_caps_mask=0xF
+
Driver compilation and testing
------------------------------