More Related Content Similar to QualTest Host User Guide (20) QualTest Host User Guide1. 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