Table of Contents

MHEG5 Test Environment

Requirements

The linux simulator requires a number of third-party libraries to be installed on the system:

Building the Test Environment

  1. Ensure that the host system has the third-party libraries listed above installed.
  2. Checkout and build MHEG5 and DSM-CC modules for the host system.
  3. Enter the test subdirectory of the MHEG5 project.
  4. Setup environment variables (see provided example_setenv.sh in the test directory)
  5. Run make

Configuring the Test Environment

Rename and modify test/lua/utils/example_local.lua to test/lua/utils/local.lua. This file specifies the path to directory/directories containing the transport stream files to use for testing.

Running the Simulator

The test application can be run in three modes:

Simulator Mode

Activated by passing the -s option on the command-line. Requires a stream-set to be specified (command line parameter -S <set-name>), as defined in the test-suite configuration files under test/lua/streams. The initial LCN to tune to can be specified using the -L <LCN> command-line option, otherwise the simulator will tune to the lowest LCN.

Record Mode

Activated by passing the -r option on the command-line. Requires a stream-set to be specified (command line parameter -S <set-name>, as with simulator mode) and a test path (command line parameter -t <test-path>). The test path specifies a directory for the test script and any associated screenshots to be created in, any directories in the path that do not exist will be created. Each path must be specific to one test, if an existing test directory is specified it will be re-written automatically. The initial LCN can be specified in the same way as simulator mode, using -L <LCN>

Playback Mode

Activated by passing the -p option on the command-line. User interaction is disabled in this mode. Requires a test-path to be specified using the -t <test-path> command-line parameter. By default, playback will run in headless mode and not display the UI. The UI can be enabled by passing -d