[dts] [PATCH V1] test_plans/ice_dcf_date_path: modify the format of test plan

[dts] [PATCH V1] test_plans/ice_dcf_date_path: modify the format of test plan

[Jiale Song]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain; charset=y, Size: 4115 bytes --]

add license info, title,description and prerequisites.

Signed-off-by: Jiale Song <songx.jiale@intel.com>
---
 test_plans/ice_dcf_date_path_test_plan.rst | 70 +++++++++++++++++-----
 1 file changed, 54 insertions(+), 16 deletions(-)

diff --git a/test_plans/ice_dcf_date_path_test_plan.rst b/test_plans/ice_dcf_date_path_test_plan.rst
index 1a0df884..780dd63d 100644
--- a/test_plans/ice_dcf_date_path_test_plan.rst
+++ b/test_plans/ice_dcf_date_path_test_plan.rst
@@ -1,20 +1,66 @@
+.. SPDX-License-Identifier: BSD-3-Clause
+   Copyright(c) 2019 Intel Corporation
 
-Common steps for launching DCF
-==============================
+================================
+ICE DCF date path function
+================================
 
-Generate 1 trust VF on 1 PF, and request 1 DCF on the trust VF.
-PF should grant DCF mode to it.
+Description
+===========
+* DCF data path support RSS packets by default.
+* For L3 packets, input set is IP src/dst.
+* For tunneling packets, input set is inner IP src/dst
 
-Generate 4 VFs on PF ::
+
+Prerequisites
+=============
+1. Hardware:
+   Intel® Ethernet 800 Series: E810-XXVDA4/E810-CQ
+
+2. Software:
+   dpdk: http://dpdk.org/git/dpdk
+   scapy: http://www.secdev.org/projects/scapy/
+
+3. Copy specific ice package to /lib/firmware/updates/intel/ice/ddp/ice.pkg,
+   then load driver::
+
+    rmmod ice
+    insmod ice.ko
+
+4. Compile DPDK::
+
+    CC=gcc meson --werror -Denable_kmods=True -Dlibdir=lib --default-library=static x86_64-native-linuxapp-gcc
+    ninja -C x86_64-native-linuxapp-gcc -j 110
+
+5. Get the pci device id of DUT, for example::
+
+    ./usertools/dpdk-devbind.py -s
+
+    0000:18:00.0 'Device 159b' if=ens785f0 drv=ice unused=vfio-pci
+    0000:18:00.1 'Device 159b' if=ens785f1 drv=ice unused=vfio-pci
+6. Generate 4 VFs on PF0(not all the VFs are used)::
 
     echo 4 > /sys/bus/pci/devices/0000:18:00.0/sriov_numvfs
 
-Set a VF as trust ::
+    ./usertools/dpdk-devbind.py -s
+    0000:18:01.0 'Ethernet Adaptive Virtual Function 1889' if=ens785f0v0 drv=iavf unused=vfio-pci
+    0000:18:01.1 'Ethernet Adaptive Virtual Function 1889' if=ens785f0v1 drv=iavf unused=vfio-pci
+    0000:18:01.2 'Ethernet Adaptive Virtual Function 1889' if=ens785f0v2 drv=iavf unused=vfio-pci
+    0000:18:01.3 'Ethernet Adaptive Virtual Function 1889' if=ens785f0v3 drv=iavf unused=vfio-pci
+
+7. Set VF0 as trust::
+
+    ip link set ens785f0 vf 0 trust on
+
+8. Set mac addr for VF1::
 
-    ip link set enp24s0f0 vf 0 trust on
     ip link set enp27s0f0 vf 0 mac D2:6B:4C:EB:1C:26
 
-Launch dpdk on the VF, request DCF mode ::
+9. Bind VFs to dpdk driver::
+
+    ./usertools/dpdk-devbind.py -b vfio-pci 0000:18:01.0 0000:18:01.1 0000:18:01.2 0000:18:01.3
+
+10.Launch dpdk on the VF, request DCF mode ::
 
     ./usertools/dpdk-devbind.py -b vfio-pci 18:01.0
     ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -l 6-10 -n 4 -a 18:01.0,cap=dcf --file-prefix=vf -- -i
@@ -23,8 +69,6 @@ Launch dpdk on the VF, request DCF mode ::
 Test Case: Launch DCF and do macfwd
 ===================================
 
-Execute **common steps** to prepare DCF test environment
-
 Set macfwd ::
 
     set fwd mac
@@ -48,8 +92,6 @@ Test Case: Check default rss for L3
 DCF data path support RSS packets by default. For L3 packets, input set is IP src/dst.
 For tunneling packets, input set is inner IP src/dst.
 
-Execute **common steps** to prepare DCF test environment
-
 Set rxonly forward mode ::
 
     set fwd rxonly
@@ -104,8 +146,6 @@ Test Case: Check default rss for L4
 DCF data path support RSS packets by default. For L3 packets, input set is IP src/dst.
 For tunneling packets, input set is inner IP src/dst.
 
-Execute **common steps** to prepare DCF test environment
-
 Set rxonly forward mode ::
 
     set fwd rxonly
@@ -166,8 +206,6 @@ Test Case: Create rule with to original VF action
 DCF data path support RSS packets by default. For L3 packets, input set is IP src/dst.
 For tunneling packets, input set is inner IP src/dst.
 
-Execute **common steps** to prepare DCF test environment
-
 Set rxonly forward mode ::
 
     set fwd rxonly
-- 
2.17.1