From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from stargate3.asicdesigners.com (stargate.chelsio.com [67.207.112.58]) by dpdk.org (Postfix) with ESMTP id 655F05A52 for ; Tue, 7 Jul 2015 19:12:55 +0200 (CEST) Received: from localhost (scalar.blr.asicdesigners.com [10.193.185.94]) by stargate3.asicdesigners.com (8.13.8/8.13.8) with ESMTP id t67HCoHO015236; Tue, 7 Jul 2015 10:12:51 -0700 From: Rahul Lakkireddy To: dev@dpdk.org Date: Tue, 7 Jul 2015 22:42:30 +0530 Message-Id: <21ae633b37fc8bfa19e37f04c0d9dd93c2ae1875.1436288467.git.rahul.lakkireddy@chelsio.com> X-Mailer: git-send-email 2.4.1 In-Reply-To: References: In-Reply-To: References: Cc: Felix Marti , Kumar Sanghvi , Nirranjan Kirubaharan Subject: [dpdk-dev] [PATCH 3/3] doc: Update cxgbe documentation X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 07 Jul 2015 17:12:56 -0000 Update cxgbe documentation with the following: 1. Add instructions on how to flash firmware and config file on Chelsio T5 devices. 2. Add a list of supported devices. 3. Add instructions on how to enable and disable flow control via testpmd. Signed-off-by: Rahul Lakkireddy Signed-off-by: Kumar Sanghvi --- doc/guides/nics/cxgbe.rst | 84 ++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 83 insertions(+), 1 deletion(-) diff --git a/doc/guides/nics/cxgbe.rst b/doc/guides/nics/cxgbe.rst index 54a019d..6ac5e07 100644 --- a/doc/guides/nics/cxgbe.rst +++ b/doc/guides/nics/cxgbe.rst @@ -102,7 +102,72 @@ Prerequisites ------------- - Requires firmware version **1.13.32.0** and higher. Visit - `Chelsio Communications `_ to get latest firmware. + `Chelsio Download Center `_ to get latest firmware + bundled with the latest Chelsio Unified Wire package. Installing and loading + the latest cxgb4 kernel driver from the Chelsio Unified Wire package should + get you the latest firmware. More information can be obtained from the User + Guide that is bundled with the Chelsio Unified Wire package. + +Steps to manually install the latest firmware from the downloaded source files +are as follows: + +#. Load the kernel module: + + .. code-block:: console + + modprobe cxgb4 + +#. Use ifconfig to get the interface name assigned to Chelsio card: + + .. code-block:: console + + ifconfig -a | grep "00:07:43" + + Example output: + + .. code-block:: console + + p1p1 Link encap:Ethernet HWaddr 00:07:43:2D:EA:C0 + p1p2 Link encap:Ethernet HWaddr 00:07:43:2D:EA:C8 + +#. Install cxgbtool: + + .. code-block:: console + + cd /tools/cxgbtool + make install + +#. Use cxgbtool to load the firmware config file onto the card: + + .. code-block:: console + + cxgbtool p1p1 loadcfg /src/network/firmware/t5-config.txt + +#. Use cxgbtool to load the firmware image onto the card: + + .. code-block:: console + + cxgbtool p1p1 loadfw /src/network/firmware/t5fw-*.bin + +#. Verify with ethtool: + + .. code-block:: console + + ethtool -i p1p1 | grep "firmware" + + Example output: + + .. code-block:: console + + firmware-version: 1.13.32.0, TP 0.1.4.8 + +Supported Chelsio T5 NICs +------------------------- + +- 1G NICs: T502-BT +- 10G NICs: T520-BT, T520-CR, T520-LL-CR, T520-SO-CR, T540-CR +- 40G NICs: T580-CR, T580-LP-CR, T580-SO-CR +- Other T5 NICs: T522-CR Sample Application Notes ------------------------- @@ -207,3 +272,20 @@ devices managed by librte_pmd_cxgbe. Port 1 Link Up - speed 10000 Mbps - full-duplex Done testpmd> + +.. note:: + + Flow control pause TX/RX is disabled by default and can be enabled via + testpmd as follows: + + .. code-block:: console + + testpmd> set flow_ctrl rx on tx on 0 0 0 0 mac_ctrl_frame_fwd off autoneg on 0 + testpmd> set flow_ctrl rx on tx on 0 0 0 0 mac_ctrl_frame_fwd off autoneg on 1 + + To disable again, use: + + .. code-block:: console + + testpmd> set flow_ctrl rx off tx off 0 0 0 0 mac_ctrl_frame_fwd off autoneg off 0 + testpmd> set flow_ctrl rx off tx off 0 0 0 0 mac_ctrl_frame_fwd off autoneg off 1 -- 2.4.1