Skip to content

Latest commit

 

History

History
165 lines (111 loc) · 5.4 KB

e810.md

File metadata and controls

165 lines (111 loc) · 5.4 KB

E810 Driver Guide

NIC setup steps for Intel® E810 Series Ethernet Adapter

1. Update Driver Version with Media Transport Library Patches

The Media Transport Library relies on certain rate limit patches that are currently not included in the E810 driver. These patches need to be applied to the driver before rebuilding it.

Note: Occasionally, after a system reboot, the operating system (Ubuntu) may automatically upgrade to a new kernel version. In such cases, it is important to remember to rebuild the driver to ensure compatibility with the new kernel version.

1.1. Download Driver Version 1.14.9

You can download the CVL 1.14.9 driver source code directly with the command:

wget https://downloadmirror.intel.com/822519/ice-1.14.9.tar.gz

(As an alternative, you can also visit https://www.intel.com/content/www/us/en/download/19630/intel-network-adapter-driver-for-e810-series-devices-under-linux.html and select Download ice-1.14.9.tar.gz.

Make sure to select the 1.14.9 version from the available version options, as there may be newer versions available. It is important to note that version 1.14.9 is the latest version we have verified. Typically, we revisit driver version upgrades on a quarterly schedule.)

The steps are based on downloading the file ice-1.14.9.tar.gz.

1.2. Unzip 1.14.9 Driver and Enter into the Source Code Directory

tar xvzf ice-1.14.9.tar.gz
cd ice-1.14.9

1.3. Patch 1.14.9 Driver with Rate Limit Patches

Apply all the patches placed in directory for ice_driver.

git init
git add .
git commit -m "init version 1.14.9"
git am $mtl_source_code/patches/ice_drv/1.14.9/*.patch

Note: The variable $mtl_source_code should be set to the top directory of the Media Transport Library source code. Please ensure that it is correctly configured. Additionally, when running the git am command, please verify that it executes without any errors.

Use git log to check if the latest commit is version: update to Kahawai_1.14.9_20240613.

1.4. Build and Install the Driver

Please refer to the below command for build and install.

1.4.1. Linux Kernel Header

If you see the below error while running make, the cause is missing the Linux kernel header files.

*** Kernel header files not in any of the expected locations.

Try to install them using below command:

# for Ubuntu
sudo apt-get install linux-headers-$(uname -r)
# for CentOS or RHEL
sudo yum install kernel-devel

1.4.2. rmmod irdma

If you see the below error while running rmmod ice, try to run sudo rmmod irdma and repeat the above command again.

rmmod: ERROR: Module ice is in use by: irdma

1.5. Verify Both the Driver and DDP Version

Please double-check the driver version by running the dmesg command. This will provide you with the necessary information to confirm the correct driver version.

sudo dmesg | grep "Intel(R) Ethernet Connection E800 Series Linux Driver"
ice: Intel(R) Ethernet Connection E800 Series Linux Driver - version Kahawai_1.14.9_20240613

Similar steps to confirm the DDP version.

sudo dmesg | grep "The DDP package was successfully loaded"
The DDP package was successfully loaded: ICE OS Default Package (mc) version 1.3.35.0

If the version is less than 1.3.35.0, please update it using the following commands. The DDP package can be found at ddp/ice-1.3.35.0.pkg within the top directory of the driver source code.

cd /usr/lib/firmware/updates/intel/ice/ddp
sudo cp <latest_ddp_dir>/ice-1.3.35.0.pkg ./
sudo rm ice.pkg
sudo ln -s ice-1.3.35.0.pkg ice.pkg
sudo rmmod ice
sudo modprobe ice

2. Update Firmware Version to Latest

This step is a one-time setup and can be skipped if you have already completed it for one Ethernet card.

2.1. Get the Latest Intel-Ethernet-Adapter-CompleteDriver-Pack

Download from https://downloadcenter.intel.com/download/22283/Intel-Ethernet-Adapter-CompleteDriver-Pack

2.2. Unzip E810 NVMUpdatePackage

Note: Change the below version number if there's a new Intel-Ethernet-Adapter-CompleteDriver-Pack release. The steps are based on the 29.0 version.

unzip Release_29.0.zip
cd NVMUpdatePackage/E810
tar xvf E810_NVMUpdatePackage_v4_40_Linux.tar.gz
cd E810/Linux_x64/

2.3. Run nvmupdate64e

Please follow the instructions provided in the nvmupdate64e tools guide. If an update is available, proceed with running the upgrade process as outlined in the nvmupdate64e tools.

sudo ./nvmupdate64e

2.4. Verify Firmware Version

To verify the firmware version, you can use the ethtool command with the interface name of your E810 card. Please replace "enp175s0f0" with the actual interface name in your setup.

ethtool -i enp175s0f0

If ethtool is not found in your system, please install it by sudo apt-get install ethtool or sudo yum install ethtool.

A correct setup should have an output similar to the following:

driver: ice
version: Kahawai_1.14.9_20240613
firmware-version: 4.40 0x8001c967 1.3534.0
expansion-rom-version:
bus-info: 0000:af:00.0
supports-statistics: yes
supports-test: yes
supports-eeprom-access: yes
supports-register-dump: yes
supports-priv-flags: yes

Next Steps

Proceed to the MTL Run Guide for further instructions.