From c721648d95f45f9a10ae632f32e0e4379b190102 Mon Sep 17 00:00:00 2001 From: Jingjing Wu Date: Mon, 12 Feb 2018 18:25:55 +0800 Subject: [PATCH] doc: update Intel VF guide update for intel VF usage: - Add note for AVF device ID generation. - Add steps for vfio-pci pass through. Signed-off-by: Jingjing Wu Acked-by: John McNamara --- doc/guides/nics/intel_vf.rst | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/doc/guides/nics/intel_vf.rst b/doc/guides/nics/intel_vf.rst index d2815380e7..49a7085a97 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 `_ +.. 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 `_. +#. 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 -- 2.20.1