power_LoadTest: Add parameter for custom tasks

client/site_tests/power_LoadTest/control

 # Copyright (c) 2011 The Chromium OS Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 AUTHOR = "Chrome OS Team"
 NAME = "power_LoadTest"
 PURPOSE = "Measure power draw when system is under load."
 CRITERIA = "This test is a benchmark."
 TIME = "LONG"
 TEST_CATEGORY = "Benchmark"
@@ skipping 14 matching lines @@
 You are now ready to run the test.
 """
 
 # TODO (bleung): Find a way to do automatic Facebook login for test account.
 
 import time
 
 loop_time = 3600
 loop_count = 11
 
+# To specify a list of custom tasks, pass in the task parameter:
+#    tasks='<task0>&<task1>&<task2>&...'
+#
+# Task format:
+# - Open a window with some tabs, keep them open for some time:
+#       single;<comma-delimited urls>;<duration>
+# - Cycle through a list of sites one at a time, for a total duration, and a
+#   given delay on each site.
+#       repeat;<comma-delimited urls>;<duration>;<delay>

[Sameer Nanda, 2011/03/31 23:42:22]

"cycle" instead of "repeat" to match up with rest of code?

[Simon Que, 2011/04/01 21:37:15]

Done.  Also single -> window.

+#
+# Duration and delay are given in minutes.  The tasks are sequential.  So if
+# task0.duration=30 and task1.duration=20, task0 will run for 30 minutes,
+# followed by task1 for 20 minutes, for a total of 50 minutes.

[Sameer Nanda, 2011/03/31 23:42:22]

lets change the units of duration to seconds instead of minutes

[Simon Que, 2011/04/01 21:37:15]

Done.

+#
+# Example:
+#    tasks='repeat;www.facebook.com,www.google.com,www.yahoo.com;20,1 &' +
+#          'single;www.bing.com,www.gmail.com,www.amazon.com,www.ask.com;5 &' +
+#          'repeat;www.youtube.com,www.microsoft.com;15,4 &' +
+#          'single;www.wikipedia.org;20'

[Sameer Nanda, 2011/03/31 23:42:22]

which of these would be in the foreground, ie, can the order of these tasks be
used to control which window is in the foreground?

[Simon Que, 2011/04/01 21:37:15]

No they can't.  They are currently all sequential.  I can change the syntax so
that background / foreground can be done in parallel.  e.g., A1 & A2 + B1 + C1 &
C2:

1. A1 and A2 in parallel
2. B1
3. C1 and C2 in parallel

This can be done in another patch.

[Sameer Nanda, 2011/04/04 16:39:34]

Yes, lets do this in a subsequent patch.

+
 job.run_test('power_LoadTest', loop_time=loop_time, loop_count=loop_count,
               low_battery_threshold=3)