Test Cases for the Compare All Three Timers Drift Test with OS Sleep (Windows Embedded CE 6.0)

1/6/2010

Some platforms, for design reasons, have known drift in the GTC clock. Take this into account when running the Compare All Three Timers Drift Tests. The tests allow you to specify drift bounds so they will not fail when the drift is within known specified bounds.

The following table shows the test cases for the Compare All Three Timers Drift Tests. See below the table for an explanation of the parameter values.

Note

If a tested clock does not run accurately, the expected duration of a test case shown in the following table might not be accurate.

Test case Description

1

Timer Test Usage Message

Prints out the usage message for the OAL Timer Tests. Tells the user what the tests do and specifies the input if any that the user needs to provide to the tests.

3020

Compare All Three - OS Sleep

Confirms that the clocks do not drift relative to each other.

The test periodically takes data samples from each of the three clocks and these samples are compared to each other for drift. The default time between the samples is 2 minutes. This test calls the standard Sleep function available in the OS to sleep for the whole 2 minutes. The OS is expected to call OEMIdle during this test and OEMIdle will sleep for maximum possible time.

The default run time for this test is 3 hours and the samples are taken every 2 minutes. These can be changed using -c "-driftRunTime time1 -driftSampleSize time2", where time1 is the run time for the test and time2 is the time between samples respectively. If there is known drift between any two clocks on the platform which is by design, the test can be given drift bounds by appending "-osSleep bound num1 num2", so that it passes when the drift is within the specified bounds. See explanation of values below table.

The value of bound is one of GtcToRtc, GtcToHiPerf, and HiPerfToRtc.

The values of num1 and num2 are the bounds for the given comparison.

The values of time1 and time2 are considered to be in seconds unless the following modifiers are used:

  • s means seconds (12s = 12 seconds)
  • m means minutes (12m = 12 minutes)
  • h means hours (12h = 12 hours)
  • d means days (12d = 12 days)

See Also

Other Resources

Compare All Three Timers Drift Test with OS Sleep