From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by dpdk.space (Postfix) with ESMTP id A4891A05D3 for ; Thu, 23 May 2019 08:27:51 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 679BC25D9; Thu, 23 May 2019 08:27:51 +0200 (CEST) Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by dpdk.org (Postfix) with ESMTP id 56EB79E4 for ; Thu, 23 May 2019 08:27:49 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by fmsmga102.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 22 May 2019 23:27:48 -0700 X-ExtLoop1: 1 Received: from unknown (HELO localhost.localdomain.sh.intel.com) ([10.240.176.135]) by fmsmga001.fm.intel.com with ESMTP; 22 May 2019 23:27:47 -0700 From: Peng Yuan To: dts@dpdk.org Cc: Peng Yuan Date: Thu, 23 May 2019 14:32:09 +0800 Message-Id: <1558593129-65333-1-git-send-email-yuan.peng@intel.com> X-Mailer: git-send-email 1.9.3 Subject: [dts] [PATCH v3]test_plans: add enable_package_download_in_ice_driver_test_plan.rst X-BeenThere: dts@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: test suite reviews and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dts-bounces@dpdk.org Sender: "dts" Add enable_package_download_in_ice_driver_test_plan.rst Signed-off-by: Peng Yuan diff --git a/test_plans/enable_package_download_in_ice_driver_test_plan.rst b/test_plans/enable_package_download_in_ice_driver_test_plan.rst new file mode 100644 index 0000000..b26c361 --- /dev/null +++ b/test_plans/enable_package_download_in_ice_driver_test_plan.rst @@ -0,0 +1,137 @@ +.. Copyright (c) <2019>, Intel Corporation + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + + - Neither the name of Intel Corporation nor the names of its + contributors may be used to endorse or promote products derived + from this software without specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE + COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, + INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR + SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, + STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED + OF THE POSSIBILITY OF SUCH DAMAGE. + +========================================================== +Flexible pipeline package processing on CPK NIC mode Tests +========================================================== + +Description +=========== + +DPDK PMD is able to load flexible pipeline package file, +process the content then program to NIC. + +This is very important feature, all Classification and Qos functions +depends on this. + +This feature set enabled package downloading to the device. The package is +to be in the /lib/firmware/intel/ice/ddp directory and named ice.pkg. +The package is shared by the kernel driver and the DPDK PMD. + +If package download failed, driver need to go to safe mode. +RSS, QINQ, and checksum offload are disabled in safe mode. + +Prerequisites +============= + +Hardware:: + + Ice NIC port*2 + DUT_port_0 <---> Tester_port_0 + DUT_port_1 <---> Tester_port_1 + +Test case 1: Download the package successfully +============================================== + +1. Put the ice.pkg to /lib/firmware/intel/ice/ddp/ice.pkg, + then reboot the server. + +2. Start the testpmd:: + + ./testpmd -c 0x3fe -n 6 -- -i --nb-cores=8 --rxq=8 --txq=8 \ + --port-topology=chained + + There will be a printing:: + + download success + +3. Normal forward + + Set forward mode:: + + testpmd> set mac fwd + testpmd> start + + Send an IPV4 packet from Tester_port_0, + Tester_port_1 can receive the forwarded packet. + The forward can run normally. + +4. The RSS function run normally. + + set rxonly mode:: + + testpmd> set mac rxonly + testpmd> start + +5. Send UPD/TCP/SCTP+IPV4/IPV6 packets with packet generator + with different IPV4/IPV6 address or TCP/UDP/SCTP ports, + the packets can be distributed to different rx queues. + +Test case 2: failed to download pkg +=================================== + +1. Server power on, then put a new ice.pkg to + /lib/firmware/intel/ice/ddp/ice.pkg. + Make sure the new ice.pkg is different with the original one. + +2. Start testpmd:: + + ./testpmd -c 0x3fe -n 6 -- -i --nb-cores=8 --rxq=8 --txq=8 \ + --port-topology=chained + + There will be an error reported:: + + ice_dev_init(): Failed to load default OS package + + The driver need to go to safe mode. + +3. Normal forward + + Set forward mode:: + + testpmd> set mac fwd + testpmd> start + + Send an IPV4 packet from Tester_port_0, + Tester_port_1 can receive the forwarded packet. + The forward can run normally. + +4. The RSS function doesn't work. + + set rxonly mode:: + + testpmd> set mac rxonly + testpmd> start + +5. Send UPD/TCP/SCTP+IPV4/IPV6 packets with packet generator + with different IPV4/IPV6 address or TCP/UDP/SCTP ports, + the packets can be only distributed to rx queue 0. -- 2.14.3