Java Device Test Suite Developer’s Guide

This chapter describes how to create a benchmark tests. It contains these sections:

• Benchmark Test Directory Structure
• Benchmark Test Types
• Writing a System Load Test
• Writing a Unit Rate Test

---

Benchmark Test Directory Structure

FIGURE 10-1 shows files in a directory that correspond to a benchmark test package. It is identical to a runtime test directory.

FIGURE 10-1 Benchmark Test Directory Contents

---

Benchmark Test Types

Java Device Test Suite has two types of benchmark tests:

• System Load Test - Determines an approximation of the percentage of processor time a constant-time operation takes, for example, playing an audio file. The core of a system load test case runs in parallel with a calibration thread that the harness starts. Having previously run the calibration thread without competition from the test, the harness computes how much less work the calibration thread accomplishes when run in parallel with the test. If, for example, when run in parallel with the test, the calibration thread achieves 40% of the work it achieved when run alone, the test system load is 60%.
• Unit Rate Test - Sampling over a fixed interval, determines how many operations, such as redrawing a screen, a test can complete. The result is an array of frame rates. The test notifies the harness every time it completes a unit of work. The harness returns a parameter that tells the test to perform another iteration or stop.

---

Writing a System Load Test

A system load test extends ComprehensiveBenchmarkTest, a class documented in devKitHome/docs/testapi/testapi/index.html. For a sample system load test, see devKitHome/tests/benchmark/src/client/com/sun/samples/benchmark/testsystemload/MediaPlayerTest.java.

For realistic system load example, see installDir/admin/shared/testpacks/Benchmark_TestSuite/src/client/com/sun/benchmark/scenarios/mediaPlayer/MediaPlayerTest.java.

---

Writing a Unit Rate Test

A unit rate test extends ComprehensiveBenchmarkTest, a class that is documented in devKitHome/docs/testapi/testapi/index.html. For a sample unit rate test, see devKitHome/tests/benchmark/src/client/com/sun/samples/benchmark/testUnitRate/GraphicsTest.java.

For realistic unit rate examples, see the directories in installDir/admin/shared/testpacks/Benchmark_TestSuite/src/client/com/sun/benchmark/scenarios/.

However, ignore the mediaPlayer directory because it contains a system load test.