CDD: Handheld: Require the report for GPU profiling
Android has defined a GPU profiling data scheme to support GPU profiling
across different GPUs. This patch adds GPU profiling as part of CDD for
handheld devices so that when the handheld device implementations claim
the GPU profiling support, we ensure the implementations follow the data
scheme Android defines.
BUG: b/144446776
Test: atest CtsGpuProfilingDataTestCases
Change-Id: I44bf999aab83116e8858bc331f9aaf544fb40aa9
diff --git a/2_device-types/2_2_handheld-reqs.md b/2_device-types/2_2_handheld-reqs.md
index 971300a..e45bc3d 100644
--- a/2_device-types/2_2_handheld-reqs.md
+++ b/2_device-types/2_2_handheld-reqs.md
@@ -41,6 +41,27 @@
Handheld device implementations:
+* [[7.1](#7_1_display_and_graphics).4.6/H-0-1] MUST report whether the device
+ supports the GPU profiling capability via a system property
+ `graphics.gpu.profiler.support`.
+
+If Handheld device implementations declare support via a system property
+`graphics.gpu.profiler.support`, they:
+
+* [[7.1](#7_1_display_and_graphics).4.6/H-1-1] MUST report as output a
+ protobuf trace that complies with the schema for GPU counters and GPU
+ renderstages defined in the [Perfetto documentation](https://developer.android.com/studio/command-line/perfetto).
+* [[7.1](#7_1_display_and_graphics).4.6/H-1-2] MUST report conformant values
+ for the device’s GPU counters following the
+ [gpu counter trace packet proto](https://android.googlesource.com/platform/external/perfetto/+/refs/heads/master/protos/perfetto/trace/gpu/gpu_counter_event.proto).
+* [[7.1](#7_1_display_and_graphics).4.6/H-1-3] MUST report conformant values
+ for the device’s GPU RenderStages following the
+ [render stage trace packet proto](https://android.googlesource.com/platform/external/perfetto/+/refs/heads/master/protos/perfetto/trace/gpu/gpu_render_stage_event.proto).
+* [[7.1](#7_1_display_and_graphics).4.6/H-1-4] MUST report a GPU Frequency
+ tracepoint as specified by the format: [power/gpu_frequency](https://android.googlesource.com/platform/external/perfetto/+/refs/heads/master/protos/perfetto/trace/ftrace/power.proto).
+
+Handheld device implementations:
+
* [[7.1](#7_1_display_and_graphics).5/H-0-1] MUST include support for legacy
application compatibility mode as implemented by the upstream Android open
source code. That is, device implementations MUST NOT alter the triggers or
