Views
Quality/TestSuite/Sensor Test Front-end
m |
m |
||
| Line 5: | Line 5: | ||
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. | 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 [[Sensor plug-in API]]. For information about specific sensor test plug-ins, see the plug-in documentation. | + | This document describes the sensor test framework from a user's point of view. For information about developing sensor test plug-ins, see [[../Sensor plug-in API]]. For information about specific sensor test plug-ins, see the plug-in documentation. |
== Running the tests == | == Running the tests == | ||
Revision as of 11:14, 7 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:
| Switch | Function |
|---|---|
| -l | Used log file, default blts_sensors_log.txt |
| -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 parameter configuration file |
| -? | This 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 |
| -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 |