From patchwork Mon Feb 12 10:15:21 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Jingjing Wu X-Patchwork-Id: 35127 Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id E7A401B2E5; Mon, 12 Feb 2018 11:24:21 +0100 (CET) Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) by dpdk.org (Postfix) with ESMTP id 0B6991B2DA for ; Mon, 12 Feb 2018 11:24:19 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga004.jf.intel.com ([10.7.209.38]) by orsmga104.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 12 Feb 2018 02:24:19 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.46,501,1511856000"; d="scan'208";a="174102685" Received: from dpdk2.sh.intel.com ([10.67.118.195]) by orsmga004.jf.intel.com with ESMTP; 12 Feb 2018 02:24:17 -0800 From: Jingjing Wu To: john.mcnamara@intel.com Cc: wenzhuo.lu@intel.com, jingjing.wu@intel.com, dev@dpdk.org Date: Mon, 12 Feb 2018 18:15:21 +0800 Message-Id: <1518430521-5008-1-git-send-email-jingjing.wu@intel.com> X-Mailer: git-send-email 2.4.11 MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH] doc: update doc for intel VF usage X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" update for intel VF usage: - Add note for AVF device ID generation. - Add steps for vfio-pci pass through. Signed-off-by: Jingjing Wu --- 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 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 `_ +.. 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 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