                                        ===========

                                        R E A D M E
                                        ===========


                                Broadcom NetXtreme-E Linux Installation

Overview
========

This Linux installer package provides Linux and RoCE drivers for compatible Linux distributions.
It also provides device Firmware for all the supported Broadcom Ethernet Network adapters.

Usage & Package Structure
=========================

board_sku_files: 
- NVRAM Firmware package files for all the supported adapters.

drivers_linux:
- There are several Linux drivers/packages
	- bundle: Bundle for L2 and RoCE drivers source and DKMS packages. This also contains SUSE signed driver packages
        - bnxt_en: L2 driver source and DKMS packages
        - bnxt_re: RoCE driver DKMS packages
        - bnxt_rocelib: RoCE library source and RPM
        - peer_mem: GPU Direct driver
        - DCSG00411462.self.cert.der: Secure boot openssl certificate

utils:
- There are several tools available here
	- linux_installer: Tool to assist the user in easily installing the Linux and RoCE drivers, libraries and upgrade Firmware
	- niccli: Tool used for updating NVRAM, including firmware updates and configuration parameters
	- nicgui: Standalone GUI wrapper for niccli
	- nictune: Tool used for automating performance tuning of Broadcom NetXtreme Ethernet Network Interface Cards
	- bcm_sosreport: Tool used for collecting system information for support purposes

For more details, please refer to the 'readme.txt' for each individual software component.

Important Considerations
========================

Root/administrator access is required when upgrading the NIC Firmware.

Powering off or rebooting during the firmware upgrade process can permanently damage the adapter.


Supported Linux Distributions
=============================
  
Please refer to the user guide here: https://techdocs.broadcom.com/us/en/storage-and-ethernet-connectivity/ethernet-nic-controllers/bcm957xxx/adapters/software-installation/supported-operating-systems.html
											     
Note:
----- 
For some Linux distributions, drivers have to be compiled and installed before using the Broadcom network adapters.

Please refer to the user guide here: https://techdocs.broadcom.com/us/en/storage-and-ethernet-connectivity/ethernet-nic-controllers/bcm957xxx/adapters/software-installation/installing-the-linux-driver.html


Software Installation 
=====================

For FW/Driver installation, please refer to 'Ethernet NIC Software Installation' here: https://techdocs.broadcom.com/us/en/storage-and-ethernet-connectivity/ethernet-nic-controllers/bcm957xxx/adapters/software-installation.html

Driver installation:
--------------------
On SLES, user must remove non-certified/engineering version of the bnxt_en/bxnt_re module prior to installing the certified version.
For the Linux Installer, on SuSE Hosts, all existing bnxt pkgs need to be removed before running the installer (rpm -qa | grep bnxt | rpm -e)


Documentation
=============

For more information about the adapter support, please refer to the documentation under:
www.broadcom.com -> Products -> Wired Connectivity -> Ethernet Network Adapters -> <Adapter family> -> <Adapter> -> Documentation


User Guide
==========

Refer to User Guide here: https://techdocs.broadcom.com/us/en/storage-and-ethernet-connectivity/ethernet-nic-controllers/bcm957xxx/adapters.html


Supported Adapters
==================

BCM957412A4120AC   - Broadcom P210p NetXtreme-E Dual-port 10Gb Ethernet PCIe Adapter
BCM957412N4120C    - Broadcom N210p NetXtreme-E Dual-port 10Gb Ethernet OCP 3.0 Adapter
BCM957412M4123C    - Broadcom M210p NetXtreme-E Dual-port 10Gb Ethernet OCP 2.0 Adapter
BCM957416A4160C    - Broadcom P210tp NetXtreme-E Dual-port 10GBASE-T Ethernet PCIe Adapter
BCM957416N4160C    - Broadcom N210tp NetXtreme E Dual-port 10GBASE-T Ethernet OCP 3.0 Adapter
BCM957416M4163C    - Broadcom M210tp NetXtreme-E Dual-port 10GBASE-T Ethernet OCP 2.0 Adapter

BCM957504-P425G    - Broadcom NetXtreme-E Quad-port 25Gb Ethernet PCIe Adapter
BCM957504-N425G    - Broadcom NetXtreme-E Quad-port 25Gb Ethernet OCP 3.0 Adapter
BCM957414A4142CC   - Broadcom P225p NetXtreme-E Dual-port 25Gb Ethernet PCIe Adapter
BCM957414N4140C    - Broadcom N225p NetXtreme-E Dual-port 25Gb Ethernet OCP 3.0 Adapter
BCM957414M4142C    - Broadcom M225p NetXtreme-E Dual-port 25Gb Ethernet OCP 2.0 Adapter
BCM957412M4122C    - Broadcom M125p NetXtreme-E Single-port 25Gb Ethernet OCP 2.0 Adapter

BCM957414A4140C    - Broadcom P150p NetXtreme-E Single-port 50Gb Ethernet PCIe Adapter
BCM957414M4143C    - Broadcom M150p NetXtreme-E Single-port 50Gb Ethernet OCP 2.0 Adapter
BCM957502-N150G    - Broadcom NetXtreme-E Single-port 50Gb Ethernet OCP 3.0 Adapter

BCM957508-P2100G   - Broadcom NetXtreme-E Dual-port 100Gb Ethernet PCIe Adapter
BCM957508-N2100G   - Broadcom NetXtreme-E Dual-port 100Gb Ethernet OCP 3.0 Adapter
BCM957504-N1100G   - Broadcom NetXtreme-E Single-port 100Gb Ethernet OCP 3.0 Adapter

BCM957508-P1200G   - Broadcom NetXtreme-E Single-port 200Gb Ethernet PCIe Adapter
BCM957508-N1200G   - Broadcom NetXtreme-E Single-port 200Gb Ethernet OCP 3.0 Adapter
