VxWorks BSP Developer's Reference : VxWorks BSP Validation Test Suite

timestamp

NAME

timestamp - tests timestamp timer

SYNOPSIS

bspVal options timestamp

DESCRIPTION

This test verifies the BSP timestamp timer functionality. This entire test takes approximately 5 minutes (default timeout value) to run. See bspVal.sh for an explanation of options.

In order to run this test, the target has to be configured with timestamp timer. To do this, add INCLUDE_TIMESTAMP to config.h file of the BSP or include the component INCLUDE_TIMESTAMP, if using project facility.

NOTE: This reference entry lists the most likely reasons for a test's failure. However, it does not list all possible reasons.
The script starts by making sure that the timestamp timer is not running. If found running, the function sysTimestampDisable( ) is called and a verification that the timer stopped is made.

The first test verifies that sysTimestampEnable( ) works. It calls the function and does a short term test to check that the timer is incrementing.

The second and third tests verify the long-term timestamp operation using sysTimestamp( ) or sysTimestampLock( ). At regular intervals, the tests take a number of readings of the timestamp timer. The value of T1_TMO_TIMESTAMP specifies the period of time over which the tests take their readings. The T1_TMO_SLICES value specifies the number of readings. The number of timestamp ticks for each interval is measured against the calculated number. The test fails if the timer error exceeds 1%.

The fourth test verifies that sysTimestampDisable( ) works. It calls the function and verifies that the timer stopped incrementing.

The fifth test verifies that the timer can be reenabled after it was disabled. It calls sysTimestampEnable( ) and verifies that the timer starts incrementing.

Barring serious hardware or software limitations (such as an identifiable VxWorks problem), the target board must pass all tests for the BSP to be validated.

CONFIGURATION PARAMETERS

T1_BOOT_TN 30
Target name (required).
T1_TMO_TIMESTAMP
Long-term test duration (optional).
T1_TMO_SLICES
Long-term test time intervals (optional).

EXAMPLE

Output consists of:

                         BSP VALIDATION TEST
                         -------------------

    Target server                     : t53-160
    BSP                               : mv147
    Second target server              : t214-2
    Second BSP                        : mv147
    Log file                          : /tmp/bspValidationLog.6425


    enable the timestamp timer                                : PASS
    sysTimestamp() long-term test                             : PASS
    sysTimestampLock() long-term test                         : PASS
    disable the timestamp timer                               : PASS
    re-enable after disable                                   : PASS

                        Tests RUN           5
                        Tests PASSED        5
                        Tests FAILED        0
                        Tests SKIPPED       0

SEE ALSO

bspVal.sh, timestampLib.tcl, pkLib.c