ffbtest verifies the functionality of the Fast Frame Buffer.
ffbtest can detect and adapt to the video modes of single- and double-buffer versions of the fast frame buffer (FFB). All ffbtest tests can run in several screen resolutions such as standard, stereo, and high resolution. In stereo mode, all tests write into the right and left eyes unless you specify otherwise. This test also supports FFB, FFB2, and FFB2+ fast frame buffer configurations. Use the ffbconfig -prconf command to display the configuration of the frame buffer you want to test.
You can interrupt ffbtest using Control-C. Turn off all other keyboard input if OPEN LOOK is running on the unit being tested.
Test accuracy is checked using a checksum algorithm. Possible locations of failing pixels are identified, as well as the likely failing FRU.
DO NOT run any other application or screen saver program that uses the FFB accelerator port while running ffbtest. Do not run power management software. These programs causes SunVTS to return incorrect errors.
Disable all screen savers before testing any graphics device. Type xset s off at a UNIX prompt to disable the Solaris screen saver. Disable power management software if it is running.
DO NOT run Open Windows across multiple monitors.
ffbtest requires approximately 7 Mbytes of disk space in the /tmp directory to extract its working files. If this space is not available, the diagnostic will fail and report warning and error messages, indicating a lack of disk space.
To start SunVTS with vtsui, but without vtsk, you must add the host name to xhost as: xhost + <hostname>.
By default, all tests are enabled except the stereo test.
Table 16-1 ffbtest Options
Due to the nature of graphic tests, reading from or writing to the frame buffer during graphic tests will disturb user operation. This test is only available in Functional Test and Stress Mode.
Table 16-2 ffbtest Test Modes
Test Mode |
Description |
---|---|
Functional Test |
The ffbtest verifies both the single- (SFB) and double-buffered (DBZ) fast frame buffer boards. |
Stress Mode |
Stress mode exercises the frame buffer as much as possible. The Random Test generator, constructed as part of the verification effort, is used. Starting from a known seed, random primitives with random attributes are generated. The primitives are checked to ensure that they were rendered in the same way as on a known good system. The test is repeated ten times, with each random picture overlaying the previous one. Stress is mode is not available on FFB2+ boards. |
/opt/SUNWvts/bin/ffbtest standard_arguments -o dev=device_name, S=subtest_number,F=#_of_subtest_loops,B=#_of_test_loops,P=test_pattern
Table 16-3 ffbtest Command Line Syntax
Argument |
Explanation |
---|---|
dev=device_name |
device_name is the relative path name of the device being tested with respect to /dev/fbs; The default is ffb0. |
S=subtest_number |
subtest_number is the test number of the subtest to be run. Select from the subtests below. You can run multiple subtests by adding the subtest numbers. For example, n=0x3 runs both test 1 and test 2; n=0x180 runs both test 0x080 and test 0x0100. Note that you do not need the leading zeros. n - 0x00001 3DRAM n - 0x00002 3DRAM Logic n - 0x00004 RAMDAC n - 0x00008 Rendering Pipeline n - 0x00010 FastFill/Vertical Scroll n - 0x00020 Pixel Processor n - 0x00040 Picking n - 0x00080 Arbitration n - 0x00100 Stereo More than one test can be selected by ORing subtest numbers. For example: n = 0x00009 selects 3DRAM and Rendering Pipeline tests. A hex number must be preceded by 0x, decimal numbers are also acceptable.
|
F=#_of_subtest_loops |
Specifies the number of times to repeat each subtest; the default is 1. |
B=#_of_test_loops |
Specifies the number of times to repeat a test loop before passing; the default is 1. |
P=test_pattern |
Specifies the test pattern number. The default is r, for random patterns. You may also choose 0 for 0x0000000, 3 for 0x3333333, 5 for 0x5555555, or 9 for 0x9999999. |
64-bit tests are located in the sparcv9 subdirectory: /opt/SUNWvts/bin/sparcv9/testname. If a test is not present in this directory, then it may only be available as a 32-bit test. For more information refer to "32-Bit and 64-Bit Tests".
Errors returned by ffbtest are nonspecific. It is not possible to determine which component caused a failure. In all error conditions, the field replaceable unit (FRU) is the entire FFB.
Table 16-4 ffbtest Error Messages
|
Error Message |
Probable Cause(s) |
Recommended Action |
---|---|---|---|
6000 |
3DRAM Memory error in string Plane |
Faulty 3DRAM, or possibly host memory error during gcopy operation. |
If the problem persists, contact your authorized Sun service provider. |
6002 |
3DRAM Memory error in string Plane |
Faulty 3DRAM, or possibly host memory error during gcopy operation. |
If the problem persists, contact your authorized Sun service provider. |
6004 |
3DRAM Memory error in string Plane |
Faulty 3DRAM, or possibly host memory error during gcopy operation. |
If the problem persists, contact your authorized Sun service provider. |
6006 |
3DRAM Memory error in Buffer A |
Faulty 3DRAM, or possibly host memory error during gcopy operation. |
If the problem persists, contact your authorized Sun service provider. |
6008 |
3DRAM Memory error in Buffer B |
Faulty 3DRAM, or possibly host memory error during gcopy operation. |
If the problem persists, contact your authorized Sun service provider. |
6010 |
3DRAM Memory error in Buffer C |
3DRAM Memory error in Buffer C. |
If the problem persists, contact your authorized Sun service provider. |
6012 |
Misaligned raster. |
Software error. |
Reinstall software. If the problem persists, contact your authorized Sun service provider. |
6013 |
File Not Found. Could not open file string. |
Software error |
Reinstall software. If the problem persists, contact your authorized Sun service provider. |
6014 |
Could not open file string: string. |
Software error. |
Reinstall software. If the problem persists, contact your authorized Sun service provider. |
6015 |
Keyword not Found, line data |
Software error, Suspect data file corruption. |
Reinstall software. If the problem persists, contact your authorized Sun service provider. |
6016 |
string error. Miscompares, starting at string. |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6017 |
Picking test error. Got a pick hit with picking disabled. |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6018 |
Picking test error. Got a pick hit outside the picking area. |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6019 |
Picking test error. Should have detected a pick hit. |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6020 |
Out of memory |
Software System Error. |
Contact system administrator |
6021 |
string failed |
Software error. |
Check for existence and/or permissions on string. Also check for available space in tmp. Reinstall software or contact your system administrator. |
6022 |
string failed |
Software error. |
Check for existence and/or permissions on string. |
6023 |
fork1(2) failed |
Software error. |
Reinstall software or contact your system administrator. |
6024 |
execl(2) failed |
Software error. |
Reinstall software or contact your system administrator. |
6025 |
Unable to open string. |
Software error. |
Check device for existence and/or permissions on string. Reinstall software or contact your system administrator. |
6026 |
ioctl(2) failed trying to read CLUT. |
hardware failure or software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6027 |
ioctl(2) failed trying to turn on FFB video. |
hardware failure or software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6028 |
failed trying to post CLUT. |
hardware failure or software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6029 |
Miscompare found in Red channel of CLUT entry data. |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6030 |
Miscompare found in Green channel of CLUT entry data |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6031 |
Miscompare found in Blue channel of CLUT entry data |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6032 |
ioctl(2) failed trying to read WID LUT. |
hardware failure or software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6033 |
ioctl(2) failed trying to post WID LUT |
hardware failure or software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6034 |
failed trying to get RAMDAC signature analysis. |
hardware failure or software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6035 |
Miscompare found in WID LUT entry data |
Faulty frame buffer |
If the problem persists, contact your authorized Sun service provider. |
6036 |
RAMDAC test failed. The on-screen image is incorrect |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6037 |
sysinfo(2) failed getting hostname |
Software error. |
Make sure you are superuser. |
6038 |
can't acquire console semaphore |
Software error. |
Reinstall software or contact your system administrator. |
6039 |
Cannot gain control of mouse: string |
Software error. |
Reinstall software or contact your system administrator. |
6040 |
Cannot gain control of keyboard: string |
Software error |
Reinstall software or contact your system administrator. |
6046 |
ioctl(2) failed trying to get current video mode. |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6047 |
ioctl(2) failed trying to set current video mode |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6048 |
ioctl(2) failed trying to get FFB system info |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6049 |
ioctl(2) failed trying to go into Diagnostic mode |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6050 |
mmap(2) failed: string |
Software system error. |
Reinstall software or contact your system administrator. |
6051 |
munmap(2) failed: string |
Software system error. |
Reinstall software or contact your system administrator. |
6052 |
close(2) failed: string |
Software system error. |
Reinstall software or contact your system administrator. |
6053 |
DGA error grabbing window on screen data |
Software error. |
Reinstall software or contact your system administrator. |
6054 |
DGA error getting window from token on screen data |
Software error. |
Reinstall software or contact your system administrator. |
6055 |
failed trying to read Transparent Overlay registers |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6056 |
ioctl(2) failed trying to post Transparent Overlay registers |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6057 |
failed trying to post cursor |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6058 |
ioctl(2) failed trying to read cursor |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6059 |
No FFB device found on display 0 |
The environmental variable DISPLAY is set wrong or the display being used is not using an FFB. |
Set the variable to a display that has the FFB plugged into it. |
6060 |
There is an inconsistency with the version of the X Window System |
Software error. |
Contact your system administrator |
6061 |
stat(2) failed trying to get info about Device Under Test |
Software error. |
Reinstall software or contact your system administrator. |
6062 |
stat(2) failed trying to get info about screen 0:data |
Software error. |
Reinstall software or contact your system administrator. |
6063 |
Can not access X Windows |
Software error. |
Try running xhost(1) or contact your system administrator. |
6064 |
wait(2) failed: string |
Software error. |
Reinstall software or contact your system administrator. |
6065 |
signal(2) failed: string |
Reinstall software or contact your system administrator. |
Reinstall software or contact your system administrator. |
6066 |
thr_kill(2) failed |
Software error. |
Reinstall software or contact your system administrator. |
6067 |
thr_join(2) failed: string |
Software error. |
Reinstall software or contact your system administrator. |
6071 |
get signatures |
operator error. |
To get signatures, run ffbtest from the command line |
6072 |
Stereo image incorrect |
Stereo image incorrect. |
If the problem persists, contact your authorized Sun service provider. |
6075 |
System LWP limit exceeded |
Software error. |
Reinstall software or contact your system administrator. |
6076 |
Error data creating thread |
Software error. |
Reinstall software or contact your system administrator. |
6104 |
Error in getting the length of the file. string |
Software error. |
If the problem persists, contact your authorized Sun service provider. |
6105 |
Stencil test failed string |
Faulty 3DRAM. |
If the problem persists, contact your authorized Sun service provider. |
6106 |
Passin test failed string |
Faulty 3DRAM. |
If the problem persists, contact your authorized Sun service provider. |
6107 |
Blend2 test failed string |
Faulty 3DRAM. |
If the problem persists, contact your authorized Sun service provider. |
6115 |
3DRAM Memory error testing string |
Faulty 3DRAM, or possibly GCopy error. |
If the problem persists, contact your authorized Sun service provider. |
6116 |
string error: 3DRAM Memory error testing string |
Faulty 3DRAM, or possibly GCopy FFB to Memory error. |
If the problem persists, contact your authorized Sun service provider. |
6117 |
string error: 3DRAM Memory error testing string |
Faulty 3DRAM, or possibly GCopy Memory to FFB error. |
If the problem persists, contact your authorized Sun service provider. |
6208 |
ioctl(2) failed trying to post Overlay WID LUT. |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6209 |
ioctl(2) failed trying to post Primary WID LUT |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6210 |
Miscompare found in Overlay WID LUT entry data |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6211 |
Miscompare found in Primary WID LUT entry data |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6212 |
ioctl(2) failed trying to read CLUT # data |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6213 |
ioctl(2) failed trying to post CLUT # data |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6214 |
Miscompare found in Red channel of CLUT # data in entry data |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6215 |
Miscompare found in Green channel of CLUT # data in entry data |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6216 |
Miscompare found in Blue channel of CLUT # data in entry data |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider.
|
6217 |
RAMDAC test failed. The on-screen image in sep 4 mode is incorrect. |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6218 |
RAMDAC test failed. The on-screen image in sep 8 mode is incorrect. |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6219 |
RAMDAC test failed. The on-screen image in combined mode is incorrect. |
Faulty frame buffer. |
If the problem persists, contact your authorized Sun service provider. |
6220 |
ioctl(2) failed trying to read Overlay WID LUT |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |
6221 |
ioctl(2) failed trying to read Primary WID LUT |
Possibly hardware failure, likely software driver error. |
Reinstall software first, if failure continues, see a system administrator or your authorized Sun service provider. |