From patchwork Wed Sep 13 17:47:17 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Kumar, Ravi1" X-Patchwork-Id: 28695 X-Patchwork-Delegate: ferruh.yigit@amd.com 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 63334199B4; Wed, 13 Sep 2017 19:47:50 +0200 (CEST) Received: from NAM01-SN1-obe.outbound.protection.outlook.com (mail-sn1nam01on0077.outbound.protection.outlook.com [104.47.32.77]) by dpdk.org (Postfix) with ESMTP id 58DDF374E for ; Wed, 13 Sep 2017 19:47:48 +0200 (CEST) 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=6wGkQt1cajg8p7lRPIvKMXb13Dw3LBmpXGQwhax1oqI=; b=iRhHW2tc008JhP8alYb0SkmfaFvPpz6vZGoJE5apSovh3Gt6qFStiwKUdy02LlrQ7xebZNBy24s/Gr/1caTBZY3BM0MIoRmA4To3oucS6OjhUd3rUHd5kngnnyptVGM6wU2JxCSHB0+2RCTD14qvJArer3m6eA+QO3xuNtzCU8E= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Ravi1.Kumar@amd.com; Received: from diesel-25be.amd.com (202.56.249.162) by DM5PR12MB1130.namprd12.prod.outlook.com (10.168.236.137) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.35.12; Wed, 13 Sep 2017 17:47:46 +0000 From: Ravi Kumar To: dev@dpdk.org Date: Wed, 13 Sep 2017 23:17:17 +0530 Message-Id: <1505324838-25734-3-git-send-email-ravi1.kumar@amd.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1505324838-25734-1-git-send-email-ravi1.kumar@amd.com> References: <1505324838-25734-1-git-send-email-ravi1.kumar@amd.com> MIME-Version: 1.0 X-Originating-IP: [202.56.249.162] X-ClientProxiedBy: PN1PR01CA0093.INDPRD01.PROD.OUTLOOK.COM (10.174.144.161) To DM5PR12MB1130.namprd12.prod.outlook.com (10.168.236.137) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: ff30bbec-4482-4367-a0e4-08d4facf8bbb X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(300000500095)(300135000095)(300000501095)(300135300095)(22001)(300000502095)(300135100095)(2017030254152)(48565401081)(300000503095)(300135400095)(2017052603199)(201703131423075)(201703031133081)(201702281549075)(300000504095)(300135200095)(300000505095)(300135600095)(300000506095)(300135500095); SRVR:DM5PR12MB1130; X-Microsoft-Exchange-Diagnostics: 1; DM5PR12MB1130; 3:dlkPtz/QFyLscOt69PMO+/f94qVSrOQpSstTIyw+uXoRsp/gGgmbtY1iUvqogfSXkxCV8oRCYl2MyzBTVar5zu7usutWy1N275r9x1hCRvwAX08voFy5hj+EDAHJC2YoKn5P/CL7TyjcavUMvdqtcHB4FkjlZDZbHQO8Pqo57DfwLNpoVntPcdHROHFXaDQMQyFDAQ2W4aT8q8OwPKKfoi2YVw+rUSqfwgCYdnbyOvoFqZ6Bwa1C2tr1vexUuub+; 25:eU3fFZ/YRkaTjZ1lRPKQdQ7h0DfPh3fxbbkm1wBJdcnlzGfOcZMroM9B2+lTtBWORAnXxk8upBs2VP4N15n8lFSQwMylwfDYOXV+hdD7Nb1lQ2CawMl4ksA32tTcA5BGRiTNagsvIeSXtRjF9nq5Ox+xoha2fbDWlXkr3xddGDjcpNykAQqjPxT/U2LrSgDKtEnJkAgISSWzXLiRAp4Qr705eH4cl4ctwgCQoI9JEsQmpBhVIXn3FxxTb2LSfYgjtsfnPY06H9z6sE0YsDj5zhua5zuIsJPWy8b2AfpkMjsbr6QuZy6aVlEyGTs3lw0l0+MemvsX/1SqEs/876Ge9A==; 31:Gsv/r3F8tr25wZS1FOLaO/V8wyErHTFL9eJJ6Wa2leYZYy1X0QrJZiUwhI/V35DwjF7IB1IODMoP1gMYuEjAkkRX1xz9MYa5wme0JE+36BQKgoWiWUv5271lUK22NDP3CfqCA8bsjxfr1Nk7MGS2lcYV/m4EjnEF9fwwo59fpi5dpVWjjLLBkM1/Pw4n7rc458CLFFOqERczHgTnZGLoG7d1ue21e5yYgxwP2erG45M= X-MS-TrafficTypeDiagnostic: DM5PR12MB1130: X-Microsoft-Exchange-Diagnostics: 1; DM5PR12MB1130; 20:DsHZFaUnK3MXJicqrr2dyGwE+omVSFVq3nX2fNxulwWSs3mX+uuFK8QRmLMUqZ0z1nnWXtgpWv84R1oQAC+rsxDOn+NmdjJgXQt/jd0+F8GPXglI9p2zXjzl/G/GpCv/yW+cth+5EaCH2oC9/Hc4+8i1Weac8vOTeMIxIan75FbFITvhrNQEH/J6us4ZafTiMzT+uuU9lfH0Cbv8ViGG/av2yM74o8zzHqEcSG1wKXT+kJZY84Nyp6zENZ91x9QiRBj7J34LHjZREMET4tSW51lj/uBLzkqg72X7d5p/3Slx2QpLE44wuf5SwPeVBQgZbqXIPvFdQmxLNKaBkiqaCrIOuERNRMFV6s4OxzOglf5ve7YBL8Hje2rt4zMMQHMwVNDAt0Cf/K8TtZSemFLe2v3eFI6kKe5vDbkO4hEaDK5cOFuraXY+mb4i1EwqfUxjeTsVQt9En/cTloJLWYQjwx7h6SKu533iW/p5UrehBzdiDZHO4PMr7IbyZocYcBzr; 4:8J1wqUYKDXCrk2X24ddcBk6sneSsV44zba53qZZej1RNdVeewoL//wI3+t6kYLvvqgRahHlWWF+RoRK1HaqwnuhpMtZT8CAgYpkft+hc3aqHHE6Ry9JA+vb2GRU1752BB+/RJYNS9I+5ptXl0VMEiuZtQF4dmk0S8cX6u/Xf3WVCbvUgAHGA3DsgEkiwDbHNiOct4rjoDH1cqkJUg5iyq734ThyVqyLk/zaRnKks8BYRzKt80zosgSatEbmjmXpf4n+3uVRMudb7U6fWBAtAuaVOiGnabZetD7VCb2UiS9d5cyxg1EZDgMyG/DJtYc7LNFkfhfk1K6YGHNQCtGzP/4nNfoyHWbzqZUdU/euzXII= X-Exchange-Antispam-Report-Test: UriScan:(250305191791016)(22074186197030)(767451399110); X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(6040450)(2401047)(8121501046)(5005006)(93006095)(93001095)(10201501046)(100000703101)(100105400095)(3002001)(6055026)(6041248)(20161123555025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123564025)(20161123560025)(20161123558100)(20161123562025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:DM5PR12MB1130; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:DM5PR12MB1130; X-Forefront-PRVS: 042957ACD7 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(6009001)(376002)(346002)(39860400002)(189002)(199003)(72206003)(50226002)(25786009)(81156014)(81166006)(5660300001)(2361001)(8676002)(68736007)(53416004)(305945005)(16526017)(106356001)(3846002)(316002)(2950100002)(105586002)(6486002)(7736002)(5003940100001)(50986999)(2351001)(6916009)(53936002)(76176999)(86362001)(6116002)(6666003)(8936002)(47776003)(36756003)(97736004)(66066001)(189998001)(33646002)(110136004)(48376002)(478600001)(2906002)(50466002)(6306002)(101416001)(2004002)(217873001); DIR:OUT; SFP:1101; SCL:1; SRVR:DM5PR12MB1130; H:diesel-25be.amd.com; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A: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; DM5PR12MB1130; 23:/HuRIgw4OhUK3o4lPS7gDNcojAxW7KTlyOyGn1cYV?= hZef8GsS3D7Vi3eftZ4+SLuO9gMcC3X/zCYXV5I3dE2CX9y96p5MCiKMC44DwuOtF+IqNaWkSQSGtCbhPb30+AKsIMdH0wlqFD04u9nHlVC+0REIignvHhxPwwganBqb0BIBOublzOHbL6+pZqufRTkuEdkfKoNoCx/Gw63rR/yK07xJyRSiA1rVdySUPjX492sNmg6M0cBKi83Ff603o6MgE3BtvXaZksD934hOtVsje8wPCz0Gyoyd9/u8+5ET4Wt7oo4ja0+Xaq4cVywuhaGrPHF8JWPMPPfVEMGpRfHHgi/X4Z7pze23rdj8SSQuBFtAJE7K1V/zYZoh2fVjqVzbNUwAc3tMy5P2Q8qIvg4bx3ml21EDcjE2C0/cm/XeO37cFfOxS6m8ziKaQilxELrfA8QjA9oo76EEZ6marUdjCnofr2NJL/+LccPzMJuBXVlw7TpwRWH78z1yPMwlFGT//3vFjNjetYIRZCNYVzQooCiJdqo48I52LfSwnGG/ziW9FK9J1CRvPtkOypQ3lfndBZm5mDlxBOyNRroAov6ztfeoyzJ4rqsm4uP2MnSFNhKgHJ1L+CKlYF7IYQlC1jdChCxeJUMW37x5k6RPvoUEbvbpqAe8pI72LxZBLSFbvW/KD4xwfa7I/lDgdu4d+DD+28EnQ1GaV8PRx9TmeRsej1hj47gFC/SwFyHCbCDz3o9mi0QShkSGnkvgx5oxAyiwfq6fz2Ez3boD0mAgZg3F0huxZTW4EcFn69+iTxEJitVtSIaGmkCDaAH5m4BIBrIcM4aKVACBSn7c2/BrHOeBffpzhIXTxt20jDHJ0013XlIDP5nrYGovTyaik1Zz+qNvOgVifu3PpcHX+BmbAIVYyLgQWvJAz3CBiNdcxDlV/Tz/L6D+9+R7mI1zDKdNW3qTHF4RyUEbQ520c79ghYbnud9lc3XOMu/RKJju9N49Yk0kTHPnjgUTyvjhDFqcfdX5ry1A9hpsCR3BXXmo8ZWDzeuE5z1SZBrXEjrGG/yCwB05llLyQMzzKbB7Z92oVxoSoqGtQtj44hY3RkofIlFaUyVQSwe1oYlg2idxjwj4ttQqmmzHLLo7pXINkVL3wHtTJkMHGZ7XaLxid9/9Qt8FOPt7IrSareJPNz59E12RB8= X-Microsoft-Exchange-Diagnostics: 1; DM5PR12MB1130; 6:4fj4pZjOWYY+D3FKpr4J4v/o/8fLLFnR50od3JiCjtldvo2xP0l5IwZlamCEDeaVqmsFxa+YJRV2/jwtf2q0CzM8Twi7plmsXRQvGT8E/4nLQHa70ZnfKA9VOw5C7fKBDXQ8Q6AiOmx2fndmPb12OOsKcj6nPnI7Tyo5hekIIVVkp3KRRJMFlKE/z2Cob0wJ3CU7IUb7yG7kGhEiKF0rvk6bH4sW+4tEN7sX5bk0wSxoVBYPQaqxF3ymLbgojmk7STtoGXTejxzpvzsGUiR08QESoKG65mkvinFmjhtlMsGD2eHuWzqV+OEV/GsKmuTCc4QwNS+4msKHP6Nwzi+0bg==; 5:uFiTg9kHvITUfxo//7FoWbEiZhR9Cn4OlBCpcQiMVDQt4IMhKx+dHZysEQRFUtGNb1jZV3RNZa1D7vVZKb1z4A9wCr1A23L3WZmpdeM2U0oc6IVw3Gq7J4FDMmHw7zIP3ZSb0NDAPqxk2iI4JIwcsA==; 24:j3bhqPXtzt3irTfQhjfEJTRwdD9Jm8ZWyAWljDOgQ9y+0tRfWzxqVZVTya5VIA5bLFZOEF5TSdyhg4TImvm44xPN97NIJfJ+dSRwQ98Rcyo=; 7:a6RT96OjUGjExKLDDvyZ+crU1yqAEeuE8RArHOh7975IXQQw489I/+dZfl0hLC1/C9Tq7dO4NvKWCIq3IUsX93pXY4XZZ+jk046SLJkvvV5t7wAKHbMjcBlRNLrd8GObDxWPUjhZAJYFh0vJfa2p4bOnFtx5FdUb/2YFHkVGsUDQUOBoj34FIFoYA1Q8ObZA033x3Qk+UMXxpUW8SHNbyjck3HXxo+b8KcB0Wnorzsc= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM5PR12MB1130; 20:tMb5z0T16+TfkZOTb+DuizsTFx2B/w2dDCreTQP8EaaHMBRO8ZIz6Erah6b6vqYNy3j9dp7UW/awhAPKY841Xe4tIMIGPfMNeGYdIyVMWKQZ3HyjYEJUJYErZxrmGLOEtfUxetOmferEAAXxj37LgZDM63kShbQ0yTcm0FI7rHdMOjgyiO7aYCFTk0uaO3ENqIL6x/Wrga7Dw/f3OauWT1vyEuOMGqGB66IDnih20cTGKhh1tU4mza3j5TZOx5rJ X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Sep 2017 17:47:46.7709 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR12MB1130 Subject: [dpdk-dev] [PATCH 3/4] doc: Add documents for AMD XGBE Ethernet 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" Signed-off-by: Ravi Kumar Reviewed-by: John McNamara --- 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..97056fa --- /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 36f4f3f..8e39847 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