Quality/TestSuite/X11 Test Specification

Revision as of 10:57, 16 December 2010

Introduction

The X Window System (commonly X or X11) is a computer software system and network protocol that provides a graphical user interface (GUI). Base X Window System is extended by X Extension libraries (mainly from freedesktop.org and XFree86 projects).

The blts-x11 test driver includes functional tests for X11 using xlib, and for various X Extensions using their user space libraries

Test Coverage

The test driver currently covers basic functionalities of X11 and it's extensions, including:

• X11 presence check
• Enumerating and checking needed X Extensions
• Basic window creation operations and drawing
• XComposite: Rendering to off-screen buffer
• XDamage: Creating and monitoring 'damage' regions
• XInput: Accessing (listing) available input devices
• XRender: Simple drawing
• XRandR: Dynamically change X screen (rotation/orientation)
• XRecord: Recording X protocol events (such as mouse movement)
• XTest: Generating input device events (for example generating mouse movement events)
• XVideo: Overlay video output

Software Coverage

Current coverage for X11 tests:

Hardware Coverage

Mainly display devices (and GPU).

Limitations

TBD

Future Improvements

Extend functional coverage of existing test and create performance tests for XVideo, XComposite and DRI2.

Running the tests

Hardware setup and test environment

No specific hardware setup is required. The test environment must be running an X11 server, and must have the following packages installed:

• libbltscommon1
• libX11
• libXdamage
• libXcomposite
• libXrandr
• libXrender
• libXtst
• libXv
• libXi

Building the test asset

The build environment must have the following packages installed:

• libbltscommon1-devel
• libX11-devel
• libXdamage-devel
• libXcomposite-devel
• libXrandr-devel
• libXrender-devel
• libXtst-devel
• libXv-devel
• libXi-devel

The source package includes the pack.sh script, which is used for building RPM and Debian packages and source tar packages. To build an RPM package with the script, execute this command in the top level source directory of asset:

./pack.sh -r

To get help about the packaging script, execute

./pack.sh -h

The asset can also be built manually by executing:

./autogen.sh
./configure
make

Test asset specific instructions

The test package can be installed in the device with the command

rpm -ivh blts-x11_{version}.rpm

Test case arguments

Running test cases

Test cases must be executed with root privileges.

Test case descriptions and execution commands:

• X11-X11 presence check
  • Check that required X11 components are present in the test device
  • blts-x11-tests -en "X11-X11 presence check"

• X11-Create simple window
  • Create a simple X11 window and execute string and rectangle drawing tests
  • blts-x11-tests -en "X11-Create simple window"

• X11-Enumerate X extensions
  • Enumerate X extensions supported by the X11 server
  • blts-x11-tests -en "X11-Enumerate X extensions"

• X11-XVideo init
  • Check that XVideo initialization works on configured screens, and test XVideo image output
  • blts-x11-tests -en "X11-XVideo init"

• X11-XTest move cursor
  • Test cursor movement using the XTest extension
  • blts-x11-tests -en "X11-XTest move cursor"

• X11-XComposite get window contents
  • Check that window contents can be captured using the XComposite extension
  • blts-x11-tests -en "X11-XComposite get window contents"

• X11-XRecord capture mouse movement
  • Check that mouse movement can be captured using the XRecord extension
  • blts-x11-tests -en "X11-XRecord capture mouse movement"

• X11-XRender draw rectangle
  • Test rectangle drawing using the XRender extension
  • blts-x11-tests -en "X11-XRender draw rectangle"

• X11-XRandR rotate screen
  • Test screen rotation using the XRandR extension
  • blts-x11-tests -en "X11-XRandR rotate screen"

• X11-XDamage monitor region
  • Check that screen region monitoring works using the XDamage extension
  • blts-x11-tests -en "X11-XDamage monitor region"

• X11-XInput enumerate devices
  • Enumerate XInput devices
  • blts-x11-tests -en "X11-XInput enumerate devices"

Module Design and Architecture

The test module can be compiled to a self-sufficient command line program. Debian and RPM packaging is provided.

Architecture diagram

References

Change History