Add Android toolchain benchmark suite

Add Android toolchain benchmark suite into toolchain-utils, which will
be synced to Android Repository.

BUG=None

TEST=None

Change-Id: Iee1ba9aa21a99ff6ce8d669c59d53af6e953703c
Reviewed-on: https://chromium-review.googlesource.com/569481
Commit-Ready: Zhizhou Yang <zhizhouy@chromium.org>
Tested-by: Zhizhou Yang <zhizhouy@chromium.org>
Reviewed-by: Luis Lozano <llozano@chromium.org>

1 files changed, 41 insertions, 0 deletions

diff --git a/android_bench_suite/README.txt b/android_bench_suite/README.txt
new file mode 100644
index 00000000..3d0cceb5
--- /dev/null
+++ b/android_bench_suite/README.txt
@@ -0,0 +1,41 @@
+This is a Android Toolchain benchmark suite.
+===========================================
+Where to find this suite:
+	This suite locates at google3, please create a google3 branch first,
+	then run:
+		$cd experimental/users/zhizhouy/benchtoolchain
+	Copy this directory to the place you want to put it.
+
+To use this suite:
+	1. Configure the basic envrionment in env_setting file.
+
+	2. Run ./apply_patches.py, which will:
+		1) Patch all the android benchmarks in the android tree.
+		Benchmark Panorama does not exist in android tree, so perftests/
+		gets copied into the top-level of android tree.
+
+		2) Apply patch autotest.diff to android_root/external/autotest, which
+		includes all the test scripts for benchmarks. Copy testcases to
+		related autotest directory.
+
+	   If you have applied the patch partially and hope to discard the
+	   patch, just run discard_patches.py
+
+	3. Build and run benchmark on the device using ./run.py. You can either
+	use test configuration file (-t test_config), or set all the variables
+	manually.
+
+	4. The raw results locate at bench_result_* in bench suite home
+	directory.
+
+	5. The JSON format result will be generated for crosperf report.
+
+Utility tools:
+	1. Autotest is a test framework located in android exteranl/autotest
+		Before first time running it, please run
+		utils/build_externals.py first to ensure all the environments
+		and tools needed are installed.
+
+	2. Crosperf is a report generating tool in ChromeOS toolchain utilities.
+		Please look for it in chromium source:
+		src/third_party/toolchain-utils/crosperf.