From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM01-SN1-obe.outbound.protection.outlook.com (mail-sn1nam01on0067.outbound.protection.outlook.com [104.47.32.67]) by dpdk.org (Postfix) with ESMTP id 028C51B332 for ; Thu, 9 Nov 2017 07:52:34 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=CAVIUMNETWORKS.onmicrosoft.com; s=selector1-cavium-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=NLVAs/TfwjQBEMcEGUgd4dIZh3l9cPaX1I9TIidFt1s=; b=l5XhPHCkVxwgWmLWqpfL8r+QECK8HFGPbiG/pdOint+31PKzkP/jDTxk+KqfCkl/QEaesnasEVIM5JQKPEYjTB9Wf0ohjlkni1BU5YwAn0QAM7KOB00etsqliuBqj/oeXkXzihCEzoWISmIfPKDg+McvtNv0zIntppd5a4+RnP4= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Rasesh.Mody@cavium.com; Received: from cavium.com (198.186.0.2) by SN4PR0701MB3838.namprd07.prod.outlook.com (2603:10b6:803:4f::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.197.13; Thu, 9 Nov 2017 06:52:32 +0000 From: Rasesh Mody To: dev@dpdk.org, john.mcnamara@intel.com thomas.monjalon@6wind.com, ferruh.yigit@intel.com Cc: Rasesh Mody , Dept-EngDPDKDev@cavium.com Date: Wed, 8 Nov 2017 22:52:19 -0800 Message-Id: <1510210340-5433-1-git-send-email-rasesh.mody@cavium.com> X-Mailer: git-send-email 1.7.10.3 MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: [198.186.0.2] X-ClientProxiedBy: CY4PR03CA0085.namprd03.prod.outlook.com (2603:10b6:910:4d::26) To SN4PR0701MB3838.namprd07.prod.outlook.com (2603:10b6:803:4f::13) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 235a7107-aa14-496b-12c0-08d5273e7403 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(4534020)(4602075)(4627115)(201703031133081)(201702281549075)(2017052603249); SRVR:SN4PR0701MB3838; X-Microsoft-Exchange-Diagnostics: 1; SN4PR0701MB3838; 3:W1GAJGLX9/aU+4b51OPJxbzAxPEsx2qZhL4Ga+s1cLxkgn/AC+6bG2Gb0lIG46HdlNGEL/WUQvjaSvvY1zR7WsIZlQdjwA2bLFSx7Y6dVQ0rnOOEVXGKpO3UFbOE5En6NBnBsaaIvx2ps1rnzJdlNpGEiPBKH9Hyntrcr4QzaR/u8giQdaDo6+K96fJZ9jgP+Tzq419KUMgOeZPklj0sHBn+JQCeYuzr2t9HLQ9VbxUXnZhvmOGynSB/Qi1gMfIQ; 25:ihfHyO44YYLE+76Eo3ZINyu/mteDIyb7xPlVI/0DBQoTlgIL02xxDYf6tls/jftHK4eKa3hgFvANdzArVPnDuIxuuQAW6V7UP2Uz/xPLH2QRufeMIMCyihmhGqgtJ2v+LrWUExPfFDwNcaqEPs3qfTpheG6QKxkzj6hSALh/K5Y7gm04Sd/FzFCjN16ldfTKSRrvExLyzY2ymaT4r+ivffdfDMiRUOAn+04UTIBJU4FqK7atx6JxcnWC0xYdHv/2EsdOknY7yDNV8QjCzOIkTCv0VkZHsTi4tgiEInGM79ZHCmeadcYNwwq3FLVGeymc7q2L1sxUfFwbUwWXA1Q0pQ==; 31:XUEXJTwHkXb6RTO8rrLqqmq1hU0QB9PLoJpTezZsVxMY0xcI8lFVBa2nD7pdP+9QiX3L4JKfX4EJmJqjWxdxiV+NiTHcYbQ8I5gD6Y7EHyUZtC2Hp1kpNQuj6AvAcEURcsRTFLuKM0mPt3p/PDtqy/JB917hgJm07ANdVobfhTWjNNhrFRwyMKVTHGb/tD8+YBledngnioUPlOdNm5ZfVfY1rCWSmIaGuUlZftfqtsE= X-MS-TrafficTypeDiagnostic: SN4PR0701MB3838: X-Microsoft-Exchange-Diagnostics: 1; SN4PR0701MB3838; 20:dzJqXk08fM6WwZpKSxnqLMsdH3sLnSo4qCnmuQMngykufJmLeFvkP1P6ccntFqwb9SRniqKdwMtWHoDeJw7vf/1jPVT0zP8lRx3XnVBJ1kdJC+6Kt0CWfaAeRLaA4EYUhpK6d1dNwQNj8FrShjLkZVw0LRWQ8TB45m8/73cexDBbniDSz6urt5+QQCKBl87YuSkPGwvmgnLh+zU5c+IkVZ3tmmEiknUJt50dkFJumrqXxCrz+cYvZhpOglJJ2XKRwjQegf5LVNzXzaLkYfigZTxh1RIRD/WOfuqhuRZy0VxtRAFOKOZVYAxhDKD+nVomyr/0RN2MFmGBFQdm7/AChlymRrcCO5Mjrya/dBr/VBrsNf3jK9khgH/j0+gFh3d2seY58jIJAT0YuWPsTPqwwhWBOeOFZmrVuiBLJ1FMoUnDwuGzXDmGtwU4OrCnNGtaSSjNtt8S5RnHv50CrdaRNNSDLxfEUaXYB25zpBqCzWoxHJQZzSPZ4CqIzSU3yWx/; 4:BxsTynN1WQkE2xhOrzctrwSwUZ0XodJodEZZTLK6on3Sh7MiSYW8XdYpxelVZLpJ8QPlj00CI+wZt2jdTASpHZwX4eKqF/IuxxJxlS/3Of+v38LgWug0oNKzDcrzZef1D4TuJfvvbml+josSadEUiaL1M2LU/wo4j6MFlEjLOVtE66Pwqg1LGUyjUR5pX0acPMAakzFFj0Z2u+Efm2dXofpX8cwnZG5tNtAlfhVZyjeYwgm2sKagKFXnjd7E5g56tnSaplLmOCcssGQ7AUbGmw== X-Exchange-Antispam-Report-Test: UriScan:; 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)(100000703101)(100105400095)(3231021)(10201501046)(3002001)(93006095)(93001095)(6041248)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123562025)(20161123564025)(20161123560025)(20161123555025)(20161123558100)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:SN4PR0701MB3838; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:SN4PR0701MB3838; X-Forefront-PRVS: 0486A0CB86 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(6009001)(346002)(376002)(199003)(189002)(2906002)(10710500007)(5660300001)(36756003)(107886003)(48376002)(478600001)(72206003)(50466002)(305945005)(2420400007)(69596002)(97736004)(15650500001)(6306002)(50226002)(53936002)(4326008)(81166006)(101416001)(105586002)(106356001)(8676002)(55016002)(7736002)(16586007)(3846002)(86362001)(21086003)(68736007)(81156014)(66066001)(6116002)(5003940100001)(8936002)(6666003)(25786009)(316002)(16526018)(4720700003)(189998001)(7110500001)(50986999)(33646002)(47776003); DIR:OUT; SFP:1101; SCL:1; SRVR:SN4PR0701MB3838; H:cavium.com; FPR:; SPF:None; PTR:InfoNoRecords; A:1; MX:1; LANG:en; Received-SPF: None (protection.outlook.com: cavium.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; SN4PR0701MB3838; 23:ytpvKp0QBubX9kAW2xVNp6UDnez55ug5Q3aCVDL?= =?us-ascii?Q?CmxnjUAJpJfArKHKdVWWcDTTv1th24BWuuC01bIrwLM67lA9ys4bO9m0HXWm?= =?us-ascii?Q?BYVXDjcfcQBtKPcCRAU/9uQs69Vq06sO9ba426t8+mIZaW3IoEQu16dsE98k?= =?us-ascii?Q?WgMHV1x3QN+i7aVo9CMSaIKg/SM6SuB97VWt8qaknc82of8eM3I9HcrtV12J?= =?us-ascii?Q?0Lt8Tm0RxYz4lqs/y2WTadXF6P3r2BEPTP0XHzAOpHEh20biHBeePMvBZy8o?= =?us-ascii?Q?u757rJTtmu14vic0QwlMN5Gg6CsGZsjy681DUgypSSrFPALTKpvyAI139alx?= =?us-ascii?Q?qBh5BtxjmGRxoPbNA9WJhHRR73157l/pmq1ENqJKg68TADMRRr1BH8GlgKIf?= =?us-ascii?Q?yIH1dqAjzXmcfQfbyG3Zn0kN9o4M8LnlnkEJFODmdqZcsSMEVj0xBJVcAUp6?= =?us-ascii?Q?gClGaFcmsRn8tYfEL7oWLB+SOdzXO8/r8ZbRDzeLl4qmgxxRiHdLkXQ3h9Ih?= =?us-ascii?Q?wrFm9pa8Oihc5HDqe3/T2aSI9rd6rJiYGp4+BK4f/loQTsTLypZJrEfd5B25?= =?us-ascii?Q?MaPgKAEV0XWrBkZBZ5UA+amhkfDe2t4esYRzUtCwOywPB0f7td0vk+KKOpcm?= =?us-ascii?Q?65fe+34UNbcNR+35Njis2Wx1KKtslR/MPcBWwkPjFBfLf0obcj70ecGKJxIh?= =?us-ascii?Q?T4vfdL/hatI0NFeVqZIwwBE469QYOzEO71+Ilhign+pXtZM9GMh5aIvdjkYD?= =?us-ascii?Q?g04EdiViCbkvTm1GVaF39euIhTABKzoxApug/pqbXTI5h2maWcJkTrD7wfy1?= =?us-ascii?Q?Qm5zxrf5DW+kSsYBrhwnXMbiwgmmYwAoPe71bICh4H8nXtmBx0dIxfXoBdiD?= =?us-ascii?Q?iwxteKPehh/ysVcUj+Sqn+JNON4Dmn+fQIeb1kYDfLTDTCEEYKRqADb7QyB9?= =?us-ascii?Q?56qlL119wEnDcRaF+xXjqgQd4bqtN2XQZUYHDG7frypmz87cV40FJhO6cagg?= =?us-ascii?Q?6VocLcVV6OcSlIol/aL604LsG/XwVHF/sizefdty0NkLO2QsFn+EiYn4iGwS?= =?us-ascii?Q?u6n8qoD0nQo74vCXXOhCvTMXj/2dL28KciGT60/m8SyMqjI+5DjmF8dsNX/a?= =?us-ascii?Q?+8BwlyJL30QENtQxnlJA2Cs1D+E5RupFJFvRNGx1PBmMwaE++p2RaGcZdLLM?= =?us-ascii?Q?tGAHDoCK3z65OJnUnz9uLsiUwcCQRY9H0WtWf?= X-Microsoft-Exchange-Diagnostics: 1; SN4PR0701MB3838; 6:K1OnlS+eP+AGA2fBDl+zU8KkialheWquJ8NMgPh9nLg7z7QWYimF/HfqzcN9wQVlxcmR1NMEVms0f69AvCPwVUt+da3cwy7qFANhF8bQrI5QCxz3r+mW0NYJhUwXxZKoGQ8jemo23cIxqNJsUK5QFQk8//p/XH56oGlO36wkgaMcGxtYP7kKzHv0pO7oGMye9wDuyuKxvpZFceF0Pnc2YQJsRWTYTKRvbexebqlxC0X/RvOSjwB/WEN/UIwRNTCkq/b+b7C0ZJ9rW9Ec+/ZRfVx5mfx5QGIQ37eytIex6aJSob5zE2reaU1zAJVwKmLF59+bPsSu2jPQXNouZM4dnk3S+IyIIDhxmqK6d26hDA4=; 5:MkYcwsSkjD7fflVqnyCIMEwCMpYFU+np+CZhW6JaJLWqpCqt6FJND4c0o3gtpcmBJ3gdW2rapMzbgyX5zJlE6c80vVoCnBsliva64bJ3eF2GVUZxVhQ7ON/wSPCzXsQwCB3EAL7PRtlLPVW2ymZLSJdzIrx9AvwmlOpMnE0TmoQ=; 24:BPBIhJosn3wKmmPhP/g9cfAaHk9cl6qLMPVXgtXyLjNobcUtDgyLN3yQfqwv1WEhLF+y+1w8A8vND7ex1r25vr8vtc7Cj9f6/PKCbOy1Z1M=; 7:oNLZX6u3GSve6QeMoMtPxnGQAx349bjvxyIobEYKc+ePu6M9zZgV0rmN04rKQ7INQnzGSnSixgaAFKsaNz5hdM9YqqO+rGT3Iz2UmTy6HhWn3V/BzWiLOrD1kvuP9chzxjJL/+8HNU4a8s0sSd2csI9d8QFYINfjnVHs/T6EwShV4QkO5QcGi1QQMaDwEg39gpJBMT7NdSxrQASNKPSotuPNe7KZuGvZelocvSAMjvzM83zpbVQaywUoOkqmn8EB SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: cavium.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Nov 2017 06:52:32.6232 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 235a7107-aa14-496b-12c0-08d5273e7403 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 711e4ccf-2e9b-4bcf-a551-4094005b6194 X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN4PR0701MB3838 Subject: [dpdk-dev] [PATCH 1/2] doc: update QEDE pmd nic guide 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, 09 Nov 2017 06:52:35 -0000 Signed-off-by: Rasesh Mody --- doc/guides/nics/qede.rst | 59 ++++++++++++++++++++++++++++++---------------- 1 file changed, 39 insertions(+), 20 deletions(-) diff --git a/doc/guides/nics/qede.rst b/doc/guides/nics/qede.rst index 09a10be..84becc9 100644 --- a/doc/guides/nics/qede.rst +++ b/doc/guides/nics/qede.rst @@ -1,5 +1,6 @@ .. BSD LICENSE Copyright (c) 2016 QLogic Corporation + Copyright (c) 2017 Cavium Inc. All rights reserved. Redistribution and use in source and binary forms, with or without @@ -32,8 +33,7 @@ QEDE Poll Mode Driver ====================== The QEDE poll mode driver library (**librte_pmd_qede**) implements support -for **QLogic FastLinQ QL4xxxx 10G/25G/40G/50G/100G CNA** family of adapters as well -as their virtual functions (VF) in SR-IOV context. It is supported on +for **QLogic FastLinQ QL4xxxx 10G/25G/40G/50G/100G Intelligent Ethernet Adapters (IEA) and Converged Network Adapters (CNA)** family of adapters as well as SR-IOV virtual functions (VF). It is supported on several standard Linux distros like RHEL7.x, SLES12.x and Ubuntu. It is compile-tested under FreeBSD OS. @@ -48,21 +48,22 @@ Supported Features - Allmulti mode - Port hardware statistics - Jumbo frames -- VLAN offload - Filtering and stripping -- Stateless checksum offloads (IPv4/TCP/UDP) -- Multiple Rx/Tx queues -- RSS (with RETA/hash table/key) -- TSS - Multiple MAC address -- Default pause flow control -- SR-IOV VF - MTU change +- Default pause flow control - Multiprocess aware - Scatter-Gather -- VXLAN tunneling offload -- N-tuple filter and flow director (limited support) +- Multiple Rx/Tx queues +- RSS (with RETA/hash table/key) +- TSS +- Stateless checksum offloads (IPv4/IPv6/TCP/UDP) - LRO/TSO +- VLAN offload - Filtering and stripping +- N-tuple filter and flow director (limited support) - NPAR (NIC Partitioning) +- SR-IOV VF +- VXLAN tunneling offload +- MPLSoUDP Tx tunnel offload Non-supported Features ---------------------- @@ -73,18 +74,30 @@ Non-supported Features Supported QLogic Adapters ------------------------- -- QLogic FastLinQ QL4xxxx 10G/25G/40G/50G/100G CNAs. +- QLogic FastLinQ QL4xxxx 10G/25G/40G/50G/100G Intelligent Ethernet Adapters (IEA) and Converged Network Adapters (CNA) Prerequisites ------------- -- Requires firmware version **8.18.x.** and management firmware - version **8.18.x or higher**. Firmware may be available +- Requires storm firmware version **8.30.12.0**. Firmware may be available inbox in certain newer Linux distros under the standard directory - ``E.g. /lib/firmware/qed/qed_init_values-8.18.9.0.bin`` + ``E.g. /lib/firmware/qed/qed_init_values-8.30.12.0.bin`` + If the required firmware files are not available then download it from + `QLogic Driver Download Center `_. + For downloading firmware file, select adapter category, model and DPDK Poll Mode Driver. + +- Requires management firmware (MFW) version **8.30.x.x** or higher to be + flashed on to the adapter. If the required management firmware is not + available then download from + `QLogic Driver Download Center `_. + For downloading firmware upgrade utility, select adapter category, model and Linux distro. + To flash the management firmware refer to the instructions in the QLogic Firmware Upgrade Utility Readme document. + +- SR-IOV requires Linux PF driver version **8.20.x.x** or higher. + If the required PF driver is not available then download it from + `QLogic Driver Download Center `_. + For downloading PF driver, select adapter category, model and Linux distro. -- If the required firmware files are not available then visit - `QLogic Driver Download Center `_. Performance note ~~~~~~~~~~~~~~~~ @@ -117,12 +130,18 @@ enabling debugging options may affect system performance. Toggle display of receive fast path run-time messages. +- ``CONFIG_RTE_LIBRTE_QEDE_VF_TX_SWITCH`` (default **"y"**) + + A knob to control per-VF Tx switching feature. + - ``CONFIG_RTE_LIBRTE_QEDE_FW`` (default **""**) Gives absolute path of firmware file. - ``Eg: "/lib/firmware/qed/qed_init_values_zipped-8.18.9.0.bin"`` + ``Eg: "/lib/firmware/qed/qed_init_values-8.30.12.0.bin"`` Empty string indicates driver will pick up the firmware file - from the default location. + from the default location /lib/firmware/qed. + CAUTION this option is more for custom firmware, it is not + recommended for use under normal condition. Driver compilation and testing ------------------------------ @@ -135,7 +154,7 @@ SR-IOV: Prerequisites and Sample Application Notes This section provides instructions to configure SR-IOV with Linux OS. -**Note**: librte_pmd_qede will be used to bind to SR-IOV VF device and Linux native kernel driver (QEDE) will function as SR-IOV PF driver. Requires PF driver to be 8.10.x.x or higher. +**Note**: librte_pmd_qede will be used to bind to SR-IOV VF device and Linux native kernel driver (qede) will function as SR-IOV PF driver. Requires PF driver to be 8.10.x.x or higher. #. Verify SR-IOV and ARI capability is enabled on the adapter using ``lspci``: -- 1.7.10.3