diff --git a/Runner/suites/Performance/Geekbench/README_Geekbench.md b/Runner/suites/Performance/Geekbench/README_Geekbench.md new file mode 100644 index 00000000..24643215 --- /dev/null +++ b/Runner/suites/Performance/Geekbench/README_Geekbench.md @@ -0,0 +1,427 @@ +# Geekbench Performance (Geekbench) + +This suite runs **Geekbench 6** on embedded Linux targets (Yocto / LE / Ubuntu variants) and produces: +- **Live console progress** (workload-by-workload + heartbeat) +- **Per-iteration logs** +- **CSV outputs** (readable summary + workloads, and optional “all metrics” long format) +- **LAVA-friendly result** file (`Geekbench.res`) with PASS/FAIL/SKIP + +It is designed to work inside the **qcom-linux-testkit** Runner layout and to be overridden from **LAVA YAML params** as well as **script CLI args**. + +--- + +## Contents + +- [What this suite does](#what-this-suite-does) +- [Prerequisites](#prerequisites) +- [Where to place Geekbench](#where-to-place-geekbench) +- [License and unlocking](#license-and-unlocking) +- [Outputs](#outputs) +- [Running locally](#running-locally) +- [LAVA integration](#lava-integration) +- [All supported Geekbench options](#all-supported-geekbench-options) +- [Runner options and environment variables](#runner-options--environment-variables) +- [Examples](#examples) +- [Baseline / gating (.conf)](#baseline--gating-conf) +- [Troubleshooting](#troubleshooting) + +--- + +## What this suite does + +By default, Geekbench runs the **CPU benchmark**. This runner: +1. Detects `init_env` and loads `functestlib.sh` + `lib_performance.sh`. +2. Optionally forces CPU governors to `performance` (best-effort). +3. Runs Geekbench **N times** (`RUNS` / `--runs`) with **live progress**: + - raw Geekbench output is streamed to console + - progress lines are emitted as `log_info`: + - `Progress,