                                        ===========

                                        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 network adapters.

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

niccli:
- New tool used for updating NVRAM, including firmware updates and configuration parameters.

bnxtnvm: 
- Tool used for updating NVRAM, including firmware updates and configuration parameters. This will be deprecated soon, please start using new 'niccli' tool.

bnxtqos:
- Tool used for managing DCB parameters ETS, PFC and AppTLV in Linux OS without using lldptool.

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

Linux:
- There are several Linux drivers/packages
	- GPU_Driver: GPUDirect drivers
	- KMP-L2-Only: DKMS Linux driver packages
        - KMP-L2-RoCE: RPMs for Linux and RoCE
	- KMP-RoCE-Lib: RPMs for RoCE library
        - KMP-RoCE-Only: DKMS RoCE driver packages
	- Linux_RoCE: RoCE driver and library source 
	- Linux_Driver: Linux and RoCE driver source
	- Linux_Installer: Installer script for installing the Linux & RoCE drivers and Firmware upgrade. Refer to 'README.md' for the installer usage
	- DCSG00411462.self.cert.der: Secure boot openssl certificate
	- UEFISecureBootReadme.txt: Secure boot readme

For more details, please refer to the README.txt in the individual software component folders.

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 other 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
