doc: update Intel VF guide
authorJingjing Wu <jingjing.wu@intel.com>
Mon, 12 Feb 2018 10:25:55 +0000 (18:25 +0800)
committerThomas Monjalon <thomas@monjalon.net>
Tue, 13 Feb 2018 17:17:30 +0000 (18:17 +0100)
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>
Acked-by: John McNamara <john.mcnamara@intel.com>
doc/guides/nics/intel_vf.rst

index d281538..49a7085 100644 (file)
@@ -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 device 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