0

Add documentation of how to measure power using Intel SoC Watch

Bug: None
Change-Id: Iee3569f24aa5506958e668d3f6307879127e4f58
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/5385699
Commit-Queue: Kenneth Russell <kbr@chromium.org>
Reviewed-by: Kenneth Russell <kbr@chromium.org>
Cr-Commit-Position: refs/heads/main@{#1277793}
This commit is contained in:
Chunbo Hua
2024-03-25 18:33:15 +00:00
committed by Chromium LUCI CQ
parent 0d8cd6c835
commit bad6657797

@ -0,0 +1,12 @@
# How to Measure Power Using Intel SoC Watch Software
Intel SoC Watch is a command line tool for monitoring and debugging system behaviors related to power consumption on Intel architecture-based platforms. It reports active and low power states for the system/CPU/GPU/devices, processor frequencies and throttling reasons, wakeups, and other metrics that provide insight into the systems energy efficiency. The tool includes utility functions that include delaying the start of collection and launching an application prior to starting collection.
Data is collected from both hardware and OS sources. When using the default mode of collection, the tool collects data at normally occurring OS context-switch points so that the tool itself is not perturbing the system sleep states. Tool overhead when collecting during idle scenarios can be < 1%, however active workloads with a high-rate of context switching will increase the overhead. A minimum collection interval is used to control the rate of collection.
Intel SoC Watch writes a summary report file (.csv) at the end of collection on the system under analysis (target system), allowing immediate access to results.
The following is now public documentation on how to achieve this:
[How to Deploy Intel SoC Watch and Measure Power.](https://docs.google.com/document/d/1mNOi95U4GfkgCaETXrrYnzaXvuFvsTSJ)
See also [Intel SoC Watch Command-line Tool Options](https://www.intel.com/content/www/us/en/docs/socwatch/user-guide/2023-1/intel-soc-watch-command-line-tool-options.html)
and [Intel SoC Watch for oneAPI Release Notes](https://www.intel.com/content/www/us/en/developer/articles/release-notes/oneapi-soc-watch.html) for more information.