From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM03-BY2-obe.outbound.protection.outlook.com (mail-by2nam03on0084.outbound.protection.outlook.com [104.47.42.84]) by dpdk.org (Postfix) with ESMTP id 795029B6B for ; Thu, 30 Nov 2017 14:12:00 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amdcloud.onmicrosoft.com; s=selector1-amd-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=J8lRxHn53q/yABiEFnwjJRtmhmZ8BjVwZyIejYxk0W4=; b=RMnoDu1Rk5KCBfZgGzhDUyJ4AJ5k8ikmCck+RIaWNVUPvsESP4010twi4ewf8aaPjHtF68t+nEzrspWqPVYM32jY8+PT+6BoXPPW/n0r9Prisv4FIiOgTbQlKMKYdYvq6LrMwr4/zwdZxWr5OWyBXpcOEi9TjhRgde1rpYJhUeE= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Ravi1.Kumar@amd.com; Received: from wallaby-smavila.amd.com (202.56.249.162) by DM5PR12MB1514.namprd12.prod.outlook.com (10.172.39.146) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.282.5; Thu, 30 Nov 2017 13:11:58 +0000 From: Ravi Kumar To: dev@dpdk.org Date: Thu, 30 Nov 2017 08:11:10 -0500 Message-Id: <1512047472-118050-14-git-send-email-Ravi1.kumar@amd.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1512047472-118050-1-git-send-email-Ravi1.kumar@amd.com> References: <1512047472-118050-1-git-send-email-Ravi1.kumar@amd.com> MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: [202.56.249.162] X-ClientProxiedBy: MA1PR01CA0077.INDPRD01.PROD.OUTLOOK.COM (10.174.56.17) To DM5PR12MB1514.namprd12.prod.outlook.com (10.172.39.146) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 5efe787a-daf5-408b-1326-08d537f3f03c X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(5600026)(4604075)(4534020)(4602075)(4627115)(201703031133081)(201702281549075)(48565401081)(2017052603286); SRVR:DM5PR12MB1514; X-Microsoft-Exchange-Diagnostics: 1; DM5PR12MB1514; 3:DGkQbRQgFePFLurUvFp3S10Yz1dASGQfTAb2w2vtkjtWH3hWDBUBVKFRkZ6g77bT8c60v9tXIm61NBfWe9ggDjFWIFFkbjfb8Z1Ufhs6jJ84Hue63IclZ8Cx+ERs3oY0yDRWtUqxv9j5T51MAaHNkBFuxR1/ILn1ZeHbn2oYwGo4+h/VuWZMk8sn4TsiHCj/um1nhcKFHHB26qoxUwirPRSw24gnRtOAHJmoTYLwLNSjtrh96SGRe64KsSzfxmAI; 25:1dtLriRq9b8FuLfLBnQY8zH3jIagdIjDcCfyvhVoch/Pcp5CdJ7GPK46HNoZTvfYGnI0EvnnduyUrBX/JHw9Mgai0gN0Ril8E28mqYmiyKgcWQK4DJzG058z+gQd5TcSWCG4YbX35RBvaZDP2sO/sBDnmTwpTnd5lACL+uK8nvYzPVtt1vWUab7rbjxqJFrWSLnGOFuBqQFHHkEiSqpqkrRA8Gb+1VmYy2vaAQh1/KBHWCB41DZwJY3G6eDDO38Mssf2IaOuKM+UzQaqcxY4tKZM7m9ZF0r4t5xhU3qMLAj/Udqiai1ek9QKFeQPDUCtUj8uHEihM7ikKQGsEV8Cfw==; 31:JKL1bEsJ9AGsylxcx38L0BbdVYXHR89P8v4AGmqYSJpS2iD6yPCQOfdFJWG9oDQ14FNZ9RbzINgkDzMuyIcJIJ7F2fS40VxEqhXacFgmnFSb/6rIw2E+4+/U0i0QmeAsoG1WMtpjJpHkYpmyloOpeb5j6kjptxYgdMNlL+91YFHK4u5nvDGOEWeKPTR9qaOMzplDI/o7PztdC8XNw0Tq9IOSgJbKdFotwEcPhqGNSnk= X-MS-TrafficTypeDiagnostic: DM5PR12MB1514: X-Microsoft-Exchange-Diagnostics: 1; DM5PR12MB1514; 20:khmufEu1Td0O0yLmsyeMPWqWHzqMB0uhfyWCUb91JrsgVw2DigHvwHHRXfJv6VSWS5a22/IJRflJ0ivoX5nwdXXGsPGuMt/tXycoiU/tTKHtLWkHDzmxcYjitxxhiPpc+VTECZwenGwlEYLCRp+tDLdMhP3RpMi4IpGiWeOvOjYJdRH2LwAo3JAE9+r/N5+uLhtAYfE3tvtRzjOAmbRKPmWzWuRc2c6mR6zDB9HxQ7GWBBbpds/fGlZZv06d+CC66NLVCdJFbrztEa3+gdZvGfCIhznLmxIUG3XQEycg3X6PLMJSryAv0oBBJ3/0BfvDWr5EUgCDccVGBwCVpdAg7IJYemmPxRUKLRU/YmwTA+SXTAWBoInpQZGDKOHF8fSV1TszvTNLflQZOQiqTyaNkxZNP1GkNkM7TM4/ejfkC9L70Ta3VJB7S4BMAjLZgZqjXSO6xP+9asRZtmtUfYoL3QLtQsAX0FOU5DKaB9vpyGJQph3AGIyw79HmNuJmxF+o; 4:UE2snSYSl558XMmS8ch5fPJbe/gShgG6g1lAd7xEL9Xtx64uQzIVB8HUtl8t+PC7WRR2Xtg9A5wWXUG3Cw4xoeY94E37q9/CsreCONVlAqwMv0xf/r1ChDRSnrVhNxw2Ye/NgPIF0YLbdHiwvBuVhmGIViFxDrC12LY0BEyaBXuQ2WHET89b7Or79p8yWo2hYCgfsH9Hk7PjJUEZWGjI4IMBDBA2iL57sdz6Qxza1TU4SLNycnLwfJD2iz/UfHlp84qO3tBC7MygYJVby0x9+Bbc+NBsnvAfQnhsPorBjx7AJUDteGI7JdA6Nz3VD7x9B22tGieMOTQm9P+b5YYMh4PIM9yzrJruFYOsU0Sb5JDHEf5VpIbtS6ngIgvm8IoZ X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(250305191791016)(22074186197030)(767451399110); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040450)(2401047)(5005006)(8121501046)(93006095)(93001095)(3231022)(3002001)(10201501046)(6055026)(6041248)(20161123555025)(20161123562025)(20161123564025)(20161123558100)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123560025)(6072148)(201708071742011); SRVR:DM5PR12MB1514; BCL:0; PCL:0; RULEID:(100000803101)(100110400095); SRVR:DM5PR12MB1514; X-Forefront-PRVS: 05079D8470 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(6009001)(366004)(346002)(39860400002)(376002)(199003)(189002)(48376002)(16586007)(6666003)(68736007)(86362001)(316002)(101416001)(2906002)(50466002)(8676002)(51416003)(6486002)(72206003)(50226002)(16526018)(50986010)(76176010)(53416004)(189998001)(7696005)(52116002)(97736004)(53936002)(6916009)(2351001)(2950100002)(105586002)(66066001)(106356001)(3846002)(25786009)(2361001)(81156014)(5660300001)(36756003)(6116002)(47776003)(305945005)(478600001)(8936002)(7736002)(6306002)(81166006)(2004002); DIR:OUT; SFP:1101; SCL:1; SRVR:DM5PR12MB1514; H:wallaby-smavila.amd.com; FPR:; SPF:None; PTR:InfoNoRecords; A:1; MX:1; LANG:en; Received-SPF: None (protection.outlook.com: amd.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DM5PR12MB1514; 23:3Zn/jNs/W5dvvLbPVulDSt0pd6vWKpO2/dM9Ot0+y?= =?us-ascii?Q?VkUXpbzkuvHVxVUYUPvpLAppz8WIBKjPdKDuR0+d/cPAhjhwJVuaZzv9zKhI?= =?us-ascii?Q?tCJE04lvvxxXXfUv4vvtMWB6Xjpi4HT9zJJv+Z9BSYj3/JnUn7871NlMZ4I3?= =?us-ascii?Q?Qz78ETFaXfLs2HdgCMW5UH6rar2UD6PpLvOU6DDC8yO9LVa9IRG/CuonC74g?= =?us-ascii?Q?ebYi8Kul3HVBmL5c2yM4a5O5I/eFB/bsUr7B7Exzq5Y8I6ITlhfLLfIsbSO5?= =?us-ascii?Q?RXPGwHg5KZHvMACIBaU8pMMTWA7kexXzmKeaGjRnoemmZ5haTbKjpp+77Mx7?= =?us-ascii?Q?JTxepQ50ywXQydwdzdypWJmiX/ejLWy8ybpkw9uvW7pQ7YneHySvtaKc6w7N?= =?us-ascii?Q?kbiN6oXN0p2jJTt3TRCIZYFXXQp5Fsp19HAkX+CttQruY1CbnZ6s7o0tEdXS?= =?us-ascii?Q?Lk2E3PmbJ3Xf54rgaYzUcn8vg1tDO85DigdR9YH85czNSaQiWfBoyzLW+fJM?= =?us-ascii?Q?t7iAe7/ALig0f90Jd/DHCnq+tvXO+nNeqPjygOhPDx1ZVw9XwChsQWALkHL6?= =?us-ascii?Q?ggbXFHLa2685/4BUSvcPUBH6H8iVl5SaH6KXfJFvbGdBnXlPAc7NXbTxCc5J?= =?us-ascii?Q?byLYChsKJZo7vLhj8D0ni5nhrG70nhOaeDLltmiWGV8pu7/cnsDOXuJPfhn0?= =?us-ascii?Q?3Zzz0ddNF+s1WfoWoKBxYytC3TvDTqBPzE9iuQKK2hDQsDQc5DovdJflyITt?= =?us-ascii?Q?zdGI4xFDZu5Z+xnSIZY14aqxS/GF+RWWI4LX20+wUlI2LubeccymVV+uk/NE?= =?us-ascii?Q?hA/88rSdHoJtL5hUbpQo8QthZARnxD0O/KOqFmX72Q5KQs4ILnD1CuQMLJuF?= =?us-ascii?Q?4ZaUJiMrV2zoN1OOkKm4jvhIDm5B1UaqKyf9GK+U5nPgrdb9Pc+QNwZh3V0J?= =?us-ascii?Q?0RwnWHf17WMPqV7ppbPmHICv9LImml2Gva+C2ib1qKSVqrqIMrJpD5a+kO/o?= =?us-ascii?Q?P9YiBqIoKmP+gqotFFL8bFuj9xWmr9Oxc5X1iBsbP8sLWgo4pK4eue0Q0/pK?= =?us-ascii?Q?PpBr6Ap4wrQdlSsZngsOYc0ruevd0VxeJga8uR7d/m0rZF1bG+f+CdrRks9M?= =?us-ascii?Q?R7JaN/rTO3F2xDw1NDKL2MVefB5+zF/aIHsUPk3k8s0WfP3np5Gbha0YC0ON?= =?us-ascii?Q?8oDgZ1q3XhWAwU=3D?= X-Microsoft-Exchange-Diagnostics: 1; DM5PR12MB1514; 6:Pn06vxkfu2BPyBK9vDRu13Kzv2dCP9YSGn/4E18gJLIkEEIsItQwYwWFVRgd86HH+1HoyerL6UK9nlUjs9WbTeCzUVq9jxEUWSAnq1Uo6I0uKUEexIGWZyc/jYiNxUdIJBNxx77Qd5nuEZdUXn02+n8lCxFeAePl33htCpSNFqltSYmyv10Gc76rOL84KhbGG+n+giJ+xX2gfr9J7FlNeCFgj+osIAn0Q0pzxAuiZJ0PToObnjwBbwxasFuVfuFMq1xmih7UJ6BW5FMYmf/PY5OMO05n+pB4het1N1HxmI7QWlGRBf49bl6q4sVbMUQGbXQXUN02zwRcmghMh9WzRXUFMJid547W8cfT/gjFtlw=; 5:1JjoWgDZsbaQHRr8Fn1duu5leaLlKuEPZkvz3TGrbd/y8MViQKbso3V3nc5sVCZNreUOZ1bLf1TD8vs7dKAth1HhRW5JnOBoJ3nF9by9gECBxOK1+u0RaF7E8CafuAmGibrj3VUYARg/cBX8wGxcgUUje1cLZ1nmp8DkT3pGSjo=; 24:Tf8jJdioutzpMG6jJCmOAx2HPNnqVLXLJUGfWE3o7Ylwytzd1wv9zLD2nE7BHlXJBuNN4HZd26dwA4XOibCo5QUBdMv6+5u0Ib1gvb7nlzs=; 7:WMDWWqgvg/9t6Amh1xsFO50Vz8xkCTqvdC6bvUNrbLz5t3ax1rsP6tuA/CQtlRJw+NGVHhOBBDV9wp9gcJ2IySANCbinDaUt8OmPAGUWetbBKdo6KfZ4O7tcTEIQ2Th+ewqRrYoB+R2d9Z14el49v/RhYOkqHBOCn6dLRMz9TqqsE9D8mNuA5shfvdk9BRD4W+Enk5V+urI+W5oG6k4bE8QdcQF6yEcbZHxgHH1wuLd1UfRvIrbVoTs+q071A5CM SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM5PR12MB1514; 20:pMAFXtyz0b1JPGUz6QMafu1NJJD0328OhVnnMyGPMY6bfrHjkMrbOJEvoV32xEmFRk/GeuyB0V5OlCyFFl+eNSRO+dZ0Ie6zCV++SB2/p8OeSxwFHmN2cx4NH0y1WkSh4g3nbhLiSEdqDOfsdyNsWMkwR/j9kUy4dSsMm38QwBqDgStXfVINMatQllK+DV4Wf41n0/TQEXk6MkxS4laRycXOFJYEeefqDTCQtz6qbp4kqALR3zfrE/YT3kDXoWM9 X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Nov 2017 13:11:58.1873 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 5efe787a-daf5-408b-1326-08d537f3f03c X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR12MB1514 Subject: [dpdk-dev] [PATCH 14/16] doc: add documents for AMD axgbe Ethernet PMD 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: Thu, 30 Nov 2017 13:12:01 -0000 Signed-off-by: Ravi Kumar --- doc/guides/nics/axgbe.rst | 214 +++++++++++++++++++++++++++++++++++++ doc/guides/nics/features/axgbe.ini | 18 ++++ doc/guides/nics/index.rst | 1 + 3 files changed, 233 insertions(+) create mode 100644 doc/guides/nics/axgbe.rst create mode 100644 doc/guides/nics/features/axgbe.ini diff --git a/doc/guides/nics/axgbe.rst b/doc/guides/nics/axgbe.rst new file mode 100644 index 0000000..96e25f6 --- /dev/null +++ b/doc/guides/nics/axgbe.rst @@ -0,0 +1,214 @@ +.. Copyright (c) 2017 Advanced Micro Devices, Inc. + All rights reserved. + + AMD 10Gb Ethernet driver + + This file is available to you under your choice of the following two + licenses: + + License 1: GPLv2 + + Copyright (c) 2017 Advanced Micro Devices, Inc. + + This file is free software; you may copy, redistribute and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 2 of the License, or (at + your option) any later version. + + This file is distributed in the hope that it will be useful, but + WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + + This file incorporates work covered by the following copyright and + permission notice: + + Copyright (c) 2013 Synopsys, Inc. + + The Synopsys DWC ETHER XGMAC Software Driver and documentation + (hereinafter "Software") is an unsupported proprietary work of Synopsys, + Inc. unless otherwise expressly agreed to in writing between Synopsys + and you. + + The Software IS NOT an item of Licensed Software or Licensed Product + under any End User Software License Agreement or Agreement for Licensed + Product with Synopsys or any supplement thereto. Permission is hereby + granted, free of charge, to any person obtaining a copy of this software + annotated with this license and the Software, to deal in the Software + without restriction, including without limitation the rights to use, + copy, modify, merge, publish, distribute, sublicense, and/or sell copies + of the Software, and to permit persons to whom the Software is furnished + to do so, subject to the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THIS SOFTWARE IS BEING DISTRIBUTED BY SYNOPSYS SOLELY ON AN "AS IS" + BASIS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A + PARTICULAR PURPOSE ARE HEREBY DISCLAIMED. IN NO EVENT SHALL SYNOPSYS + 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. + + License 2: Modified BSD + + Copyright (c) 2017 Advanced Micro Devices, Inc. + 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 Advanced Micro Devices, Inc. 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 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. + + This file incorporates work covered by the following copyright and + permission notice: + + Copyright (c) 2013 Synopsys, Inc. + + The Synopsys DWC ETHER XGMAC Software Driver and documentation + (hereinafter "Software") is an unsupported proprietary work of Synopsys, + Inc. unless otherwise expressly agreed to in writing between Synopsys + and you. + + The Software IS NOT an item of Licensed Software or Licensed Product + under any End User Software License Agreement or Agreement for Licensed + Product with Synopsys or any supplement thereto. Permission is hereby + granted, free of charge, to any person obtaining a copy of this software + annotated with this license and the Software, to deal in the Software + without restriction, including without limitation the rights to use, + copy, modify, merge, publish, distribute, sublicense, and/or sell copies + of the Software, and to permit persons to whom the Software is furnished + to do so, subject to the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THIS SOFTWARE IS BEING DISTRIBUTED BY SYNOPSYS SOLELY ON AN "AS IS" + BASIS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A + PARTICULAR PURPOSE ARE HEREBY DISCLAIMED. IN NO EVENT SHALL SYNOPSYS + 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. + +AXGBE Poll Mode Driver +====================== + +The AXGBE poll mode driver library (**librte_pmd_axgbe**) implements support +for AMD 10 Gbps family of adapters. It is compiled and tested in standard linux distro like Ubuntu. + +Supported Features +------------------ + +AXGBE PMD has support for: + +- Base L2 features +- Unicast/multicast filtering +- Promiscuous mode +- Port statistics +- TSS (Transmit Side Scaling) +- RSS (Receive Side Scaling) +- Checksum offload +- Jumbo Frame upto 9K + + +Supported Chipsets and NICs +--------------------------- +- AMD 10 Gigabit Ethernet Controller + + +Configuration Information +------------------------- + +The following options can be modified in the ``.config`` file. Please note that +enabling debugging options may affect system performance. + +- ``CONFIG_RTE_LIBRTE_AXGBE_PMD`` (default **n**) + + Toggle compilation of axgbe driver. To use axgbe PMD set this config parameter + to 'y'. + +- ``CONFIG_RTE_LIBRTE_AXGBE_DEBUG_INIT`` (default **n**) + + Toggle display of initialization related messages. + + +Building DPDK +------------- + +See the :ref:`DPDK Getting Started Guide for Linux ` for +instructions on how to build DPDK. + +By default the AXGBE PMD library will be built into the DPDK library. + +For configuring and using UIO frameworks, please also refer :ref:`the +documentation that comes with DPDK suite `. + + +Prerequisites and Pre-conditions +-------------------------------- +- Prepare the system as recommended by DPDK suite. + +- AXGBE PMD works only with legacy interrupts, so load igb_uio module in legacy interrupt mode + using module params. + +- Bind the intented AMD device to igb_uio module. + +Now system is ready to run DPDK application. + + +Usage Example +------------- + +Refer to the document :ref:`compiling and testing a PMD for a NIC ` +for details. + +Example output: + +.. code-block:: console + + [...] + EAL: PCI device 0000:02:00.4 on NUMA socket 0 + EAL: probe driver: 1022:1458 net_axgbe + Interactive-mode selected + USER1: create a new mbuf pool : n=171456, size=2176, socket=0 + USER1: create a new mbuf pool : n=171456, size=2176, socket=1 + USER1: create a new mbuf pool : n=171456, size=2176, socket=2 + USER1: create a new mbuf pool : n=171456, size=2176, socket=3 + Configuring Port 0 (socket 0) + Port 0: 00:00:1A:1C:6A:17 + Checking link statuses... + Port 0 Link Up - speed 10000 Mbps - full-duplex + Done + testpmd> diff --git a/doc/guides/nics/features/axgbe.ini b/doc/guides/nics/features/axgbe.ini new file mode 100644 index 0000000..042ff1e --- /dev/null +++ b/doc/guides/nics/features/axgbe.ini @@ -0,0 +1,18 @@ +; +; Supported features of the 'axgbe' network poll mode driver. +; +; Refer to default.ini for the full list of available PMD features. +; +[Features] +Speed capabilities = Y +Link status = Y +Jumbo frame = Y +Promiscuous mode = Y +Allmulticast mode = Y +RSS hash = Y +CRC offload = Y +L3 checksum offload = Y +L4 checksum offload = Y +Basic stats = Y +Linux UIO = Y +x86-64 = Y diff --git a/doc/guides/nics/index.rst b/doc/guides/nics/index.rst index 23babe9..31191a6 100644 --- a/doc/guides/nics/index.rst +++ b/doc/guides/nics/index.rst @@ -40,6 +40,7 @@ Network Interface Controller Drivers build_and_test ark avp + axgbe bnx2x bnxt cxgbe -- 2.7.4