BSP Developer's Guide

VxWorks 5.5
BSP Developer’s Guide
The third test spawns a single pkLoopbackTest( ) task for each serial port connected in
loopback mode. Each port sees a pattern of sequential characters sent and received at the
maximum baud rate. All characters must be received in the order sent. If this test fails,
check that all serial ports under test are set up correctly for loopback mode. Make sure
that the serial driver is handling receive and transmit interrupts properly. Make sure that
all serial channels under test have been configured and initialized to the correct values.
The fourth test spawns several pkLoopbackTest( ) tasks for each serial port connected in
loopback mode. Each task repeatedly sends a particular character to one of the ports.
There are several tasks for each serial port under test. Each port should receive all the
characters that were sent. If this test fails, check the same problem areas suggested for the
third test.
The third and fourth tests spawn one or more pkLoopbackTest( ) tasks for each serial
device connected in loopback mode. These tasks run concurrently, sending and receiving
characters at the highest baud rate supported by both host and target. It is possible that
target boards with slower CPUs and many serial devices might not possess the raw
processing power required to keep up with the tests. If hardware limitations are causing
the loopback tests to fail, the tests can be configured to lighten the processor load. The
serial.tcl tests run at the highest baud specified in the bspVal macro,
BSPTEST_HOST_RATES (provided that the rate is supported by both the host and
target).
Modifying BSPTEST_HOST_RATES to exclude the higher common baud rates will cause
the tests to run at a lower rate, thus avoiding possible hardware- related problems.
Additionally, the pkLib.c constant PK_LOOP_TASK_NUM can be changed from the
default value of 4 to decrease the number of concurrent tasks running in the fourth test. In
this case, the object code file pkLib.o must be rebuilt from the changed pkLib.c source
file.
Target boards with several serial devices and a small amount of local RAM (1Mbyte or
under) might run out of memory while executing the tests. In this case, either configure
the target to use an external memory card or decrease the number of tasks running as
described above.
If the test script execution ends prematurely, the target board might be left set to a baud
rate other than T1_TIP_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
Baud rates supported on host. (required)
T1_SER_DEVICE
Serial device to be used on host. (required)
396