rteval

This test measures realtime system latencies with cyclictest under loads.

What It Tests

  • kcompile: provides system load to cyclictest through building of the Linux kernel.

  • hackbench: provides system load to cyclictest through running hackbench.

  • cyclictest: measures system latencies under loads provided by kcompile and hackbench.

Preconditions

  • System requires root privileges

  • The rteval package and its dependencies must be available for installation

  • For ostree enabled image, it shall be unlocked via ostree admin unlock --hotfix

Test Parameters

Parameter

Default

Description

DOWNLOAD_KERNEL

"https://mirrors.edge.kernel.org/pub/linux/kernel/v5.x/linux-5.7.tar.xz"

The Linux kernel to be used by the kcompile workload

DURATION

"10m"

The duration for which the tests will run (e.g., 1m, 5m, 10m)

TEST_PROG_VERSION

""

The commit version of the rteval suite to be cloned

TEST_GIT_URL

""

The URL where the rteval suite is cloned from

TEST_DIR

"$(pwd)/rteval"

The location where the rteval suite is cloned to

SKIP_INSTALL

"False"

Skip the install

Test Steps

cd automated/linux/rteval
./rteval.sh -d "${DURATION}" -v "${TEST_PROG_VERSION}" -s "${SKIP_INSTALL}" -p "${TEST_DIR}" -k "${DOWNLOAD_KERNEL}" -u "${TEST_GIT_URL}"

Refer to rteval.yaml for complete test definition and execution details.

Expected Results

  • the test completes successfully without critical errors.

  • the measured latencies are within acceptable thresholds for the target real-time system.

References