Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[lkvs] [pcie] New Test: add 3 pcie capability TCs #310

Merged
merged 1 commit into from
Jul 4, 2024
Merged

[lkvs] [pcie] New Test: add 3 pcie capability TCs #310

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions BM/pcie/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# pcie related tests description

## case implemented by pcie_check.sh and pcie_check.c for general PCIe capability check
### for simplicity, only check PCIe Cap Structure (7.5.3 in spec) Max Speed, Current Speed, Supported Speed, Target Speed
- PCIe root port (PCI bridge) Gen4 capability test, apply for PCIe Gen4 platform
```
./pcie_check.sh gen4
```
- PCIe root port (PCI bridge) Gen5 capability test, apply for PCIe Gen5 platform
```
./pcie_check.sh gen5
```
- PCIe root port (PCI bridge) Gen6 capability test, apply for PCIe Gen4 platform
```
./pcie_check.sh gen6
```
343 changes: 343 additions & 0 deletions BM/pcie/pcie_check.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,343 @@
#!/bin/bash
# SPDX-License-Identifier: GPL-2.0-only
# Copyright (c) 2024 Intel Corporation

# Author: Hongyu Ning <[email protected]>
#
# History: 28, Jun., 2024 - Hongyu Ning - creation


# @desc This script do basic pcie capability check with lspci and
# BM/tools/pcie/pcie_check.c
# pcie Gen4, Gen5 and Gen6 covered
# ref spec: PCI-SIG PCI Express® Base Specification Revision 6.0.1 on 29 August 2022

###################### Variables ######################
SCRIPT_DIR="$( cd "$( dirname "$0" )" && pwd )"
echo "$SCRIPT_DIR"

###################### Functions ######################
# function to check if PCI bridge exists
pci_bridge_device_check() {
local pci_bridge_device
local dev
pci_bridge_device=$(lspci -nnv | grep -wE "PCI bridge" | awk '{print $1}')
pci_bridge_device=$(echo -e $pci_bridge_device)
IFS=" " read -ra pci_bridge_array <<< "$pci_bridge_device"
for dev in "${pci_bridge_array[@]}"
do
if [[ -z "$dev" ]]; then
die "No PCI bridge device found"
fi
test_print_trc "PCI bridge device found: $dev"
done
}

# function on convert decimal into binary based on input digits argument
# example: decimal_to_binary 5 4, covert decimal 5 into binary of 4 digits
decimal_to_binary() {
local decimal
local digits
decimal=$1
digits=$2
digits=$((digits+1))
echo "obase=2; $decimal" | bc | tail -c "$digits"
}

# function on PCIe Max Link Speed check, support gen4, gen5 and gen6
# with arguments of gen4, gen5 or gen6
pci_max_link_speed() {
local gen
local dev
local reg
gen=$1
dev="${2#[0-9][0-9][0-9][0-9]:}"
# check Link Capabilities Register section 7.5.3.6 in spec
reg=$(pcie_check i 10 c 4 | grep "$dev")
if [[ "$gen" = "gen5" ]]; then
if [[ "$reg" -eq 4 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Max Link Speed is: 32GT/s"
else
reg=$(decimal_to_binary "$reg" 4)
test_print_wrn "PCI bridge: $dev, PCIe Max Link Speed registers value $reg"
fi
echo 32
elif [[ "$gen" = "gen6" ]]; then
if [[ "$reg" -eq 5 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Max Link Speed is: 64GT/s"
else
reg=$(decimal_to_binary "$reg" 4)
test_print_wrn "PCI bridge: $dev, PCIe Max Link Speed registers value $reg"
fi
echo 64
elif [[ "$gen" = "gen4" ]]; then
if [[ "$reg" -eq 3 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Max Link Speed is: 16GT/s"
else
reg=$(decimal_to_binary "$reg" 4)
test_print_wrn "PCI bridge: $dev, PCIe Max Link Speed registers value $reg"
fi
echo 16
else
die "PCIe Max Link Speed check failed, invalid gen argument $gen"
fi
}

# function on PCIe Current Link Speed check, support gen4, gen5 and gen6
# with arguments of gen4, gen5 or gen6
pci_current_link_speed() {
local gen
local dev
local reg
gen=$1
dev="${2#[0-9][0-9][0-9][0-9]:}"
# check Link Status Register section 7.5.3.8 in spec
reg=$(pcie_check i 10 12 4 | grep "$dev")
if [[ "$gen" = "gen5" ]]; then
if [[ "$reg" -eq 4 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Current Link Speed is: 32GT/s"
echo 32
elif [[ "$reg" -eq 3 ]]; then
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed is: 16GT/s (downgraded)"
echo 16
elif [[ "$reg" -eq 2 ]]; then
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed is: 8GT/s (downgraded)"
echo 8
elif [[ "$reg" -eq 1 ]]; then
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed is: 5GT/s (downgraded)"
echo 5
elif [[ "$reg" -eq 0 ]]; then
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed is: 2.5GT/s (downgraded)"
echo 2.5
else
reg=$(decimal_to_binary "$reg" 4)
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed registers value $reg"
echo 0
fi
elif [[ "$gen" = "gen6" ]]; then
if [[ "$reg" -eq 5 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Current Link Speed is: 64GT/s"
echo 64
elif [[ "$reg" -eq 4 ]]; then
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed is: 32GT/s (downgraded)"
echo 32
elif [[ "$reg" -eq 3 ]]; then
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed is: 16GT/s (downgraded)"
echo 16
elif [[ "$reg" -eq 2 ]]; then
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed is: 8GT/s (downgraded)"
echo 8
elif [[ "$reg" -eq 1 ]]; then
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed is: 5GT/s (downgraded)"
echo 5
elif [[ "$reg" -eq 0 ]]; then
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed is: 2.5GT/s (downgraded)"
echo 2.5
else
reg=$(decimal_to_binary "$reg" 4)
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed registers value $reg"
echo 0
fi
elif [[ "$gen" = "gen4" ]]; then
if [[ "$reg" -eq 3 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Current Link Speed is: 16GT/s"
echo 16
elif [[ "$reg" -eq 2 ]]; then
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed is: 8GT/s (downgraded)"
echo 8
elif [[ "$reg" -eq 1 ]]; then
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed is: 5GT/s (downgraded)"
echo 5
elif [[ "$reg" -eq 0 ]]; then
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed is: 2.5GT/s (downgraded)"
echo 2.5
else
reg=$(decimal_to_binary "$reg" 4)
test_print_wrn "PCI bridge: $dev, PCIe Current Link Speed registers value $reg"
echo 0
fi
else
die "PCIe Current Link Speed check failed, invalid gen argument $gen"
fi
}

# function on PCIe Supported Link Speed check, support gen4, gen5 and gen6
# with arguments of gen4, gen5 or gen6
pci_supported_link_speed() {
local gen
local dev
local reg
gen=$1
dev="${2#[0-9][0-9][0-9][0-9]:}"
# check Link Capabilities 2 Register section
# 8 bits vector, bit 0 is reserved, so need to remove it
reg=$(pcie_check i 10 2c 8 | grep "$dev")
reg=$(decimal_to_binary "$reg" 8)
reg=${reg%[0-1]}
if [[ "$gen" = "gen5" ]]; then
if [[ "$reg" -eq 31 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5-32GT/s"
echo "2.5-32GT/s"
elif [[ "$reg" -eq 15 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5-16GT/s"
echo "2.5-16GT/s"
elif [[ "$reg" -eq 7 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5-8GT/s"
echo "2.5-8GT/s"
elif [[ "$reg" -eq 3 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5-5GT/s"
echo "2.5-5GT/s"
elif [[ "$reg" -eq 1 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5GT/s"
echo "2.5GT/s"
else
test_print_wrn "PCI bridge: $dev, PCIe Supported Link Speeds registers value $reg"
echo "0"
fi
elif [[ "$gen" = "gen6" ]]; then
if [[ "$reg" -eq 63 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5-64GT/s"
echo "2.5-64GT/s"
elif [[ "$reg" -eq 31 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5-32GT/s"
echo "2.5-32GT/s"
elif [[ "$reg" -eq 15 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5-16GT/s"
echo "2.5-16GT/s"
elif [[ "$reg" -eq 7 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5-8GT/s"
echo "2.5-8GT/s"
elif [[ "$reg" -eq 3 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5-5GT/s"
echo "2.5-5GT/s"
elif [[ "$reg" -eq 1 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5GT/s"
echo "2.5GT/s"
else
test_print_wrn "PCI bridge: $dev, PCIe Supported Link Speeds registers value $reg"
echo "0"
fi
elif [[ "$gen" = "gen4" ]]; then
if [[ "$reg" -eq 15 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5-16GT/s"
echo "2.5-16GT/s"
elif [[ "$reg" -eq 7 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5-8GT/s"
echo "2.5-8GT/s"
elif [[ "$reg" -eq 3 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5-5GT/s"
echo "2.5-5GT/s"
elif [[ "$reg" -eq 1 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Supported Link Speeds: 2.5GT/s"
echo "2.5GT/s"
else
test_print_wrn "PCI bridge: $dev, PCIe Supported Link Speeds registers value $reg"
echo "0"
fi
else
die "PCIe Supported Link Speed check failed, invalid gen argument $gen"
fi
}

# function on PCIe Target Link Speed check, support gen4, gen5 and gen6
# with arguments of gen4, gen5 or gen6
pci_target_link_speed() {
local gen
local dev
local reg
gen=$1
dev="${2#[0-9][0-9][0-9][0-9]:}"
# check Link Control 2 Register section
reg=$(pcie_check i 10 30 4 | grep "$dev")
if [[ "$gen" = "gen5" ]]; then
if [[ "$reg" -eq 4 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Target Link Speed is: 32GT/s"
echo 32
else
reg=$(decimal_to_binary "$reg" 4)
test_print_wrn "PCI bridge: $dev, PCIe Target Link Speed registers value $reg"
echo 0
fi
elif [[ "$gen" = "gen6" ]]; then
if [[ "$reg" -eq 5 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Target Link Speed is: 64GT/s"
echo 64
else
reg=$(decimal_to_binary "$reg" 4)
test_print_wrn "PCI bridge: $dev, PCIe Target Link Speed registers value $reg"
echo 0
fi
elif [[ "$gen" = "gen4" ]]; then
if [[ "$reg" -eq 3 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Target Link Speed is: 16GT/s"
echo 16
else
reg=$(decimal_to_binary "$reg" 4)
test_print_wrn "PCI bridge: $dev, PCIe Target Link Speed registers value $reg"
echo 0
fi
else
die "PCIe Target Link Speed check failed, invalid gen argument $gen"
fi
}

###################### Do Works ######################
cd "$(dirname "$0")" 2>/dev/null || exit 1
source ../.env

# run pre-check
pci_bridge_device_check

# run pcie capability check
pci_bridge_device=0
dev=0
gen=$1
max_speed=0
support_speed=0
target_speed=0
passed=0

pci_bridge_device=$(lspci -nnv | grep -wE "PCI bridge" | awk '{print $1}')
pci_bridge_device=$(echo -e $pci_bridge_device)
IFS=" " read -ra pci_bridge_array <<< "$pci_bridge_device"
for dev in "${pci_bridge_array[@]}"
do
max_speed=$(pci_max_link_speed $gen $dev)
pci_current_link_speed $gen $dev
support_speed=$(pci_supported_link_speed $gen $dev)
target_speed=$(pci_target_link_speed $gen $dev)
if [[ "$gen" != "gen4" && "$gen" != "gen5" && "$gen" != "gen6" ]]; then
die "Invalid gen argument $gen"
elif [[ "$gen" = "gen4" ]]; then
# check if max speed is 16GT/s, support speed is 2.5-16GT/s and target speed is 16GT/s
# bypass current link speed check as it may be downgraded due to various reasons
if [[ "$max_speed" -eq 16 && "$support_speed" = "2.5-16GT/s" && "$target_speed" -eq 16 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Gen4 capability check passed"
passed=1
break
fi
elif [[ "$gen" = "gen5" ]]; then
# check if max speed is 32GT/s, support speed is 2.5-32GT/s and target speed is 32GT/s
# bypass current link speed check as it may be downgraded due to various reasons
if [[ "$max_speed" -eq 32 && "$support_speed" = "2.5-64GT/s" && "$target_speed" -eq 32 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Gen5 capability check passed"
passed=1
break
fi
elif [[ "$gen" = "gen6" ]]; then
# check if max speed is 64GT/s, support speed is 2.5-64GT/s and target speed is 64GT/s
# bypass current link speed check as it may be downgraded due to various reasons
if [[ "$max_speed" -eq 64 && "$support_speed" = "2.5-64GT/s" && "$target_speed" -eq 64 ]]; then
test_print_trc "PCI bridge: $dev, PCIe Gen6 capability check passed"
passed=1
break
fi
fi
die "PCI bridge: $dev, PCIe $gen capability check failed"
done

if [[ "$passed" -eq 1 ]]; then
test_print_trc "PCIe $gen capability check test completed successfully"
else
die "PCIe $gen capability check failed after all PCI bridge devices checked"
fi
8 changes: 8 additions & 0 deletions BM/pcie/tests
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# This file collects PCIe tests on Intel® Architecture-based platforms.

# case info: PCIe gen4 device capability check
./pcie_check.sh gen4
# case info: PCIe gen5 device capability check
./pcie_check.sh gen5
# case info: PCIe gen6 device capability check
./pcie_check.sh gen6
Loading