| Zhizhou Yang | e598690 | 2017-08-10 17:37:53 -0700 | [diff] [blame] | 1 | This is a Android Toolchain benchmark suite. |
| 2 | =========================================== |
| 3 | Where to find this suite: |
| 4 | This suite locates at toolchain/benchmark under Android repository tree. |
| 5 | |
| 6 | To use this suite: |
| 7 | 1. Configure the basic envrionment in env_setting file. |
| 8 | |
| 9 | 2. Run ./apply_patches.py, which will: |
| 10 | 1) Create non-existing benchmarks in the Android tree. Apply |
| 11 | patch to some benchmarks to make them workable to the suite. |
| 12 | |
| 13 | 2) Apply patch autotest.diff to android_root/external/autotest, |
| 14 | which includes all the test scripts for benchmarks. Copy |
| 15 | testcases to related autotest directory. |
| 16 | |
| 17 | If you have applied the patch partially or hope to discard all the |
| 18 | patches, just run ./discard_patches.py |
| 19 | |
| 20 | 3. Build and run benchmark on the device using ./run.py. You can either |
| 21 | use test configuration file (-t test_config), or set all the variables |
| 22 | manually. |
| 23 | |
| 24 | 4. The raw results locate at bench_result_* in bench suite home |
| 25 | directory. |
| 26 | |
| 27 | 5. The JSON format result will be generated for crosperf report. |
| 28 | |
| 29 | Utility tools: |
| 30 | 1. Autotest is a test framework located in android exteranl/autotest |
| 31 | Before first time running it, please run |
| 32 | utils/build_externals.py first to ensure all the environments |
| 33 | and tools needed are installed. |
| 34 | |
| 35 | 2. Crosperf is a report generating tool in ChromeOS toolchain |
| 36 | utilities, which has a mirror at external/toolchain-utils in Android |
| 37 | tree. |