From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM01-BY2-obe.outbound.protection.outlook.com (mail-by2nam01on0085.outbound.protection.outlook.com [104.47.34.85]) by dpdk.org (Postfix) with ESMTP id 0E8A91B1E1 for ; Fri, 5 Jan 2018 10:53:10 +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=zo26ecUXpHr3hCITo/9rEtogjRz0B8n2z2IsTcTjHvM=; b=mcN5XqhYWDcfaLiVcJJ9A0pf9vMDkU0O6FBPA7daf9oV/oK2NwP0pAmc5N7F9UnYoAZcA3waYX1EYRXHEF5ek0wGiad7/t7Rtl2C8TPh/E7RHBmZMY9ouO5On3DAGtjAJ6AuEuuvbyXkVouswMoeAJWmvvkyN5KPYtpOK1wVFpk= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Ravi1.Kumar@amd.com; Received: from wallaby-smavila.amd.com (202.56.249.162) by BN6PR12MB1506.namprd12.prod.outlook.com (10.172.24.147) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.386.5; Fri, 5 Jan 2018 09:53:07 +0000 From: Ravi Kumar To: dev@dpdk.org Cc: ferruh.yigit@intel.com Date: Fri, 5 Jan 2018 04:52:13 -0500 Message-Id: <1515145938-97474-11-git-send-email-Ravi1.kumar@amd.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1515145938-97474-1-git-send-email-Ravi1.kumar@amd.com> References: <1512047472-118050-1-git-send-email-Ravi1.kumar@amd.com> <1515145938-97474-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: BM1PR0101CA0031.INDPRD01.PROD.OUTLOOK.COM (10.174.221.17) To BN6PR12MB1506.namprd12.prod.outlook.com (10.172.24.147) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: a40b0ee2-de74-4d99-f463-08d554221fd4 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(48565401081)(4534020)(4602075)(4627115)(201703031133081)(201702281549075)(5600026)(4604075)(2017052603307)(7153060); SRVR:BN6PR12MB1506; X-Microsoft-Exchange-Diagnostics: 1; BN6PR12MB1506; 3:JYNjb6ALo64sr4Ar/mSmUYkK1Tkx/zpD9J7oxh1tAhK4iUySv9s2phPlBnGewCIMhrE6WRFtiUL3DLAJtMyWQ+glhMFNSnJwtLZ/AlSEzsOp+Tv9xNdx1avyQZfiGIXJlZyWjDO4ayWXjltgPShcJXMbaHQlIxe5Ez0eQhWdYWwrwyTtq2VmhCJBmdlyVAL6zYXaML7EMhA1ZvVNlaYTS1aZyxM+a66sMg20vXldFmyeFqEqJCZQsnVpCxhDYWF2; 25:DIcssKpyiBsKM4gnQbPtm3xSrbTh32we316MNEBho2MBDSj9TBaI0dQriZHu5/PFaKTAaHIkZJOMw5/TuwIhvtnB4VKK9IdYQXkr4YfOecwsdt1VxXNaJi2jTHLl8AOtugXKzXIF+FNr7N3xEBAsjnxTo05ZSEwk+J2/dqePDwblD+4EJOs+sXk+hLJg6KrRs/TQFeDdplo7YHci5wV1BKAIVt/0bYVCDDdIm6sdUlCvJ7WMgCFWMnM8DJPCVGqGM1p0kbK1d9YQ4AxFb0UYWtX7UAH9v8nos2dcmanw1TFVWaZ0aaC6lLqZ+hmY95RsBkSHqihnb66uNdAIN1AsOQ==; 31:RhdvXPmawKuq+Kh7ACTuIKpQeuMcPhpGUy36Hq+KFsvqMuQFVNiM9VLnd8M+JPcm/lBwvFKcCKpcGJ7BFDOVP50JG4LFwHuDrVZxE42GAPf7/yv7ePqvcIC9ky6Gqshfe19HWXMK45AwK7XX7GJU6NLlPt5lDwKI6gUOHZpqHP1c87mRDzT9F95ddL2xegLrwoXWveTiaOMVoe0uZ1U84kgbQkri93+NXACjNFPUyBw= X-MS-TrafficTypeDiagnostic: BN6PR12MB1506: X-Microsoft-Exchange-Diagnostics: 1; BN6PR12MB1506; 20:T6CS3vdclu32pTaCFMRLSuJrZVQGc6ZI9RVsDmrIO+Ut7fL62hUmbLXp9/C3tDXnX+Hjgx4GdEUD3xNgY9bkJrcrtcuVgK44Jn/Zy2JC8170LOUpazG3On3K5yNet65cS6Beq1TmmXKpZFjMulcFAAL6eKC0tsNwNDwZ6roRfqSMQiXEQWGGm21irMJtrQHTxkwEE8nRHBFm/mBZKOIPVGuF8N/O+9FOnG+LsE1jep82LNV3O73y02ovk5cPrlr+s2WNpekYqHrAZhQYb1LISaPFL7sZRWfb/nPlXy488Uck+syQkoT9aEVBVgiZDDUkZ1dlv+WwFLP1XrPxRFrR3B4Onh+3dqHUqkf0VFoZc/NlGAmXT5DfJsoRu88em3EHYPVEgEOLjMHUsR3+XdtFh1end6lYuxUydpoc70y1AR+fBc6ErCpEcMflfR9YwnDEt25AN0+6XKYLNbGwewUJFFcWStOFRcAIvLcIEQe1VcKeuvT5mX2n3UFuqgZkZQet; 4:rPpTIqGfjJOZVhYb479h8p3v0hLHHDn0LiuTVUokN/pzhFmr6wLubGJYV7K1sqTz04wVbH7lKe80jMDkfBI64Y+mM/yuQomGNTctEihjthOCaFC+FHZSZ/kyUCfAPnCyv/aUbEhTRtdF+n4QWdV9BFEYTQgJRF4W3MgYFhDZDKgfFb/scaakj4lqMmkx739CfEBjSySGx25ScVt6uuT+XgVCLxL2bk1ktBF87l1spBFEDRThpkGx8HzP/wzVdcq3eC7Oa/kR2yDXY6+tkgEL9TWIjUkwevabkqVsmhyJFEC8AP9KOF6Dwm2NyhANcV3J9FZ3sAHcPQWDV3sUENBnn+TkdDzbjbKqx7vm94EissK3QUSU2oZfVyVHkZu5voWD X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(250305191791016)(22074186197030)(767451399110); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040470)(2401047)(5005006)(8121501046)(93006095)(93001095)(10201501046)(3002001)(3231023)(944501075)(6055026)(6041268)(20161123558120)(20161123564045)(20161123560045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123562045)(6072148)(201708071742011); SRVR:BN6PR12MB1506; BCL:0; PCL:0; RULEID:(100000803101)(100110400095); SRVR:BN6PR12MB1506; X-Forefront-PRVS: 05437568AA X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(39380400002)(346002)(366004)(396003)(39860400002)(376002)(199004)(189003)(105586002)(4326008)(53936002)(36756003)(68736007)(50226002)(7696005)(8676002)(51416003)(52116002)(25786009)(3846002)(6306002)(106356001)(8936002)(2906002)(53416004)(6116002)(81156014)(2361001)(6486002)(81166006)(47776003)(97736004)(16586007)(316002)(66066001)(305945005)(48376002)(2351001)(478600001)(7736002)(16526018)(6916009)(2950100002)(6666003)(86362001)(59450400001)(76176011)(50466002)(386003)(5660300001)(72206003)(2004002); DIR:OUT; SFP:1101; SCL:1; SRVR:BN6PR12MB1506; 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; BN6PR12MB1506; 23:Ok0eRXnrrW2IBA6XcPXxuNEN8FQZRL4/9t6b2RVqE?= =?us-ascii?Q?/APZSVfnF5RBs+dZPiFCtSuUs8KvEJ/rYpskyLuJiuYsAKZXccNZLgTE+C90?= =?us-ascii?Q?CK79+2hc+XcCCp0kLhVibxUpLokIZH7yvKfba6PuPylVpPYnVIGlKlYiTgRS?= =?us-ascii?Q?Q3cRM3w2w85cSKB1AlbKz/6zuTunO4pvRCEa2vSXVqMlAhsXy+nilBNz22LP?= =?us-ascii?Q?oqk8088H3eNPplVArO8sekOQuNUJv7+aq13paYxnlTmXs6/BwBPxNfxp0Cek?= =?us-ascii?Q?czmf+JVXSs4i2bwvU4FCsr+Kl0XiJCfYkjIrZ/KTSqNB/X/7vvrlfo3oiJux?= =?us-ascii?Q?PXWfEm5bgCFexGRRca9hFheYrSnEV0TV3c9nb0g5+oY/AjaRhQV0D2lGaUY9?= =?us-ascii?Q?BDSswAAin7l4rhXRH0Py6euk4PihzLKu2B5iS74rvVXqq/7ETSibL51KHnTB?= =?us-ascii?Q?9nG6YGLUzZy/kxqYukE7z58Yz2T7GTw8GZ08rf1ZvS2/vY9QnH3r+/+X9BhE?= =?us-ascii?Q?Ui0MR+P71fPVpOP7eXX5d3U3PMi3DE8k5CugcPftrMNp9eM+sFNfEq//Dd0W?= =?us-ascii?Q?3jbxJLwLUndj4a98K1CKI7Z6EQd4Sv1Q9JiM9BWMhguUOOIMERH/4CB6cJIh?= =?us-ascii?Q?g4XFlGhBymY//UVFS0IGJQIXnjFOLix2vzKWGv2d2SsGadsOymxmlrkRB8pk?= =?us-ascii?Q?bpPVl+OTKKVbu2JwIvmv++Cto5CwsgVK23eR0785ZBf97i/gSeRTP/ONDUIE?= =?us-ascii?Q?NlMf3/hF9Y9G3fdNnPOZKX+PGYUKhQk95CdBDndeM87P85duoK5piPdsk+a+?= =?us-ascii?Q?lRk0RNAYJnLcK1w4zUCz4ooyMimpD9G5U5TFAuW17y/r1QSlqLnTmsVv35Ia?= =?us-ascii?Q?14dtqe0ruH82+I9VtAnv76oXaZ/pHfx6QxeLXNKHKGXkIrLrWw9uSSNKik3L?= =?us-ascii?Q?v0Kj2vTPRlo++1uv2B7dCFFGTmf1PSqgrbfPSAMRNarQsDJ0MXMQUu/IO2VB?= =?us-ascii?Q?pLz1OqlBpstfl7slsOuryU6T3nb5UhFnFeAyrcrLZ4Ei3gOlQLK4yZwFyLqL?= =?us-ascii?Q?XpBZ+ZDCQzhIipTKlPsqpnu6zMVM4iG8q3t7/97Hsu2VRoa0pMUWwnCsdvRn?= =?us-ascii?Q?rVVPkvr+f53iOvUSGog1czDiZ1eTFepBJw+WQoc3pU0vnMolFjmriRkJDbYW?= =?us-ascii?Q?H0/lW4ZoMnLoXSLdy5GzoM6pUaR6S56vLhf?= X-Microsoft-Exchange-Diagnostics: 1; BN6PR12MB1506; 6:tqKIAYfKyJKSTM65g/AAosaRsfulG1OnhOeK6uxdPqkfXhM99w0aa9xa8AaKGMmFpOKmTg/JtJ/PS2E8EW5AikRxKMGXdE9LogPDkdMr3x5+JWz3E78ozQPWJBTjyzGenm4QrnH9gK0ezTlKHna1IsJk6rluNjGVC6+T0i80xNJLHVU2ZfApsAMGZkivzUOhCjEcSKRc16zA8GoSXpeIZuYd0JmMAfr19QHz6OU5YN+5B9VqFQy/hTC8GICzkgJcsyQufYrtRtZppdupSWQ8LoOWDEEAPQCMZ1eNu/hnrT39D7el52yuNBtg2OCQMd/4fP2NpBpjdjKmWGGKD8M1yNMxdWnCOP7gv5fEBlM6/Wo=; 5:1f6XeLW4nzZdJ+EQuOzQZz5C5ye35oNvqSxWPUcZzZXLLMbLx62e5aYpYw+a8JJdGqvGdVq+qcvTyF06JmCHPQFYMO3aNdv42ONCT8C6xelPZ0ciU8em4S+HBdFFc1Z7B3lokLrMBcMIcOM/F9f3tocD5IuxACupBIpkm+5xLyY=; 24:JpfbhZwCYOjDNh+Qt8mNJso8BnEbrdiY+iTIIU2nZ1SJ9jPlES3jGBTvDByazGcWAYItCwJjI0p+eB/xYZjfi3YiEFrO4vI+hm3G+XMvdt4=; 7:7qL4RJnX0xwWmLL/B7yla0sNhXReTdjfmX2sqTs5klyIj59EKdsF3B3XIftJvE1asfANGKZv+feu4Pm4HlMO4duWC6Xp6GuVuvSmHYrf/M+B1sCHz527O5VOG0YUOxrmpw23AWfoFUBvml1gh7a16AZ0UY3wGs5YD9vgZf6xFw++S8E76YdvcnbyQEt1F+pD5VZYDx25PX2rD1ImjOpnQMftSw3qwW86l+vxKliy3nUrHSTl0T9IeKcgKu6ji1eY SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; BN6PR12MB1506; 20:lgCnmPh6clb0tfGVPnjqz60IwnfGnc/xdHjPY95+3z1W+KNNa4HPfgqGXs/tdpKldLl6ue+fTprKaOykN/mRkF61+GDDMcM0j+2QDUJreYKIdoMqMks/TajgEkTjxb2HygTfvShwCB3Mgw85ketSkdHIbMv1S+2tussLPMKDpl5NH452G9rouFIvivwFRyPV98yM1V/HqdSYtdqamCkuqeqlXn8T1+Chccdw5u83rdIpLYjZRw2xgIa8GP+//EEH X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Jan 2018 09:53:07.1370 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: a40b0ee2-de74-4d99-f463-08d554221fd4 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN6PR12MB1506 Subject: [dpdk-dev] [PATCH v2 11/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: Fri, 05 Jan 2018 09:53:10 -0000 Signed-off-by: Ravi Kumar --- doc/guides/nics/axgbe.rst | 211 +++++++++++++++++++++++++++++++++++++ doc/guides/nics/features/axgbe.ini | 14 +++ doc/guides/nics/index.rst | 1 + 3 files changed, 226 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..e9bebb8 --- /dev/null +++ b/doc/guides/nics/axgbe.rst @@ -0,0 +1,211 @@ +.. 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 +- 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 intended 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..f644128 --- /dev/null +++ b/doc/guides/nics/features/axgbe.ini @@ -0,0 +1,14 @@ +; +; 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 +Jumbo frame = Y +RSS hash = Y +CRC offload = Y +L3 checksum offload = Y +L4 checksum offload = 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