PVQA-caller is implemented as efficient native (unmanaged code) cross platform console application (Linux / OS X / Windows).It receives configuration switches from command line, makes a VoIP call according to parameters and dumps call characteristics to console.
Depending on switches PVQA-caller can register on PBX, make call to different systems, support ICE for complex network infrastructure, play received audio to speaker or save it as audio file.
The table below contains PVQA-caller configuration switches.
|target||SIP address to call. Can be SIP or SIPS address.
|transport||SIP transport to use. Values can be UDP / TCP / TLS / ANY.
Recommended value is “any”, which is set by default.
|Optional. Default value is “any”|
|username||Username for registration.
|Mandatory. PVQA-caller requires registration on PBX before starting a call.|
|password||Password for registration.
|domain||Domain name of registrar PBX.
May include port number.
|logfile||Path to detailed PVQA-caller detailed activity log file.||Optional parameter. PVQA-caller does not write log file by default.|
|duration||Maximum call duration in seconds. After specified duration call will be terminated by PVQA-caller.||Optional parameter. PVQA-caller does not initiate end of call by default.|
|native-audio||Forces PVQA-caller to play audio to default audio output device.||Optional parameter. PVQA-caller will not play audio to speakers by default.|
|verbose||Verbose. PVQA-caller will write to console current progress of the test call.||Optional parameter. By default PVQA-caller dumps only result statistics to console.|
Here is an example of PVQA-caller usage:
./pvqa-caller –username myusername –password mypassword –domain voipobjects.com –transport tcp –target “<sip:firstname.lastname@example.org>” –logfile pvqa-caller.log –verbose –dump-pcm incomingaudio.wav
Call quality statistics is returned in JSON format and contains the following metrics:
|codec||Name of used codec.|
|network_mos||MOS value is based on packet loss statistics and calculated according to G.107 (E-model) standard.|
|pvqa_mos||MOS value calculated by PVQA analyzer.|
|pvqa_report||Report generated by PVQA analyzer.|
|rtp_lost||Number of lost RTP packets.|
|rtp_sent||Number of sent RTP packets.|
|rtp_received||Number of received RTP packets.|
|rtt||RTT time in milliseconds.|
|jitter||Jitter in milliseconds.|
|duration||Duration in seconds.|
|target||SIP address of remote peer.|
PVQA-caller requires pvqa.lic and pvqa.cfg files, which are license and configuration files of PVQA analyzer correspondingly.