doc: add Windows support for mlx5
authorTal Shnaiderman <talshn@nvidia.com>
Sun, 3 Jan 2021 10:28:27 +0000 (12:28 +0200)
committerFerruh Yigit <ferruh.yigit@intel.com>
Thu, 14 Jan 2021 09:12:37 +0000 (10:12 +0100)
Windows is supported by mlx5 PMD.
The mlx5 guide is updated with the needed information.

Signed-off-by: Tal Shnaiderman <talshn@nvidia.com>
doc/guides/nics/features.rst
doc/guides/nics/features/default.ini
doc/guides/nics/features/mlx5.ini
doc/guides/nics/mlx5.rst
doc/guides/rel_notes/release_21_02.rst

index 43f74e0..cf82e9d 100644 (file)
@@ -819,6 +819,14 @@ Other kdrv
 Kernel module other than above ones supported.
 
 
+.. _nic_features_windows:
+
+Windows
+-------
+
+Support Windows.
+
+
 .. _nic_features_armv7:
 
 ARMv7
index 4d0ad32..ee786d3 100644 (file)
@@ -69,6 +69,7 @@ BSD nic_uio          =
 Linux UIO            =
 Linux VFIO           =
 Other kdrv           =
+Windows              =
 ARMv7                =
 ARMv8                =
 Power8               =
index 54ec95d..9d14678 100644 (file)
@@ -45,6 +45,7 @@ FW version           = Y
 Module EEPROM dump   = Y
 Multiprocess aware   = Y
 Other kdrv           = Y
+Windows              = P
 ARMv8                = Y
 Power8               = Y
 x86-32               = Y
index 6950cc1..efa3e8b 100644 (file)
@@ -102,6 +102,16 @@ Features
 Limitations
 -----------
 
+- Windows support:
+
+  On Windows, the features are limited:
+
+  - Promiscuous mode is not supported
+  - The following rules are supported:
+
+    - IPv4/UDP with CVLAN filtering
+    - Unicast MAC filtering
+
 - For secondary process:
 
   - Forked secondary process not supported.
@@ -1013,8 +1023,8 @@ Below are some firmware configurations listed.
    FLEX_PARSER_PROFILE_ENABLE=4
    PROG_PARSE_GRAPH=1
 
-Prerequisites
--------------
+Linux Prerequisites
+-------------------
 
 This driver relies on external libraries and kernel drivers for resources
 allocations and initialization. The following dependencies are not part of
@@ -1127,7 +1137,44 @@ required from that distribution.
 
    Several versions of Mellanox OFED/EN are available. Installing the version
    this DPDK release was developed and tested against is strongly
-   recommended. Please check the `prerequisites`_.
+   recommended. Please check the `linux prerequisites`_.
+
+Windows Prerequisites
+---------------------
+
+This driver relies on external libraries and kernel drivers for resources
+allocations and initialization. The dependencies in the following sub-sections
+are not part of DPDK, and must be installed separately.
+
+Compilation Prerequisites
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+DevX SDK installation
+^^^^^^^^^^^^^^^^^^^^^
+
+The DevX SDK must be installed on the machine building the Windows PMD.
+Additional information can be found at
+`How to Integrate Windows DevX in Your Development Environment
+<https://docs.mellanox.com/display/winof2v250/RShim+Drivers+and+Usage#RShimDriversandUsage-DevXInterface>`__.
+
+Runtime Prerequisites
+~~~~~~~~~~~~~~~~~~~~~
+
+WinOF2 version 2.60 or higher must be installed on the machine.
+
+WinOF2 installation
+^^^^^^^^^^^^^^^^^^^
+
+The driver can be downloaded from the following site:
+`WINOF2
+<https://www.mellanox.com/products/adapter-software/ethernet/windows/winof-2>`__
+
+DevX Enablement
+^^^^^^^^^^^^^^^
+
+DevX for Windows must be enabled in the Windows registry.
+The keys ``DevxEnabled`` and ``DevxFsRules`` must be set.
+Additional information can be found in the WinOF2 user manual.
 
 Supported NICs
 --------------
@@ -1176,7 +1223,7 @@ Below are detailed device names:
 Quick Start Guide on OFED/EN
 ----------------------------
 
-1. Download latest Mellanox OFED/EN. For more info check the  `prerequisites`_.
+1. Download latest Mellanox OFED/EN. For more info check the `linux prerequisites`_.
 
 
 2. Install the required libraries and kernel modules either by installing
index b1bb2d8..c64294e 100644 (file)
@@ -61,6 +61,12 @@ New Features
 
   * Added support for Stingray2 device.
 
+* **Updated Mellanox mlx5 driver.**
+
+  Updated the Mellanox mlx5 driver with new features and improvements, including:
+
+  * Introduced basic support on Windows.
+
 
 Removed Items
 -------------