Re: [dts] [PATCH v3]test_plans: add enable_package_download_in_ice_driver_test_plan.rst

["Tu, Lijuan" <lijuan.tu@intel.com>]

Applied, thanks

> -----Original Message-----
> From: dts [mailto:dts-bounces@dpdk.org] On Behalf Of Peng Yuan
> Sent: Thursday, May 23, 2019 2:32 PM
> To: dts@dpdk.org
> Cc: Peng, Yuan <yuan.peng@intel.com>
> Subject: [dts] [PATCH v3]test_plans: add
> enable_package_download_in_ice_driver_test_plan.rst
> 
> Add enable_package_download_in_ice_driver_test_plan.rst
> 
> Signed-off-by: Peng Yuan <yuan.peng@intel.com>
> 
> 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