TestRtpApp

RTP Test Application Configuration

The RTP Test Application is a utility application which allows for the comparison of a played RTP audio stream against a list of files loaded from disk.

Here is a configuration example:

<?xml version="1.0" encoding="utf-8"?>
<n2svcd>
  ...
  <applications>
    ...
    <!-- TestRtpApp for receiving and comparing UDP RTP packets. -->
    <application name="TestRtpApp" module="TestRtpApp">
        <include>
            <lib>../../n2sip/apps/rtp_test/lib</lib>
            <lib>../../n2sip/apps/rtp/lib</lib>
            <lib>../../n2sip/lib</lib>
            <lib>../lib</lib>
        </include>
        <parameters>
            <parameter name="inbound_rtp_local_host" value="${N2SVCD_TEST_IP}"/>
            <parameter name="rtp_start_port" value="3000"/>
            <parameter name="rtp_streams_per_app" value="40"/>
        </parameters>
    </application>
    ...
  </application>
  ...
</n2svcd>

Note the use of ${N2SVCD_TEST_IP}. All parameter value attributes support the use of environment variables to allow a single n2svcd.xml to operate on different platforms without needing to be modified for each platform.

Configuration Details

The application element attributes for SIP Test Application instance may include the below.

For details of the various parameter types used, refer to Common Configuration.

Parameter Name Type XML Type Description
See: Common Application configuration
module String Attribute [Required] TestRtpApp
include.lib String Attribute [Required] ../../n2sip/apps/rtp_test/lib
[Required] ../../n2sip/apps/rtp/lib
[Required] ../../n2sip/lib
[Required] ../lib
parameters Array Element [Required] As per Common Configuration Application parameters.
"inbound_rtp_local_host" String Atrribute Local IPv4 Host Name or A.B.C.D IPv4 Address which the UDP server listens on.
(Default = 0.0.0.0, all addresses)
"rtp_start_port" Integer Attribute The lowest IPv4 Port Number which will be assigned. This must be an even-numbered port.
Each stream requires two ports – the even-numbered port for RTP and the odd-numbered port for RTCP.
Hence each TestRtpApp will use 2 * rtp_streams_per_app ports.
The lowest port will be rtp_start_port and the highest port will be rtp_start_port + (2 * repeat * rtp_streams_per_app) - 1.
All ports in the range must be strictly reserved. The stream will fail if the port is not available.
(Default = 3000).
"rtp_streams_per_app" Integer Attribute Number of simultaneous audio streams that a single TestRtpApp will support.
(Default = 20).

Message Handling

In addition to the common Application management messages, the TestRtpApp uses the following messages: