This file is a compilation of the few various KeyLabs text files found in the tarball. These are made as one text file for quick and easy online viewing. The text files which come with the testing programs themselves are in separate folders in the tarball. The various text files are separated with lines like: >>> BEGIN VIDEO WORKSHEET <<< >>> END VIDEO WORKSHEET <<< >>> BEGIN TTCP TEST TOOL TEXT FILE <<< >>> END TTCP TEST TOOL TEXT FILE <<< The text files included in this file are: vc_cert.txt >>> BEGIN VIDEO ADAPTER WORKSHEET (vc_cert.txt) <<< Linux Video Card Certification Worksheet KeyLabs' Linux Video Card Certification Test Rev/ 1.1 - JCW Tester Name: ____________________________________ Date: __________________________ Section 1: Product Information Manufacturer: ____________________________________________________________________ Product Name and Model Number: ____________________________________________________ Product Description:_______________________________________________________________ Overall Result: PASS FAIL Amount Video RAM: _____________ RAMDAC:________________________________________ Bus: PCI AGP Integrated Chipset: ____________ Programmable clock: Yes No Driving Clock (Dot Clock) Frequencies:_____________________________________________ Video Card is: 2D 3D Both Video Card target market: Server Workstation Both Section 2: Testing Environment & Product Setup Testing Tools Test Monitor Manufacturer: _______________________________________________________ Monitor H sync: __________ Monitor V sync: __________ Monitor Bandwidth:_______ Test Mouse: ______________________________________________________________________ Test Keyboard: ___________________________________________________________________ Test System is a: ________________________________________________________________ CPU ______________ Amount RAM: _____________ Amount HD Space:_________________ Is this card a Plug 'n' Play type video card? YES NO Does the product require modification out of the box? YES NO Are X servers supplied by the manufacturer? YES NO Are X servers available on the Internet? YES NO Does the product install as suggested by the manufacturer? YES NO Does the manufacturer provide an install script or program? YES NO Are any additional steps required to setup the product? YES NO Linux Distribution for this Test: [ ] Caldera [ ] Pacific High Tech [ ] S.u.S.E. [ ] Redhat Section 3: Tests System Detection Test: PASS FAIL SuperProbe/XF86 Detection Tests: PASS FAIL Procedure used: __________________ Display Console Compatibility clear command PASS FAIL less usage PASS FAIL X Driver Install Test mouse detected/installed: PASS FAIL keyboard detected/installed PASS FAIL v. card detected/installed PASS FAIL monitor properly installed PASS FAIL resolutions PASS FAIL Resolution Sqitching Test PASS FAIL 2D X Functionality - HDBench Test PASS FAIL 3D X Functionality Mesa hardware-assist compile PASS FAIL N/A Xscreensaver 3D demo PASS FAIL N/A Demo used: ________________ Quake III PASS FAIL N/A Mixed Functionality Load Test PASS FAIL N/A Additional Features Testing PASS FAIL N/A Section 4: Testing Procedures System Detection Test Procedure: Tester powers up the system and checks /proc/pci (for PCI& AGP bus cards) or does a pnpdump (for ISA cards) to determine if the system correctly detects the video card. Determination: If the card/chip shows in the above-listed files then the test is a pass; otherwise, fail. SuperProbe/XF86 Detection Test Procedure: Tester runs SuperProbe to determine if the card is properly identified and read. If SuperProbe is not available, the tester uses the probling facilities of XF86Setup to see if the card can be properly identified and read. Determination: The card must be properly identified and read (the returned information must match the manufacturer's information) for the test to be considered a pass; otherwise, fail. While either of the two procedures (SuperProbe or XF86Setup) are acceptable the tester should make a note as to which procedure was used in the test. Display Console Compatibility Procedure: Tester operates the system using the console to verify the video display adapter will setup and work correctly. Tester must verify proper keyboard functionality (use an editor such as Emacs) and proper mouse functionality (have gpm installed and running.) Determination: All fonts must show correctly; keys must funcitons properly inside an editor; control keys must function properly. For gpm tests, all three buttons must work correctly when using the point/cut/paste functions. X Driver Install Test Procedure: Tester follows manufacturer's procedures for setting up X. If there are no specific instructions from the manufacturer, the tester uses standard XF86Setup program procedure to install X for the video card. Determination: For this test X must be completely installed and working and the following must be true: mouse properly detected and installed keyboard properly detected and installed video card properly detected and installed monitor properly installed For workstation: resolution modes available at 1024x768 & higher with minimum 16-bit color depth For server: resolution modes available at 640x480 or higher with minimum 8-bit color depth If any other element of the X install other than the video card fails, the tester should replace that equipment with equipment which will function for the test (failure of equipment other than the video card does not fail the video card.) If the video card cannot be properly detected by the X or installed by XF86Setup, the test is a fail. [NOTE: Target market is relevant here: Usage of the XF86_VGA16 X server is acceptable for servers but not for workstations. If the card's target market is both servers and workstations, then the card must meet test requirements for workstations.] Resolution Switching Test Procedure: Tester uses either the to cycle through the available resolutions. If only one resolution is available, the tester should reconfigure the X driver setup to allow for additional resolutions for this test. Determination: The switching between resolutions should occur without crashing of the X server. Screens should allow for virtual desktops where going from higher to lower resolutions. If such behavior results, the test is a pass; otherwise, fail. 2D X Functionality Test Procedure: Tester installs the HDBench test program and runs the video test. Statistics are to be collected, placed in a note on the test worksheet and made available to the customer if requested. Determination: All tests in the video suite of HDBench must pass and return statistics for the test to pass; otherwise, fail. 3D X Functionality Test Procedure: Tester installs and compiles Mesa for hardware-assisted 3D rendering. Tester then installs either Xscreensaver or Quake III. Actual testing is done with either the 3D demos of Xscreensaver or with Quake III. Determination: The 3D rendering must use hardware-assisted 3D rendering: Software rendering is not acceptable for this test. If Xscreensaver is used, the 3D demo program used must be documented on the provided line and the demo must run and must operate as described in the man page for the demo. If Quake III is used as the test program, the program must use a hardware-assisted video mode; the program must cycle completely through start-setup-play (one complete level) and then exit. Mixed Functionality Load Test Procedure: Tester uses (and installs if necessary) one of the following window managers: BlackBox, WindowMaker, or Enlightenment. Tester installs and compiles either wterm or aterm with transparent functionality and pixmaps included. Tester installs ImageMagic. Xscreensaver should already be installed. Testing is: Xscreensaver running a 3D demo (with hardware-assist!) in a window; Window manager displaying an image in the root window; Multiple term windows (transparent, shaded or tinted) with the root window image visable as the background of the term (minimum 2); Multiple animated GIFs being run by ImageMagic's animate program (minimum 2); Multiple transparent GIFs being displayed by ImageMagic's display program (minimum 2.) Determination: To pass, all the above must be running simultaneously and remain running for a period of eight or more hours. After eight hours continuous operation tester performs the following functions: Starts an additional animated GIF with ImageMagic's animate program; Displays an additional transparent GIF with ImageMagic's display program; Opens an additional transparent term window; Changes the image in the root window via the window manager; Changes the 3D demo being displayed via Xscreensaver control panel. If at any time during the eight hour load test or during the post-load changes the X server crashes, the tester will need to try and determine the cause of the crash. To do this, restart the load test programs listed in procedure and let run for an additional hour. If this is possible, then the cause of the crash was most likely the X server or the interaction of one of the running programs with the X server (which is not a failure of the video card.) If the programs cannot be immediately restarted or can only be restarted after period of time has passed, then the video card be over-heating. An over-heated video card is a failure of the test. If the eight hour load test and subsequent changes occur without event, the test is a pass; otherwise, fail. If there is a test fail, be sure to document as much as possible in a note attached to the worksheet. Additional Features Testing Procedure: If a particular card/chip has additional features not listed in this test which are being promoted by the manufacturer, the tester must determine if it's possible these features are available for use under Linux. If they are, the tester must devise a test for these features, test the features and document all procedures and testing and attach the results to both this worksheet and to the final report. Determination: If the testing devised and executed by the tester proves the functionality of the additional features of the product being tested are indeed available under Linux then this test is a pass; otherwise, fail. Resources: Manufacturer's web site 3Dfx-HOWTO XFree86-HOWTO XFree-Video-Timings-HOWTO XWindow-User-HOWTO >>> END VIDEO ADAPTER WORKSHEET (vc_cert.txt) <<<