Patch Detail

HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 129560,
    "url": "http://patchwork.dpdk.org/api/patches/129560/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dts/patch/20230716140054.3222247-3-yaqi.tang@intel.com/",
    "project": {
        "id": 3,
        "url": "http://patchwork.dpdk.org/api/projects/3/?format=api",
        "name": "DTS",
        "link_name": "dts",
        "list_id": "dts.dpdk.org",
        "list_email": "dts@dpdk.org",
        "web_url": "",
        "scm_url": "git://dpdk.org/tools/dts",
        "webscm_url": "http://git.dpdk.org/tools/dts/",
        "list_archive_url": "https://inbox.dpdk.org/dts",
        "list_archive_url_format": "https://inbox.dpdk.org/dts/{}",
        "commit_url_format": ""
    },
    "msgid": "<20230716140054.3222247-3-yaqi.tang@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dts/20230716140054.3222247-3-yaqi.tang@intel.com",
    "date": "2023-07-16T14:00:53",
    "name": "[V1,2/3] test_plans/igc_tx_timestamp: igc enable tx timestamp offloading",
    "commit_ref": null,
    "pull_url": null,
    "state": "new",
    "archived": false,
    "hash": "57450f4d383a9fc6501d9b23ed6152fedf0788cc",
    "submitter": {
        "id": 2357,
        "url": "http://patchwork.dpdk.org/api/people/2357/?format=api",
        "name": "Yaqi Tang",
        "email": "yaqi.tang@intel.com"
    },
    "delegate": null,
    "mbox": "http://patchwork.dpdk.org/project/dts/patch/20230716140054.3222247-3-yaqi.tang@intel.com/mbox/",
    "series": [
        {
            "id": 28946,
            "url": "http://patchwork.dpdk.org/api/series/28946/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dts/list/?series=28946",
            "date": "2023-07-16T14:00:51",
            "name": "IGC Enable Tx Timestamp Offloading",
            "version": 1,
            "mbox": "http://patchwork.dpdk.org/series/28946/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/patches/129560/comments/",
    "check": "pending",
    "checks": "http://patchwork.dpdk.org/api/patches/129560/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "<dts-bounces@dpdk.org>",
        "X-Original-To": "patchwork@inbox.dpdk.org",
        "Delivered-To": "patchwork@inbox.dpdk.org",
        "Received": [
            "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 1E36042E8D;\n\tSun, 16 Jul 2023 16:01:55 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 16537427EE;\n\tSun, 16 Jul 2023 16:01:55 +0200 (CEST)",
            "from mga12.intel.com (mga12.intel.com [192.55.52.136])\n by mails.dpdk.org (Postfix) with ESMTP id B2E3E4013F\n for <dts@dpdk.org>; Sun, 16 Jul 2023 16:01:52 +0200 (CEST)",
            "from orsmga005.jf.intel.com ([10.7.209.41])\n by fmsmga106.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 16 Jul 2023 07:01:52 -0700",
            "from dpdk-yaqi.sh.intel.com ([10.67.118.189])\n by orsmga005.jf.intel.com with ESMTP; 16 Jul 2023 07:01:49 -0700"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple;\n d=intel.com; i=@intel.com; q=dns/txt; s=Intel;\n t=1689516112; x=1721052112;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=661eVFG7oPWB7oLZD0b3QzdND98/Qz0y7BicbvOaDV4=;\n b=Vech7dnsh8ujGa7wMeccOoiWIOEI2yDf00GhHFE7Wo+IVfT3fhRO5HCH\n D9jrEsSt+GmDNweDP3KLC776uPQtZsi0cSW/8gI2r05eD7IMQjr23wOWF\n QIZHFZAJefqFS8Z/LMXSrKau+9Yie4TX1ihw6S6wEot3uG4l0NYLit9oK\n /dRqhnEfqUbq1xZg+Y7Qfjg6V9POF3UDrgYN1FT9ZN8qxThT4XyYH96LS\n fOMtsZFj52vVofySd8b1RMHoDhXccEJ0bvKzM/2lleJqMVu7xaeFTjyJx\n gT1vrrcL2okBbceSp5jwmvd9CU6jvPU3RtQgwjS9AclIvja+r8wkbNuwq g==;",
        "X-IronPort-AV": [
            "E=McAfee;i=\"6600,9927,10773\"; a=\"345351250\"",
            "E=Sophos;i=\"6.01,210,1684825200\"; d=\"scan'208\";a=\"345351250\"",
            "E=McAfee;i=\"6600,9927,10773\"; a=\"896930498\"",
            "E=Sophos;i=\"6.01,210,1684825200\"; d=\"scan'208\";a=\"896930498\""
        ],
        "X-ExtLoop1": "1",
        "From": "Yaqi Tang <yaqi.tang@intel.com>",
        "To": "dts@dpdk.org",
        "Cc": "Yaqi Tang <yaqi.tang@intel.com>",
        "Subject": "[PATCH V1 2/3] test_plans/igc_tx_timestamp: igc enable tx timestamp\n offloading",
        "Date": "Sun, 16 Jul 2023 14:00:53 +0000",
        "Message-Id": "<20230716140054.3222247-3-yaqi.tang@intel.com>",
        "X-Mailer": "git-send-email 2.25.1",
        "In-Reply-To": "<20230716140054.3222247-1-yaqi.tang@intel.com>",
        "References": "<20230716140054.3222247-1-yaqi.tang@intel.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "X-BeenThere": "dts@dpdk.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "test suite reviews and discussions <dts.dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dts>,\n <mailto:dts-request@dpdk.org?subject=unsubscribe>",
        "List-Archive": "<http://mails.dpdk.org/archives/dts/>",
        "List-Post": "<mailto:dts@dpdk.org>",
        "List-Help": "<mailto:dts-request@dpdk.org?subject=help>",
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/dts>,\n <mailto:dts-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dts-bounces@dpdk.org"
    },
    "content": "IGC Enable Tx timestamp offloading by leveraging I225 NIC's \"Launch Time\".\n\nSigned-off-by: Yaqi Tang <yaqi.tang@intel.com>\n---\n test_plans/igc_tx_timestamp_test_plan.rst | 161 ++++++++++++++++++++++\n 1 file changed, 161 insertions(+)\n create mode 100644 test_plans/igc_tx_timestamp_test_plan.rst",
    "diff": "diff --git a/test_plans/igc_tx_timestamp_test_plan.rst b/test_plans/igc_tx_timestamp_test_plan.rst\nnew file mode 100644\nindex 00000000..727e73be\n--- /dev/null\n+++ b/test_plans/igc_tx_timestamp_test_plan.rst\n@@ -0,0 +1,161 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+   Copyright(c) 2023 Intel Corporation\n+\n+==================================\n+IGC Enable Tx Timestamp Offloading\n+==================================\n+\n+Description\n+===========\n+IGC Enable Tx timestamp offloading by leveraging I225 NIC's \"Launch Time\".\n+Measure time interval for Rx timestamp when setting Tx interval between packets in one burst and MAX/MIN error.\n+Currently, the minimum time interval for Rx timestamp when setting Tx interval implemented by 2.5G IGC NIC is 300ns.\n+\n+.. note::\n+   testpmd> set txtimes (inter),(intra)\n+   inter is the delay between the bursts in the device clock units.\n+   intra is the delay between the packets within the burst specified in the device clock units. \n+   Due to the time difference in the software, the inter value should be as large as possible to avoid conflicts, \n+   so the inter value in this plan is set to 30000000.\n+\n+Prerequisites\n+=============\n+\n+Topology\n+--------\n+The connection is as below table::\n+   +-----------------------------+\n+   |     DUT     |     TESTER    |\n+   +=============================+\n+   |            2.5G             |\n+   | IGC-NIC-1  ----  IGC-NIC-2  |\n+   +-----------------------------+\n+\n+Hardware\n+--------\n+Supported NICs: IGC-I225_LM/IGC-I226_LM\n+\n+Software\n+--------\n+dpdk: http://dpdk.org/git/dpdk\n+runtime command: https://doc.dpdk.org/guides/testpmd_app_ug/testpmd_funcs.html\n+\n+General Set Up\n+--------------\n+1. Compile DPDK::\n+\n+    # CC=gcc meson --werror -Denable_kmods=True -Dlibdir=lib --default-library=static <dpdk build dir>\n+    # ninja -C <dpdk build dir> -j 110\n+\n+2. Get the pci device id and interface of DUT and tester.\n+   For example, 0000:18:00.0 and 0000:86:00.0 is pci device id,\n+   ens785 and ens803 is interface::\n+\n+    <dpdk dir># ./usertools/dpdk-devbind.py -s\n+\n+    0000:18:00.0 'Device 125b' if=ens785 drv=igc unused=vfio-pci\n+    0000:86:00.0 'Device 125b' if=ens803 drv=igc unused=vfio-pci\n+    \n+3. Bind the DUT port to dpdk::\n+\n+    <dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci <DUT port pci device id>\n+\n+4. Tester compile test-timestamp app::\n+\n+   # gcc /root/pkt_rx_tx.c -o test-timestamp -lpthread\n+\n+5. Tester Launch test-timestamp app::\n+\n+   # ./test-timestamp -i <Tester port interface> -t\n+\n+Test Case\n+=========\n+Test Case 1: Enable tx timestamp, check time interval of rx timestamp\n+---------------------------------------------------------------------\n+Launch testpmd enable tx timestamp offloading, set different txtimes intra and measure time interval of Rx timestamp between packets in one burst and MAX/MIN error.\n+When the set txtimes intra more than 300ns, the time interval for Rx timestamp is the set intra. When it's less than 300ns, the time interval for Rx timestamp is 300ns.\n+\n+Subcase 1: set txtimes intra 2000ns\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+Test Steps\n+~~~~~~~~~~\n+1. Launch testpmd enable tx timestamp::\n+\n+   ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -l 1-2 -n 4 -a 0000:18:00.0 -- -i --tx-offloads=0x200000\n+\n+2. Set txtimes intra::\n+\n+   set fwd txonly\n+   set txtimes 30000000,2000\n+   start\n+\n+3. Check the time interval of Rx timestamp is 2000ns and measure MAX/MIN error.\n+\n+Subcase 2: set txtimes intra 1000ns\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+1. Modify subcase 1 test step 2 to::\n+\n+    set txtimes 30000000,1000\n+\n+2. Execute subcase 1 test steps to check the time interval of Rx timestamp is 1000ns and measure MAX/MIN error.\n+\n+Subcase 3: set txtimes intra 400ns\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+1. Modify subcase 1 test step 2 to::\n+\n+    set txtimes 30000000,400\n+\n+2. Execute subcase 1 test steps to check the time interval of Rx timestamp is 400ns and measure MAX/MIN error.\n+\n+Subcase 4: set txtimes intra 300ns\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+1. Modify subcase 1 test step 2 to::\n+\n+    set txtimes 30000000,300\n+\n+2. Execute subcase 1 test steps to check the time interval of Rx timestamp is 300ns and measure MAX/MIN error.\n+\n+Subcase 5: set txtimes intra 200ns\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+1. Modify subcase 1 test step 2 to::\n+\n+    set txtimes 30000000,200\n+\n+2. Execute subcase 1 test steps to check the time interval of Rx timestamp is 300ns and measure MAX/MIN error.\n+\n+Test Case 2: Without tx timestamp, check time interval of rx timestamp\n+----------------------------------------------------------------------\n+Launch testpmd without tx timestamp offloading, set different txtimes intra and measure time interval for Rx timestamp between packets in one burst and MAX/MIN error.\n+Regardless of the value of txtimes intra, the time interval for Rx timestamp is 300ns.\n+\n+Subcase 1: set txtimes intra 2000ns\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+Test Steps\n+~~~~~~~~~~\n+1. Launch testpmd enable tx timestamp::\n+\n+   ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -l 1-2 -n 4 -a 0000:18:00.0 -- -i\n+\n+2. Set txtimes intra::\n+\n+   set fwd txonly\n+   set txtimes 30000000,2000\n+   start\n+\n+3. Check the time interval of Rx timestamp is 300ns and measure MAX/MIN error.\n+\n+Subcase 2: set txtimes intra 1000ns\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+1. Modify subcase 1 test step 2 to::\n+\n+    set txtimes 30000000,1000\n+\n+2. Execute subcase 1 test steps to check the time interval of Rx timestamp is 300ns and measure MAX/MIN error.\n+\n+Subcase 3: set txtimes intra 400ns\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+1. Modify subcase 1 test step 2 to::\n+\n+    set txtimes 30000000,400\n+\n+2. Execute subcase 1 test steps to check the time interval of Rx timestamp is 300ns and measure MAX/MIN error.\n",
    "prefixes": [
        "V1",
        "2/3"
    ]
}