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

baudConsole

NAME

baudConsole - console baud rate test

SYNOPSIS

bspVal options baudConsole

DESCRIPTION

This test verifies the target console's ability to communicate at all supported serial baud rates. It has a run-time of several minutes. See bspVal.sh for an explanation of options.

NOTE:

This reference entry lists the most likely reasons for a test's failure. However, it does not list all possible reasons.

This script consists of one test for each serial baud rate supported by both the host and the target. The host's supported rates are given in the macro BSPTEST_HOST_RATES. The target's supported rates are determined by the return value of an ioctl( ) call to the serial driver. A return of OK (0) indicates that the requested baud rate is supported. A return of ERROR (-1) indicates that the rate is unsupported. Baud rates supported by the target but not by the host cannot be tested. The actual communication verification amounts to simply being able to check the present baud rate from the shell, and calling ioctl( ) to set the console to the next baud rate. If any of these tests fail, check that the serial device is capable of supporting the given rate. The baud rate generator must be properly initialized and enabled, if present. Also check that the serial driver's ioctl( ) routine performs error checking consistent with intended baud rate support.

If the test execution ends prematurely, the target board might be left set to a baud rate other than T1_SER_BAUD. This situation could leave the board in such a state that a power cycle reset would be necessary to continue with other tests.

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

BSPTEST_HOST_RATES 25

Host supported baud rates (required).

T1_SER_DEVICE

Serial device to be used on host (required).

T1_SER_BAUD

Default serial baud rate (required).

EXAMPLE

Output consists of:

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

    Target server                     : t53-160
    BSP                               : mv147
    Log file                          : /tmp/bspValidationLog.5219



    Baud Console Test :
    console at 150 baud                                       : PASS
    console at 300 baud                                       : PASS
    console at 600 baud                                       : PASS
    console at 1200 baud                                      : PASS
    console at 1800 baud                                      : PASS
    console at 2400 baud                                      : PASS
    console at 4800 baud                                      : PASS
    console at 9600 baud                                      : PASS
    console at 19200 baud                                     : PASS
    console at 38400 baud                                     : PASS

                     Tests RUN           10
                     Tests PASSED        10
                     Tests FAILED         0
                     Tests SKIPPED        0

SEE ALSO

bspVal.sh, bspCommonProc.tcl, serLib.tcl, envLib.tcl, pkLib.c