diff mbox

[dpdk-dev] doc: update doc for intel VF usage

Message ID 1518430521-5008-1-git-send-email-jingjing.wu@intel.com (mailing list archive)
State Superseded, archived
Headers show


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

Commit Message

Jingjing Wu Feb. 12, 2018, 10:15 a.m. UTC
update for intel VF usage:
 - Add note for AVF device ID generation.
 - Add steps for vfio-pci pass through.

Signed-off-by: Jingjing Wu <jingjing.wu@intel.com>
 doc/guides/nics/intel_vf.rst | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)
diff mbox


diff --git a/doc/guides/nics/intel_vf.rst b/doc/guides/nics/intel_vf.rst
index d281538..b645503 100644
--- a/doc/guides/nics/intel_vf.rst
+++ b/doc/guides/nics/intel_vf.rst
@@ -74,7 +74,7 @@  every new drop of the VF driver would add more and more advanced features that c
 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.
+Intel products starting Ethernet Controller 700 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.
@@ -82,6 +82,12 @@  For more detail on SR-IOV, please refer to the following documents:
 *   `Intel® AVF HAS <https://www.intel.com/content/dam/www/public/us/en/documents/product-specifications/ethernet-adaptive-virtual-function-hardware-spec.pdf>`_
+.. note::
+    To use DPDK AVF PMD on Intel® 700 Series Ethernet Controller, the device id (0x1889) need to specified during device
+    assignment in hypervisor. Take qemu for example, the device assignment should carry the AVF device id (0x1889) like
+    ``-device vfio-pci,x-pci-device-id=0x1889,host=03:0a.0``.
 The PCIE host-interface of Intel Ethernet Switch FM10000 Series VF infrastructure
@@ -498,6 +504,19 @@  The setup procedure is as follows:
         For more information, please refer to: `http://wiki.qemu.org/Features/CPUModels <http://wiki.qemu.org/Features/CPUModels>`_.
+#.  If use vfio-pci to pass through device instead of pci-assign, steps 8 and 9 need to be updated to bind deivce to vfio-pci and
+    replace pci-assign with vfio-pci when start virtual machine.
+    .. code-block:: console
+        sudo /sbin/modprobe vfio-pci
+        echo "8086 10ed" > /sys/bus/pci/drivers/vfio-pci/new_id
+        echo 0000:08:10.0 > /sys/bus/pci/devices/0000:08:10.0/driver/unbind
+        echo 0000:08:10.0 > /sys/bus/pci/drivers/vfio-pci/bind
+        /usr/local/kvm/bin/qemu-system-x86_64 -m 4096 -smp 4 -boot c -hda lucid.qcow2 -device vfio-pci,host=08:10.0
 #.  Install and run DPDK host app to take  over the Physical Function. Eg.
     .. code-block:: console