[dts] [PATCH] test_plans: add test plan enable_jumboframe_for_vf

[Junyu Jiang <junyux.jiang@intel.com>]

Signed-off-by: Junyu Jiang <junyux.jiang@intel.com>
---
 .../enable_jumboframe_for_vf_test_plan.rst    | 158 ++++++++++++++++++
 1 file changed, 158 insertions(+)
 create mode 100644 test_plans/enable_jumboframe_for_vf_test_plan.rst

diff --git a/test_plans/enable_jumboframe_for_vf_test_plan.rst b/test_plans/enable_jumboframe_for_vf_test_plan.rst
new file mode 100644
index 0000000..ff93a93
--- /dev/null
+++ b/test_plans/enable_jumboframe_for_vf_test_plan.rst
@@ -0,0 +1,158 @@
+.. 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.
+
+
+==================================================
+VF enable jumbo frame by configuring DPDK PF Tests
+==================================================
+
+Description
+===========
+
+when do MTU set on VF port of ixgbe NIC, jumbo frame mode need enable by host pf,
+to receive Jumbo Frames with a configurable maximum packet length that is greater
+than the standard maximum Ethernet frame length (1518 bytes).
+
+Prerequisites
+=============
+
+1. Hardware:
+   Ethernet Controller 10G X550T 1563
+   Ethernet Connection X552/X557-AT 10GBASE-T 15ad
+   
+2.Bind PF ports to igb_uio driver::
+
+	usertools/dpdk-devbind.py --bind=igb_uio 0000:af:00.0
+  
+3.Create 1 VF device from PF devices,then bind the created VF to igb_uio driver::
+
+	echo 1 > /sys/bus/pci/devices/0000\:af\:00.0/max_vfs
+	usertools/dpdk-devbind.py --bind=igb_uio 0000:af:10.0
+
+4.Start testpmd on host::
+
+	./x86_64-native-linux-gcc/app/testpmd -c 0xf -n 4 -w af:00.0 --file-prefix=PF -- -i
+	testpmd> set verbose 1
+	testpmd> set promisc 0 off
+	testpmd> start
+ 
+5.Start VF testpmd::
+
+	./x86_64-native-linux-gcc/app/testpmd -c 0xf -n 4 -w af:10.0 --file-prefix=VF -- -i
+	testpmd> set verbose 1
+	testpmd> start
+  
+Test Case1: Mtu is greater than 1518
+====================================
+  
+Set MTU on vf port::
+
+	testpmd> stop
+	testpmd> port stop 0
+	testpmd> port config mtu 0 2000
+	testpmd> port start 0
+	testpmd> start
+
+Send the packet what the length is greater than 1518 less than 2000 to PF port::
+
+	sendp([Ether(dst='B4:96:91:57:78:FC')/IP()/("X" * 1600)], iface="enp175s0f1", count=1)
+
+Send the packet what the length is greater than 1518 less than 2000 to VF port::
+
+	sendp([Ether(dst='CE:43:0B:2E:AE:64')/IP()/("X" * 1600)], iface="enp175s0f1", count=1)
+  
+Check that packets length greater than the standard maximum frame (1518) less than 2000 can received
+on VF port and PF port.
+ 
+Send the packet what the length is greater than 2000 to PF port::
+
+	sendp([Ether(dst='B4:96:91:57:78:FC')/IP()/("X" * 2100)], iface="enp175s0f1", count=1)
+	
+Send the packet what the length is greater than 2000 to VF port::
+	
+	sendp([Ether(dst='CE:43:0B:2E:AE:64')/IP()/("X" * 2100)], iface="enp175s0f1", count=1)
+
+Check that packets length greater than 2000 can not received on VF port and PF port.
+  
+Quit VF testpmd, and then restart the VF testpmd::
+
+	testpmd> quit
+	./x86_64-native-linux-gcc/app/testpmd -c 0xf -n 4 -w af:10.0 --file-prefix=VF -- -i
+	testpmd> set verbose 1
+	testpmd> start
+
+Send the packet what the length is greater than 1518 less than 2000 to VF port again::
+    
+	sendp([Ether(dst='CE:43:0B:2E:AE:64')/IP()/("X" * 1600)], iface="enp175s0f1", count=1)
+  
+Check that packets length greater than the standard maximum frame (1518) less than 2000 can received
+on VF port.
+  
+Send the pkts what the length is greater than 2000 to VF port again::
+
+	sendp([Ether(dst='CE:43:0B:2E:AE:64')/IP()/("X" * 2100)], iface="enp175s0f1", count=1)
+	
+Check that packets length greater than 2000 can not received on VF port. 
+ 
+Test case2: The maximum mtu(9710)
+=================================
+
+Set MTU on vf port::
+
+	testpmd> stop
+	testpmd> port stop 0
+	testpmd> port config mtu 0 9710
+	testpmd> port start 0
+	testpmd> start
+  
+Send the packet what the length is 9710 to PF port::
+
+	sendp([Ether(dst='B4:96:91:57:78:FC')/IP()/("X" * 9676)], iface="enp175s0f1", count=1)
+	
+Send the packet what the length is 9710 to VF port::
+	
+	sendp([Ether(dst='CE:43:0B:2E:AE:64')/IP()/("X" * 9676)], iface="enp175s0f1", count=1)
+	
+Check that packets length is 9710 can received on VF port and PF port.
+
+Quit VF testpmd, and then restart the VF testpmd::
+
+	testpmd> quit
+	./x86_64-native-linux-gcc/app/testpmd -c 0xf -n 4 -w af:10.0 --file-prefix=VF -- -i
+	testpmd> set verbose 1
+	testpmd> start 
+  
+Send the pkts what the length is 9710 to VF port::
+
+	sendp([Ether(dst='CE:43:0B:2E:AE:64')/IP()/("X" * 9676)], iface="enp175s0f1", count=1)
+
+Check that packets length is 9710 can received on VF port.
-- 
2.17.1