From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM02-BL2-obe.outbound.protection.outlook.com (mail-bl2nam02on0079.outbound.protection.outlook.com [104.47.38.79]) by dpdk.org (Postfix) with ESMTP id C8E051B208 for ; Wed, 10 Jan 2018 15:53:04 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=CAVIUMNETWORKS.onmicrosoft.com; s=selector1-cavium-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=jnPMy6VpK6eBxQPTq3Da0FGhwM3XVpYCTCtaKg6Y118=; b=YJir7Mh5qzH9NcJm75m/fzZZQAaN2zR797sDfc/mwk3S5eXyb4dVPGPT1wbHXQzuze8DFLsgS5xaHPzGobdjyXCjFSB16UlI+ndmaBgwVzmwdDP1bn58a/glkAqfzgwMoGvJ4wfluX5qmlpCGAUp/56inWEn6R/DndMOEQ0oN6Q= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Pavan.Bhagavatula@cavium.com; Received: from Pavan-LT.caveonetworks.com (111.93.218.67) by DM5PR07MB3466.namprd07.prod.outlook.com (10.164.153.21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.386.5; Wed, 10 Jan 2018 14:52:55 +0000 From: Pavan Nikhilesh To: jerin.jacob@caviumnetworks.com, santosh.shukla@caviumnetworks.com, harry.van.haaren@intel.com, gage.eads@intel.com, hemant.agrawal@nxp.com, nipun.gupta@nxp.com, liang.j.ma@intel.com Cc: dev@dpdk.org, Pavan Nikhilesh Date: Wed, 10 Jan 2018 20:21:44 +0530 Message-Id: <20180110145144.28403-12-pbhagavatula@caviumnetworks.com> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20180110145144.28403-1-pbhagavatula@caviumnetworks.com> References: <20171130072406.15605-1-pbhagavatula@caviumnetworks.com> <20180110145144.28403-1-pbhagavatula@caviumnetworks.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Originating-IP: [111.93.218.67] X-ClientProxiedBy: BN6PR16CA0009.namprd16.prod.outlook.com (10.172.212.147) To DM5PR07MB3466.namprd07.prod.outlook.com (10.164.153.21) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 7d373fa7-f871-4be8-40a2-08d55839d749 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(4534020)(4602075)(4627115)(201703031133081)(201702281549075)(5600026)(4604075)(2017052603307)(7153060)(7193020); SRVR:DM5PR07MB3466; X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3466; 3:X+UXkPdwHOkZli+DOi2ERPEjFqloaR4p9EpLnQMkr5bLOP/hbG6mdiUN6CX6GxLWgIcTXZwmWuQz/YGYYVANL1V1So56a+RFVNAo4HMTlBZaMCQKShschGMwQv1w4X7342yaLIOisR3vjFB/Q3omU4gFUUV4P4INn4i5k9JlZUQOjYOrHDq0H9opuyE5UPni6Gt/NOcIUBJo62a9gh8/VELdNttPtwa4EBe7aTeHRHYxjk7oH6P/JU2bqL4KeilP; 25:vnln7ak8TbJRPAHXuRACRAOBsRKrsCnaLFlkdzNrEsIiRgAeiIlHiuvLqFBr2JKUE3E+rdbIWa0PmcGc76yBjDo9mzZPLGn5bqofDmEW2hbno2e4q5UzTS8TKRUBGffv8DPC95/kumu3RuS7EaKaOZTS/O4PN/dhpb5nV8ttcloLcwJcxiclkrkEwoLNe0cErr7bDvWY/CfkEGG0cFR6cXIjQMY4UGhFKISdvm/7i/xIRytYSNTpcRJxmESn0mdfWDTCy3F/xNWk+2gJYxpPsqlJYHzRaJ940aQqU4/FQ5pl4n9eWKdpwtMrlT3KSl+wyZzRDwd+lfxOgEzltlDgDw==; 31:WpiIu4AMjFPGecH2CR3u65tyeYyL8hM4aHFIAKLDGonPAG1XksC0ESeryjcZbuOKQqy/cF4BsY17rp3OAZ9W1K32VP8xs8+oBge+hud83SBHdE549ati0as7NKPkUHUNSRDI86+0rglQe14RmSzzWpCk349G3HTCOGHyar25nN+cBDtreTvdW/E2SKnWQOMXvuzL3U464jQ6Up3UKKimAuGS8L3rlbOcCVjjfdcLWIo= X-MS-TrafficTypeDiagnostic: DM5PR07MB3466: X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3466; 20:dysx9O4gk6fVKsY4czfPw4HmpMq0xaseOynrQ1Xa9d4kxIXgClauNC4YztAgux1lqMuUmsFKp87+lWGLhQ9l7Kh/l3EdZTarxklcA1hR0fhrazTzhtS2rZ8Ghv0NWY84ifqgZro41ETuXxjPmDdJkKLb1uRP1RBo+hl3eLCjfzmCmfCkkjPKZdPsQRrCausBz3nt4GwL84MewbSfXiRDTctWws9FgJw6y5r6cOUQuoZasM4x4KU1YlcV9hcJymFWLvYzDhUqdYR37SRqZU0GN5GD7/ynFrSJq7ej9cj+jNM/R1/dYgXZf9OLX+QIn1K6aHWU2j4GSHikFfDl2NkzPtJwyZV6b4xph+vUFc6uyc4U+HxzfF/vpDIZIi1hBC195hx4RgrTPYV3KNkKVkXZQ1FRbyTPaQ53+Fo5VTObYhob2lTFyw2zgtYStC69kvpLviXkdLQD0/6uqqO5mNGTWjVSUe5iYNCUfntqzJVe57l2ZBIb7pNcqHBqWQvyyA9sbZuTSFZDFtcuB2++R3QsQL6HA7P1d7ROmoHPR9hSnbe9tcmKzYk3KCZk24YcY6rp+A/AvsXoyQcqoql7M8enTZwLIbu1xBjeW+DrhO9Euzs= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(145185744447497)(159090696235961)(131327999870524)(42262312472803); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040470)(2401047)(5005006)(8121501046)(10201501046)(3002001)(93006095)(3231023)(944501075)(6041268)(20161123560045)(20161123564045)(20161123558120)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123562045)(6072148)(201708071742011); SRVR:DM5PR07MB3466; BCL:0; PCL:0; RULEID:(100000803101)(100110400095); SRVR:DM5PR07MB3466; X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3466; 4:vk92lpWbTzpQhdtE9s+hD2zyhoGji+4PZclGe9wooJnLPvEvkLWLw/VRIdnNui7zm/myieva7y/a0YEbmjNT0O/ngf3G4tH5zUeDWje++SvCuffC1hZDg3sbhX9ERUicEu80ESeopr55yRjbzRo8z3bDP0PVqBGsJtjbzFa+fnFD2WRxhh7/pOq6M4u+cH+PYKYwgGhVwgKc10z9sTsb1GJoVcqkUIOioIq6E3KKmzPN2OrlAvR0TRErFlAcC/MLRyc+C6Il2sSjZkBrPvECiD23olUJLKy9Zk2n4+txsY+v5HTaUvpBnwMKZVFVlmE8wn4T/drBpr9qQ64eMnPYZFuANuAEvIPo4oYFyFcr//SuxTTZ+fvoXgvFxS7krU/3F2/+3F2uf/qPT9u8uuVAsrN4ALMTBlxsEpUXJKrr+Dc= X-Forefront-PRVS: 0548586081 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(39860400002)(346002)(366004)(376002)(396003)(39380400002)(199004)(377424004)(189003)(76176011)(25786009)(53376002)(107886003)(4326008)(6666003)(2950100002)(23676004)(106356001)(42882006)(8656006)(8676002)(59450400001)(105586002)(53936002)(6486002)(52116002)(53416004)(6512007)(50466002)(47776003)(5009440100003)(19273905006)(305945005)(68736007)(6306002)(386003)(6506007)(69596002)(36756003)(72206003)(2906002)(50226002)(316002)(478600001)(7736002)(3846002)(1076002)(6116002)(5660300001)(66066001)(16200700003)(16526018)(81166006)(2870700001)(53946003)(97736004)(81156014)(8936002)(562404015)(42262002)(569006); DIR:OUT; SFP:1101; SCL:1; SRVR:DM5PR07MB3466; H:Pavan-LT.caveonetworks.com; FPR:; SPF:None; PTR:InfoNoRecords; A:1; MX:1; LANG:en; Received-SPF: None (protection.outlook.com: cavium.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtETTVQUjA3TUIzNDY2OzIzOnM2cEV3dWY5cnRTQkNKRUVxR2tMM2JJYVZp?= =?utf-8?B?cFFvaU9pN0JTN0FMdUJicTRnOU9nbTNWeEZMZUNNUzdwcDVwQkJscnFkdW5a?= =?utf-8?B?NDJuL2M1QXBkWFh3dGVCSzR2QmFRZzFlSmR6OUZCc2NKK01uSVV1OTVSSW85?= =?utf-8?B?M1c2ek1vVDh0NjlYNitycUVqQVdQM1l6Mmg5UXF5TTBaWWxlb0hyWEtxck1u?= =?utf-8?B?UVpzNURGNmlnUEZvaHEzcW5uZkE5RVd5NVlWL0N4TVUzeEdQaks2TTlmd0Ry?= =?utf-8?B?ZkszY0FiTDhLWTlxeTVzN1hsSE1uZ2QyYnVacU92Qk9oWDNjd28zZzIzdnlQ?= =?utf-8?B?cUlaVVg0NUZrMExVUCtJM2dwaFdxcFpQaG9GSkhXVDdHNzh4UDZNSEo5WlQv?= =?utf-8?B?cGhkcTVHUmZGeTExNHREUjhDa2tGNjUwRjg3QXN4SnBRYmRTMFV3YUY0WDNH?= =?utf-8?B?YmJnSjNKSnZrTmpMUHdMc0JRd2xxQ3h5amV6Q01YRDM0TFVHRkY1ZkNHR01X?= =?utf-8?B?aE5oQ0w3QStkdFlsLzdGWFNtL1h3ajZCTk43Y21mKzZJQTR0N2VndnRHNGRq?= =?utf-8?B?SnI3SnN6S3dySWFYL2p4VEpDVERsVXBnNUdlM0tJWjBoUTh0REZtTzZNelZx?= =?utf-8?B?T1V0SDkyeGlMaFF6UUpKQlE5N1dWbWN4S1JRMDVQVHZxV1BkWStwaTlNbEd6?= =?utf-8?B?WHh5d0hNM2pidEJ6MUFJQ3dOMGF2OUR2L0FxbFhUbHh1VlhNVU9FV3hTN3Rs?= =?utf-8?B?QmpqR0ViK0w3UzhRdUhmcWdidk83NkcxMWJHa1lEL2Z5ZnQ4RTZPcEtuRU9I?= =?utf-8?B?Y1U3YW1IYk1uV1QxMFJBSVRUd1VvNUF0b3liVWZJZXVDZXRxV0haeTdRVm95?= =?utf-8?B?aVR1VU1hdkNwYmNTRTVFdExqUkVib0FvRGI4QzJkMi9KY2tEODFqREV3MTRY?= =?utf-8?B?RGttMkVJRDF4Y1FvZnVld3ZpNXJRMTZ5RmVRQW9IMDk4OWw4cy9GWWlNZnJn?= =?utf-8?B?aVJ0WHNUc0ZsWEp1QVdkYjRYeTlIQWhGMTZJMmNvZlk5ckZORXRlV29TUHJj?= =?utf-8?B?RVZ5dTh5YmlRNnJZK1R1aWFUaC9rdGtjME9BWnpZN0IyT1pVdDVoYVowWDh1?= =?utf-8?B?bkc1bnpxbm1lbFg1U1hmSUdFckJMQUZDMGRlTFJIQ2kzd3pwUkRQVTMrVE82?= =?utf-8?B?UGJhTUM4clhoVjYrNldVT3NTSDh4UmxFOWt0SmJjM3dZYnpTVjJ4MEhlRm1l?= =?utf-8?B?UHFNcW5wR1hyRHM1S3B1RzZNWU8xNDJjNXpyZWdlVlJtcmhLTGNJanIvNXR0?= =?utf-8?B?ZmZUZ2kzY3IxMDBaaENmd2I5cXRVS1JzTm53THlrN1NONmg1NEU2WVdxVWor?= =?utf-8?B?aDBaMTFQODIwQlhGN3lNYzBndkNSQmorb0ZnUUlTcElKejI1RFdyUEkvbURY?= =?utf-8?B?SFErQ0VpSGNQYURPWitjL1BaY1Q0WjJWVndra2liZWpUdWwrMWJBcmNxQ1M4?= =?utf-8?B?R1h0ZG9PK3Jobms5cXdYUklXbnZIdzRkZW9qbktKaXBueXpIMHJrMVNLbmRX?= =?utf-8?B?ZTlOaUtxT3p2Zk1jT2hQWEc1bnRLUUdZR0M3dk5TNXNSMUxPNjQvNk4wM1g2?= =?utf-8?B?cXJYR1IrekdRam1nNGNsY0M3STUvbVlvMHlWNmlURmk3YWNTemIxaGJCTXl4?= =?utf-8?B?VU5Ha3FrZjYxd3RKcE84c0t3dlNRem9qSFlmcm5GaUtWeFdIaUJic0E1SFR5?= =?utf-8?B?OThBc1QyVkxMeExUbXJ0VHZOc21GcTZWN0ZQWXhOaDhxajVyak05OXlubTNz?= =?utf-8?B?cUY1QjZydy9WNkxYRkNpUmhJdnJEUmw1Ulp5eHIrYXNaTlg2OWcvMk1nV0xy?= =?utf-8?B?RUd0OHVhT2ZIdG43c1pwWXZHM1NBUmtEb1hia2h3VENzdGdETXNzbGtmNFFz?= =?utf-8?B?dXgwMWQ5MG5nPT0=?= X-Microsoft-Exchange-Diagnostics: 1; DM5PR07MB3466; 6:hHRCfsqYvWZE9/ZOxIJu59xOQ7nmm3qcDMMWXWIzF43QDDoDX/F+K2AEsq9phxJE6/810BKf5027GAijjUji603IaMHb84h/XNYHxt18Ifpwu9g0fVOsqjSko0qaYomiqO3kDKdLhOuwJvAWNd2hbOYlqVeTFZQxIQAL/zOhFsRnTvmq6atFYq8FvfV03A/ExofcvsVB672AwZ92DZpnrpePQ+jYWG8FwXSoxfvlzYUIKJtiMrtRwtW6qmIi5/8jOYByEbdHFW3V/f93j3/yrS5y2Tvdy9va+RUzdxtgKwISM0GTiSvOVVZy3XY3UDth3FIx+Q9OF1o2k/8xw17rt3fxwv+kCac6vucrOZ9OzIs=; 5:Q9+WnlDvKqQFs5wuDk2BuunFTXbt17EQaulhYzcQLcRGsWvTeTzIqvIKRIaqxPME3ohlerc/HRN+4DOv2YE/cXdVg4DGan4a7eyJVIix4E8C5+QnmZFRQli1c4MBAPaDrjWLdBIhz0JyORq6nhQ8bCsH4EJTsPhQU0lev23EJ9k=; 24:ORdKI9xzA9DBoKJj81EtmyDFjyeL0kN9yNH8zEBWZNaN9ClyxNV2f5Q03zR9Z6xhHB1n7BUYOIlAIyocmIDMsLGYd6oaPDAx8FwV7raXrcg=; 7:HlmcdxpNuDXGS1Egf3KC17sJdofAhzoT0s30LJfRukO9Z0JBUnxhYnOttcrsGATH0uzUKLfsQ3vt9dZDbKV8rhA/uK6P5C+sdi6Pq2fw4U0IKqX5Nk0ZGLZiU9gTymz4LA+ADmAKhmxXMDNjB6oE7qVukDgHZWO+6NBHDCHZZqXCKi1RbmiBhpRKFq9wFRpY1mgv3QJxeS6yQXADPECXuwUVxfMXD5rMvKwWCkaSrKZyjxeNA8MScfNI3pDS3Fgv SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Jan 2018 14:52:55.5293 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 7d373fa7-f871-4be8-40a2-08d55839d749 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 711e4ccf-2e9b-4bcf-a551-4094005b6194 X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR07MB3466 Subject: [dpdk-dev] [PATCH v3 12/12] doc: add pipeline test in eventdev test guide X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jan 2018 14:53:05 -0000 Signed-off-by: Pavan Nikhilesh --- v3 Changes: - add SPDX licence tags .../tools/img/eventdev_pipeline_atq_test.svg | 3261 ++++++++++++++++++++ .../tools/img/eventdev_pipeline_queue_test.svg | 3261 ++++++++++++++++++++ doc/guides/tools/testeventdev.rst | 174 ++ 3 files changed, 6696 insertions(+) create mode 100644 doc/guides/tools/img/eventdev_pipeline_atq_test.svg create mode 100644 doc/guides/tools/img/eventdev_pipeline_queue_test.svg diff --git a/doc/guides/tools/img/eventdev_pipeline_atq_test.svg b/doc/guides/tools/img/eventdev_pipeline_atq_test.svg new file mode 100644 index 000000000..533bc11b9 --- /dev/null +++ b/doc/guides/tools/img/eventdev_pipeline_atq_test.svg @@ -0,0 +1,3261 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + +   + + + + + + worker 0 + worker 1 + worker n + port 0 + port 1 + port n + + producer 0 + + q0 + q1 + qs-1 + + + + port n+1 + + + test: pipeline_atq + + + + producer 1 + qs + qs+1 + q2s-1 + + + + port n+2 + + + + + + + producer m-1 + q2s + q2s+1 + q3s-1 + + + + port n+m + + + + + + + + + + + + total queues = (number of stages * number of producers) + All workers are linked to all queues + eth port 1 Rxq 0 + eth port a Rxq 0 + eth port 0 Rxq 0 + + + + + + Event type Atomic + Event type Parallel/Ordered + + + + + mt safe tx? + + + + eth port 1 Txq 0 + eth port 0 Txq 0 + eth port a Txq 0 + + + + + Spin lock + Event ethRx adptr 0 + Event ethRx adptr 1 + Event ethRx adptr a + + diff --git a/doc/guides/tools/img/eventdev_pipeline_queue_test.svg b/doc/guides/tools/img/eventdev_pipeline_queue_test.svg new file mode 100644 index 000000000..d147bb633 --- /dev/null +++ b/doc/guides/tools/img/eventdev_pipeline_queue_test.svg @@ -0,0 +1,3261 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + +   + + + + + + worker 0 + worker 1 + worker n + port 0 + port 1 + port n + + producer 0 + + q0 + q1 + qs-1 + + + + port n+1 + + + test: pipeline_queue + + + + producer 1 + qs + qs+1 + q2s-1 + + + + port n+2 + + + + + + + producer m-1 + q2s + q2s+1 + q3s-1 + + + + port n+m + + + + + + + + + + + + total queues = (number of stages * number of producers) + number of producers + All workers are linked to all queues + eth port 1 Rxq 0 + eth port a Rxq 0 + eth port 0 Rxq 0 + + + + + + Event type Atomic + Event type Parallel/Ordered + + + + + mt safe tx? + + + + eth port 1 Txq 0 + eth port 0 Txq 0 + eth port a Txq 0 + + + + + Spin lock + Event ethRx adptr 0 + Event ethRx adptr 1 + Event ethRx adptr a + + diff --git a/doc/guides/tools/testeventdev.rst b/doc/guides/tools/testeventdev.rst index 11e608b74..527798b3d 100644 --- a/doc/guides/tools/testeventdev.rst +++ b/doc/guides/tools/testeventdev.rst @@ -468,3 +468,177 @@ Example command to run perf ``all types queue`` test: sudo build/app/dpdk-test-eventdev --vdev=event_octeontx -- \ --test=perf_atq --plcores=2 --wlcore=3 --stlist=p --nb_pkts=0 + + +PIPELINE_QUEUE Test +~~~~~~~~~~~~~~~~~~~ + +This is a pipeline test case that aims at testing the following: + +#. Measure the end-to-end performance of an event dev with a ethernet dev. +#. Maintain packet ordering from Rx to Tx. + +.. _table_eventdev_pipeline_queue_test: + +.. table:: Pipeline queue test eventdev configuration. + + +---+--------------+----------------+-----------------------------------------+ + | # | Items | Value | Comments | + | | | | | + +===+==============+================+=========================================+ + | 1 | nb_queues | (nb_producers | Queues will be configured based on the | + | | | * nb_stages) + | user requested sched type list(--stlist)| + | | | nb_producers | | + +---+--------------+----------------+-----------------------------------------+ + | 2 | nb_producers | >= 1 | Producers will be configured based on | + | | | | the number of detected ethernet devices.| + | | | | Each ethdev will be configured as an Rx | + | | | | adapter. | + +---+--------------+----------------+-----------------------------------------+ + | 3 | nb_workers | >= 1 | Selected through --wlcores command line | + | | | | argument | + +---+--------------+----------------+-----------------------------------------+ + | 4 | nb_ports | nb_workers + | Workers use port 0 to port n. | + | | | nb_producers | Producers use port n+1 to port n+m, | + | | | | depending on the Rx adapter capability. | + +---+--------------+----------------+-----------------------------------------+ + +.. _figure_eventdev_pipeline_queue_test: + +.. figure:: img/eventdev_pipeline_queue_test.* + + pipeline queue test operation. + +The pipeline queue test configures the eventdev with Q queues and P ports, +where Q and P is a function of the number of workers, the number of producers +and number of stages as mentioned in :numref:`table_eventdev_pipeline_queue_test`. + +The user can choose the number of workers and number of stages through the +``--wlcores`` and the ``--stlist`` application command line arguments +respectively. + +The number of producers depends on the number of ethernet devices detected and +each ethernet device is configured as a event_eth_rx_adapter that acts as a +producer. + +The producer(s) injects the events to eventdev based the first stage sched type +list requested by the user through ``--stlist`` the command line argument. + +Based on the number of stages to process(selected through ``--stlist``), +The application forwards the event to next upstream queue and when it reaches +the last stage in the pipeline if the event type is ``atomic`` it is enqueued +onto ethdev Tx queue else to maintain ordering the event type is set to +``atomic`` and enqueued onto the last stage queue. +On packet Tx, application increments the number events processed and print +periodically in one second to get the number of events processed in one +second. + + +Application options +^^^^^^^^^^^^^^^^^^^ + +Supported application command line options are following:: + + --verbose + --dev + --test + --socket_id + --pool_sz + --wlcores + --stlist + --worker_deq_depth + --prod_type_ethdev + + +.. Note:: + + * The ``--prod_type_ethdev`` is mandatory for running this test. + +Example +^^^^^^^ + +Example command to run pipeline queue test: + +.. code-block:: console + + sudo build/app/dpdk-test-eventdev -c 0xf -s 0x8 --vdev=event_sw0 -- \ + --test=pipeline_queue --wlcore=1 --prod_type_ethdev --stlist=a + + +PIPELINE_ATQ Test +~~~~~~~~~~~~~~~~~~~ + +This is a pipeline test case that aims at testing the following with +``all types queue`` eventdev scheme. + +#. Measure the end-to-end performance of an event dev with a ethernet dev. +#. Maintain packet ordering from Rx to Tx. + +.. _table_eventdev_pipeline_atq_test: + +.. table:: Pipeline atq test eventdev configuration. + + +---+--------------+----------------+-----------------------------------------+ + | # | Items | Value | Comments | + | | | | | + +===+==============+================+=========================================+ + | 1 | nb_queues | (nb_producers | Queues will be configured based on the | + | | | * nb_stages) | user requested sched type list(--stlist)| + +---+--------------+----------------+-----------------------------------------+ + | 2 | nb_producers | >= 1 | Producers will be configured based on | + | | | | the number of detected ethernet devices.| + | | | | Each ethdev will be configured as an Rx | + | | | | adapter. | + +---+--------------+----------------+-----------------------------------------+ + | 3 | nb_workers | >= 1 | Selected through --wlcores command line | + | | | | argument | + +---+--------------+----------------+-----------------------------------------+ + | 4 | nb_ports | nb_workers + | Workers use port 0 to port n. | + | | | nb_producers | Producers use port n+1 to port n+m, | + | | | | depending on the Rx adapter capability. | + +---+--------------+----------------+-----------------------------------------+ + +.. _figure_eventdev_pipeline_atq_test: + +.. figure:: img/eventdev_pipeline_atq_test.* + + pipeline atq test operation. + +The pipeline atq test configures the eventdev with Q queues and P ports, +where Q and P is a function of the number of workers, the number of producers +and number of stages as mentioned in :numref:`table_eventdev_pipeline_atq_test`. + +The atq queue test functions as same as ``pipeline_queue`` test. The difference +is, It uses, ``all type queue scheme`` instead of separate queues for each +stage and thus reduces the number of queues required to realize the use case. + + +Application options +^^^^^^^^^^^^^^^^^^^ + +Supported application command line options are following:: + + --verbose + --dev + --test + --socket_id + --pool_sz + --wlcores + --stlist + --worker_deq_depth + --prod_type_ethdev + + +.. Note:: + + * The ``--prod_type_ethdev`` is mandatory for running this test. + +Example +^^^^^^^ + +Example command to run pipeline queue test: + +.. code-block:: console + + sudo build/app/dpdk-test-eventdev -c 0xf -s 0x8 --vdev=event_sw0 -- \ + --test=pipeline_atq --wlcore=1 --prod_type_ethdev --stlist=a -- 2.14.1