QualTest Host User Guide
0 likes52 views
The document outlines the objectives and functionalities of the Qualtest Host utility from Sevana OÜ, which integrates Qualtest GSM with desktop systems or Raspberry Pi to manage call events and audio quality testing. It specifies the hardware and software requirements for operation, including the necessary configurations and command-line parameters to automate call monitoring and audio playback. Additionally, it provides examples of command execution and configuration files for setting up various test endpoints.
![Copyright © Sevana Oü, 2019
Sevana Oü
Roosikrantsi tn 2
Tallinna linn, Harju maakond, 10119
Estonia
Phone: +3726170331
"copy_recorded": "copy_dir"
},
{
"comments": "It is Moto G5",
"mobile_device": "ZY3227ZTJZ",
"play_device": "USB Audio Device",
"capture_device": "",
"play_file": "jane_8k_with_silence.wav",
"record_file": "",
"auto_accept": true,
"time_limit": 30,
"exec": "echo Hello from Moto G5",
"copy_recorded": "copy_dir"
}
]
}
Run it with ./qualtest-host --devices-config devices.json --adp-path=<PATH TO ADB UTILITY>
A possible scheme of test system setup one can find below:](https://image.slidesharecdn.com/qualtesthostuserguide-190821084037/85/QualTest-Host-User-Guide-4-320.jpg)
QualTest Host User Guide
- 1. Copyright © Sevana Oü, 2019 Sevana Oü Roosikrantsi tn 2 Tallinna linn, Harju maakond, 10119 Estonia Phone: +3726170331 QualTest Host Document objectives. This document describes application purpose, requirements, software architecture and user operations for QualTest Host utility from Sevana Ou. Application purpose. Application purpose is to provide means to integrate QualTest GSM (QG) with desktop or Raspberry Pi (RPi). Application receives notification from QG about call events, copies recorded calls to desktop, limits time of call, runs pvqa and aqua utilities to estimate voice quality. Hardware requirements. Hardware is a typical desktop or RPi or another ARM based single board computer and a USB audio card, which won’t be necessary if you want to setup auto answering machine only. Mobile device has to be Android (KitKat at least) phone. Software requirements. Software requires desktop/ RPi side with Linux / OS X / Windows operating system. Installation is simple, one just runs provided installation and configuration scripts. Utility does not require database connection and does not use any database software itself (but can be extended with this functionality upon request). System requires ADB package from Google, which one can find at https://developer.android.com/studio/releases/platform-tools. Requirements for the mobile side: - QualTest GSM - developer mode turned on (to allow ADB) - rooted phone is optional to install QualTest GSM
- 2. Copyright © Sevana Oü, 2019 Sevana Oü Roosikrantsi tn 2 Tallinna linn, Harju maakond, 10119 Estonia Phone: +3726170331 Operation model. QualTest Host (QH) is a utility that connects to Android phone(s) via ADB and monitors QualTest GSM events, such as incoming call, call started, call finished. For finished call the recorded file (if QualTest GSM runs as system app on rooted phone) can be copied to desktop by invoking a shell script. In other words QH is a “glue” between calls, QualTest GSM, captured audio and desktop. Using QH one can make a fully automated test system. This system will make regular test calls (e.g. every 5 minutes) to different locations, report quality and alert if something is wrong. Another use case is mobile autoresponder - QH can play audio files right to phone's headset input when receiving incoming call. Parameters list. Configuration of the utility is made from command line. Available parameters one can find in the table below: Parameter name Parameter description --output-device Output audio device name. QH will play file to this output. --input-device Input audio device name. QH will capture audio from this input. --show-devices Shows all available audio inputs and outputs. --play-file File to play. --record-file File to record from audio input. It is NOT about recordings from QualTest GSM. Usually you do not need this option. Used for special test cases only. --copy-recorded Path to directory where recorded files (from QualTest GSM) will be stored. --exec Command to execute after recorded file copied from mobile phone. -- RECORDED-- substring will be replaced with path to the copied file. --mobile-device Mobile device ID. This parameter is the phone ID. Please find it from "ADB devices" output. ID must be set, it is required value if QH has to listen notifications from Qualtest GSM.
- 3. Copyright © Sevana Oü, 2019 Sevana Oü Roosikrantsi tn 2 Tallinna linn, Harju maakond, 10119 Estonia Phone: +3726170331 --call-timelimit Call time can be limited. QH will finish the call after specified timeout. Examples of timeout value: 10s, 5000ms, 6m, 1h. --adb-path Path to ADB executable. Default is 'adb' which will work only if it is included in PATH environment settings. It is recommended for explicit values. --daemon Run QH as daemon. --autoaccept Accepts incoming calls. Can be set “on” or “off”. Default value is “on”. --help Shows help. --devices-config Path to configuration file. File can include parameters for multiple devices/endpoints. --verbose Verbose output --test-play Forces playing of reference audio file. Duration of playing is limited by --call- timelimit parameter value. Here is an example of command to run auto answering machine (phone app is already configured to automatically answer calls): ./qualtest-host --mobile-device $DEVICE_ID --play-device "$AUDIO_OUTPUT" --adb-path $ADB_PATH -- play-file jane_8k_with_silence.wav --call-timelimit 30s Example of simple endpoint to run tests with reference audio: ./qualtest-host --mobile-device $DEVICE_ID --copy-recorded . --exec "./aqua_test.sh jane_8k.wav -- RECORDED--" Example of multiple endpoints configuration file: { "items": [ { "comments": "It is Galaxy S5", "mobile_device": "04baf426", "play_device": "USB Audio Device", "capture_device": "USB Audio Device", "play_file": "jane_8k_with_silence.wav", "record_file": "", "auto_accept": true, "time_limit": 30, "exec": "echo Hello from Galaxy S5",
- 4. Copyright © Sevana Oü, 2019 Sevana Oü Roosikrantsi tn 2 Tallinna linn, Harju maakond, 10119 Estonia Phone: +3726170331 "copy_recorded": "copy_dir" }, { "comments": "It is Moto G5", "mobile_device": "ZY3227ZTJZ", "play_device": "USB Audio Device", "capture_device": "", "play_file": "jane_8k_with_silence.wav", "record_file": "", "auto_accept": true, "time_limit": 30, "exec": "echo Hello from Moto G5", "copy_recorded": "copy_dir" } ] } Run it with ./qualtest-host --devices-config devices.json --adp-path=<PATH TO ADB UTILITY> A possible scheme of test system setup one can find below:
- 5. Copyright © Sevana Oü, 2019 Sevana Oü Roosikrantsi tn 2 Tallinna linn, Harju maakond, 10119 Estonia Phone: +3726170331