[dpdk-dev,v4,15/15] doc: update doc for avf driver

Message ID 1515140505-38655-16-git-send-email-wenzhuo.lu@intel.com (mailing list archive)
State Superseded, archived
Delegated to: Helin Zhang
Headers

Checks

Context Check Description
ci/checkpatch success coding style OK
ci/Intel-compilation success Compilation OK

Commit Message

Wenzhuo Lu Jan. 5, 2018, 8:21 a.m. UTC
  From: Jingjing Wu <jingjing.wu@intel.com>

Signed-off-by: Jingjing Wu <jingjing.wu@intel.com>
---
 doc/guides/nics/intel_vf.rst           | 16 ++++++++++++++--
 doc/guides/rel_notes/release_18_02.rst | 16 ++++++++++++++++
 2 files changed, 30 insertions(+), 2 deletions(-)
  

Comments

Zhang, Helin Jan. 7, 2018, 3:09 p.m. UTC | #1
Is there any public spec? If yes, I'd suggest to add the link to a doc for reference.

/Helin

> -----Original Message-----

> From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Wenzhuo Lu

> Sent: Friday, January 5, 2018 4:22 PM

> To: dev@dpdk.org

> Cc: Wu, Jingjing

> Subject: [dpdk-dev] [PATCH v4 15/15] doc: update doc for avf driver

> 

> From: Jingjing Wu <jingjing.wu@intel.com>

> 

> Signed-off-by: Jingjing Wu <jingjing.wu@intel.com>

> ---

>  doc/guides/nics/intel_vf.rst           | 16 ++++++++++++++--

>  doc/guides/rel_notes/release_18_02.rst | 16 ++++++++++++++++

>  2 files changed, 30 insertions(+), 2 deletions(-)

> 

> diff --git a/doc/guides/nics/intel_vf.rst b/doc/guides/nics/intel_vf.rst index

> 1e83bf6..3adb684 100644

> --- a/doc/guides/nics/intel_vf.rst

> +++ b/doc/guides/nics/intel_vf.rst

> @@ -28,8 +28,8 @@

>      (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF

> THE USE

>      OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH

> DAMAGE.

> 

> -I40E/IXGBE/IGB Virtual Function Driver

> -======================================

> +Intel Virtual Function Driver

> +=============================

> 

>  Supported Intel® Ethernet Controllers (see the *DPDK Release Notes* for

> details)  support the following modes of operation in a virtualized

> environment:

> @@ -93,6 +93,18 @@ and the Physical Function operates on the global

> resources on behalf of the Virt  For this out-of-band communication, an SR-

> IOV enabled NIC provides a memory buffer for each Virtual Function,  which

> is called a "Mailbox".

> 

> +Intel® Ethernet Adaptive Virtual Function

> +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

> +Adaptive Virtual Function (AVF) is a SR-IOV Virtual Function with the same

> device id (8086:1889) on different Intel Ethernet Controller.

> +AVF Driver is VF driver which supports for all future Intel devices

> +without requiring a VM update. And since this happens to be an adaptive

> +VF driver, every new drop of the VF driver would add more and more

> +advanced features that can be turned on in the VM if the underlying HW

> device supports those advanced features based on a device agnostic way

> without ever compromising on the base functionality. AVF provides generic

> hardware interface and interface between AVF driver and a compliant PF

> driver is specified.

> +

> +Intel products starting Ethernet Controller 710 Series to support Adaptive

> Virtual Function.

> +

> +The way to generate Virtual Function is like normal, and the resource of VF

> assignment depends on the NIC Infrastructure.

> +

>  The PCIE host-interface of Intel Ethernet Switch FM10000 Series VF

> infrastructure

> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

> ^^^^^^^^^^^^^^^^^

> 

> diff --git a/doc/guides/rel_notes/release_18_02.rst

> b/doc/guides/rel_notes/release_18_02.rst

> index 24b67bb..0672b0e 100644

> --- a/doc/guides/rel_notes/release_18_02.rst

> +++ b/doc/guides/rel_notes/release_18_02.rst

> @@ -41,6 +41,22 @@ New Features

>       Also, make sure to start the actual text at the margin.

>       =========================================================

> 

> +   * **Add AVF (Adaptive Virtual Function) net PMD.**

> +

> +     A new net PMD has been added, which supports Intel® Ethernet

> Adaptive

> +     Virtual Function (AVF) with features list below:

> +

> +     * Basic Rx/Tx burst

> +     * SSE vectorized Rx/Tx burst

> +     * Promiscuous mode

> +     * MAC/VLAN offload

> +     * Checksum offload

> +     * TSO offload

> +     * Jumbo frame and MTU setting

> +     * RSS configuration

> +     * stats

> +     * Rx/Tx descriptor status

> +     * Link status update/event

> 

>  API Changes

>  -----------

> --

> 1.9.3
  
Wenzhuo Lu Jan. 8, 2018, 2:02 a.m. UTC | #2
Hi Helin,

> -----Original Message-----

> From: Zhang, Helin

> Sent: Sunday, January 7, 2018 11:09 PM

> To: Lu, Wenzhuo <wenzhuo.lu@intel.com>; dev@dpdk.org

> Cc: Wu, Jingjing <jingjing.wu@intel.com>

> Subject: RE: [dpdk-dev] [PATCH v4 15/15] doc: update doc for avf driver

> 

> Is there any public spec? If yes, I'd suggest to add the link to a doc for

> reference.

We do have a public spec, https://www.intel.com/content/dam/www/public/us/en/documents/product-specifications/ethernet-adaptive-virtual-function-hardware-spec.pdf.
I'll send a V5 for it.

> 

> /Helin
  

Patch

diff --git a/doc/guides/nics/intel_vf.rst b/doc/guides/nics/intel_vf.rst
index 1e83bf6..3adb684 100644
--- a/doc/guides/nics/intel_vf.rst
+++ b/doc/guides/nics/intel_vf.rst
@@ -28,8 +28,8 @@ 
     (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
     OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
-I40E/IXGBE/IGB Virtual Function Driver
-======================================
+Intel Virtual Function Driver
+=============================
 
 Supported Intel® Ethernet Controllers (see the *DPDK Release Notes* for details)
 support the following modes of operation in a virtualized environment:
@@ -93,6 +93,18 @@  and the Physical Function operates on the global resources on behalf of the Virt
 For this out-of-band communication, an SR-IOV enabled NIC provides a memory buffer for each Virtual Function,
 which is called a "Mailbox".
 
+Intel® Ethernet Adaptive Virtual Function
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Adaptive Virtual Function (AVF) is a SR-IOV Virtual Function with the same device id (8086:1889) on different Intel Ethernet Controller.
+AVF Driver is VF driver which supports for all future Intel devices without requiring a VM update. And since this happens to be an adaptive VF driver,
+every new drop of the VF driver would add more and more advanced features that can be turned on in the VM if the underlying HW device supports those
+advanced features based on a device agnostic way without ever compromising on the base functionality. AVF provides generic hardware interface and
+interface between AVF driver and a compliant PF driver is specified.
+
+Intel products starting Ethernet Controller 710 Series to support Adaptive Virtual Function.
+
+The way to generate Virtual Function is like normal, and the resource of VF assignment depends on the NIC Infrastructure.
+
 The PCIE host-interface of Intel Ethernet Switch FM10000 Series VF infrastructure
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/doc/guides/rel_notes/release_18_02.rst b/doc/guides/rel_notes/release_18_02.rst
index 24b67bb..0672b0e 100644
--- a/doc/guides/rel_notes/release_18_02.rst
+++ b/doc/guides/rel_notes/release_18_02.rst
@@ -41,6 +41,22 @@  New Features
      Also, make sure to start the actual text at the margin.
      =========================================================
 
+   * **Add AVF (Adaptive Virtual Function) net PMD.**
+
+     A new net PMD has been added, which supports Intel® Ethernet Adaptive
+     Virtual Function (AVF) with features list below:
+
+     * Basic Rx/Tx burst
+     * SSE vectorized Rx/Tx burst
+     * Promiscuous mode
+     * MAC/VLAN offload
+     * Checksum offload
+     * TSO offload
+     * Jumbo frame and MTU setting
+     * RSS configuration
+     * stats
+     * Rx/Tx descriptor status
+     * Link status update/event
 
 API Changes
 -----------