[dts] [PATCH] test_plans: add test plan of single port MAC loopback

[Peng Yuan]

Signed-off-by: Peng Yuan <yuan.peng at intel.com>

diff --git a/test_plans/unit_tests_loopback_test_plan.rst b/test_plans/unit_tests_loopback_test_plan.rst
new file mode 100644
index 0000000..ef32084
--- /dev/null
+++ b/test_plans/unit_tests_loopback_test_plan.rst
@@ -0,0 +1,91 @@
+.. Copyright (c) <2014-2017>, 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.
+
+====================================
+Unit Tests: single port MAC loopback
+====================================
+
+According to loopback mode, setup loopback link or not.
+If loopback mode is setted, packets will be sent to rx_q from tx_q directly.
+Else if loopback mode is disabled, packets will sent to peer port from tx_q. 
+Loopback mode can be used to support testing task.
+This is the test plan for unit test to verify if XL710 can enable single port
+mac loopback.
+
+Prerequisites
+=============
+
+Two 40Gb Ethernet ports of the DUT are directly connected and link is up.
+bind the port to dpdk driver::
+
+    ./usertools/dpdk-devbind.py -b igb_uio 05:00.0
+
+Test case 1: enable loopback mode
+=================================
+
+1. enable loopback mode:
+In dpdk/test/test/test_pmd_perf.c
+set::
+
+    .lpbk_mode=1
+    #define MAX_TRAFFIC_BURST              32
+
+then make test
+
+2. start test::
+
+    ./test/test/test -c f -n 4 -- -i
+    RTE>>pmd_perf_autotest
+
+The final output of the test will be matrix of average cycles of IO used per
+packet, and "Test OK" is printed out.
+the peer port can't receive any packet.
+
+Test case 2: disable loopback mode
+=================================
+
+1. disable lookback mode:
+In dpdk/test/test/test_pmd_perf.c
+set::
+
+    .lpbk_mode=0
+    #define MAX_TRAFFIC_BURST              32
+
+then make test
+
+2. start test::
+
+    ./test/test/test -c f -n 4 -- -i
+    RTE>>pmd_perf_autotest
+
+there is not "Test OK" presented.
+the peer port can receive all the 32 packets.
-- 
2.5.0