From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM01-BY2-obe.outbound.protection.outlook.com (mail-by2nam01on0075.outbound.protection.outlook.com [104.47.34.75]) by dpdk.org (Postfix) with ESMTP id 93EA4AAF3 for ; Fri, 9 Mar 2018 09:43:19 +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=6RkGKNVYi4SlsU3VgE/arkRr+ixU+EZdmSo8dl4eadM=; b=I+ebltIqkm8hEgV3Nnbon0S0Ut4eZ/ynC+DmO+M/xS4PVX/o/s0uHFURnYC2DiouVnzTMJYLLtis9DmBUp0C5ICBLZrkVMvp/rewBT2oqr7YbJzso8mpl3TFZ0P5zoFsJJC+cJI+qRLW0HTlmaOtonuJue/pbH5am27I0apghGs= Received: from wallaby-smavila.amd.com (202.56.249.162) by MWHPR12MB1517.namprd12.prod.outlook.com (2603:10b6:301:b::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.567.12; Fri, 9 Mar 2018 08:43:16 +0000 From: Ravi Kumar To: dev@dpdk.org Cc: ferruh.yigit@intel.com Date: Fri, 9 Mar 2018 03:42:27 -0500 Message-Id: <1520584954-130575-11-git-send-email-Ravi1.kumar@amd.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1520584954-130575-1-git-send-email-Ravi1.kumar@amd.com> References: <1515145938-97474-1-git-send-email-Ravi1.kumar@amd.com> <1520584954-130575-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: BM1PR0101CA0057.INDPRD01.PROD.OUTLOOK.COM (2603:1096:b00:19::19) To MWHPR12MB1517.namprd12.prod.outlook.com (2603:10b6:301:b::21) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: 2fe447ea-57a2-4c64-cdbf-08d58599ce0e X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(48565401081)(5600026)(4604075)(4534165)(4627221)(201703031133081)(201702281549075)(2017052603328)(7153060)(7193020); SRVR:MWHPR12MB1517; X-Microsoft-Exchange-Diagnostics: 1; MWHPR12MB1517; 3:EMhBP5w08I7RqNtyPOQ1SdGbEFz+Nwid6BqrIpxTtr5gR9mI7OUlou+8P6kajDoL4CYX8ovPc3OgE3kES6jz5B+9gCeb1aqKb3CBJcLlEedUakTPDp4D6UbjiWO4L3ZpHkrYHlKrOsxZ5juswFDsqQJ+fABkQ2Wg6fhjXnL7bIkZ/WI7rU4HQ0HFLD4qtk8EI9J1x9kgGYWS2mpWJ88nS533FzLCP3r7YGNk+dDO0WqxL49UKTKSPBX2eH5H1h/L; 25:+ZgMH3mGmnjyetN4D4QS1feDSJFJPkZpp0HXiOcpM8jkCYexNQFfnHqZx/DXq3D4Xw5G3VxTnWfYqUXQpZkLZdbFiBP3R/mY6UNWJK75p53iSAnyM038G1NjWekV6appH9TgwxQ6Gf17I6dex8In+P7VOqpvvPYZ1j5+3dKZtY2U4k126TFFTRTdf/8x5sTHhJ4M/ljNtM8QKMSpmM0jeK6Bmwdx5EyVGmTfcLNbqPMg9ch0kMRvW/b7fuCUWNIeGd8Y/h5Iy4fZHpVXnLXjbvvApgDBS2q3pVT3yf4I0DVtBgAtEpZesiETCgwY7qZ+4WZjF5+S6dLTZZu9FxFvsQ==; 31:wToBsiQRViSXS2RU0x6jVMwVb6d0NHuIe0Dc1/DzKvTnXczvbwC3o6euahe3XzIBcU+YOzf+maHe4T0jkhUMIhIyMjYaiIQkFKH5n5XsOj4gVdGt7AHAu4YieZ5rI0VhB4qK/0br3tnInLGycQJktWe0dYMHalCdKbtJ4ss+Vcm3SCHCa65jO9E/EElkM0RYpAfsILk8Ufk3/rQ7vaj8s6CHd0w8Fn+8DHerjfFsOIw= X-MS-TrafficTypeDiagnostic: MWHPR12MB1517: X-Microsoft-Exchange-Diagnostics: 1; MWHPR12MB1517; 20:1dm+yElS++CUyhBxG4Nde04cVUfpsxU8/qqrK1AfTFsmWDKUD+4GH/jgHqVeSSpR5Ldv8EdJaPdYzSVvYyd7B5NGKFweP1yQxFJMl5OZbHXwDP4x2xEHJylnOkYHiAdoctnM0nusYoQgel3YyYZpKM0sHU+/Iiye4wWVXt8JZarARGQ3qcvCPzlXTJbVpPJ/dHOo8tc7PcI/rtIZlvvdHczAyUrd6UCmjbyQJtybc+gypodMw3ZCB12L44CG3GHSblBpA5PzZLv5ZqdABZ4NH7d//Dxgcvz19ivPoYqdLQNs03KuKg3QV4cply9QohI4O9ClM0KoqSZ0ABRTgfBCJHpmoioDsRhi3nM/vy5oK3ynp89nIb+MfTPACAk3xpg8/qS1lPVvQpzCdD4b6oTAlzIl3Owxu38HCY2PfhOAvWpZi2O6lTRcbz0drLWEAXVw99prmxvPQIsfyH+BfPE+tLoIEuntiomVWyCTZzp7pduPwaowrHQvYWXdUcWMTkRk; 4:ovFO43brMe6U16p9SAmMT9RkcjPKvUbj8ke9gtyLXccAKvn8tvtgwFBEdSF/mHeGUSzMtds8rLJia5potP3L/G5gjvDXzYqTXaV0arN7ZF0eXNYBukW14uIBS8ixvkYDfXkBzkZrrujW41m+mxKtW29OAugvT234GORb2kEcs1RMxzkajEcA/NFVNjnsf+FDB9X5dmPo+PHvSh2wypSspg/F7opPYvPbJBsNS51PbkEEdpm3oZxw6fznN62I09FYNwkz1nHdvJaZxRBuQgwff3Dcq+WmIz5Da2oSNQkov4quXobRo3qJPXuAH06G8ZrxRdZn9qdUVQJQ1xh6k2eafIO85VT2UMImyZWwXjYEdjuxY+YxZroOb3J+g8AQfNwf X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(250305191791016)(22074186197030)(767451399110); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(8121501046)(5005006)(3002001)(10201501046)(93006095)(93001095)(3231220)(944501244)(52105095)(6055026)(6041310)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123558120)(20161123562045)(20161123560045)(20161123564045)(6072148)(201708071742011); SRVR:MWHPR12MB1517; BCL:0; PCL:0; RULEID:; SRVR:MWHPR12MB1517; X-Forefront-PRVS: 0606BBEB39 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(346002)(39380400002)(396003)(39860400002)(366004)(376002)(199004)(189003)(305945005)(50226002)(386003)(6346003)(26005)(36756003)(97736004)(25786009)(7736002)(50466002)(8936002)(4326008)(16586007)(86362001)(81156014)(81166006)(6666003)(2950100002)(6916009)(16526019)(186003)(5660300001)(59450400001)(316002)(8676002)(76176011)(52116002)(51416003)(7696005)(53416004)(48376002)(6306002)(478600001)(106356001)(6116002)(3846002)(68736007)(2351001)(2906002)(6486002)(66066001)(47776003)(105586002)(72206003)(53936002)(2361001)(2004002); DIR:OUT; SFP:1101; SCL:1; SRVR:MWHPR12MB1517; 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) Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Ravi1.Kumar@amd.com; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; MWHPR12MB1517; 23:o2P0qhXio2AIJcMts1xUmIEhCJNKl01G+HTikx2uy?= =?us-ascii?Q?zZkBAr1v9cHsm47g7EnJno4BqoYMkAHfacZCcDbSRZX+xd0NXaEUxMyqU2RZ?= =?us-ascii?Q?/+48Sq/hT2DLyetwFFr3Grmoy2Nf//3vO3YAg+KQOIij4dFDZYitm8OHyL1X?= =?us-ascii?Q?pHypfhK2SUVR3+4W3XoaKadDCJKKLpBUtmd5BnqavrlC22kCn33XFCVEIBKP?= =?us-ascii?Q?gAPYP2RX2cOhWd7VlkVzhA7PLBK011OtZNWp8Qslqr/yxhTkKOnu5PKF2lDt?= =?us-ascii?Q?zPvznDv2n1xQ860cN7zYFXLkeCjXF1kAzpwRzDeiP0IAAhEO5O7+pdL7tIla?= =?us-ascii?Q?pjtrTHtmRAXedKLOW9ECZTGEDTn1nUDsx7ixs6WLEF3rxCkh49iJiB8JULWn?= =?us-ascii?Q?gfkNoMl0Ex/HKz4e+MKk6z0wj7pbYpQxTpHT6JN9xLyGf/PLgEKBhrie5pwa?= =?us-ascii?Q?Sm9lkRvrTCjtNMac/MQ/T/QOcaFg8RfydREdW35kJKHXZH7eSKFrb/Auwde6?= =?us-ascii?Q?FfbSf/EMXrByu+3+T4qvSW01+dKZ23Zr9A2Vbl/iiazO5FfurGyEKu+FoLoW?= =?us-ascii?Q?646rg+Iy0+WndshIJmjxsYd8KTKl+xiIScAZ8CtqdEOcXswET2jNkVphq7zT?= =?us-ascii?Q?qneFZXgUFemd96OdAosSGz8D0FCX7z1t0pzPcoCBLCxX6EgjjKxlFzZojn8t?= =?us-ascii?Q?ERs79jM1QIxb036+rm7rM4kR7xIUAWGG+4aGh2rTW8byAXNxndgBzjOUhBZM?= =?us-ascii?Q?nzN+2x2V6eq2Xv38427xyhFa7LjC14Soy850kEfOMHFuuAyS3WK2c94vhbag?= =?us-ascii?Q?4QSZDsWfUdiXiYqE8FqWBdM6eOn7k8uFkd3y7qmDqh5UVCMknFV9QVy0n7ph?= =?us-ascii?Q?kv9TPD5M5odBoHUfdVIz8llYjXiz1uRWkA5fEUAmuC8Yg+1BIBZXutb0j7bn?= =?us-ascii?Q?2ShbjIwAdB8yaospmlFIONsjaZjDU4VaNupvOA9Uie1F+uTgEcCLsXIkfVKy?= =?us-ascii?Q?0oldpbheAWgFepnOBaMhuettPU68I0Gv10SZX50SU3XET/EPzYjPxuplsQlC?= =?us-ascii?Q?eMNke6FVWD5yNhnuJgYTrz/ptnLcOIrBx5p1Czwv809z1tzsFeG5E19lW4zM?= =?us-ascii?Q?Feyw5zNJDcIRc44aqJfQcKklCCsEra+d7eTGHh8NWBIYQSi6pDLrx4MY1ren?= =?us-ascii?Q?cdbDDrx5259MALcvPKFGNrCORqU+Rm85J9v2fHPk6UqtZFHOhpD+MYMPl0KR?= =?us-ascii?Q?M6YIwjfTVj6fYgcEfk=3D?= X-Microsoft-Antispam-Message-Info: to7rRxa+MILUPmARtvOrlzbIEFXwx2BhbSOre2vI25GEqVtIw1ES5CEFst/f0l6nrZsIwPZ3KYb/BT5bFo70xNeeQS3RC71I/rjqB2STAuLTJtMfOoEAUrc7pPZmll0QtF1FXhEGqtJMcqWfv0qdIIHqHULrLeWpeo5oFZAq3vu2Ly4acNZRCljCXX5tcZ7u X-Microsoft-Exchange-Diagnostics: 1; MWHPR12MB1517; 6:eQsYXnHF0Smy4M09mYmw0iTwjBcXrCmRUJEk/BeoB4t8uvkmRcReKYGpYY0b5XHigsjBcQzw+y/xSi7DviIk6KQrJhiypj1k6YR7SpGVCWobfpPf97q4kAh4o+QPZfQTaDOPsH9EeRbe49Rhpmal6J1B527/H4s6qKwN+Xd3XqDVDRTnmWd40VXLVbDQYRhieCT3KymLLTP2CBNC8QHe/St1lVgOqOLffqiPoCSyblYZtpM4Ofmba4ZZm/mOJJkEQXbpynlJ9qItR0OgoBaq7oSfCf5UuwbsHP65nR+AnL7wT7f3rEDl1nWSm8Mmox3mjaeR+P1LOOIOqEyH/BDYEavM97pLyPmDTzfF4glig24=; 5:BKtdXxh9MYDwU5v+iBF5z4W2s+eWZyw7fQoXy0ZXqk4ymS2nfgSPwkdyX/b7EgtjTuylw/ZPw/jLlhxUNEKOfeXiy2dyuYtMC8Rt6lLeOt8lnWU82UmKNmQ0WPX1Wc39H+h54TtWaurGBkWQwOXdnR1GgxrLxEpkdK+kz5/HjbE=; 24:QweDNZFTzmFvZAOePn+h19zESDRLPsH3cRF2rE5mDLIda6eU2alPnvqEjOAnArt9y3r/zWb2kD/8cmlVEFNlIwIotb+82T/vxf3b5KUy9KQ=; 7:i2QLjt5/i8SKoqLTDNBJvGl+WN/Yt2X+oT3eSicUxv7nhGzmJ0aAxz5NOv7a8yt3t2Bm0oOivP/IDKie+H2Ov9SGzAyYKQk3RCsrjLELvbdvyhih9cbDojyBWf/wsVSI7sNI99lD2pvU83qVjHZ8sjHt7E79fF+32euO2qBy5EO40NNHhoYmeyiCNxuaxfo4lN9jFqRPCracGGCf6WpimmTudkhodAyqqjb7wWRR5yYHzSotLKvoTDJlVeG3Fprf SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; MWHPR12MB1517; 20:trczxc9myEhi/fz45o06hI/GRT+xQ1x74pQ5yQb4A/RCf/NfwcuxCXEaf7gnHHxK/s04yMgokjmzUcRnYWzWFOU1TRLwcBf16YYJZckEcx3pJbsx+jqAGkD11262/WONmCV0H4A6SllmJfzTLr8GDF5k7fQjkLJXWnUqlAuMtSm03RyhqEVm77BL0weYy/sJtTgngx5OG/W7N6lh7hiSryMU+vZEOQZaodEW72cKozt5QZaEmWVS+IWfo3jfvUYv X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Mar 2018 08:43:16.6516 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 2fe447ea-57a2-4c64-cdbf-08d58599ce0e X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-Transport-CrossTenantHeadersStamped: MWHPR12MB1517 Subject: [dpdk-dev] [PATCH v3 11/18] 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, 09 Mar 2018 08:43:20 -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 59419f4..0c90aa9 100644 --- a/doc/guides/nics/index.rst +++ b/doc/guides/nics/index.rst @@ -13,6 +13,7 @@ Network Interface Controller Drivers build_and_test ark avp + axgbe bnx2x bnxt cxgbe -- 2.7.4