From 0d2fceab0eb0776b8e9c10903b50572579de8cc3 Mon Sep 17 00:00:00 2001
From: Swung0x48 <swung0x48@outlook.com>
Date: Wed, 26 Aug 2026 05:52:28 -0400
Subject: [PATCH] [Docs] (DeviceBench): note session.sh leaves frequency pins
 active by design

---
 tools/device_bench/session.sh | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/tools/device_bench/session.sh b/tools/device_bench/session.sh
index 4920b240..e42e6e35 100755
--- a/tools/device_bench/session.sh
+++ b/tools/device_bench/session.sh
@@ -8,6 +8,11 @@
 # Usage: session.sh --device devices/odinlite.env [--backend magma|espryt|mobileglues]
 #                   [--settle 150] [--retries 3] [--no-pin]
 # Exits 0 with the game in-world (after settle seconds), 1 otherwise.
+# NOTE: leaves the game running AND the frequency pins active (that is the
+# point of a session). When done: am force-stop the game and unpin via
+# `echo <cluster> -1 > /proc/ppm/policy/hard_userlimit_{min,max}_cpu_freq`
+# and `echo 0 > /proc/gpufreq/gpufreq_opp_freq` (or run a bench.sh, whose
+# cleanup unpins).
 
 set -u -o pipefail
 cd "$(dirname "$0")"