From patchwork Wed Jul 17 15:55:19 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jerin Jacob Kollanukkaran X-Patchwork-Id: 56650 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id A9F141BE71; Wed, 17 Jul 2019 17:55:19 +0200 (CEST) Received: from mx0b-0016f401.pphosted.com (mx0a-0016f401.pphosted.com [67.231.148.174]) by dpdk.org (Postfix) with ESMTP id 971171BE70 for ; Wed, 17 Jul 2019 17:55:17 +0200 (CEST) Received: from pps.filterd (m0045849.ppops.net [127.0.0.1]) by mx0a-0016f401.pphosted.com (8.16.0.42/8.16.0.42) with SMTP id x6HFpjGj010820; Wed, 17 Jul 2019 08:55:15 -0700 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h=from : to : cc : subject : date : message-id : mime-version : content-transfer-encoding : content-type; s=pfpt0818; bh=sNqkKP1kmoJZC4rDLb32PSj4IE7G2EWdbA0kf5ZucS0=; b=i6L/iMIuO0avzdfuDnHP5D+5Hu7zcVIBuBEImhOHf3mFt8+gWA4cl1BLHrumuABQxA+/ E4xOn3cbeAyEG/G+12I2FRelFQ4o1PdzpJw4RvEInXtqm5I7vH/bB6wVg7rem65666au caRnyPQ1i7XXOn5yVt6AgCsRytp71IB7tPU4FraRMJzJVbYRDjivv8JMk5VsjNSrMA8K EOmbB/KX1YqBfN5B/VQElqmMZ3hCPYe0rdAO7pkiebV6XV4zxLoDst9O7LOiKeubky3v rkP30Z7yVTOBRhU8tSl4B7HocThf79UQvc+2wXgbK1yNW1ha6cB6rNZb+bZ5PwctEHXB gg== Received: from sc-exch01.marvell.com ([199.233.58.181]) by mx0a-0016f401.pphosted.com with ESMTP id 2ts07vgwky-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Wed, 17 Jul 2019 08:55:15 -0700 Received: from SC-EXCH01.marvell.com (10.93.176.81) by SC-EXCH01.marvell.com (10.93.176.81) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Wed, 17 Jul 2019 08:55:14 -0700 Received: from maili.marvell.com (10.93.176.43) by SC-EXCH01.marvell.com (10.93.176.81) with Microsoft SMTP Server id 15.0.1367.3 via Frontend Transport; Wed, 17 Jul 2019 08:55:14 -0700 Received: from jerin-lab.marvell.com (jerin-lab.marvell.com [10.28.34.14]) by maili.marvell.com (Postfix) with ESMTP id 7EA2C3F7040; Wed, 17 Jul 2019 08:55:12 -0700 (PDT) From: To: , Jerin Jacob , Nithin Dabilpuram , Vamsi Attunuru , "John McNamara" , Marko Kovacevic CC: Date: Wed, 17 Jul 2019 21:25:19 +0530 Message-ID: <20190717155519.48285-1-jerinj@marvell.com> X-Mailer: git-send-email 2.22.0 MIME-Version: 1.0 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:5.22.84,1.0.8 definitions=2019-07-17_07:2019-07-17,2019-07-17 signatures=0 Subject: [dpdk-dev] [PATCH] doc: update Marvell OCTEON TX2 LBK support 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: , Errors-To: dev-bounces@dpdk.org Sender: "dev" From: Jerin Jacob Add LBK HW block abstraction details and the application usage models. This patch also updates missing DPI HW block to DPDK subsystem mapping as well. Signed-off-by: Jerin Jacob --- doc/guides/platform/octeontx2.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/doc/guides/platform/octeontx2.rst b/doc/guides/platform/octeontx2.rst index f5be973a5..4194a4358 100644 --- a/doc/guides/platform/octeontx2.rst +++ b/doc/guides/platform/octeontx2.rst @@ -61,6 +61,10 @@ DPDK subsystem. +---+-----+--------------------------------------------------------------+ | 6 | TIM | rte_event_timer_adapter | +---+-----+--------------------------------------------------------------+ + | 7 | LBK | rte_ethdev | + +---+-----+--------------------------------------------------------------+ + | 8 | DPI | rte_rawdev | + +---+-----+--------------------------------------------------------------+ PF0 is called the administrative / admin function (AF) and has exclusive privileges to provision RVU functional block's LFs to each of the PF/VF. @@ -82,6 +86,23 @@ resource provisioning example where, 2. PFx-VF1 ethdev driver bound to the first DPDK application. 3. PFy ethdev driver, PFy-VF0 ethdev driver, PFz eventdev driver, PFm-VF0 cryptodev driver bound to the second DPDK application. +LBK HW Access +------------- + +Loopback HW Unit (LBK) receives packets from NIX-RX and sends packets back to NIX-TX. +The loopback block has N channels and contains data buffering that is shared across +all channels. The LBK HW Unit is abstracted using ethdev subsystem, Where PF0's +VFs are exposed as ethdev device and odd-even pairs of VFs are tied together, +that is, packets sent on odd VF end up received on even VF and vice versa. +This would enable HW accelerated means of communication between two domains +where even VF bound to the first domain and odd VF bound to the second domain. + +Typical application usage models are, + +#. Communication between the Linux kernel and DPDK application. +#. Exception path to Linux kernel from DPDK application as SW ``KNI`` replacement. +#. Communication between two different DPDK applications. + OCTEON TX2 packet flow ----------------------