Views
Quality/TestSuite/Sensor Test Front-end
m |
m |
||
| Line 51: | Line 51: | ||
Arguments: | Arguments: | ||
| - | {| cellspacing="0" border="1" | + | {{:Quality/TestSuite/Common_General_Switch}} |
| - | ! Switch ! | + | {|style="width:100%" cellspacing="0" border="1" |
| - | + | !style="width:20%"|Optional Switch | |
| - | + | !style="width:80%"|Function | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | | | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
|- | |- | ||
| -p || Specify the plug-in to test. This is the full path of the sensor plug-in .so. | | -p || Specify the plug-in to test. This is the full path of the sensor plug-in .so. | ||
Revision as of 13:03, 14 December 2010
Contents |
Introduction
The BLTS sensor test framework consists of the front-end test runner application, implemented in the blts-sensors-frontend package, and sensor test plug-ins, which are implemented in separate packages. The front-end implements a set of generic tests that are parameterized to execute sensor-specific tests. The sensor test plug-ins provide the front-end with access to sensor data by implementing a plug-in API, and specify in a configuration file how test cases are run. The front-end in turn loads sensor test plug-ins, and runs the test cases as configured.
This document describes the sensor test framework from a user's point of view. For information about developing sensor test plug-ins, see Quality/TestSuite/Sensor plug-in API. For information about specific sensor test plug-ins, see the plug-in documentation.
Running the tests
Hardware setup and test environment
The sensor test front-end does not have any requirements for the hardware on the test device, but individual sensor test plug-ins may have additional hardware requirements.
The test enviroment must have the following packages installed:
- libbltscommon1
Building the test asset
The build enviroment must have the following packages installed:
- libbltscommon1-devel
The test asset sources include 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 toplevel source directory of blts-sensors-frontend:
./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-sensors-frontend_{version}.rpm
Executing tests
Before any tests can be executed, a sensor test plug-in must be installed on the device. Once a plug-in is installed, tests can be executed from command line:
blts-sensors-frontend -p <path_to_plug-in> -C <path_to_config>
Arguments:
| General Switch | Function |
|---|---|
| -l | Used log file |
| -e | Execute single or multiple selected tests, for example -e 1,4,5. |
| -en | Execute test by name, for example -en "My test X" |
| -s | Show list of all tests |
| -C | Used configuration file |
| -? | Help message |
| -xml, -axml | Create result XML. -axml appends results to an existing XML file. |
| -auto | Silent logging for test automation. Only the results are printed to stdout. |
| -v | Verbose logging (default) |
| -vv | Even more verbose logging |
| Optional Switch | Function |
|---|---|
| -p | Specify the plug-in to test. This is the full path of the sensor plug-in .so. |
Sensor test plug-ins are installed to /usr/lib/tests/blts-sensor-plugins, and plug-in configuration files are installed to /etc/blts. For example, when using the example sensor test plug-in, the command line for running the tests would look like this:
blts-sensors-frontend -p /usr/lib/tests/blts-sensor-plugins/libbltssensor_example.so -C /etc/blts/blts-sensor-example.cnf
Test cases must be run with root privileges.
Documentation for sensor-specific test cases is provided by individual sensor test plug-in packages.
References
| blts-sensors-frontend | blts-sensors-frontend sources |
Change History
| Version | Date | Handled By | Status | Comments |
|---|---|---|---|---|
| 0.1 | 7-Dec-2010 | Pasi Matilainen | Draft | Page created |