Skip to content

Latest commit

 

History

History
161 lines (110 loc) · 5.09 KB

e810.md

File metadata and controls

161 lines (110 loc) · 5.09 KB

E810 driver guide

NIC setup steps for Intel® E810 Series Ethernet Adapter

1. Update driver version with Intel® Media Transport Library patches

The Intel® 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 with 1.12.7

To download the CVL 1.12.7 driver source code, please 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.12.7.tar.gz.

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

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

1.2 Unzip 1.12.7 driver and enter into the source code directory

tar xvzf ice-1.12.7.tar.gz
cd ice-1.12.7

1.3 Patch 1.12.7 driver with rate limit patches

Apply the all patches under ice_driver

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

Note: The variable $imtl_source_code should be set to the top directory of the Intel® 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.12.7_20231116.

1.4 Build and install the driver

Pls refer to below command for build and install.

cd src
make
sudo make install
sudo rmmod ice
sudo modprobe ice

1.4.1 Linux kernel header

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

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

Try to install use 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 below error while rmmod ice, try to run sudo rmmod irdma and repeat 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.12.7_20230821

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 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 28.2 version.

unzip Release_28.2.zip
cd NVMUpdatePackage/E810
tar xvf E810_NVMUpdatePackage_v4_30_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.12.7_20230821
firmware-version: 4.30 0x8001af29 1.3429.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