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

scsi

NAME

scsi - SCSI test

SYNOPSIS

bspVal options scsi

DESCRIPTION

This test verifies SCSI read and write operations. See bspVal.sh for an explanation of options.

In order to run this test, the target has to be configured for SCSI support. The target has to be configured for scsi show routines either by defining INCLUDE_SCSI_SHOW in config.h of the BSP or adding component INCLUDE_SCSI_SHOW, if using project facility.

WARNING:

All data on the SCSI device under test is overwritten.

The execution time of the test run by this script depends on the size and speed of SCSI device being tested, the CPU speed, and the test buffer size (T1_SCSI_BUFSIZE). A small buffer slows the test. For particularly slow targets, slow devices, large SCSI devices, and/or small buffers, it might be necessary to increase the timeout value specified by the macro T1_TMO_SCSI. The entire script could take more than one hour to complete.

For target boards with limited RAM, it might be necessary to reduce T1_SCSI_BUFSIZE from its default of 64 kilobytes. The buffer size must be a multiple of the block size of the device under test.

NOTE:

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

The first test verifies the return value of scsiShow( ) routine. If this test fails, it is assumed that SCSI is not configured properly and the next test (for read/write operations on the device) is skipped.

The second test calls pkTestOneUnit( ) to test the SCSI device specified by T1_SCSI_ID and T1_SCSI_LUN. A pattern is written to every block of the device, then each block is read to verify the pattern. If this test fails, check that the SCSI ID and LUN are properly configured and that the device appears in the output from the scsiShow( ) command.

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. Of course, if SCSI is not supported by the target board, then SCSI testing is not a BSP validation requirement.

CONFIGURATION PARAMETERS

T1_SER_DEVICE 20

Serial device used for target.

T1_SER_BAUD

Serial baud rate used for target.

T1_SCSI_ID

SCSI ID of the device under test.

T1_SCSI_LUN

SCSI LUN of the device under test.

T1_SCSI_BUFSIZE

Buffer size, in bytes (optional).

T1_SCSI_NBBUF

Number of buffers to write (optional).

T1_SCSI_NBLOOP

Number of loops to perform (optional).

T1_TMO_SCSI

Timeout value, in seconds (optional).

EXAMPLE

Output consists of:

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

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



    SCSI Test :
    scsiShow() test                                           : PASS
    SCSI write/read/verify device                             : PASS

                      Tests RUN           2
                      Tests PASSED        2
                      Tests FAILED        0
                      Tests SKIPPED       0

SEE ALSO

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